justin
03c6c540ef
input_cost_trend/input_cost_series now accept six fertilizers (urea, uan, anhydrous, dap, map, potash) alongside diesel, with an optional `geo` region (default Cornbelt). Real $/ton + MoM/YoY change + seasonal context. - client: pass geo through; add input_cost_geographies - server: expand VALID_INPUTS; geo param + docstrings - format already unit-aware ($/ton) and geo-aware - README tools table now lists the reference/trend + input-cost tools - CHANGELOG: regional fertilizer input-cost release notes - tests: fertilizer $/ton + region formatting Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
339 lines
14 KiB
Python
339 lines
14 KiB
Python
"""Markdown formatter tests — no network, just JSON-in / markdown-out."""
|
||
|
||
from __future__ import annotations
|
||
|
||
import os
|
||
import sys
|
||
|
||
sys.path.insert(0, os.path.abspath(os.path.join(os.path.dirname(__file__), "..")))
|
||
|
||
from ag_bids_mcp import format as fmt
|
||
|
||
|
||
def test_fmt_best_with_winner():
|
||
payload = {
|
||
"commodity": "corn", "today": "2026-05-20",
|
||
"best": {
|
||
"source_name": "Mercer Landmark — St Henry",
|
||
"delivery": "May 2026",
|
||
"bid_cents": 491, "basis_cents": 33,
|
||
"futures_contract": "ZCK26",
|
||
"fetched_at": "2026-05-20T15:00:00+00:00",
|
||
},
|
||
}
|
||
out = fmt.fmt_best("corn", payload)
|
||
assert "Mercer Landmark — St Henry" in out
|
||
assert "$4.9100/bu" in out
|
||
assert "May 2026" in out
|
||
assert "+0.33" in out
|
||
|
||
|
||
def test_fmt_best_no_winner():
|
||
payload = {"commodity": "wheat", "today": "2026-05-20", "best": None}
|
||
out = fmt.fmt_best("wheat", payload)
|
||
assert "No current-month" in out
|
||
assert "wheat" in out
|
||
|
||
|
||
def test_fmt_futures_with_changes():
|
||
payload = {
|
||
"commodity": "corn", "delivery": "Jul 2026", "contract": "ZCN26",
|
||
"symbol": "ZC",
|
||
"quote": {
|
||
"settle_date": "2026-05-29", "open_cents": 461, "last_cents": 455,
|
||
"prev_close_cents": 460, "change_since_open_cents": -6,
|
||
"change_on_day_cents": -5, "fetched_at": "2026-05-29T18:00:00+00:00",
|
||
},
|
||
}
|
||
out = fmt.fmt_futures(payload)
|
||
assert "ZCN26" in out and "Jul 2026" in out
|
||
assert "$4.5500" in out # last
|
||
assert "$4.6100" in out # open
|
||
assert "▼ -0.06" in out # change since open
|
||
assert "▼ -0.05" in out # change on day
|
||
|
||
|
||
def test_fmt_futures_no_open_yet():
|
||
payload = {
|
||
"commodity": "soy", "delivery": None, "contract": "continuous",
|
||
"symbol": "ZS=F",
|
||
"quote": {
|
||
"settle_date": "2026-05-29", "open_cents": None, "last_cents": 1180,
|
||
"prev_close_cents": 1177, "change_since_open_cents": None,
|
||
"change_on_day_cents": 3, "fetched_at": "2026-05-29T18:00:00+00:00",
|
||
},
|
||
}
|
||
out = fmt.fmt_futures(payload)
|
||
assert "continuous nearby" in out
|
||
assert "no open captured yet" in out
|
||
assert "▲ +0.03" in out # change on day still shown
|
||
|
||
|
||
def test_fmt_futures_no_quote():
|
||
out = fmt.fmt_futures({"commodity": "wheat", "delivery": None,
|
||
"contract": "continuous", "quote": None})
|
||
assert "No futures quote on file" in out
|
||
|
||
|
||
def test_fmt_price_trend():
|
||
payload = {"commodity": "corn", "geo": "OH", "unit": "$/bu",
|
||
"source": "USDA NASS Quick Stats",
|
||
"trend": {"period": "2026-04-01", "value_cents": 468,
|
||
"prev_cents": 459, "change_cents": 9, "change_pct": 2.0,
|
||
"yoy_cents": 480, "yoy_change_cents": -12, "yoy_pct": -2.5,
|
||
"seasonal": {"normal_cents": 435, "median_cents": 430,
|
||
"min_cents": 400, "max_cents": 480,
|
||
"percentile": 75, "vs_normal_pct": 7.6,
|
||
"sample_years": 4},
|
||
"recent_direction": "up", "baseline_years": 10, "points": 120}}
|
||
out = fmt.fmt_price_trend(payload)
|
||
assert "corn — OH" in out
|
||
assert "$4.68/bu" in out
|
||
assert "+$0.09" in out and "+2.0%" in out # MoM change
|
||
assert "−$0.12" in out and "−2.5%" in out # YoY
|
||
assert "75th pct" in out
|
||
|
||
|
||
def test_fmt_price_trend_empty():
|
||
out = fmt.fmt_price_trend({"commodity": "wheat", "geo": "US", "unit": "$/bu", "trend": None})
|
||
assert "No data on file" in out
|
||
|
||
|
||
def test_fmt_price_series():
|
||
payload = {"commodity": "corn", "geo": "US", "unit": "$/bu", "count": 2,
|
||
"series": [{"period": "2026-03-01", "value_cents": 459},
|
||
{"period": "2026-04-01", "value_cents": 468}]}
|
||
out = fmt.fmt_price_series(payload)
|
||
assert "Mar 2026" in out and "$4.59/bu" in out
|
||
assert "Apr 2026" in out and "$4.68/bu" in out
|
||
|
||
|
||
def test_fmt_price_trend_diesel_units():
|
||
payload = {"commodity": "diesel", "geo": "US", "unit": "$/gal", "source": "EIA",
|
||
"trend": {"period": "2026-05-25", "value_cents": 552, "prev_cents": 560,
|
||
"change_cents": -8, "change_pct": -1.4, "yoy_cents": None,
|
||
"yoy_change_cents": None, "yoy_pct": None, "seasonal": None,
|
||
"recent_direction": "down", "baseline_years": 10, "points": 200}}
|
||
out = fmt.fmt_price_trend(payload, label="retail diesel")
|
||
assert "$5.520/gal" in out # 3-decimal $/gal formatting
|
||
|
||
|
||
def test_fmt_input_cost_payload_shape():
|
||
# Input-cost payload uses item/label and has no geo.
|
||
payload = {"item": "diesel", "label": "retail diesel", "unit": "$/gal", "source": "EIA",
|
||
"trend": {"period": "2026-05-25", "value_cents": 552, "prev_cents": 560,
|
||
"change_cents": -8, "change_pct": -1.4, "yoy_cents": 349,
|
||
"yoy_change_cents": 203, "yoy_pct": 58.2, "seasonal": None,
|
||
"recent_direction": "down", "baseline_years": 10, "points": 1680}}
|
||
out = fmt.fmt_price_trend(payload)
|
||
assert "diesel — retail diesel" in out # item/label header, no geo segment
|
||
assert "$5.520/gal" in out
|
||
assert "+58.2%" in out # YoY surfaced
|
||
|
||
|
||
def test_fmt_input_cost_fertilizer_ton_and_region():
|
||
# Fertilizer payload carries item + geo (region) + $/ton.
|
||
payload = {"item": "urea", "geo": "Cornbelt", "label": "urea", "unit": "$/ton",
|
||
"source": "USDA AgTransport",
|
||
"trend": {"period": "2026-03-01", "value_cents": 69812, "prev_cents": 51812,
|
||
"change_cents": 18000, "change_pct": 34.7, "yoy_cents": 45500,
|
||
"yoy_change_cents": 24312, "yoy_pct": 53.4, "seasonal": None,
|
||
"recent_direction": "up", "baseline_years": 10, "points": 39}}
|
||
out = fmt.fmt_price_trend(payload)
|
||
assert "urea — Cornbelt — urea" in out # item, region, label all present
|
||
assert "$698.12/ton" in out
|
||
assert "USDA AgTransport" in out
|
||
assert "Mar 2026" in out # monthly period rendered as month
|
||
|
||
|
||
def test_fmt_inputs_lime_table():
|
||
payload = {
|
||
"product": "lime", "count": 2,
|
||
"rows": [
|
||
{"source_name": "Bob's Lime Quote", "commodity": "lime",
|
||
"display_name": "Lime", "delivery": "spot",
|
||
"bid_cents": 42000, "commodity_kind": "fertilizer",
|
||
"fetched_at": "2026-05-20T15:00:00+00:00"},
|
||
{"source_name": "Coop X", "commodity": "lime",
|
||
"display_name": "Lime", "delivery": "spot",
|
||
"bid_cents": 45500, "commodity_kind": "fertilizer",
|
||
"fetched_at": "2026-05-20T15:01:00+00:00"},
|
||
],
|
||
}
|
||
out = fmt.fmt_inputs(payload)
|
||
assert "LIME prices" in out
|
||
assert "$420.00" in out
|
||
assert "$455.00" in out
|
||
assert "Bob's Lime Quote" in out
|
||
|
||
|
||
def test_fmt_inputs_empty():
|
||
out = fmt.fmt_inputs({"product": "lime", "rows": []})
|
||
assert "No lime prices on file." in out
|
||
|
||
|
||
def test_fmt_latest_table_picks_correct_unit():
|
||
payload = {"count": 2, "rows": [
|
||
{"source_name": "Bambauer", "commodity": "corn",
|
||
"display_name": "Corn", "delivery": "May 2026",
|
||
"bid_cents": 458, "basis_cents": 2, "commodity_kind": "grain",
|
||
"futures_contract": "ZCN26", "fetched_at": "2026-05-20T15:00:00+00:00"},
|
||
{"source_name": "Coop X", "commodity": "lime",
|
||
"display_name": "Lime", "delivery": "spot",
|
||
"bid_cents": 42000, "basis_cents": None, "commodity_kind": "fertilizer",
|
||
"futures_contract": None, "fetched_at": "2026-05-20T15:00:00+00:00"},
|
||
]}
|
||
out = fmt.fmt_latest(payload)
|
||
assert "$4.5800" in out # grain in /bu (4 decimals)
|
||
assert "$420.00" in out # fertilizer in /ton (2 decimals)
|
||
|
||
|
||
def test_fmt_history_with_trend_arrow():
|
||
payload = {
|
||
"commodity": "corn", "days": 7,
|
||
"rows": [
|
||
{"source_name": "Andersons", "delivery": "May 2026",
|
||
"bid_cents": 480, "basis_cents": 25,
|
||
"fetched_at": "2026-05-15T15:00:00+00:00"},
|
||
{"source_name": "Andersons", "delivery": "May 2026",
|
||
"bid_cents": 496, "basis_cents": 30,
|
||
"fetched_at": "2026-05-20T15:00:00+00:00"},
|
||
],
|
||
}
|
||
out = fmt.fmt_history(payload)
|
||
assert "▲" in out
|
||
assert "$4.8000" in out
|
||
assert "$4.9600" in out
|
||
# Basis trend is now surfaced in the summary line too.
|
||
assert "basis +0.25 → +0.30" in out
|
||
|
||
|
||
def _history_multi():
|
||
return {
|
||
"commodity": None, "days": 7,
|
||
"rows": [
|
||
{"source_name": "Minster", "commodity": "corn", "delivery": "Jul 2026",
|
||
"bid_cents": 461, "basis_cents": 11, "futures_cents": 450,
|
||
"fetched_at": "2026-05-23T15:00:00+00:00"},
|
||
{"source_name": "Minster", "commodity": "corn", "delivery": "Jul 2026",
|
||
"bid_cents": 464, "basis_cents": 14, "futures_cents": 450,
|
||
"fetched_at": "2026-05-29T15:00:00+00:00"},
|
||
{"source_name": "Minster", "commodity": "soy", "delivery": "Nov 2026",
|
||
"bid_cents": 1145, "basis_cents": -50, "futures_cents": 1195,
|
||
"fetched_at": "2026-05-23T15:00:00+00:00"},
|
||
{"source_name": "Minster", "commodity": "soy", "delivery": "Nov 2026",
|
||
"bid_cents": 1148, "basis_cents": -45, "futures_cents": 1193,
|
||
"fetched_at": "2026-05-29T15:00:00+00:00"},
|
||
],
|
||
}
|
||
|
||
|
||
def test_fmt_history_spans_crops_and_shows_basis_futures():
|
||
out = fmt.fmt_history(_history_multi())
|
||
# No commodity filter → "all crops" scope, both crops present.
|
||
assert "all crops" in out
|
||
assert "corn" in out and "soy" in out
|
||
# Futures column populated from futures_cents.
|
||
assert "$4.5000" in out
|
||
# Basis movement annotated per series.
|
||
assert "+0.11 → +0.14" in out
|
||
assert "-0.50 → -0.45" in out
|
||
|
||
|
||
def test_fmt_basis_movement_aggregates_per_crop():
|
||
out = fmt.fmt_basis_movement(_history_multi())
|
||
assert "Basis movement" in out
|
||
# corn basis 0.11 → 0.14 (stronger), soy -0.50 → -0.45 (stronger)
|
||
assert "**corn**" in out and "**soy**" in out
|
||
assert "stronger" in out
|
||
assert "1 elevators, 1 series" in out
|
||
|
||
|
||
def test_fmt_basis_movement_skips_non_grain_and_nulls():
|
||
payload = {"commodity": None, "days": 7, "rows": [
|
||
{"source_name": "Coop", "commodity": "lime", "delivery": "spot",
|
||
"bid_cents": 42000, "basis_cents": None, "fetched_at": "2026-05-23T15:00:00+00:00"},
|
||
]}
|
||
out = fmt.fmt_basis_movement(payload)
|
||
assert "No grain basis samples" in out
|
||
|
||
|
||
def test_fmt_basis_detail_per_series():
|
||
out = fmt.fmt_basis_detail(_history_multi())
|
||
assert "Basis movement by elevator" in out
|
||
# One row per (crop, elevator, delivery)
|
||
assert "| corn | Minster | Jul 2026 |" in out
|
||
assert "| soy | Minster | Nov 2026 |" in out
|
||
assert "weaker" not in out # both strengthened in this fixture
|
||
assert "stronger" in out
|
||
|
||
|
||
def test_fmt_sources_table():
|
||
payload = {"sources": [
|
||
{"id": 1, "name": "Test Elev", "kind": "elevator",
|
||
"city": "Ada", "state": "OH", "zip": "45810",
|
||
"last_success_at": "2026-05-20T14:55:00+00:00",
|
||
"consecutive_failures": 0, "last_error": None},
|
||
]}
|
||
out = fmt.fmt_sources(payload)
|
||
assert "Test Elev" in out
|
||
assert "elevator" in out
|
||
assert "Ada, OH 45810" in out # location column
|
||
|
||
|
||
def test_fmt_health_buckets():
|
||
payload = {"sources": [
|
||
{"name": "Healthy", "kind": "elevator",
|
||
"last_success_at": "2026-05-20T14:55:00+00:00",
|
||
"consecutive_failures": 0, "last_error": None},
|
||
{"name": "Stale", "kind": "elevator",
|
||
"last_success_at": None,
|
||
"consecutive_failures": 0, "last_error": None},
|
||
{"name": "Down", "kind": "elevator",
|
||
"last_success_at": "2026-05-15T14:55:00+00:00",
|
||
"consecutive_failures": 5, "last_error": "boom"},
|
||
]}
|
||
out = fmt.fmt_health(payload)
|
||
assert "Healthy: **1**" in out
|
||
assert "Stale (never succeeded): **1**" in out
|
||
assert "Down" in out and "**1**" in out
|
||
# Down section lists boom
|
||
assert "boom" in out
|
||
|
||
|
||
def test_fmt_deliveries():
|
||
out = fmt.fmt_deliveries({"commodity": "corn",
|
||
"deliveries": ["May 2026", "Jul 2026"]})
|
||
assert "- May 2026" in out
|
||
assert "- Jul 2026" in out
|
||
|
||
|
||
def test_fmt_commodities_lists_all_six():
|
||
out = fmt.fmt_commodities()
|
||
for name in ("corn", "soy", "wheat", "map", "potash", "lime"):
|
||
assert name in out.lower()
|
||
|
||
|
||
def test_fmt_summary_includes_best_for_today():
|
||
payload = {
|
||
"today": "2026-05-20", "prev_trading_day": "2026-05-19",
|
||
"commodities": [
|
||
{"symbol": "corn", "display_name": "Corn",
|
||
"futures": {"contract": "ZC=F", "today_last_cents": 458,
|
||
"prev_close_cents": 455, "change_cents": 3},
|
||
"best_for_today": {
|
||
"source_name": "Mercer Landmark — St Henry",
|
||
"delivery": "May 2026", "bid_cents": 491, "basis_cents": 33,
|
||
}},
|
||
{"symbol": "soy", "display_name": "Soybeans",
|
||
"futures": {"contract": "ZS=F", "today_last_cents": 1180,
|
||
"prev_close_cents": 1177, "change_cents": 3},
|
||
"best_for_today": None},
|
||
],
|
||
}
|
||
out = fmt.fmt_summary(payload)
|
||
assert "Corn" in out and "Soybeans" in out
|
||
assert "Mercer Landmark — St Henry" in out
|
||
assert "$4.5800" in out # corn last
|
||
assert "No current-month local bid posted" in out # soy fallback
|