Recurring Range Runner

from datetime import date
from typing import Any, Callable, Dict, Optional, Sequence

class RangeRunner:
    def __init__(
        self,
        job_factory: Callable[..., Any],
        start: date,
        stop: Optional[date] = None,
        params: Optional[Dict[str, Any]] = None,
        max_backfill_days: int = 90,
    ):
        """
        job_factory: callable returning a per-date job when invoked with a date and optional shared params.
        start/stop: inclusive/exclusive boundaries for the date range; stop defaults to the day after the latest date to run.
        params: extra keyword arguments forwarded to every job.
        max_backfill_days: clamp open-ended runs to this many days counting back from yesterday when start is too far in the past.
        """

    def planned_dates(self, now: Optional[date] = None) -> Sequence[date]:
        """Return the ordered set of dates that will be triggered; defaults to using current UTC date when now is not provided."""

    def planned_jobs(self, now: Optional[date] = None) -> Sequence[Any]:
        """Return instantiated interval jobs matching planned_dates(), each created via job_factory with its date and shared params."""

    def run(self, now: Optional[date] = None) -> None:
        """Dispatch the planned jobs using the package's recurring/backfill helper rather than manual loops."""