"""Pin the day ``resolve_budget`` believes it is, around the 5h -> 4h base cut. ``earned_time`` takes the reading hour off the floor from its penalty start on: ``READING.penalty_from``, delayed by maturity (0.6.0) to the day after ``confirmed_on`` when no credit is on record. A budget test that reads the real clock would change its answer on that day, so every such test pins the date on one side of the cut. The module asks ``datetime.now().astimezone()``, so that chain is what the pin answers (at noon, so the gaming day is the same date). """ from __future__ import annotations from datetime import datetime, time, timedelta from typing import TYPE_CHECKING from unittest.mock import MagicMock, patch import earned_time if TYPE_CHECKING: from contextlib import AbstractContextManager from datetime import date # With no ledger on record (the suite's empty LEDGER_HOME) the cut waits for # the day after READING.confirmed_on: fail closed, never before penalty_from. _CUT = earned_time.penalty_start(earned_time.READING, None) assert _CUT is not None, "earned_time.READING lost its penalty_from date" AFTER_CUT = _CUT BEFORE_CUT = _CUT - timedelta(days=1) def pin_today(day: date) -> AbstractContextManager[object]: """Make ``_budget_resolve`` see ``day`` as today. Args: day: The local date the module's clock should report. Returns: A patch context manager replacing the module's ``datetime`` binding. """ clock = MagicMock() # A real aware noon: the module also takes the 06:00 gaming day from it. noon = datetime.combine(day, time(12)).astimezone() clock.now.return_value.astimezone.return_value = noon return patch("steam_backlog_enforcer._budget_resolve.datetime", clock)