Files
ha-freshharvest/tests/test_parser.py
T
flan 3e880ff2c1
Validate / hassfest (push) Failing after 23s
Validate / pytest (push) Successful in 9s
Validate / HACS (push) Failing after 1m21s
Expose every order component as its own entity and prepare for release
Each cost line is now an entity rather than an attribute: subtotal, box price,
add-ons, tax and delivery fee, plus a total and free-delivery-remaining for the
open order, a delivery-day sensor, and a binary sensor that turns off at the
cutoff. Entities share a base class and declare a scope, so a description
states only the field it reads.

Also parses the driver tip, Bounty savings and the free-delivery threshold. The
threshold is carried across orders because the progress bar only renders on
carts that have not met it.

Adds LICENSE, hacs.json, a CI workflow, a pre-publish audit script, and a test
that cross-checks every entity's translation_key against both translation
files. Manifest URLs now point at GitHub rather than a private forge.
2026-08-03 19:32:50 +00:00

147 lines
5.1 KiB
Python

"""Tests for the dashboard parser.
The parser is import-isolated from Home Assistant so these run without a HA
install; only beautifulsoup4 is needed.
"""
from __future__ import annotations
import importlib.util
import sys
import types
from datetime import date
from pathlib import Path
import pytest
FIXTURE = Path(__file__).parent / "fixtures" / "dashboard.html"
API_PATH = (
Path(__file__).parent.parent / "custom_components" / "freshharvest" / "api.py"
)
def _load_api():
"""Import api.py with aiohttp/yarl stubbed out."""
if "aiohttp" not in sys.modules:
stub = types.ModuleType("aiohttp")
stub.ClientSession = object
stub.ClientError = Exception
sys.modules["aiohttp"] = stub
if "yarl" not in sys.modules:
try:
import yarl # noqa: F401
except ImportError:
stub = types.ModuleType("yarl")
stub.URL = lambda value="": value
sys.modules["yarl"] = stub
spec = importlib.util.spec_from_file_location("fh_api", API_PATH)
module = importlib.util.module_from_spec(spec)
sys.modules["fh_api"] = module
spec.loader.exec_module(module)
return module
api = _load_api()
@pytest.fixture(name="snapshot")
def snapshot_fixture():
return api.parse_dashboard(FIXTURE.read_text(encoding="utf-8"))
def test_account_level_fields(snapshot):
assert snapshot.delivery_day == "Tuesdays"
assert snapshot.next_delivery == date(2026, 8, 4)
assert len(snapshot.orders) == 2
def test_next_order_is_the_locked_one(snapshot):
"""The next arrival is past its cutoff; the open cart is the one after it.
Guards the trap that sank the first attempt: the locked cart carries the
class `cart-contents-skipped`, which does not mean the user skipped it.
"""
order = snapshot.next_order
assert order.delivery_id == "1000001"
assert order.delivery_date == date(2026, 8, 4)
assert order.is_open is False
def test_next_order_totals_and_contents(snapshot):
order = snapshot.next_order
assert order.box_name == "Georgia Grown Small Box"
assert (order.subtotal, order.tax, order.delivery_fee) == (72.93, 2.19, 0.0)
assert order.driver_tip == 4.00
assert order.bounty_savings == 5.69
assert order.total == 79.12
assert [(i.quantity, i.name, i.unit) for i in order.items] == [
(1, "Bolero Carrots", ".5 lb"),
(2, "Georgia Peaches", "6 count"),
]
assert [(a.name, a.price, a.quantity, a.unit) for a in order.addons] == [
("Black Mission Figs", 7.99, 1, "1 pint"),
("Complete Recovery Smoothie", 17.96, 4, "15.2 fl oz"),
("Organic Fruit Punch Juice Boxes", 13.98, 2, "8 count"),
]
assert len(order.all_items) == 5
def test_addons_total_reconciles_with_the_subtotal(snapshot):
"""Add-ons plus the box price must equal the subtotal the portal reports."""
order = snapshot.next_order
assert order.addons_total == 39.93
assert round(order.addons_total + order.box_price, 2) == order.subtotal
def test_addons_total_is_zero_when_nothing_is_added(snapshot):
assert snapshot.open_order.addons == []
assert snapshot.open_order.addons_total == 0.0
def test_open_order(snapshot):
order = snapshot.open_order
assert order.delivery_id == "1000002"
assert order.delivery_date == date(2026, 8, 11)
assert order.is_open is True
assert order.shop_window == "Shop tomorrow"
assert order.total == 39.98
def test_free_delivery_threshold_applies_to_every_order(snapshot):
"""The bar renders only on carts below the threshold, so it must carry over."""
assert snapshot.free_delivery_threshold == 70.0
# This cart has the bar: $70.00 - $33.00 matches the portal's own message.
assert snapshot.open_order.free_delivery_remaining == 37.0
# This one does not, and must still resolve rather than staying unknown.
assert snapshot.next_order.free_delivery_remaining == 0.0
def test_free_delivery_remaining_agrees_with_the_fee_charged(snapshot):
"""Nothing left to spend must mean nothing was charged for delivery."""
for order in snapshot.orders:
assert (order.free_delivery_remaining == 0.0) == (order.delivery_fee == 0.0)
def test_unset_driver_tip_is_none_not_zero(snapshot):
"""An untipped order reads 'Add Tip'; that is unknown, not a $0.00 tip."""
assert snapshot.open_order.driver_tip is None
def test_driver_tip_placeholder_is_not_money(snapshot):
"""'Add Tip' sits in a value slot but is not an amount."""
assert api._money("Add Tip") is None
assert api._money("$1,234.50") == 1234.50
assert api._money("$0.00") == 0.0
def test_tab_date_rolls_over_the_year():
"""A January tab against a December anchor belongs to the next year."""
assert api._parse_tab_date("Tue 1/5", date(2026, 12, 29)) == date(2027, 1, 5)
assert api._parse_tab_date("Tue 8/11", date(2026, 8, 4)) == date(2026, 8, 11)
assert api._parse_tab_date("no date here", date(2026, 8, 4)) is None
def test_unrecognised_markup_raises():
with pytest.raises(api.FreshHarvestError):
api.parse_dashboard("<html><body>signed out</body></html>")