From b972cff06617c0987f1caa61b4aa39cc222054de Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:25:28 -0500 Subject: [PATCH 01/45] Add MANIFEST.in to include test configuration and fixtures --- MANIFEST.in | 2 ++ 1 file changed, 2 insertions(+) create mode 100644 MANIFEST.in diff --git a/MANIFEST.in b/MANIFEST.in new file mode 100644 index 0000000..c871591 --- /dev/null +++ b/MANIFEST.in @@ -0,0 +1,2 @@ +include tests/conftest.py +recursive-include tests/fixtures *.html From aeb16e9d5100b704f00994ff4af119258f2caeda Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:25:40 -0500 Subject: [PATCH 02/45] Bump version to 1.2.0 and update dependency group for mypy and ruff --- pyproject.toml | 16 +++++++++++++++- 1 file changed, 15 insertions(+), 1 deletion(-) diff --git a/pyproject.toml b/pyproject.toml index 81818dc..5569924 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "elf" -version = "1.1.1" +version = "1.2.0" description = "Advent of Code helper for Python: fetch and cache inputs, submit answers, and pull private leaderboards." readme = "README.md" license = "MIT" @@ -60,5 +60,19 @@ build-backend = "setuptools.build_meta" [dependency-groups] dev = [ + "mypy>=1.19.0", "pytest>=9.0.1", + "ruff>=0.14.0", ] + +[tool.mypy] +files = ["elf"] +python_version = "3.11" + +[tool.ruff] +line-length = 100 +target-version = "py311" + +[tool.ruff.lint] +select = ["B", "BLE", "E", "F", "I", "PYI", "RUF012", "RUF022", "SIM", "UP"] +ignore = ["UP042"] From 236fd9ddc28739f233369ece73feee77957ddacd Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:25:46 -0500 Subject: [PATCH 03/45] Add `elf doctor` command for local configuration diagnostics --- README.md | 88 +++++++++++++++++++++++++++++++++++++++++++------------ 1 file changed, 69 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index 5cc8eea..9da90ab 100644 --- a/README.md +++ b/README.md @@ -32,6 +32,7 @@ If Advent of Code is part of your December ritual too, I hope this little elf ma - Explore private leaderboards as **tables**, **JSON**, or **Pydantic models** - View your **status calendar** (table, JSON, or model) - Inspect your **guess history** with timestamps and per-part details +- Diagnose local configuration safely with **`elf doctor`** - Open any AoC page (puzzle, input, or website) straight from the CLI - Use elf as a **CLI tool** or a full **Python API** @@ -108,14 +109,17 @@ Set your email address in the environment variable `AOC_USER_AGENT`: ```sh export AOC_USER_AGENT="you@example.com" +``` + Windows PowerShell: + +```powershell $env:AOC_USER_AGENT = "you@example.com" setx AOC_USER_AGENT "you@example.com" ``` If this variable is not set or does not look like an email address, elf falls back to a safe default and prints a warning. -Your User-Agent header will look like: -elf/ (you@example.com) +Your User-Agent header will look like `elf/ (you@example.com)`. This helps Eric identify the person sending the traffic while still including the library name. If the warning fires, elf instead sends `elf/ (+https://github.com/cak/elf)` so AoC still sees a recognizable identifier even without your email. @@ -125,7 +129,7 @@ If the warning fires, elf instead sends `elf/ (+https://github.com/cak/ ```sh export AOC_SESSION="your-session-token" -elf input # fetch today's input +elf input # fetch the latest relevant puzzle input elf answer 2025 1 1 123 # submit answer for part 1 elf status # view progress elf leaderboard 2025 123456 --view-key ABCDEF @@ -136,7 +140,7 @@ elf leaderboard 2025 123456 --view-key ABCDEF If you prefer to keep your own local copies of puzzle inputs, elf works just like a regular Unix command. You can redirect the output to save any day's input: ```sh -elf input > input.txt # save today's input +elf input > input.txt # save the default event/day input elf input 2025 2 > day02.txt # save a specific day's input ``` @@ -164,6 +168,7 @@ Commands: status Show yearly star status open Open puzzle/input/website cache Show cache information + doctor Check local configuration without contacting Advent of Code ``` Enable detailed tracebacks with `--debug` or `ELF_DEBUG=1` when troubleshooting. @@ -185,9 +190,11 @@ Options: Defaults: -- `year`: current year -- `day`: current day in December, otherwise 1 (Dec 1) -- Caches to `~/.cache/elf///input.txt` (or platform equivalent) +- In December, `year` and `day` follow the active event (capped at its final day). +- Outside December, they select the final day of the latest completed event. +- An explicitly selected archived year defaults to that event's final day. +- Events from 2015 through 2024 have 25 days; the reduced format from 2025 onward has 12. +- Explicit `year` and `day` arguments always take precedence. ### `elf answer` @@ -205,7 +212,8 @@ Behaviors: - Year and day are required to avoid accidental submissions. - Detects locked puzzles (future days or future years) and shows unlock timestamp. - Identifies too high / too low / duplicate guesses from local cache -- Caches cooldown responses locally for ~60 seconds to avoid hammering the site +- Honors and persists AoC's exact cooldown deadline; falls back to 60 seconds if the response format is unfamiliar +- Never sleeps or automatically retries a submission—you remain in control of every POST - Writes to guess cache automatically (per part) Exit codes: @@ -214,7 +222,7 @@ Exit codes: - `2` when AoC rate-limits you (cooldown/WAIT) - `1` for incorrect/too-high/too-low/unknown guesses -Duplicate guesses reuse cached submissions, so the exit code follows the cached result: e.g., a cached correct/completed guess still exits `0`, while cached incorrect/high/low responses return `1`. +Duplicate guesses reuse cached submissions, so the exit code follows the cached result: e.g., a cached correct/completed guess still exits `0`, while cached incorrect/high/low responses return `1`. A cooldown returns the exact UTC retry time when AoC provides one. Example errors: @@ -231,9 +239,13 @@ Display local guess history (per part). Requires a cached `guesses.csv` from pre ```sh Usage: elf guesses [YEAR] [DAY] + +Options: + --session TEXT Select the account cache (env: AOC_SESSION) ``` `elf guesses` loads its data solely from the local `guesses.csv`; it never reaches out to AoC and does not require `AOC_SESSION`, so it works offline as long as the cache already exists. +If more than one account has cached guesses for the same puzzle, set `AOC_SESSION` or pass `--session` so elf can select the right private cache. Example table: @@ -262,6 +274,8 @@ Supports: - **json:** raw JSON - **model:** structured Pydantic model +Leaderboard JSON is cached for 15 minutes, matching Advent of Code's minimum request interval. Cache entries are isolated by event, leaderboard ID, and a one-way fingerprint of the session cookie or view key. + ### `elf status` View your Advent of Code star calendar. Requires a session cookie. @@ -276,7 +290,7 @@ Options: Defaults: -- `year`: current year if omitted +- `year`: the active event during December, otherwise the latest completed event Prints stars for each day. @@ -305,22 +319,45 @@ Shows: - Number of cached files - Reminder to delete the directory manually to clear cache +### `elf doctor` + +Run local diagnostics without contacting Advent of Code: + +```sh +elf doctor +``` + +The report includes the installed version, AoC clock and resolved default puzzle, +whether session and User-Agent variables are configured, and whether the cache is +writable with private permissions. Credential values are never printed. Warnings +do not fail the command; cache-access errors return exit code `1`. + --- ## Caching Behavior - Default cache dir: macOS/Linux `~/.cache/elf`, Windows `%LOCALAPPDATA%\elf` - Override location with `ELF_CACHE_DIR` (respects `XDG_CACHE_HOME` on Linux) -- Inputs stored under: `///input.txt` -- Guess history stored as `///guesses.csv` +- Inputs and guesses are isolated by a one-way account fingerprint; session cookies are never written to disk or included in paths +- Inputs stored under: `/accounts////input.txt` +- Guess history stored under: `/accounts////guesses.csv` +- Private leaderboard JSON is scoped by event, board ID, and account/view-key fingerprint and cached for at least 15 minutes +- New cache files use private permissions where supported and are replaced atomically to avoid partial files after interruption +- Cross-process lock files prevent concurrent leaderboard refreshes and lost guess-history writes; abandoned locks expire safely - Duplicate/high/low guesses are short‑circuited locally when possible -- Cooldown responses are cached locally for ~60 seconds to avoid hammering AoC +- Cooldown responses retain AoC's server-provided retry deadline; historical entries without one use a 60-second fallback - Guardrails rely on your local guess history only (new machines/cleared cache = fresh) - Delete the cache directory to clear everything +### Upgrading existing caches + +Elf 1.2 preserves the original unscoped `///` files. On first authenticated use, each legacy file is copied into the current account's private namespace and marked as claimed; it is never deleted or copied into a second account. If an old cache belongs to a different AoC account, set the intended account's session before first accessing that puzzle. The original file remains available for manual recovery. + +Existing four-column `guesses.csv` files are upgraded in place on the next write by adding an optional `retry_at` column. Historical rows and original timestamps are preserved. Because cache namespaces intentionally use a session-cookie fingerprint, a replacement cookie starts a new namespace rather than risking cross-account data sharing; older caches remain untouched. + ### Concurrency note -The library reuses a process-global `httpx.Client` to keep CLI calls fast. For heavy multi-threaded usage, create separate `elf.aoc_client.AOCClient` instances per thread to avoid sharing the global session. +Each internal `AOCClient` owns and closes its `httpx.Client` when used as a context manager. Advanced callers can inject an existing `httpx.Client` to control connection pooling and lifecycle; injected clients are never closed by elf. --- @@ -340,6 +377,8 @@ input_text = get_puzzle_input(2023, 5) result = submit_puzzle_answer(2023, 5, 1, "12345") print(result.is_correct, result.message) +if result.retry_at: + print("Try again after", result.retry_at) leaderboard = get_private_leaderboard( 2023, session=None, board_id=123456, view_key=None, fmt=OutputFormat.MODEL @@ -354,7 +393,7 @@ print(status) `elf.helpers` includes some small utilities you can use in your own AoC solutions: ```python -from elf.helpers import parse_input, read_test_input, timer +from elf.helpers import parse_input, read_input, timer ``` ### Leaderboard Example @@ -365,9 +404,9 @@ from elf.helpers import parse_input, read_test_input, timer ┏━━━━━━┳━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━┓ ┃ Rank ┃ Name ┃ Stars ┃ Local Score ┃ Last Star (UTC) ┃ ┡━━━━━━╇━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━┩ -│ 1 │ User A │ 45 │ 900 │ 2025-12-26 00:53:17 │ -│ 2 │ User B │ 45 │ 855 │ 2025-12-26 00:53:56 │ -│ 3 │ User C │ 36 │ 622 │ 2025-12-26 03:29:21 │ +│ 1 │ User A │ 24 │ 900 │ 2025-12-12 00:53:17 │ +│ 2 │ User B │ 24 │ 855 │ 2025-12-12 00:53:56 │ +│ 3 │ User C │ 18 │ 622 │ 2025-12-12 03:29:21 │ └──────┴────────────────┴───────┴─────────────┴─────────────────────┘ ``` @@ -433,13 +472,24 @@ Run the test suite via: uv run pytest ``` +Run the complete local quality pass via: + +```sh +uv run ruff check elf tests +uv run ruff format --check elf tests +uv run mypy +uv build +``` + +GitHub Actions runs the full Python 3.11–3.14 suite on Linux, plus Python 3.14 smoke jobs on macOS and Windows. Tests block external network access, mock every Advent of Code interaction, and never fetch inputs or submit answers. + Alternatively, you can still run: ```sh python -m pytest ``` -Running `python -m pytest` directly requires `pytest` to be installed in your environment. Install it via `pip install pytest>=9.0.1` (or use `uv run pytest` / `pip install .[dev]` if you maintain the dev extras) before running the command outside of `uv`. +Running `python -m pytest` directly requires `pytest` to be installed in your environment. Install it via `pip install pytest>=9.0.1` (or use `uv sync --group dev` and `uv run pytest`) before running the command outside of `uv`. ## Special Thanks From f2cca99eb0f76a3570443bc3723957c2859c8c0d Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:26:25 -0500 Subject: [PATCH 04/45] update deps --- uv.lock | 664 ++++++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 506 insertions(+), 158 deletions(-) diff --git a/uv.lock b/uv.lock index 0b536da..2d97f96 100644 --- a/uv.lock +++ b/uv.lock @@ -1,61 +1,128 @@ version = 1 revision = 3 requires-python = ">=3.11" +resolution-markers = [ + "python_full_version >= '3.15'", + "python_full_version >= '3.11.5' and python_full_version < '3.15'", + "python_full_version < '3.11.5'", +] + +[[package]] +name = "annotated-doc" +version = "0.0.6" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/0f/6e/a61e86e43bb6039b31a33a8f5fba76fe1cdacf3661e7b9756d4ff1b28cdc/annotated_doc-0.0.6.tar.gz", hash = "sha256:7969bb69912085b2285849c0dcac0b4b374fd180c13cf10a87f284ffcf347bbf", size = 10767, upload-time = "2026-11-10T18:17:11.28Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/cd/f5/3dd85d583e55be76cd02b1fc9bbec771b12d63124b01661d9535ccf8721f/annotated_doc-0.0.6-py3-none-any.whl", hash = "sha256:361ca0950cc7082f53fa69e9328409f40a62c61e57e0a47e1825a08078a58a53", size = 5293, upload-time = "2026-11-10T18:17:10.249Z" }, +] [[package]] name = "annotated-types" -version = "0.7.0" +version = "0.8.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/ee/67/531ea369ba64dcff5ec9c3402f9f51bf748cec26dde048a2f973a4eea7f5/annotated_types-0.7.0.tar.gz", hash = "sha256:aff07c09a53a08bc8cfccb9c85b05f1aa9a2a6f23728d790723543408344ce89", size = 16081, upload-time = "2024-05-20T21:33:25.928Z" } +sdist = { url = "https://files.pythonhosted.org/packages/5f/56/a8120250d128bed162cd73c76d45f6ef9991f3e068f62a8ee060afa3104a/annotated_types-0.8.0.tar.gz", hash = "sha256:13b2beaad985e05e2d6407ee4c4f35590b11f8d693a258a561055cac8f64cab7", size = 15893, upload-time = "2026-07-23T20:16:13.995Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/78/b6/6307fbef88d9b5ee7421e68d78a9f162e0da4900bc5f5793f6d3d0e34fb8/annotated_types-0.7.0-py3-none-any.whl", hash = "sha256:1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53", size = 13643, upload-time = "2024-05-20T21:33:24.1Z" }, + { url = "https://files.pythonhosted.org/packages/99/91/8acff4f5e50511b911bbccb72b8628a49c68ce14148cd9f6431094859a90/annotated_types-0.8.0-py3-none-any.whl", hash = "sha256:f072f4d804ea359e4eaf198b1af7a8b0943881a87f31bb764f8bf219bb9419e0", size = 13427, upload-time = "2026-07-23T20:16:12.938Z" }, ] [[package]] name = "anyio" -version = "4.12.0" +version = "4.16.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "idna" }, - { name = "typing-extensions", marker = "python_full_version < '3.13'" }, + { name = "typing-extensions", marker = "python_full_version < '3.15'" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/16/ce/8a777047513153587e5434fd752e89334ac33e379aa3497db860eeb60377/anyio-4.12.0.tar.gz", hash = "sha256:73c693b567b0c55130c104d0b43a9baf3aa6a31fc6110116509f27bf75e21ec0", size = 228266, upload-time = "2025-11-28T23:37:38.911Z" } +sdist = { url = "https://files.pythonhosted.org/packages/a1/98/7e457a3b014976887a050561955c0b76e1e7e2d6e27b78ecef2ef80518f2/anyio-4.16.0.tar.gz", hash = "sha256:59bb03251907983d1603d27c3087ddb1e93299ea2163adcdba37899a4fb12ffb", size = 310971, upload-time = "2026-11-01T11:20:07.282Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/7f/9c/36c5c37947ebfb8c7f22e0eb6e4d188ee2d53aa3880f3f2744fb894f0cb1/anyio-4.12.0-py3-none-any.whl", hash = "sha256:dad2376a628f98eeca4881fc56cd06affd18f659b17a747d3ff0307ced94b1bb", size = 113362, upload-time = "2025-11-28T23:36:57.897Z" }, + { url = "https://files.pythonhosted.org/packages/a9/16/7757fb84c819accc7d7e9af5291b261e4abb8627ee040f99e7d35ef2457a/anyio-4.16.0-py3-none-any.whl", hash = "sha256:c66ae634e0b8228396b801741beb3294326d4b6102f7bba4041c0dfb58c29026", size = 134521, upload-time = "2026-11-01T11:20:05.59Z" }, +] + +[[package]] +name = "ast-serialize" +version = "0.13.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/21/d5/5dc1ee8a80c3b20a0b63c61b43ba6bc53517faecd1def47bcd752d22268e/ast_serialize-0.13.1.tar.gz", hash = "sha256:401cc84e8888d4d76f2c8d296fa006ed1a5ff993b6aff90dd777c03973efd025", size = 955137, upload-time = "2026-10-17T00:04:17.183Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/f3/a8/fbd136b9f70c59e75f59a8e974c84102976f1201828b4f886480ba956936/ast_serialize-0.13.1-cp314-cp314-pyemscripten_2026_0_wasm32.whl", hash = "sha256:3e129d44b0cffbea24a7f40117ce49e30993c3d119e584d4817ebd6f87246456", size = 897306, upload-time = "2026-10-17T00:02:52.479Z" }, + { url = "https://files.pythonhosted.org/packages/50/3f/2ad51e9823a790e7a70fd781e9595ab3abeace27f3aefcaa1939457efd72/ast_serialize-0.13.1-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:523d45bab16ddaf1399c04c4fe81bbf180f81e33c2f7bcbe76be56b0f7311ab4", size = 1236082, upload-time = "2026-10-17T00:02:54.82Z" }, + { url = "https://files.pythonhosted.org/packages/c0/5c/8e959db5cc2237f9d4c560a8e2253c98f9746883fb4774651e4cda458901/ast_serialize-0.13.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:638333fb8ae72c62753f9e794fda20290883ddc65b0d85e26e08f8bb227567ad", size = 1221242, upload-time = "2026-10-17T00:02:56.395Z" }, + { url = "https://files.pythonhosted.org/packages/d6/05/ab1c56c3b7adcac88764bba609502d6b4989e449b2dd60eb478e1d20e369/ast_serialize-0.13.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:cc34c670747d85d4232834665e247009413eaebe47c69eaf60a5c439aaecaed9", size = 1282105, upload-time = "2026-10-17T00:02:58.275Z" }, + { url = "https://files.pythonhosted.org/packages/0d/f4/41981fcd2ddffe0760e5326be9dcbd2eda9478a8430a637e5123bd8fcb26/ast_serialize-0.13.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:8c8ebd419811c435812d242fb2a173e57dfede198c9ac9a0a584666ebc9b9331", size = 1287905, upload-time = "2026-10-17T00:03:00.068Z" }, + { url = "https://files.pythonhosted.org/packages/6a/43/b783addc5681153707121991b7b47892f7e9c8ba58a0d03b71a3b023ba47/ast_serialize-0.13.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:8899c038b1c15ae8b98e379057fb3ef398ceb0b21d1737a8156dd5a0923b7e51", size = 1541806, upload-time = "2026-10-17T00:03:01.503Z" }, + { url = "https://files.pythonhosted.org/packages/47/10/969db095038ee15270f65ad20d1129c5e4da605bf7e93b70ae640f1c8a9f/ast_serialize-0.13.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e14c4de98f965647a74e6eaf37e20207124e45451ccd36e84a6f6ebab45e0372", size = 1309946, upload-time = "2026-10-17T00:03:02.971Z" }, + { url = "https://files.pythonhosted.org/packages/06/dd/7c623d2fb0b868948952d1787e629a43b866f7d4caefd5445e20aefacec4/ast_serialize-0.13.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7f3e8a3eff69af640db985360fef35073fb46956dfc3e5c614cf00920d2746dd", size = 1302773, upload-time = "2026-10-17T00:03:04.378Z" }, + { url = "https://files.pythonhosted.org/packages/d4/c2/4d49469110a19a44fc6269f4fd59679bcf84df068f185f89b73bee4da19b/ast_serialize-0.13.1-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:75d7750fe98f6f35a96c43aba8d98a2e623e22c778a0c17ab9ede92eb10f5d82", size = 1299579, upload-time = "2026-10-17T00:03:05.88Z" }, + { url = "https://files.pythonhosted.org/packages/9d/9a/2d381f1f262dda15affc8ad643fba1619eb07e7d9f8bd904deffef183006/ast_serialize-0.13.1-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:43e8ddd63e80fc280c2f790157386f27f9b9f6ccb9c4f8e803b863cbfb085769", size = 1355969, upload-time = "2026-10-17T00:03:07.321Z" }, + { url = "https://files.pythonhosted.org/packages/9d/9c/2266794e6c25fa9ce51ce04a9bf4b7e330e3ac9351ba3fa14e487678acdb/ast_serialize-0.13.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:9221e09496fb942901993c1812ee87950cc0ecbb514c7c0f1f5fa6d78f701ed8", size = 1460227, upload-time = "2026-10-17T00:03:08.733Z" }, + { url = "https://files.pythonhosted.org/packages/2b/d6/14deb28e5d8f328f626a0778ea2cf98fe908f2bbcccd804cb6f449ee1782/ast_serialize-0.13.1-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:7a5c38bdb93669c596f94fb7204dd6ebe4fadb19058ac9a2faf2948c2a175f96", size = 1562691, upload-time = "2026-10-17T00:03:10.25Z" }, + { url = "https://files.pythonhosted.org/packages/f5/19/7a28c0e5ba54f0d3e054f847a2a549b748cb179ab433321a8dc1b39e398d/ast_serialize-0.13.1-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:acf4e9f055d75058ab01536da330648746f2f82b7697a85230547f2d5ebe895c", size = 1558669, upload-time = "2026-10-17T00:03:11.799Z" }, + { url = "https://files.pythonhosted.org/packages/18/9a/f9e2690eab58217f1d395a964a78efa7eaf813a1e38be8dfd9a8d45d0840/ast_serialize-0.13.1-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:87427913c325adc811e81e7c9a757b061f47ef1e29114ac479aa0953a2687a98", size = 1665071, upload-time = "2026-10-17T00:03:13.284Z" }, + { url = "https://files.pythonhosted.org/packages/8e/f3/ef5b159a0d7161b404f05e7ec21cf7735ee7edc10c000cd2cbbc7bb6b69a/ast_serialize-0.13.1-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:ad88921f95b92bc144d9ad059a0e16f8c1ae69f5239f2d3c6536fd2774f73dfe", size = 1473364, upload-time = "2026-10-17T00:03:14.563Z" }, + { url = "https://files.pythonhosted.org/packages/1d/87/6e8ac4a865124a12cc4f915bf1bcfac3bba426cd5f58d3712a873ee61012/ast_serialize-0.13.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:f8b17e2921e56621bcb46792bd3e0b82ca3b85de78d5936e7b8174ba1758b0aa", size = 1500566, upload-time = "2026-10-17T00:03:15.917Z" }, + { url = "https://files.pythonhosted.org/packages/f5/1e/29155f1621433008013ad5c940a03d41a676be0680c41527040472d37583/ast_serialize-0.13.1-cp314-cp314t-win32.whl", hash = "sha256:2f9a9ce8b0994f757b941f7f7fe384a6666b4162b941ebc5c248081baea18e47", size = 1128674, upload-time = "2026-10-17T00:03:17.481Z" }, + { url = "https://files.pythonhosted.org/packages/bb/64/2506da65143ea138de5822e9173e0b72320a2f70e23bd723f044033175f1/ast_serialize-0.13.1-cp314-cp314t-win_amd64.whl", hash = "sha256:5d99910e6b9a9b9360bcca2ae99aee36cc912ce058df2a57d1c33099b6cb2593", size = 1163306, upload-time = "2026-10-17T00:03:19.046Z" }, + { url = "https://files.pythonhosted.org/packages/6d/8f/c7cb22638899b0cf15908809c270560e46395e65604bc59e4b623ab9f405/ast_serialize-0.13.1-cp314-cp314t-win_arm64.whl", hash = "sha256:a789cbe14d0a0e9ec9b32a456e5abc81ad8799479c3cfd88a29e3442262aebe6", size = 1133775, upload-time = "2026-10-17T00:03:20.377Z" }, + { url = "https://files.pythonhosted.org/packages/2b/e2/b0c140fe50fa39dd249e382f7733af6f816c90021fe7959a0b026f86237f/ast_serialize-0.13.1-cp315-abi3.abi3t-macosx_10_12_x86_64.whl", hash = "sha256:23d768369b89d551077dc173da6892fad00443338417523b6732f4e8ba4a7ed5", size = 1236160, upload-time = "2026-10-17T00:03:21.945Z" }, + { url = "https://files.pythonhosted.org/packages/23/c4/a8a2ca21e3943555b48221f8fba546877a7ad39efaf6505506524967d7c4/ast_serialize-0.13.1-cp315-abi3.abi3t-macosx_11_0_arm64.whl", hash = "sha256:68f8829d114dab6c9db4a8bbb8d0e342958faee1b5e15a29022678df639960f8", size = 1222214, upload-time = "2026-10-17T00:03:23.462Z" }, + { url = "https://files.pythonhosted.org/packages/15/19/2f58f2ba64e4799b39de85c140aef09a03aa6ea53be75dd292a9d9b9d8ae/ast_serialize-0.13.1-cp315-abi3.abi3t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4e385b17d5bde892a6184003a9aff3518387908b73f8f5ea539313c07c8c0ede", size = 1282979, upload-time = "2026-10-17T00:03:24.695Z" }, + { url = "https://files.pythonhosted.org/packages/b1/af/ca6087fe84210c1ccd43e3182917bb70649fa1e69745a90c1d59ba08fea8/ast_serialize-0.13.1-cp315-abi3.abi3t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:02686b281ec9b8e9614f6f0db27e12e4cac515f336c5d05b678bc9eb73ff2af5", size = 1288596, upload-time = "2026-10-17T00:03:26.04Z" }, + { url = "https://files.pythonhosted.org/packages/b0/2c/4ef964c763329a0347125e745ec0451ba4fbaceec9efe2ac729b7cd55f17/ast_serialize-0.13.1-cp315-abi3.abi3t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:a8ab2c2585b2e22e48cd4aff2136fce4eab4ced569b85f150ef9a5a5d6f34d49", size = 1545540, upload-time = "2026-10-17T00:03:27.52Z" }, + { url = "https://files.pythonhosted.org/packages/bb/85/aa961dbb75813cfa94de0ce9a16a9510c226b95f604c405421e727f44bb0/ast_serialize-0.13.1-cp315-abi3.abi3t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:c652d9f5d52d8b81eff3ff2c95c9dd0f281de45f6ad5d3fa95527550c396454a", size = 1309374, upload-time = "2026-10-17T00:03:29.091Z" }, + { url = "https://files.pythonhosted.org/packages/b4/e6/f2b67c327d9f9533e41791804403ccc2dc457821195a2e51f0b587a90b90/ast_serialize-0.13.1-cp315-abi3.abi3t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:121e1d08d58b75c15491cc3003609cbad71ac2b0016043c36d30a6b2032b6605", size = 1303466, upload-time = "2026-10-17T00:03:30.451Z" }, + { url = "https://files.pythonhosted.org/packages/73/1d/33f18b81d1bb1f5d682943ea92fda8130a6593627f12f6201668d40824fd/ast_serialize-0.13.1-cp315-abi3.abi3t-manylinux_2_31_riscv64.whl", hash = "sha256:30cf89b6a6844542d116c758725d13de5b97b9410a51ee577715f761270d0c1c", size = 1300576, upload-time = "2026-10-17T00:03:32.102Z" }, + { url = "https://files.pythonhosted.org/packages/25/cb/64914144925f1a4abdd9217e717b122255c38fc5ebe4342f92052f3bacbc/ast_serialize-0.13.1-cp315-abi3.abi3t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:732aaae9e498c973fc63fd7f308009b57c4afa6ff59d0b674d894e57d0bca01a", size = 1355960, upload-time = "2026-10-17T00:03:33.676Z" }, + { url = "https://files.pythonhosted.org/packages/ee/80/bd29379fab2bce19adc0bf9177002b11b23dfe8d8fecf409998b458b4624/ast_serialize-0.13.1-cp315-abi3.abi3t-musllinux_1_2_aarch64.whl", hash = "sha256:d9c1a920b2aa0c1e016bed7721689717034ca0dba64ac3a3ff243b003d4e8dd8", size = 1459779, upload-time = "2026-10-17T00:03:35.09Z" }, + { url = "https://files.pythonhosted.org/packages/83/89/012dbe733de05ffdf8e40ca0f9fa5d417cb16ec93a74463c57c001914198/ast_serialize-0.13.1-cp315-abi3.abi3t-musllinux_1_2_armv7l.whl", hash = "sha256:847cad4c22953823f5e76d0b126c6f9da670cfa45b1df41b9324e22189d77611", size = 1563399, upload-time = "2026-10-17T00:03:37.285Z" }, + { url = "https://files.pythonhosted.org/packages/69/37/ee4bcb0358bee38744eb0f18560446572d095fe3bf6b63d6f739d08a839c/ast_serialize-0.13.1-cp315-abi3.abi3t-musllinux_1_2_i686.whl", hash = "sha256:aca07de3ca8e3d9f2b716c3c31f4f384fe4bd2d03e09912417cff7a3e08036f7", size = 1558808, upload-time = "2026-10-17T00:03:38.711Z" }, + { url = "https://files.pythonhosted.org/packages/54/1c/ff44c5355251d61ef22934c4430bb31a61de4781d25a992154aac9b8c82a/ast_serialize-0.13.1-cp315-abi3.abi3t-musllinux_1_2_ppc64le.whl", hash = "sha256:5db12d843d931b9d1f1519ce66b9cbfe72d8563b75c1204d255322254d1964dd", size = 1666324, upload-time = "2026-10-17T00:03:40.376Z" }, + { url = "https://files.pythonhosted.org/packages/c8/bb/6da4bfc8aa3403e6447607131bf3463acaf954d990c6c8b6787c1902ddfe/ast_serialize-0.13.1-cp315-abi3.abi3t-musllinux_1_2_riscv64.whl", hash = "sha256:fb8021f4dc3296de18737e3b8b34994411da725374d74a0b9eb32a738f2a23d0", size = 1474089, upload-time = "2026-10-17T00:03:41.715Z" }, + { url = "https://files.pythonhosted.org/packages/21/97/897e33bef2eefd880e6350e375cc66bc5bcd00a139be480fd655f5b3f095/ast_serialize-0.13.1-cp315-abi3.abi3t-musllinux_1_2_x86_64.whl", hash = "sha256:0d764913374ba21df8cd618045b371ed104ce55c6276de7c59e554a4f5ba26fd", size = 1501542, upload-time = "2026-10-17T00:03:43.08Z" }, + { url = "https://files.pythonhosted.org/packages/8d/4c/821211ac83870c27e4412381b7c7838336456b40575bf840e4680b2018d9/ast_serialize-0.13.1-cp315-abi3.abi3t-win32.whl", hash = "sha256:2bad302ae2427454ef9dab71bd5c3ad67188860c39d36daee38f72031edb39c4", size = 1126118, upload-time = "2026-10-17T00:03:44.616Z" }, + { url = "https://files.pythonhosted.org/packages/1f/86/2b2d5e6c4fa352874a80618e742ffd32d249dee6c119f4233b51afc6b8f4/ast_serialize-0.13.1-cp315-abi3.abi3t-win_amd64.whl", hash = "sha256:032b09d86c785c3984e975378b7861f2a68ac44e22ba7b07b93a536b2524eeb8", size = 1163766, upload-time = "2026-10-17T00:03:45.986Z" }, + { url = "https://files.pythonhosted.org/packages/77/a3/d610cfcdabaa44fd62a54ca1fc57a7dba120643798b089a14914973562de/ast_serialize-0.13.1-cp315-abi3.abi3t-win_arm64.whl", hash = "sha256:929eda0c419e622ab49df3a4c45f81c57dcc10874bbad55d0470a4a03324dac3", size = 1134043, upload-time = "2026-10-17T00:03:48.453Z" }, + { url = "https://files.pythonhosted.org/packages/f0/89/0e30f9eddf7d44ccf9d25979030754fd0457af61fa4279acb8c293a04f97/ast_serialize-0.13.1-cp315-cp315-pyemscripten_2026_5_wasm32.whl", hash = "sha256:bf53a3ba1cbe45399fc1e4ccd684b8f2a11cca450f89706b79122f478534c6f5", size = 897546, upload-time = "2026-10-17T00:03:50.093Z" }, + { url = "https://files.pythonhosted.org/packages/81/92/d705be88ff452b9ba0088b554a0cbd308fd01879da092b33fd2ad7d1aa60/ast_serialize-0.13.1-cp39-abi3-macosx_10_12_x86_64.whl", hash = "sha256:4bcf1d5f4eefecaa325a34ecf079b2741189e7d0821523f92cb343a389a67489", size = 1242416, upload-time = "2026-10-17T00:03:51.521Z" }, + { url = "https://files.pythonhosted.org/packages/60/c2/98370845a7f35cb8a25782e78284b48e01bf3128339881d48d613f304f8f/ast_serialize-0.13.1-cp39-abi3-macosx_11_0_arm64.whl", hash = "sha256:1b158f1c9e3a0d386913924c57995d6df78224868a4d0f215bdd41587c97b34a", size = 1229729, upload-time = "2026-10-17T00:03:52.825Z" }, + { url = "https://files.pythonhosted.org/packages/d8/8b/2d7ffed76addd9d3fcf37fb171400942735c8912264c763561a85407f6a8/ast_serialize-0.13.1-cp39-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:77a6201b69ce42e919f2fd9a559138d5410b5d8afff7c3a6b1f500b0481ff7d8", size = 1292255, upload-time = "2026-10-17T00:03:54.148Z" }, + { url = "https://files.pythonhosted.org/packages/6b/2a/bb9e0e719d89cc950fadfcfcc9cb4bc7640419c4228c852f031ab8abf440/ast_serialize-0.13.1-cp39-abi3-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:6eb0be64c9b8f1ed26637eef345abe75ea90351c92c85a8aec7838b3af971011", size = 1298501, upload-time = "2026-10-17T00:03:55.559Z" }, + { url = "https://files.pythonhosted.org/packages/7a/32/13ce07dce48226f5bd9cfd8f708ec101a8be05aa430cda4918ce31ce8c82/ast_serialize-0.13.1-cp39-abi3-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:7f2427bddfca208e84de700044fadf9aef2769a70bae740a1bdabb89ee9e1117", size = 1553758, upload-time = "2026-10-17T00:03:56.952Z" }, + { url = "https://files.pythonhosted.org/packages/e2/fb/9b51d186db0c20ca28cbaaefd50f03b573c89327b9a2627820cbce22196b/ast_serialize-0.13.1-cp39-abi3-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:88df960e67184a71874e5b2ee014f87d1254a0dbc1f903c7bd7b1ab7733ecaef", size = 1318258, upload-time = "2026-10-17T00:03:58.418Z" }, + { url = "https://files.pythonhosted.org/packages/c5/fa/da311559dd3dae9af5825cf21660775a929b970f72e3786af3f2cd667944/ast_serialize-0.13.1-cp39-abi3-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9f99786e0d62082a5b121b3437f3167562133711df22128de1e9886f57f0b226", size = 1313260, upload-time = "2026-10-17T00:04:00.194Z" }, + { url = "https://files.pythonhosted.org/packages/2b/11/97a4b9e5b4776d72f47fcd9a09a497bbf68ec8c1ae074307a2c51e410d85/ast_serialize-0.13.1-cp39-abi3-manylinux_2_31_riscv64.whl", hash = "sha256:a01b515b25a03184eff4acef25b981ae007916379682e908fc8785b342a0bf3e", size = 1309992, upload-time = "2026-10-17T00:04:01.575Z" }, + { url = "https://files.pythonhosted.org/packages/2e/c4/62f85121a80cd451ef04f550cf0f7ea0ad9ff46cc4e9a5b9ae439b6527b1/ast_serialize-0.13.1-cp39-abi3-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:29422d7bcd9e7f39411571c36cec45ce8a7a9b3ad4b2e7aa64497c15a9e397f6", size = 1362715, upload-time = "2026-10-17T00:04:02.881Z" }, + { url = "https://files.pythonhosted.org/packages/c1/fa/c5f4a545f72a7681e3295bab6e3600ee0862ec4391bed961fe9f735b67e0/ast_serialize-0.13.1-cp39-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:6ffb0f548a7dc126067fdfb7b2325ab5dfcdeecc29faf5e0f0461c96d6ebfa3d", size = 1469931, upload-time = "2026-10-17T00:04:04.181Z" }, + { url = "https://files.pythonhosted.org/packages/38/a9/65aed4f8fa7a001a7cfdc03e68e844517ab041ba6fb614b7d78a1d6ac056/ast_serialize-0.13.1-cp39-abi3-musllinux_1_2_armv7l.whl", hash = "sha256:2876444a5f87a7c76f371af3c07c2fda563a08bc8af52568df812e8aba4bf568", size = 1570945, upload-time = "2026-10-17T00:04:05.778Z" }, + { url = "https://files.pythonhosted.org/packages/fb/8c/44b2da991cede79bfbf52089f33a5f0168945466b3d9cd38b5dcf08e7130/ast_serialize-0.13.1-cp39-abi3-musllinux_1_2_i686.whl", hash = "sha256:885a62ec6481ce58ab24c6357360d7a82023b62dd7e5e7ceccf59e9662a3272b", size = 1569978, upload-time = "2026-10-17T00:04:07.347Z" }, + { url = "https://files.pythonhosted.org/packages/46/e4/109b2a5beca700237767d5add920c2f8e1ba9bd5799b0faf143d0e9cf4ef/ast_serialize-0.13.1-cp39-abi3-musllinux_1_2_ppc64le.whl", hash = "sha256:2015fd0165e463aac3b1aadc6a1fa1e5820c14ca950821f4fe02f8a3f6a388d6", size = 1676082, upload-time = "2026-10-17T00:04:08.7Z" }, + { url = "https://files.pythonhosted.org/packages/73/e0/7df70f6dbb11b5762da5416318f08316a1c51348e0d69ec79ca5f98f836a/ast_serialize-0.13.1-cp39-abi3-musllinux_1_2_riscv64.whl", hash = "sha256:eb41e1906502ac80d24ff343f45008552a3f5b5158607959fe6a07dbfc6eb037", size = 1483207, upload-time = "2026-10-17T00:04:10.162Z" }, + { url = "https://files.pythonhosted.org/packages/1f/bc/523aa1c08bd69b5654621beb3dc1a9035715a4a63762fb8d219d6fb3eb81/ast_serialize-0.13.1-cp39-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:ca9acc67f796aa2554fa3037dccc022a4b08b38b2ad153edfac9c9bb7cb1f3c6", size = 1512140, upload-time = "2026-10-17T00:04:11.589Z" }, + { url = "https://files.pythonhosted.org/packages/66/83/6607060659998f00afdea0d8375c1e6e2b7d515ab905090d9a5a02f48851/ast_serialize-0.13.1-cp39-abi3-win32.whl", hash = "sha256:4f98da562e5901d69c7dd30885594c5438f859edf354e9ac7517d188fb026c3a", size = 1131889, upload-time = "2026-10-17T00:04:12.953Z" }, + { url = "https://files.pythonhosted.org/packages/9f/6f/bafd6490fe7b355627fabe95f4417e3d02da93102c8552550eb9a0774e1e/ast_serialize-0.13.1-cp39-abi3-win_amd64.whl", hash = "sha256:ddf7cbc9c8abf70102c4a088efe154bb86bfb825b0a10e556d2b15972cf99bd7", size = 1171153, upload-time = "2026-10-17T00:04:14.362Z" }, + { url = "https://files.pythonhosted.org/packages/11/25/4235f4b375a67a37ac595bf478a5407a744eaf7b64113c1c3a5432b8d954/ast_serialize-0.13.1-cp39-abi3-win_arm64.whl", hash = "sha256:48f11d96c9ec71119612f8e79a8c55c12f2b136716d68347433c561d27a25f43", size = 1139035, upload-time = "2026-10-17T00:04:15.767Z" }, ] [[package]] name = "beautifulsoup4" -version = "4.14.3" +version = "4.15.0" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "soupsieve" }, + { name = "soupsieve", version = "2.10", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version < '3.11.5'" }, + { name = "soupsieve", version = "4.1", source = { registry = "https://pypi.org/simple" }, marker = "python_full_version >= '3.11.5'" }, { name = "typing-extensions" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/c3/b0/1c6a16426d389813b48d95e26898aff79abbde42ad353958ad95cc8c9b21/beautifulsoup4-4.14.3.tar.gz", hash = "sha256:6292b1c5186d356bba669ef9f7f051757099565ad9ada5dd630bd9de5fa7fb86", size = 627737, upload-time = "2025-11-30T15:08:26.084Z" } +sdist = { url = "https://files.pythonhosted.org/packages/43/65/318323f98dbee45d42dff61d8f047181bc6f2268a9068cfad035a46be5af/beautifulsoup4-4.15.0.tar.gz", hash = "sha256:288e3ca7d54b06f2ac191970bc275c1939cb46d450b255bf6718b04aa37ab4f7", size = 632571, upload-time = "2026-06-07T16:44:20.453Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/1a/39/47f9197bdd44df24d67ac8893641e16f386c984a0619ef2ee4c51fbbc019/beautifulsoup4-4.14.3-py3-none-any.whl", hash = "sha256:0918bfe44902e6ad8d57732ba310582e98da931428d231a5ecb9e7c703a735bb", size = 107721, upload-time = "2025-11-30T15:08:24.087Z" }, + { url = "https://files.pythonhosted.org/packages/88/c6/92fcd42f1ba33e1184263f25bfabf3d27c383410470f169e4b8163bf9c17/beautifulsoup4-4.15.0-py3-none-any.whl", hash = "sha256:d6f88de62e1d4e38ecb1077eb9724cd0eff29d2a08ca16a401e9b9e93f117cf9", size = 109924, upload-time = "2026-06-07T16:44:21.566Z" }, ] [[package]] name = "certifi" -version = "2025.11.12" +version = "2026.10.23" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/a2/8c/58f469717fa48465e4a50c014a0400602d3c437d7c0c468e17ada824da3a/certifi-2025.11.12.tar.gz", hash = "sha256:d8ab5478f2ecd78af242878415affce761ca6bc54a22a27e026d7c25357c3316", size = 160538, upload-time = "2025-11-12T02:54:51.517Z" } +sdist = { url = "https://files.pythonhosted.org/packages/fd/11/b524cbd9bbdaca58608e4cf4053fd463417549e1959fa8d3aa18319f9555/certifi-2026.10.23.tar.gz", hash = "sha256:a9895e6e2758b371e0545e321a3a8fd1fcfd9829ada8824a936dfb16aaaf36cd", size = 136225, upload-time = "2026-10-23T11:36:16.478Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/70/7d/9bc192684cea499815ff478dfcdc13835ddf401365057044fb721ec6bddb/certifi-2025.11.12-py3-none-any.whl", hash = "sha256:97de8790030bbd5c2d96b7ec782fc2f7820ef8dba6db909ccf95449f2d062d4b", size = 159438, upload-time = "2025-11-12T02:54:49.735Z" }, -] - -[[package]] -name = "click" -version = "8.3.1" -source = { registry = "https://pypi.org/simple" } -dependencies = [ - { name = "colorama", marker = "sys_platform == 'win32'" }, -] -sdist = { url = "https://files.pythonhosted.org/packages/3d/fa/656b739db8587d7b5dfa22e22ed02566950fbfbcdc20311993483657a5c0/click-8.3.1.tar.gz", hash = "sha256:12ff4785d337a1bb490bb7e9c2b1ee5da3112e94a8622f26a6c77f5d2fc6842a", size = 295065, upload-time = "2025-11-15T20:45:42.706Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/98/78/01c019cdb5d6498122777c1a43056ebb3ebfeef2076d9d026bfe15583b2b/click-8.3.1-py3-none-any.whl", hash = "sha256:981153a64e25f12d547d3426c367a4857371575ee7ad18df2a6183ab0545b2a6", size = 108274, upload-time = "2025-11-15T20:45:41.139Z" }, + { url = "https://files.pythonhosted.org/packages/32/d1/a3652fe2c19134d0d15922177821d863cbd7e842d53a21bbe7e8e3a1b5ac/certifi-2026.10.23-py3-none-any.whl", hash = "sha256:e9b54de76e530bb6cf0ccd036787103acb58fd42ba930ea8bf948ddbaa2f61d1", size = 135082, upload-time = "2026-10-23T11:36:14.763Z" }, ] [[package]] @@ -69,7 +136,7 @@ wheels = [ [[package]] name = "elf" -version = "1.1.1" +version = "1.2.0" source = { editable = "." } dependencies = [ { name = "beautifulsoup4" }, @@ -81,7 +148,9 @@ dependencies = [ [package.dev-dependencies] dev = [ + { name = "mypy" }, { name = "pytest" }, + { name = "ruff" }, ] [package.metadata] @@ -94,7 +163,11 @@ requires-dist = [ ] [package.metadata.requires-dev] -dev = [{ name = "pytest", specifier = ">=9.0.1" }] +dev = [ + { name = "mypy", specifier = ">=1.19.0" }, + { name = "pytest", specifier = ">=9.0.1" }, + { name = "ruff", specifier = ">=0.14.0" }, +] [[package]] name = "h11" @@ -135,32 +208,148 @@ wheels = [ [[package]] name = "idna" -version = "3.11" +version = "3.20" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/6f/6d/0703ccc57f3a7233505399edb88de3cbd678da106337b9fcde432b65ed60/idna-3.11.tar.gz", hash = "sha256:795dafcc9c04ed0c1fb032c2aa73654d8e8c5023a7df64a53f39190ada629902", size = 194582, upload-time = "2025-10-12T14:55:20.501Z" } +sdist = { url = "https://files.pythonhosted.org/packages/f5/08/8eea9d4b8302028f3abb2c0813953f7aec26d33b7a8960ed760e65ff29fa/idna-3.20.tar.gz", hash = "sha256:a7db850025b95ded1eae8a46181a1a6c56c92c96f0e2b005d9ff8dc0210cab44", size = 216463, upload-time = "2026-09-17T14:11:04.752Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/0e/61/66938bbb5fc52dbdf84594873d5b51fb1f7c7794e9c0f5bd885f30bc507b/idna-3.11-py3-none-any.whl", hash = "sha256:771a87f49d9defaf64091e6e6fe9c18d4833f140bd19464795bc32d966ca37ea", size = 71008, upload-time = "2025-10-12T14:55:18.883Z" }, + { url = "https://files.pythonhosted.org/packages/58/a2/bb081bab032533a855d44de1d56f8e8426114ff1ba5d1f07a438a0a654f8/idna-3.20-py3-none-any.whl", hash = "sha256:ab7ae7122974553370f0bdb919e1a960b2cd1bc1ef0276416d896db81c14582c", size = 69583, upload-time = "2026-09-17T14:11:03.168Z" }, ] [[package]] name = "iniconfig" -version = "2.3.0" +version = "2.3.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/01/e1/2069291243c926a2ff1cd706c7f3eeb9b62144bf60f77c9fb9ff2fb26bd3/iniconfig-2.3.1.tar.gz", hash = "sha256:67f4b9c50da0dedf52af349e7749a80a9057a5031199791b906c3bb3ae878960", size = 21209, upload-time = "2026-10-06T22:48:38.076Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/56/43/4ca9e49d27a1fcf6bece6f6aec0ea46bb9112489b93d4b688fb415457bdb/iniconfig-2.3.1-py3-none-any.whl", hash = "sha256:9121e2c1fdb355232495be3194c8dfe87ccc2d5dee45947b78e68f499790d7a7", size = 7552, upload-time = "2026-10-06T22:48:36.959Z" }, +] + +[[package]] +name = "librt" +version = "0.16.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" } +sdist = { url = "https://files.pythonhosted.org/packages/04/f5/9dc696772d241814bacac7880bac32f2930b5a6ebc1f85317b83161a011c/librt-0.16.0.tar.gz", hash = "sha256:ac38d6d8d66bf3d744148dbbc0b8e193e195a51e364ed55e224631f5721891fc", size = 219839, upload-time = "2026-09-29T00:55:32.891Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" }, + { url = "https://files.pythonhosted.org/packages/ba/0e/b04fd2d76b6a78a02286938251b2c119fb36ddece92c76cb4886ef7d44b8/librt-0.16.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:fe4372c52d4849096c6cc1cda2817d293ec51440c890474ed59ef38d46556f18", size = 148058, upload-time = "2026-09-29T00:44:40.903Z" }, + { url = "https://files.pythonhosted.org/packages/a3/fc/e1ed24aadb32d38603c0c07f579d739eb4d90e64e90d525b024e4a999b4d/librt-0.16.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:c72c5295a84bd249526da9bdca38f2e176d15c31c13bb0063c5053f4ca023421", size = 153073, upload-time = "2026-09-29T00:44:42.165Z" }, + { url = "https://files.pythonhosted.org/packages/be/38/133ab655409420e0c34a9a9836a7f4e5ae75fba758d7fe177099130d58ba/librt-0.16.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:be56ba9c884143495b517f23fe794ae367d58cd89ea0fdd6d437e3c024a87f9f", size = 493052, upload-time = "2026-09-29T00:44:44.043Z" }, + { url = "https://files.pythonhosted.org/packages/94/42/aaa663bc9421f5bf7bbbe9d3316d7219749698ec7688ac3b519770a89c04/librt-0.16.0-cp311-cp311-manylinux2014_i686.manylinux_2_17_i686.manylinux_2_28_i686.whl", hash = "sha256:ef46c1a29ffb8c72e882e22618ec618778eacd0578fb22c6e7cf9c11d15f357b", size = 485506, upload-time = "2026-09-29T00:44:45.479Z" }, + { url = "https://files.pythonhosted.org/packages/7b/59/83a6eb5087ba8b45b083859e2085256963e06d4c2531944cdd962670bfb5/librt-0.16.0-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:d3c94211ee0c4f8d649ec06b7c115c0ec4eadb873a0e3154ca15cef3f814b071", size = 498708, upload-time = "2026-09-29T00:44:46.916Z" }, + { url = "https://files.pythonhosted.org/packages/a0/e4/15a8d62b2bc12935080ec7277e2e0b9b233047781eb784a51d3e25af669a/librt-0.16.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:94aed6a8308818b91677957d1bd03188869cd7aeb23c5dba7912a6c0402f7602", size = 515981, upload-time = "2026-09-29T00:44:48.316Z" }, + { url = "https://files.pythonhosted.org/packages/46/4f/287cc282ac5dd815204c0779e79401bb0a568c3a1335fb319bf0838fb566/librt-0.16.0-cp311-cp311-manylinux_2_34_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:349c0bcb87ebd07481b6ff781e25cdc699723dbe2212e57dabb27f7a13b7b87d", size = 508670, upload-time = "2026-09-29T00:44:49.726Z" }, + { url = "https://files.pythonhosted.org/packages/bf/5b/ab7292add898ade0d2b5b75d32a923aae315861671aa5c39f5491309f7ae/librt-0.16.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:001bfd59a7d45b17e3e75f2a8c6405280b35e7b84471792778e718c4f368950e", size = 530393, upload-time = "2026-09-29T00:44:51.356Z" }, + { url = "https://files.pythonhosted.org/packages/7a/9e/8e6bcf027d4bcbc16a4e864b3d158a1d3e5f55ffa53af0238020cad89271/librt-0.16.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:28e038895b998d7a0c7798922ce8a1dc157675df5cf1c9ef0aca809ed804b7a1", size = 534302, upload-time = "2026-09-29T00:44:52.893Z" }, + { url = "https://files.pythonhosted.org/packages/96/a4/8c5ab4f3b3a8e905ff8305d76976a2e666f52fe049edd398aed2402beb36/librt-0.16.0-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:0dbe4096a7ecc00fa835d24510ad8545a4efef738dac96e0e63516783ccde905", size = 536150, upload-time = "2026-09-29T00:44:54.421Z" }, + { url = "https://files.pythonhosted.org/packages/ea/5e/7c4bc267e3cd4b8bd288de9f62d61fff203829c9cc649ea2aa12e9218cf0/librt-0.16.0-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:5cd5b092441053364af968ea12084692cb9d4a22f3ce9524e377880bf028761e", size = 514316, upload-time = "2026-09-29T00:44:55.998Z" }, + { url = "https://files.pythonhosted.org/packages/e0/75/c8bc6b50f43c73819334233f5a3259c81216742cef56d2140c3dd377c3f0/librt-0.16.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:3ddeb3c9dedb461bb457c6c7d9aa7fbf35329da313d1a7543d00c8d0f3473c96", size = 557731, upload-time = "2026-09-29T00:44:57.581Z" }, + { url = "https://files.pythonhosted.org/packages/93/fb/e241f91bc8de6c7ac1c6a20ea6dd381bc52312b44d711ffcd97140db1e57/librt-0.16.0-cp311-cp311-win32.whl", hash = "sha256:e05108e0849966f53a8d2d3112a7af881d0efaa479bc735bba91108f9f2350a7", size = 104922, upload-time = "2026-09-29T00:44:59.078Z" }, + { url = "https://files.pythonhosted.org/packages/d1/38/c892383d2bb1a6a80b2ec8ede84970a265a792c56614a06282bf3008517c/librt-0.16.0-cp311-cp311-win_amd64.whl", hash = "sha256:5f49cff01bd608ef7d97104cb035c75455e79c2d70bf4a506cf773338ac1860d", size = 125093, upload-time = "2026-09-29T00:49:01.621Z" }, + { url = "https://files.pythonhosted.org/packages/e4/56/8bbde1ed0b21480163617648f638fdaec9374cf5e9c846ebcee34ec02a42/librt-0.16.0-cp311-cp311-win_arm64.whl", hash = "sha256:1d28ae980ae2218f9c5b95d191e947296f918c9bf0b400d467a9430275bbe678", size = 115910, upload-time = "2026-09-29T00:52:40.131Z" }, + { url = "https://files.pythonhosted.org/packages/ad/76/bbdaeb87b7c47b5c7343e90222b9bfa4e4a8a83f647e02933ad0129225b1/librt-0.16.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:fe52bf4641069e7978a14253b036cb9002def1926317e710f2e249f8a8c47742", size = 151028, upload-time = "2026-09-29T00:52:41.508Z" }, + { url = "https://files.pythonhosted.org/packages/fd/0c/ab8ed3dab0085931aec4a792c7eaac8dc6c5ff4691fda3a5360d9d8a9cd2/librt-0.16.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:5bcc2c4726ced915b00de0c9856a4eeabfb3fddb93e10e0b8f735b7709358b6d", size = 155283, upload-time = "2026-09-29T00:52:42.873Z" }, + { url = "https://files.pythonhosted.org/packages/eb/36/494e79d460c80c1f030661e8287c9eca5e1ad652dc2b2180b6cd42abce0a/librt-0.16.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ff7baa55f8e7c69851419e50a666015d02a74198716fd45c0125a2112e0a389f", size = 503185, upload-time = "2026-09-29T00:52:44.638Z" }, + { url = "https://files.pythonhosted.org/packages/9b/34/a8464038dd9db6e4381fa2b6eb73dc9a50888d77102c4c139304ac35cddc/librt-0.16.0-cp312-cp312-manylinux2014_i686.manylinux_2_17_i686.manylinux_2_28_i686.whl", hash = "sha256:b95d5d92ab83d39e760a52091bb1baba664f3a2351e39b1e16801e5747c2f0e9", size = 496738, upload-time = "2026-09-29T00:52:46.441Z" }, + { url = "https://files.pythonhosted.org/packages/6a/53/e0e5e334ef0c6ed27039d323819368b9ef6712be87d55ee2bf9799398afd/librt-0.16.0-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:b6d085d70bce51d43c5c7c36d63490770180d8779e71c49305c87b4213918de7", size = 513818, upload-time = "2026-09-29T00:52:48.068Z" }, + { url = "https://files.pythonhosted.org/packages/ad/f7/7ce72cbf19d0addd05090b339152fd0548a02562c2866a603e6e3b3da2df/librt-0.16.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:36e53948e99bbe3ffea257124cfcae1cfb01831555c9a9c903c9f9a72db7fd07", size = 531952, upload-time = "2026-09-29T00:52:49.816Z" }, + { url = "https://files.pythonhosted.org/packages/83/22/0b1bcb6a8e723c8b4fd60dfc8ae8ec6461c54073fbc8685efeb8d900d407/librt-0.16.0-cp312-cp312-manylinux_2_34_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:54d11f726aae9df5a6ffbbf0a03a52449bbac84a53ef03669cb41cdfd4ae41bf", size = 524465, upload-time = "2026-09-29T00:52:51.354Z" }, + { url = "https://files.pythonhosted.org/packages/64/2e/e9c23b8b9df1813da1be205deca9606beb7ddd033972246cd426d05374a0/librt-0.16.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:4323193ac0cd025f85af531df8ba91bf24d1973b401697347a6282e8fd3fcf5e", size = 543191, upload-time = "2026-09-29T00:52:53.284Z" }, + { url = "https://files.pythonhosted.org/packages/bc/e5/6a8b21b342c03ed7e230fa3afbfd2edc58e6e87ef1f0d11fa2b9a748c252/librt-0.16.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:e42f8e098b9c5396fefa05fb1cc7e33b0e08fc51da106b5de4a45fd22aac6743", size = 546979, upload-time = "2026-09-29T00:52:54.932Z" }, + { url = "https://files.pythonhosted.org/packages/84/9e/b5129023eced1be01e01c22757f53be551d463b1bb7264f787927404c1d6/librt-0.16.0-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:39ec1d5a14e37baf1450a6cabf03fe552340808bf1ad9d71824ab90117716459", size = 555317, upload-time = "2026-09-29T00:52:56.869Z" }, + { url = "https://files.pythonhosted.org/packages/71/89/28bba5938c725fe91f06bf93f7fa6c6b150229df53a87b454b0d5c2a796e/librt-0.16.0-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:d1aabe3925cbb4a08d15b7b20ba4011b53019da0c4173a25155139b7b1baed65", size = 535846, upload-time = "2026-09-29T00:52:58.475Z" }, + { url = "https://files.pythonhosted.org/packages/22/92/63773026614f888c5d4e370e395ce42ca604b89f70b3acdfedbf94851b80/librt-0.16.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:300c3ffdc459f4a779a8411ecb188e3ac0b1ff3a3a7b099642555dedae06c69b", size = 573700, upload-time = "2026-09-29T00:53:00.127Z" }, + { url = "https://files.pythonhosted.org/packages/66/8f/347d4677eefb57cd9f8e01d95a1dcee9a91b4e44e664173c32ff6f3752e5/librt-0.16.0-cp312-cp312-win32.whl", hash = "sha256:c17194318e4c0c0348b36f36c2ec7534436fe0a4c15582403162a4f08c80797a", size = 106158, upload-time = "2026-09-29T00:53:02.031Z" }, + { url = "https://files.pythonhosted.org/packages/f0/2c/5193dc81127cd5ddfad031391b046bf32dda219b38463ab872407ca30646/librt-0.16.0-cp312-cp312-win_amd64.whl", hash = "sha256:25a58a19ea8d83b68209f04912df765e9260635ef77646542ed4b4abe6bc7940", size = 126176, upload-time = "2026-09-29T00:53:03.445Z" }, + { url = "https://files.pythonhosted.org/packages/ff/3d/9668a400c8dd81d162eba38b33fa49fa6205f1a64493570a13fbb815c3ee/librt-0.16.0-cp312-cp312-win_arm64.whl", hash = "sha256:f7be7cf555bc30ec12622e9447299cc4a9b8ff307548b634794353db0c2065dc", size = 116572, upload-time = "2026-09-29T00:53:04.815Z" }, + { url = "https://files.pythonhosted.org/packages/46/cd/ae5e0e9dba45d1399aa04a5395bcc0bead40d9fa06dc903634a7b4d7473d/librt-0.16.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:c5e6144e68b577f157519f2ba88ca20e3ed61c29b00e5cdfa76cd2d45acf059a", size = 151036, upload-time = "2026-09-29T00:53:06.284Z" }, + { url = "https://files.pythonhosted.org/packages/41/5a/48a16e323c5f9447a94cce7b59babf60fa04e62c3365ecf060c77ed8b320/librt-0.16.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:33f41443a1f4e1f099331b3d8120e409fbff84b9760bc1cc9ea496f37ddaa5cc", size = 155211, upload-time = "2026-09-29T00:53:07.72Z" }, + { url = "https://files.pythonhosted.org/packages/3f/29/0f59299eb4251a409b2e690ad4b7d9f8a676db829d7817ec961f32b44f7e/librt-0.16.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7e510b7770bee609617a3374a96548eb114cae048023e3f049ee449e7ff2db32", size = 502587, upload-time = "2026-09-29T00:53:09.191Z" }, + { url = "https://files.pythonhosted.org/packages/de/ba/d6fb4ef8d1537c396079d72289f16be7cd35a366e5065c51253fea2760b6/librt-0.16.0-cp313-cp313-manylinux2014_i686.manylinux_2_17_i686.manylinux_2_28_i686.whl", hash = "sha256:efc49c462d4516b8a58b00b490078fa64689fd1fe66970cc190131d7afb8027e", size = 496146, upload-time = "2026-09-29T00:53:11.016Z" }, + { url = "https://files.pythonhosted.org/packages/52/fc/8c50dd4d7cc97c0ee8f252c8a3104980f234391cf1519b554e8b9de08b60/librt-0.16.0-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:92caf82ebef5e12d21c72242b70d1e92536f1711cf2a727a4c276de4b4469087", size = 513336, upload-time = "2026-09-29T00:53:12.655Z" }, + { url = "https://files.pythonhosted.org/packages/a9/59/16c409c56f708eda2db9a0553662845d45e3871c77d70a240dae3f3bdc56/librt-0.16.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:17bac7f7a16b328fff77e440287693eb017abde913595b5827ebccbc21ecd8a6", size = 531689, upload-time = "2026-09-29T00:53:14.39Z" }, + { url = "https://files.pythonhosted.org/packages/88/82/d34772a6c29d1446dcca6e64d74062efd508523ab351aa16625a4689d5cc/librt-0.16.0-cp313-cp313-manylinux_2_34_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:5b976054553670829985ed767feb78fb6bcede0175327c4844dd5c281c1be659", size = 524537, upload-time = "2026-09-29T00:53:16.064Z" }, + { url = "https://files.pythonhosted.org/packages/77/8f/24c5631313746131ccee53bc91fdc8374f9cf25e0082a1fee9c93bb98acc/librt-0.16.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:0058f9d68721094105917254c72ac0569117bb7b13b9769cf45d26d89f9d21cd", size = 543231, upload-time = "2026-09-29T00:53:17.939Z" }, + { url = "https://files.pythonhosted.org/packages/f2/cb/5f8e0d41dbd8b499c2265e939c31acc9ba59845565bf99539ad1c06aebcf/librt-0.16.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:30b7beaf3f4487b7d8adef1f158b49067cb4d5a19fa7a3bf31a4e7a820e435c5", size = 546499, upload-time = "2026-09-29T00:53:19.666Z" }, + { url = "https://files.pythonhosted.org/packages/be/61/063052de441d1385f59cea4223f184bf9e5d125de1ae3239b490aa1e486e/librt-0.16.0-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:468df902df016a06eb0e40b0747dc8d14e47d7a38b18b63b1fb167d85cb94d63", size = 555261, upload-time = "2026-09-29T00:53:21.292Z" }, + { url = "https://files.pythonhosted.org/packages/14/11/a2ada0529372268d6401afa9d457a095b68cd7753532b6f7f33049a19b43/librt-0.16.0-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:aea7b1f2b125dad5de85f049136651bff256c883c65e6b9209b2da0a1ac3cdef", size = 536029, upload-time = "2026-09-29T00:53:23.07Z" }, + { url = "https://files.pythonhosted.org/packages/23/9d/5bb6d38853382986dca702fc7e06c8256d30f5fa0676d882773b744610dc/librt-0.16.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:a8afb6557920860b7a3a596eb804cf37e09e7cf8a803db2478c202acc72d8c2e", size = 573748, upload-time = "2026-09-29T00:53:24.696Z" }, + { url = "https://files.pythonhosted.org/packages/99/f6/0025cde35ff7f607684dc775a2b2d732cce2561cec050a6ee1fb2e1fc6fe/librt-0.16.0-cp313-cp313-pyemscripten_2025_0_wasm32.whl", hash = "sha256:77c7a2b4fe2c1369e0d5aa1cade26740a7b14be32fbc9a5535d617d20065c39d", size = 79861, upload-time = "2026-09-29T00:53:26.089Z" }, + { url = "https://files.pythonhosted.org/packages/93/93/303b8592909bd583f83f02818ffbea3f7647ca1e22b1cd5465d04b8145fe/librt-0.16.0-cp313-cp313-win32.whl", hash = "sha256:02d89c813d5ff74b17df72d3a34819d132cd168e56b81bf755b809bd9e46b8c4", size = 106236, upload-time = "2026-09-29T00:53:27.43Z" }, + { url = "https://files.pythonhosted.org/packages/cf/24/80bbb463c60ed18e29cb26aba386ddb76609580e4e7160710e550587018c/librt-0.16.0-cp313-cp313-win_amd64.whl", hash = "sha256:14ed6ebe3e4f85f326d7920011ad30ff49ed9334e62cf88caef9ba973d9e3a92", size = 126180, upload-time = "2026-09-29T00:53:28.7Z" }, + { url = "https://files.pythonhosted.org/packages/43/80/b1a6fbdd7da825cdd55c71aa81eb6cfa82c513c360774152eacb50b4a771/librt-0.16.0-cp313-cp313-win_arm64.whl", hash = "sha256:83d4041a3d9b2fd053a8a4e1f22878b3e5833e2712956382d5c048d791454e91", size = 116557, upload-time = "2026-09-29T00:53:30.012Z" }, + { url = "https://files.pythonhosted.org/packages/1e/93/9e0cf7da129a93c3dc7f45bc3cd4a660f2aaa995aa8a6f95c2583ef41239/librt-0.16.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:931a0bb0fcac88f263e269e46eb30ba8e21402cd3c62ca40cb97034c0693fab1", size = 149844, upload-time = "2026-09-29T00:53:31.391Z" }, + { url = "https://files.pythonhosted.org/packages/8f/26/8a90d2a8f2b2e471bb486b7aec117b8ae622715ed6c39853aec48ea20073/librt-0.16.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:1bc17e54e5305f8d40b7ca203671ff5a9e59c1d0f8ea0f625dcca53a3984de11", size = 154111, upload-time = "2026-09-29T00:53:32.718Z" }, + { url = "https://files.pythonhosted.org/packages/35/ce/67abb46258da4d3e42ff5b141db6f38c59357bef84c7979f183b22f924f1/librt-0.16.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:877698bf6bca5721d8be345f2fe09778e40ecadea8b58c73075f2b1a53666bf2", size = 494234, upload-time = "2026-09-29T00:53:34.466Z" }, + { url = "https://files.pythonhosted.org/packages/12/f9/ea7162414a16f8f1bbd3b493ad6d22b926c5471916e078350bdbca8c4e5f/librt-0.16.0-cp314-cp314-manylinux2014_i686.manylinux_2_17_i686.manylinux_2_28_i686.whl", hash = "sha256:5981c011b306781ce561e18e14230a14524a3d8109b97553666c942c18f31a96", size = 491173, upload-time = "2026-09-29T00:53:36.124Z" }, + { url = "https://files.pythonhosted.org/packages/b1/09/9b3e869060dd33f9989b80ba4fea306f6db8cecefcdfe6d7346ef0603f65/librt-0.16.0-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:afced3dfc17cd805ecf7a3d77996a71cf5f2c75aa66eb0c21a9930f4fc992f86", size = 505547, upload-time = "2026-09-29T00:53:37.686Z" }, + { url = "https://files.pythonhosted.org/packages/50/07/79007d2165f649ea93e08c0962d1d62c70af9cde77965255095bf9d96f9a/librt-0.16.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ca8052401c55d7511dda6760719fda7618067e83535d7d0010096d216c34b667", size = 523057, upload-time = "2026-09-29T00:53:39.301Z" }, + { url = "https://files.pythonhosted.org/packages/61/0c/8fbaff66d0ba376d8864653f5acce1569bae27e89648671f26f7eca67ab8/librt-0.16.0-cp314-cp314-manylinux_2_34_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:1e511762a074005bb0aa569166779834e75e438370226930d0ce1866d4b6a33b", size = 515158, upload-time = "2026-09-29T00:53:41.012Z" }, + { url = "https://files.pythonhosted.org/packages/df/2e/23ff0dece76f07a4124413a57682efa0bbeb5765ac0122bc0955513f82ca/librt-0.16.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:f1e8591bd8a5a628cd7f07954c6a1592359a878bf032957a8e9057a41d644311", size = 534183, upload-time = "2026-09-29T00:53:42.451Z" }, + { url = "https://files.pythonhosted.org/packages/26/c4/e11dea21d9a29486eba78887380374189d472734fa32cc50cb37ca44d3d0/librt-0.16.0-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:a4aaefb4ba6c07e1aeebb2795c8958148f1d6f9af3b555b53d23d766edb6d67a", size = 540663, upload-time = "2026-09-29T00:53:44.272Z" }, + { url = "https://files.pythonhosted.org/packages/44/75/e873ae158a8b7f5359be33e7fd6c1fbe02d9a78a3e89a77de6b0e837f476/librt-0.16.0-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:d92db7a0f6aee44f1baee94750457e8d2d1c6ccea41842de6268d34e8dc7eddd", size = 545908, upload-time = "2026-09-29T00:53:45.812Z" }, + { url = "https://files.pythonhosted.org/packages/ba/36/8939d3f6a93e11bd9592e6fe28d2b44f1c2dc4bed6e22e72359a91e18ffb/librt-0.16.0-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:378dfaffb38e59c24a87cde5713cd865d51ff7383fa12947f3907f306ea1ca55", size = 523302, upload-time = "2026-09-29T00:53:47.596Z" }, + { url = "https://files.pythonhosted.org/packages/71/14/35309f44a077f0f42ade0e2e7cd88c0cea760c661af205c01ea90d3c0e1f/librt-0.16.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:3e0c39bdc85370422e8b637be76eb1fd07d30967551b03e62267dd156f553152", size = 565911, upload-time = "2026-09-29T00:53:49.278Z" }, + { url = "https://files.pythonhosted.org/packages/78/0c/df6255b94967f3159ebc46f08d8e783c12da6ee269ddb74b2efed63c640c/librt-0.16.0-cp314-cp314-pyemscripten_2026_0_wasm32.whl", hash = "sha256:1b384b90ab79a7bc30b566895809a636e0666f21f3cf12b54823d025b7e83839", size = 79119, upload-time = "2026-09-29T00:53:50.938Z" }, + { url = "https://files.pythonhosted.org/packages/6b/44/d30d5a5461378c9d33f36736c6791c3b4c4ba4b1ffe0da7350aedcb2c9a0/librt-0.16.0-cp314-cp314-win32.whl", hash = "sha256:52327da75a94012e7f932f913d20d3876bed3c102be00e6c3e8600ff7bdd58a7", size = 100140, upload-time = "2026-09-29T00:53:52.205Z" }, + { url = "https://files.pythonhosted.org/packages/c2/98/769712f356a1e897df3581bb0c3100375d054a000de26099360ea65b5111/librt-0.16.0-cp314-cp314-win_amd64.whl", hash = "sha256:3f0b8114c44b2ac06ff5dacd08e07e8e807ff4f46083f2a1602685122559be41", size = 120464, upload-time = "2026-09-29T00:53:53.495Z" }, + { url = "https://files.pythonhosted.org/packages/bf/d3/ae2abccc8bdc8b063c1613a77686e17b74e9d3d60cfe6f12c63fa2821b9f/librt-0.16.0-cp314-cp314-win_arm64.whl", hash = "sha256:8caf96a4ef8fb27d0ac0d1ad8337d26a240acd4a02fe4345d0a8f264753e8f99", size = 110889, upload-time = "2026-09-29T00:53:54.817Z" }, + { url = "https://files.pythonhosted.org/packages/e4/26/0737d4be058dd6376eade7dd8b380d4b869b6394cee929393a5a431c45bb/librt-0.16.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:953107e2f68d0f3512c48f898b0dbf0ce5cc52bba0f318d847c985dc555ee4cc", size = 159838, upload-time = "2026-09-29T00:53:56.22Z" }, + { url = "https://files.pythonhosted.org/packages/01/96/9bc96531d7c620e9949af904470f02e3fa8f35129ab8e8f281c51eaa3788/librt-0.16.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:ad37d5b9abd49c9a655dcda7ea52a8a752884062ef1ee71ae17c2f2a0f81fe6a", size = 162018, upload-time = "2026-09-29T00:53:57.532Z" }, + { url = "https://files.pythonhosted.org/packages/0e/fa/b0289dcb186eb3f97221ba00da5f4bd3ba7fa5e99752d48aa8d336615334/librt-0.16.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2c4aa329c17bd1aaea4f6e89335d8ccd494b3a5830b6654462273e50e11023f0", size = 703983, upload-time = "2026-09-29T00:53:59.024Z" }, + { url = "https://files.pythonhosted.org/packages/d9/ab/05ebbbde7530fc5eeb58fbd1581522a9f64f132fa703c4c595eed6e14760/librt-0.16.0-cp314-cp314t-manylinux2014_i686.manylinux_2_17_i686.manylinux_2_28_i686.whl", hash = "sha256:0ead24d2562a49473dddd9efef8581f020007eb0054389c3ee3ffad38b1ca4c9", size = 683847, upload-time = "2026-09-29T00:54:00.671Z" }, + { url = "https://files.pythonhosted.org/packages/a3/75/f52aeecd4dbadbddf80725ba7de126d8bd5d0eb66247eae17a81ed90dd4d/librt-0.16.0-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:02118f56a9c36ddd07dfd9b919d9ecc117ba20a90987d56aa4c429fa34509188", size = 698045, upload-time = "2026-09-29T00:54:02.247Z" }, + { url = "https://files.pythonhosted.org/packages/e6/55/fa277a835cd6eb42380591ceb85f48c5b4d2b2d7e2cb9869e1e17d24d237/librt-0.16.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4e29522c62e28595ff7e324c6834ade51127707f0e255b18d1c1cf03d39c1048", size = 724640, upload-time = "2026-09-29T00:54:04.078Z" }, + { url = "https://files.pythonhosted.org/packages/25/e4/2cf64354f3fde8ebd591b3b48f96510bee24ac5f7d1e567adbbe210abdbd/librt-0.16.0-cp314-cp314t-manylinux_2_34_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:3ff4b2367926b69c6215635902cccb04048e73094e9862900d27cb2c6bbff143", size = 731748, upload-time = "2026-09-29T00:54:05.741Z" }, + { url = "https://files.pythonhosted.org/packages/f8/c9/c180af3e94e01aa529fa93d7733fec2abc47f222345400cf21d5481d5f8a/librt-0.16.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:c6f1b27bf1632a7e016af9f145f82be95e1edd7721a646505c21059257cb5a04", size = 754960, upload-time = "2026-09-29T00:54:07.38Z" }, + { url = "https://files.pythonhosted.org/packages/95/d6/01073aa78c58f356b10d9c57b3fe9abb143df338142bcd316df417b89db0/librt-0.16.0-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:5696d7f52e7b37217cb3a8f92c744fe835942602fdd4c1a8bc4741d3bfdce15e", size = 747000, upload-time = "2026-09-29T00:54:09.06Z" }, + { url = "https://files.pythonhosted.org/packages/f7/d8/1de3783908658d697a8cfc00582f61299ffba7796d7260c112e4700b1109/librt-0.16.0-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:6072e92dd876ff6ceeb6cf371e35e51f479349837391341f479b08df4564242b", size = 749569, upload-time = "2026-09-29T00:54:10.702Z" }, + { url = "https://files.pythonhosted.org/packages/b7/32/e817f66c96d6caa8bb8435ff93c4c220624d59efc506be59ab98fcd01d0c/librt-0.16.0-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:39ca4f2f2fe05de8e63493da592d84311adabe5bef52b193851981da9816b302", size = 729483, upload-time = "2026-09-29T00:54:12.25Z" }, + { url = "https://files.pythonhosted.org/packages/7c/c9/23992ccd2b9d22798fdd0f61353183a47414e651da782ad83eb680f50833/librt-0.16.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:f9807485a908f00355820f18e91e045ffdcdc5adb68aaec40a1e2b88c5f7bba1", size = 776584, upload-time = "2026-09-29T00:54:13.837Z" }, + { url = "https://files.pythonhosted.org/packages/67/3b/e8af957f08e6e2e8e566b099e43d2748418aa565df6ee1d9d3331209fdfe/librt-0.16.0-cp314-cp314t-win32.whl", hash = "sha256:94be5cb7bca4df6201f4183e9e4fa2086c655283d20b38cd84500a69057575a7", size = 104402, upload-time = "2026-09-29T00:54:15.568Z" }, + { url = "https://files.pythonhosted.org/packages/ca/1c/946e6443d7cd32347a086043395e421e52fd603c9163d2ec970ceab8eed6/librt-0.16.0-cp314-cp314t-win_amd64.whl", hash = "sha256:d46ca272b251d033dd4527b0dec5f261a28a52bd5fa0f99c117b0a1f8588cc2d", size = 126227, upload-time = "2026-09-29T00:54:17.165Z" }, + { url = "https://files.pythonhosted.org/packages/c2/a3/bc4f9959d3c62bcbf9e5fd3470a8bbd8bf33224ed4c25d7fba173201b8ac/librt-0.16.0-cp314-cp314t-win_arm64.whl", hash = "sha256:b9d6d4b14e92d876f8026b54c20c445f36425214c1081dc76f74e40db386b82b", size = 116493, upload-time = "2026-09-29T00:54:18.567Z" }, + { url = "https://files.pythonhosted.org/packages/b6/4b/10fdb42dfab4c1533e1570e686b18e86ff4328b406361b39fb3016667638/librt-0.16.0-cp315-cp315-macosx_10_15_x86_64.whl", hash = "sha256:6fe436af2eaf630474f491af5d032cbe45f93fcff5c3b9fe4ab194a7255b20ff", size = 149829, upload-time = "2026-09-29T00:54:19.933Z" }, + { url = "https://files.pythonhosted.org/packages/8e/30/a90ca13f1d3d91af1680000a4038536907018fbd51764767287a05d28b8b/librt-0.16.0-cp315-cp315-macosx_11_0_arm64.whl", hash = "sha256:8ff5d26c529336be9bd7ae04483235d77778ee7d6444a95353102b542601ce81", size = 154522, upload-time = "2026-09-29T00:54:21.306Z" }, + { url = "https://files.pythonhosted.org/packages/5c/dd/bcf364eacfa070bb1fc88d503111ae7177914197ba1fa717c748926e7930/librt-0.16.0-cp315-cp315-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:909d8e3c1faee44cb762b1c519ff8613dcc5ceae5c99987a00917b5a31fd1d6a", size = 497593, upload-time = "2026-09-29T00:54:22.798Z" }, + { url = "https://files.pythonhosted.org/packages/18/c1/2c4e81e347bdabfe8346bfc6dc37ae5e154d61c88e30848ec0606025a5e0/librt-0.16.0-cp315-cp315-manylinux2014_i686.manylinux_2_17_i686.manylinux_2_28_i686.whl", hash = "sha256:6d4a64283ee61824b5790de882bc68e2d9d7a5143537cb7a966f7354f71646d4", size = 480459, upload-time = "2026-09-29T00:54:24.364Z" }, + { url = "https://files.pythonhosted.org/packages/ab/d7/fef2a3cb8400701be496f6e459876f650b3451f407e30cb243de571ae615/librt-0.16.0-cp315-cp315-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:5810ba811297fdf37a1531a57667cb8ace0842013ca8606bf9eb7c24cf4be154", size = 507814, upload-time = "2026-09-29T00:54:25.997Z" }, + { url = "https://files.pythonhosted.org/packages/e1/6f/53762927a32e9dc9eb1d1c1f3528da281290c86d96929a8af652f671266e/librt-0.16.0-cp315-cp315-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e56aaf8c167548dc8e5d6f3bd0f48dcdd299a23c73be3f744aab79d99e9c7f5d", size = 525114, upload-time = "2026-09-29T00:54:27.747Z" }, + { url = "https://files.pythonhosted.org/packages/6c/67/0b9d031f303c4e8c691a9a8ef9d272f13b530c11cc563b819df621b6a348/librt-0.16.0-cp315-cp315-manylinux_2_34_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:8f36c58e33b304b525c6c9c5076399c6ebf1109e17b9051a05a407b091b9215b", size = 520465, upload-time = "2026-09-29T00:54:29.331Z" }, + { url = "https://files.pythonhosted.org/packages/ae/d5/2056a3a85864e882eb17a203a10ddb26fa748bc9718ec67e79059ab46cae/librt-0.16.0-cp315-cp315-musllinux_1_2_aarch64.whl", hash = "sha256:242e00b3d4fa37c3d3c1ca5f5c9adb7d909ddb1eac9c41f2787320d00caa0af2", size = 537257, upload-time = "2026-09-29T00:54:30.915Z" }, + { url = "https://files.pythonhosted.org/packages/54/57/e0d79790c163cbc0909e209a6f62e30bb713b647f905a176cdc64848fd4d/librt-0.16.0-cp315-cp315-musllinux_1_2_i686.whl", hash = "sha256:0253721561787b8df8443eb347b7a6461015354e5bdd37ee38a41fef220d2bb0", size = 527442, upload-time = "2026-09-29T00:54:32.478Z" }, + { url = "https://files.pythonhosted.org/packages/aa/50/1c0c95aba7af51f4752ea34fbf2eb79b36e7cae3a72536248e8c735de735/librt-0.16.0-cp315-cp315-musllinux_1_2_ppc64le.whl", hash = "sha256:3e483a8d69ede8067db70c0e83007423b6925de6fd53afed01d66160f2e9398c", size = 548139, upload-time = "2026-09-29T00:54:34.183Z" }, + { url = "https://files.pythonhosted.org/packages/98/91/a8a43dd5138d4f55f88846b8f0c85454a4fad69952cebfcff9948f831290/librt-0.16.0-cp315-cp315-musllinux_1_2_riscv64.whl", hash = "sha256:69ba927445cfaaffb4081003ef5224c55a5c2ab67ef956f416ef744916e44121", size = 529708, upload-time = "2026-09-29T00:54:35.761Z" }, + { url = "https://files.pythonhosted.org/packages/2d/41/d5226881ab2b7c20d9d587b37bdd4a0ec8775a96d00ca87ac9f385587db4/librt-0.16.0-cp315-cp315-musllinux_1_2_x86_64.whl", hash = "sha256:d6a365f2ab45a984d0e00eee0dd17f599ceab8cadab6ea07b6111c8132fc0e42", size = 567781, upload-time = "2026-09-29T00:54:37.409Z" }, + { url = "https://files.pythonhosted.org/packages/bb/bf/2345ba57a626e8c78c4ddcc724636a8df5a593fe46c1ee76bbf477e32b0d/librt-0.16.0-cp315-cp315-pyemscripten_2026_5_wasm32.whl", hash = "sha256:f01f3805f2dae4781c0c34b440e31740d082950bdaf89a6f601ad589a28af57a", size = 79177, upload-time = "2026-09-29T00:54:38.792Z" }, + { url = "https://files.pythonhosted.org/packages/1e/40/99e77936cc9207f629b077bf7cbc5e2f0827cddd7c29792f04ef881bd2c3/librt-0.16.0-cp315-cp315-win32.whl", hash = "sha256:b0e3e721c75d2e79a76d4422c79d7ba705fe1bbafec907037fe7a657a480a0e3", size = 100127, upload-time = "2026-09-29T00:54:40.251Z" }, + { url = "https://files.pythonhosted.org/packages/56/1e/801fe26bc622061b9dfd010e166d94142cb774b733217e6d98d1c0cf2638/librt-0.16.0-cp315-cp315-win_amd64.whl", hash = "sha256:bc02954b1295de798bbdb0b4e2d8a28c2117de8b5c73dcbeb27dc32572dfb971", size = 120480, upload-time = "2026-09-29T00:54:41.722Z" }, + { url = "https://files.pythonhosted.org/packages/bb/a9/d533983055bd36e112627384c2c038845d1df882540b8bcefb566475640b/librt-0.16.0-cp315-cp315-win_arm64.whl", hash = "sha256:c5db585d43449a5f54303d4b2774e45e1babd975cfe1630a3d708c0b80c3e560", size = 110915, upload-time = "2026-09-29T00:54:43.052Z" }, + { url = "https://files.pythonhosted.org/packages/55/fe/d62238fa9c653b0e0613290349467cb65711b5800e8e474f45e942a0ad95/librt-0.16.0-cp315-cp315t-macosx_10_15_x86_64.whl", hash = "sha256:f06c689cb14afd9b612727553a5ec5a40febf113ca41c4413a2b0b334285884b", size = 159714, upload-time = "2026-09-29T00:54:44.497Z" }, + { url = "https://files.pythonhosted.org/packages/f3/ac/f31efe7818700be72ba4f9af8a80fa67c39808c8d26dacc55dc1f6f35172/librt-0.16.0-cp315-cp315t-macosx_11_0_arm64.whl", hash = "sha256:13b4e8aba90b0b1c82474e9844aa9ffe7ad3faa484350e1da64cb8188d903134", size = 162086, upload-time = "2026-09-29T00:54:45.968Z" }, + { url = "https://files.pythonhosted.org/packages/d9/16/4d7487bf86a9d7e8e18f37ba5538789233ea693637379b75701bd35ec9de/librt-0.16.0-cp315-cp315t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5a269c46ae327d8e6f8c1f85f7516cb52c0fa48127565a1105a4f4a05ff2a0b4", size = 712727, upload-time = "2026-09-29T00:54:47.486Z" }, + { url = "https://files.pythonhosted.org/packages/77/74/50cd550ccc1a517b9ed62347625c01ddf8c4afad66490312677c011458f6/librt-0.16.0-cp315-cp315t-manylinux2014_i686.manylinux_2_17_i686.manylinux_2_28_i686.whl", hash = "sha256:a33e0dae1f8592146a4764d54ce842b278732d21a84e17c3bbe6b1bc158a2248", size = 681106, upload-time = "2026-09-29T00:54:49.126Z" }, + { url = "https://files.pythonhosted.org/packages/df/5d/7293f712975ee6fdd2251411fd9ef1c62bc99c7b83ecbe62dbc999b1fab7/librt-0.16.0-cp315-cp315t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:47ada6ea32636492c61aa8ad27ae3b9404bfe7a97e3ba946d1984236cc741da0", size = 705921, upload-time = "2026-09-29T00:54:50.905Z" }, + { url = "https://files.pythonhosted.org/packages/67/f7/8aab946f11d59d1bece9ffc65d994b200c789a8ca5a95c17e17e609f912a/librt-0.16.0-cp315-cp315t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c43bd6e642d8a248c114327f98dd25ac5a7cb5aa168ef02f0559b91874df16b8", size = 731786, upload-time = "2026-09-29T00:54:52.584Z" }, + { url = "https://files.pythonhosted.org/packages/43/76/1c42ab31e7cb8384ebf6d3af607213c495222474f4940443ae7639ab7685/librt-0.16.0-cp315-cp315t-manylinux_2_34_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c3d1bb7841a816ace6449bb26d3f9560dbfa20e71c568d23f0f62bf1e68f50b1", size = 744964, upload-time = "2026-09-29T00:54:54.217Z" }, + { url = "https://files.pythonhosted.org/packages/6f/2e/4b19982d933d2dfced671e840b219e4c1cd3f507df6e6dabb51bbd4e3850/librt-0.16.0-cp315-cp315t-musllinux_1_2_aarch64.whl", hash = "sha256:3931f7a3db322e7f44e02a280e3949326ce9579ad388ee8d691dc7c76da9fb70", size = 765305, upload-time = "2026-09-29T00:54:55.815Z" }, + { url = "https://files.pythonhosted.org/packages/b8/1b/e872583de2dcb3ac7746e7a2321aeeb168274f3952a87dc66e05ddb29faf/librt-0.16.0-cp315-cp315t-musllinux_1_2_i686.whl", hash = "sha256:f4462528b6000afe8f16907b5c7c2553abf1df005ba5140e6eb394541c3624c3", size = 744959, upload-time = "2026-09-29T00:54:57.532Z" }, + { url = "https://files.pythonhosted.org/packages/10/de/a18c6bcfb297af2674233e90b3c3661c3a0af0f1434a0c966d2ef708a835/librt-0.16.0-cp315-cp315t-musllinux_1_2_ppc64le.whl", hash = "sha256:80039ba9b6a7d5f1a0175a4cca6bbefead87bd854c80abad1cb30afe47a830db", size = 758138, upload-time = "2026-09-29T00:54:59.484Z" }, + { url = "https://files.pythonhosted.org/packages/22/1c/0df1d732539c297bb1a093e1fe3204d2faf76a9022cf4e1d1c2fce059790/librt-0.16.0-cp315-cp315t-musllinux_1_2_riscv64.whl", hash = "sha256:7a1d272724b581bb6bc769dfdafed6da2ecc9886ba2450311de55a4ac2e1e9cd", size = 744268, upload-time = "2026-09-29T00:55:01.179Z" }, + { url = "https://files.pythonhosted.org/packages/a2/f7/ccaf31331f20c91a5bd9bd48ffc3f743f9c81bb5720cc7b2a720ca204f0a/librt-0.16.0-cp315-cp315t-musllinux_1_2_x86_64.whl", hash = "sha256:fbe4fb8c5445f7496d7f7f6bb0807875d09d47e6771ffa175fb2df2895fb86ba", size = 785783, upload-time = "2026-09-29T00:55:02.938Z" }, + { url = "https://files.pythonhosted.org/packages/c1/ea/7421d9e6db894cd6cd788b604b3394a163ded6b942052b6f96c23ccf08e1/librt-0.16.0-cp315-cp315t-win32.whl", hash = "sha256:375bfe6b572a8f6cfc398709356046173bf27e64c4c5edaf5f7062f051fb4bf9", size = 104355, upload-time = "2026-09-29T00:55:04.533Z" }, + { url = "https://files.pythonhosted.org/packages/85/6d/7c31a506eb847bc58aeb2402d58e17605e821f68ab5df5e66fe274a6df41/librt-0.16.0-cp315-cp315t-win_amd64.whl", hash = "sha256:bd3150023d3dc2bc70f3784e59ffa1140d56ddba3d8125b3d6f9f85221279bfc", size = 126134, upload-time = "2026-09-29T00:55:06.017Z" }, + { url = "https://files.pythonhosted.org/packages/36/69/7a5d10ac409c4da0355e054a14371871da9b5557fcc42772cd00181c6cce/librt-0.16.0-cp315-cp315t-win_arm64.whl", hash = "sha256:8ceafb70f2a4f0826f11031942e59c0728fd98da112dc346d4352bde1e486866", size = 116391, upload-time = "2026-09-29T00:55:07.484Z" }, ] [[package]] name = "markdown-it-py" -version = "4.0.0" +version = "4.3.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "mdurl" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/5b/f5/4ec618ed16cc4f8fb3b701563655a69816155e79e24a17b651541804721d/markdown_it_py-4.0.0.tar.gz", hash = "sha256:cb0a2b4aa34f932c007117b194e945bd74e0ec24133ceb5bac59009cda1cb9f3", size = 73070, upload-time = "2025-08-11T12:57:52.854Z" } +sdist = { url = "https://files.pythonhosted.org/packages/16/fc/cee2c45553c9a9bf77d8b0c391560c556d7ed756b1f0bb35eb5d48db09ea/markdown_it_py-4.3.0.tar.gz", hash = "sha256:91a58fa5b72c71a40cf7177250fd767480d7a2bb3ac426ccfb76fb90305fdaaa", size = 242701, upload-time = "2026-11-10T16:18:30.467Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/94/54/e7d793b573f298e1c9013b8c4dade17d481164aa517d1d7148619c2cedbf/markdown_it_py-4.0.0-py3-none-any.whl", hash = "sha256:87327c59b172c5011896038353a81343b6754500a08cd7a4973bb48c6d578147", size = 87321, upload-time = "2025-08-11T12:57:51.923Z" }, + { url = "https://files.pythonhosted.org/packages/c9/31/5f0ac2f1a1c67423c995c731a11cd4ad05d081a2be969d74f868bdb9cc70/markdown_it_py-4.3.0-py3-none-any.whl", hash = "sha256:7aa1511a46c39138de78d9eba92ce47e63124d8003fc98b3a351909e04239efa", size = 96951, upload-time = "2026-11-10T16:18:28.975Z" }, ] [[package]] @@ -172,27 +361,105 @@ wheels = [ { url = "https://files.pythonhosted.org/packages/b3/38/89ba8ad64ae25be8de66a6d463314cf1eb366222074cfda9ee839c56a4b4/mdurl-0.1.2-py3-none-any.whl", hash = "sha256:84008a41e51615a49fc9966191ff91509e3c40b939176e643fd50a5c2196b8f8", size = 9979, upload-time = "2022-08-14T12:40:09.779Z" }, ] +[[package]] +name = "mypy" +version = "2.4.1" +source = { registry = "https://pypi.org/simple" } +dependencies = [ + { name = "ast-serialize" }, + { name = "librt", marker = "platform_python_implementation != 'PyPy'" }, + { name = "mypy-extensions" }, + { name = "pathspec" }, + { name = "typing-extensions" }, +] +sdist = { url = "https://files.pythonhosted.org/packages/4a/3c/78ecece71ee4b5445389a4ccd11627cfb9c69e4de554d11060171f376305/mypy-2.4.1.tar.gz", hash = "sha256:63b590965691e540a335fa74dadf31a7069142f6b72e234689bbd244edf55623", size = 4066728, upload-time = "2026-10-28T19:23:13.286Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/4b/8b/2bc7f489528db504221ad7eff6b3f83979ee57d066103c72a85d09046a30/mypy-2.4.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:79a1e79199e980fb41f219cb3d4746d25c64b0b623840d3ed57df1cdc13a6502", size = 14321495, upload-time = "2026-10-28T19:21:16.612Z" }, + { url = "https://files.pythonhosted.org/packages/18/9a/b2f037b4982dce33645296e4394b031ade60f697f468761fa3ea8e2f8ece/mypy-2.4.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4e18d0da3898b3bcd16192f15a206e7b8b8dd0f4a0b3e51aa5bd5c2afe749e2c", size = 14467468, upload-time = "2026-10-28T19:22:10.629Z" }, + { url = "https://files.pythonhosted.org/packages/c4/5a/379f9bfa18bf3f8d43668fbd9ae4f2922dd027a559c461ca9d41cde1d32e/mypy-2.4.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b69a15fc2e75858d6b15e91ed3a0dcff1a533265183b64734138791fe0f49aa5", size = 15421496, upload-time = "2026-10-28T19:22:48.005Z" }, + { url = "https://files.pythonhosted.org/packages/83/50/3bde18a2824ec296432cebe01752ccd0ab8a2ad784abe4390040d019b3bf/mypy-2.4.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:70971cc0bcb1d3f03d2eb68fa430a6481ccc03558dc001d9534d7e5fa274c392", size = 15670425, upload-time = "2026-10-28T19:21:57.026Z" }, + { url = "https://files.pythonhosted.org/packages/6a/36/8b722b88c325d317354de7d10d8fb9d4dc0f958433e873a91fc4ed21a06e/mypy-2.4.1-cp311-cp311-win_amd64.whl", hash = "sha256:6f7225951a277dd0d6add900731d487174b7d24ac133c09d670ed63b4d8cb90d", size = 11300972, upload-time = "2026-10-28T19:21:48.724Z" }, + { url = "https://files.pythonhosted.org/packages/c2/d6/fb2bab1245658d68af8abfe776362a780c621fe0f364f2c7b53039a945ee/mypy-2.4.1-cp311-cp311-win_arm64.whl", hash = "sha256:be4c03f33c55500191df2ed4a9b5e7edbdd1fff067fe361a5a9b1b5d3262da6e", size = 10873349, upload-time = "2026-10-28T19:21:32.104Z" }, + { url = "https://files.pythonhosted.org/packages/c0/1a/0be9dc6af5e0e04128f18a5e36b4ca44bfb0085857d37aa6a7de1ac2b0cb/mypy-2.4.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:d63737426a048a27705a4eedb828669f4bc0873612a1b46b0b9fe892b2ebaaaf", size = 14381321, upload-time = "2026-10-28T19:21:54.223Z" }, + { url = "https://files.pythonhosted.org/packages/0d/a6/7907e36711a8a8c703f961f076fab61793383694140bd1fd87589f3f68d4/mypy-2.4.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7344869cad05f073b8cae2826774fa0161e3eb2f5c685b76813574008d77d750", size = 14466373, upload-time = "2026-10-28T19:22:25.211Z" }, + { url = "https://files.pythonhosted.org/packages/5d/b8/7313212b29de570c25c9859d7c8e4ef2251a6d34338a1e20031d94297721/mypy-2.4.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a20ff6cd2af7a670c64f089bfa5fbcebe8ff3bf896c5e6ac7c9862c7960e4494", size = 15553666, upload-time = "2026-10-28T19:22:36.511Z" }, + { url = "https://files.pythonhosted.org/packages/23/8f/92966b6082ff49da9142e1e527eb9af4359a9a61632a1cfc313da96b37fe/mypy-2.4.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:9ed1195502cca32be5ef756b1693477f4991db2f2e34eaa90cc4ad6bea4f9531", size = 15802641, upload-time = "2026-10-28T19:21:13.421Z" }, + { url = "https://files.pythonhosted.org/packages/b6/b4/874f6fd54b005020ad63e2cf7a59b178d16a771d478849b29b842cb0cf14/mypy-2.4.1-cp312-cp312-win_amd64.whl", hash = "sha256:4c194c5d878130fca1ae662dfb1feb6274afbab0b40032c80147377e0ea803d5", size = 11383067, upload-time = "2026-10-28T19:22:03.516Z" }, + { url = "https://files.pythonhosted.org/packages/b0/41/5ae8e6528c2faa96e4a921a999d2c7ac7c565bee184b4282bf62ffa76b5d/mypy-2.4.1-cp312-cp312-win_arm64.whl", hash = "sha256:71eda06e5bae51976ce869fda429159c9cec678bd02f25bb197f0265c8f991be", size = 10946882, upload-time = "2026-10-28T19:21:39.51Z" }, + { url = "https://files.pythonhosted.org/packages/6a/65/cd19bc06b67d2df4828220245fd98569ba40fac00c60ba48bef1817d8ac3/mypy-2.4.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:3f1613bfe6726169a5680ec3dad5fe1f6d96285c12aded51ad432eadedd39d45", size = 14214179, upload-time = "2026-10-28T19:22:27.49Z" }, + { url = "https://files.pythonhosted.org/packages/c9/db/4d54ca4f49a0113d0c956980272aefdc6eec5458f7a72b350785b9ef2249/mypy-2.4.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:680ba5d9f0e3fe0c746b3d14df15f2a718e4bc308a1145616a1ea691ce7c354b", size = 14376217, upload-time = "2026-10-28T19:21:08.019Z" }, + { url = "https://files.pythonhosted.org/packages/a2/45/089b4724b85f0f408941be5298f817ee89181c1ce031a73d60ebb150c2c7/mypy-2.4.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1fb70621535c22fd4b1a0450d37ed1d6c5eb39656a1cebfb189084c12de54ba7", size = 15467623, upload-time = "2026-10-28T19:21:21.555Z" }, + { url = "https://files.pythonhosted.org/packages/27/4c/15edbc64b0b1412bfe94c74192b3b56554ab642b85a31bb06cef6313101f/mypy-2.4.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:4af5ad558033bf71a44a1be149ed61633522824f84c1b6bc2445d3fe2d2a5296", size = 15729867, upload-time = "2026-10-28T19:21:37.557Z" }, + { url = "https://files.pythonhosted.org/packages/76/5b/7d160fb685994b65b0ca86d352f3afb5424f96a9e6914719f7b861fb6701/mypy-2.4.1-cp313-cp313-win_amd64.whl", hash = "sha256:acdd82cb3a2eb10720e87706a128d75785d005a8c47e36a4973221524f41fc56", size = 11390802, upload-time = "2026-10-28T19:22:18.081Z" }, + { url = "https://files.pythonhosted.org/packages/9a/ea/453d27f8d531f57c5f14aa73094eaa48e3fb77f680bdede2045cb64fa58b/mypy-2.4.1-cp313-cp313-win_arm64.whl", hash = "sha256:133886ef1a7a8cf673df55d865e41580c6c46aa9b8e31e1325dfe315c038f745", size = 10950427, upload-time = "2026-10-28T19:22:59.003Z" }, + { url = "https://files.pythonhosted.org/packages/7d/75/282d43d6fea7be984ac63e75ffd8eee146ba2f3b077bb1ca5bf3f973e0c4/mypy-2.4.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c45485061ba08f700acc12cfc8b177e6997e6bc353605babfc0abb081e079456", size = 14233251, upload-time = "2026-10-28T19:22:44.977Z" }, + { url = "https://files.pythonhosted.org/packages/ac/a8/9021263cc7e761451c7d8131bdfab3c0a5c2d67aa2d694670019e1ab86a7/mypy-2.4.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:727890a32f1858c09549eb55a8b234fe990d460450b28f03e8213ef925f1247c", size = 14394953, upload-time = "2026-10-28T19:21:29.492Z" }, + { url = "https://files.pythonhosted.org/packages/16/10/4192a5cea09ebbc41c534f57bd0d8f0fb42a8e810632cda6e37f072c59fd/mypy-2.4.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:beb254fec368c4e7f7f82a5f310c6470b893ec88a90b66426da971c6826b0453", size = 15442824, upload-time = "2026-10-28T19:22:42.068Z" }, + { url = "https://files.pythonhosted.org/packages/99/e6/d3b0a7474aa4f696594a47a218b6796d9c4346fc81ed288904278cddd9bd/mypy-2.4.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ec416d5d2ae689e681f5727e328723f18d8b5dc8c903a146b7851dc5727aad8a", size = 15717227, upload-time = "2026-10-28T19:22:54.026Z" }, + { url = "https://files.pythonhosted.org/packages/48/6a/2ec530dacd4f77ca50d0fa05b854098f2d75e5d18c587d2612b44f10d68c/mypy-2.4.1-cp314-cp314-pyemscripten_2026_0_wasm32.whl", hash = "sha256:0e95ad0bec03ced9a73b42514208abd24c789e67f0e1eba476e276dd7a2dea3a", size = 7898637, upload-time = "2026-10-28T19:21:41.709Z" }, + { url = "https://files.pythonhosted.org/packages/cc/56/de9d7bad12e3868d5f1f4279aed20b1b568b2c5e166f2d3a05b211dca0b1/mypy-2.4.1-cp314-cp314-win_amd64.whl", hash = "sha256:51f742d4154824837ca6e92aa81f00eec222700a3c337bd258e5562a3880d75a", size = 11576656, upload-time = "2026-10-28T19:22:13.232Z" }, + { url = "https://files.pythonhosted.org/packages/b8/12/4fa9883b9b59e5c96ff62845ad019dc47786031c45d67eaccf452cffffd8/mypy-2.4.1-cp314-cp314-win_arm64.whl", hash = "sha256:f44dd4c5ab22df21206dd926c98381ebdbf5bfd696df37dd38ded2d23143fcb6", size = 11174403, upload-time = "2026-10-28T19:23:01.346Z" }, + { url = "https://files.pythonhosted.org/packages/3f/f2/827e356fc4f74c60b8da42663336e035b49d948a3c11224b0fc7543086b1/mypy-2.4.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:2875280687e64740e6ddcef43bd4c5852ad45ff34549740f6aea3f0373870b93", size = 15713427, upload-time = "2026-10-28T19:21:26.757Z" }, + { url = "https://files.pythonhosted.org/packages/a2/fa/e58a4fcae1d238189eac758036c0921992a86e3e6209190efd96d61fc5d4/mypy-2.4.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ea0714d2bccaf6d010c970e1d3ba2c9c2add79d2030aad2ef03167d788948276", size = 15938481, upload-time = "2026-10-28T19:22:34.371Z" }, + { url = "https://files.pythonhosted.org/packages/a1/54/a20f881801b88900923f2be1541a4b438ad0f0883e03836641fdc3d7adf4/mypy-2.4.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:63c6ff0e7ea546943001a91639c9f0c64b60d239268fa5d29e4a6c87f82c2373", size = 17243006, upload-time = "2026-10-28T19:22:39.425Z" }, + { url = "https://files.pythonhosted.org/packages/de/1c/ff84a6133a6e89c390bff6b25d9bad6598e7891b205f4b30b496906d636d/mypy-2.4.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:a5b5da107dc2c93fb0a22f7a45dbaea5dc131afc7056b5468d78e819f9a138e6", size = 17557728, upload-time = "2026-10-28T19:21:43.607Z" }, + { url = "https://files.pythonhosted.org/packages/15/4a/effa47d39b8fadf679c08e7c78559e523f9769a42a75662d2d15b2b9cdd6/mypy-2.4.1-cp314-cp314t-win_amd64.whl", hash = "sha256:c3a4d0c47053cc90035dd3a2c321112b593ad42935d0cbfd747288e1564fa8ca", size = 12370826, upload-time = "2026-10-28T19:22:29.779Z" }, + { url = "https://files.pythonhosted.org/packages/46/9f/b214ececb1a97fbb61ab3dfd48ae3cffd92ae2c148af4c9dc94c6c56772b/mypy-2.4.1-cp314-cp314t-win_arm64.whl", hash = "sha256:0c5bf267645351887b72903fd2f5fbddcf85234e0e6c4ad94e2fcfb4f0c3f971", size = 11851083, upload-time = "2026-10-28T19:23:11.288Z" }, + { url = "https://files.pythonhosted.org/packages/57/5b/e44a2edb0b25a9f1429de770e1d0238af23302671dd40c77ac5efeb0c559/mypy-2.4.1-cp315-cp315-macosx_11_0_arm64.whl", hash = "sha256:db599d03e7d60d15f2e0a11665c18bc52a88699fcab990fdf8cecd5be8ac801c", size = 14243144, upload-time = "2026-10-28T19:21:10.975Z" }, + { url = "https://files.pythonhosted.org/packages/59/d4/5c99dc3a28e11d2f0fcbb02df63d2d3e574dedc0f9f69d50901df305a7a6/mypy-2.4.1-cp315-cp315-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c6c7210e40dd423af7d65cbe428b5906d11dc60659337bdae4e5fdf02ce32ed7", size = 14409316, upload-time = "2026-10-28T19:22:15.515Z" }, + { url = "https://files.pythonhosted.org/packages/c3/c9/3108b38f4c30eabd80194f5d9771a87e27196c5e0ddb5bf4b99c6ed1e97e/mypy-2.4.1-cp315-cp315-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a2d4a51db92059eecc2c33b2a5194b28585ebfd917292c015fe87a77dbff6cd2", size = 15445573, upload-time = "2026-10-28T19:22:05.635Z" }, + { url = "https://files.pythonhosted.org/packages/dd/12/84a53eceaf11c46dfd7931fb6b8902d01fb33787d3a991e81c461458150b/mypy-2.4.1-cp315-cp315-musllinux_1_2_x86_64.whl", hash = "sha256:01b7718552d017f88d1151f3cc9d6556d778a90bd58060a2c3d87d070f9099fb", size = 15732989, upload-time = "2026-10-28T19:23:06.512Z" }, + { url = "https://files.pythonhosted.org/packages/65/ba/bf017dc2abdf83b2f74e29c43834b7af67dc1f1b20202f02dae60b4781a0/mypy-2.4.1-cp315-cp315-pyemscripten_2026_5_wasm32.whl", hash = "sha256:3467b1d13000812ab85dc2a3834b9379ec77798ca1bcabe434e23fb21fead692", size = 7898932, upload-time = "2026-10-28T19:21:59.366Z" }, + { url = "https://files.pythonhosted.org/packages/76/05/0c22b1f0390120a8592d31209cb6b9f932b6a0b426fe643e550de15139e3/mypy-2.4.1-cp315-cp315-win_amd64.whl", hash = "sha256:080cf64a60b90a73435542feecf4171904cc5710658165b40c6869115d4aa100", size = 11577577, upload-time = "2026-10-28T19:22:01.302Z" }, + { url = "https://files.pythonhosted.org/packages/73/fb/ac01e173629697ddac2f11e51efd10347d673f9a7311b03f4aba710ebccd/mypy-2.4.1-cp315-cp315-win_arm64.whl", hash = "sha256:f9118a3f50de264b614861bb11814833a742138ac3c8e2e49a860b6977fb2704", size = 11173540, upload-time = "2026-10-28T19:21:46.444Z" }, + { url = "https://files.pythonhosted.org/packages/5b/e4/b9b9c8eb09e70927ee65b1456cfed35710b6e4ff0b07f364ceaf2202307c/mypy-2.4.1-cp315-cp315t-macosx_11_0_arm64.whl", hash = "sha256:9d7dafd56179d296651df9e1844b91c9517c379398f017a2a435d077a28943c1", size = 15706623, upload-time = "2026-10-28T19:22:20.528Z" }, + { url = "https://files.pythonhosted.org/packages/26/74/1ceb1ca884add0565e618d013dd24333039100dc0fcc42661561f2e1cae5/mypy-2.4.1-cp315-cp315t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d923cec43316f0e6736b8298fd00abeaaf348a091c20e7296b3aebceecb63eca", size = 15944095, upload-time = "2026-10-28T19:21:04.779Z" }, + { url = "https://files.pythonhosted.org/packages/2b/68/27bcf9b4efa22733b6050485ae37845b94c9b8851abe4fc60632d905c32d/mypy-2.4.1-cp315-cp315t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d6e081b466e88d4343adffe11aff0f02df34b5b9070b4b700053a0b7294c0be1", size = 17223065, upload-time = "2026-10-28T19:23:03.724Z" }, + { url = "https://files.pythonhosted.org/packages/1a/a3/ed5724b317bf585c29f3c8be2792e97d45925d65a9c8af40ceeb267072e6/mypy-2.4.1-cp315-cp315t-musllinux_1_2_x86_64.whl", hash = "sha256:70196470ac300f444a302a738541101893c2c57804078b33690286a7899149e9", size = 17560589, upload-time = "2026-10-28T19:21:34.539Z" }, + { url = "https://files.pythonhosted.org/packages/42/2f/005185e6ab4752fd6cc2d1a6d1421fe21979770afe2490c00c555f34a913/mypy-2.4.1-cp315-cp315t-win_amd64.whl", hash = "sha256:de95648e0a6d46fa9929b956ed2c87c5dc9933d4d59945e6390e9d753c74e7c1", size = 12353324, upload-time = "2026-10-28T19:22:51.481Z" }, + { url = "https://files.pythonhosted.org/packages/a1/d6/20420cc9c780087139662534d128c2f3274361f8bb7e9cf0d5495a846ed5/mypy-2.4.1-cp315-cp315t-win_arm64.whl", hash = "sha256:ef8d5be90032261197ac388d945d8ff4f476c95880798a1911760af64ddfe71f", size = 11845599, upload-time = "2026-10-28T19:22:23.136Z" }, + { url = "https://files.pythonhosted.org/packages/21/5c/6e8010f8f2c4ad817364592d4b3883633417269b913fc9d5174fdeb7e565/mypy-2.4.1-py3-none-any.whl", hash = "sha256:1784648d6ec8c2b5465e3f26241b845a0b3cb4e56c993c64abe16989e7698999", size = 2801286, upload-time = "2026-10-28T19:21:19.516Z" }, +] + +[[package]] +name = "mypy-extensions" +version = "1.2.0" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/d0/6f/43edf3be2748d0e40974a5ee046a8bb4c9961a4bdd3e7d5c6dcbf32d1af6/mypy_extensions-1.2.0.tar.gz", hash = "sha256:c6e275a07f1c2fc096b62940452d0eaa3f3af7de45d704787866240a7c6d5a51", size = 6566, upload-time = "2026-11-03T16:26:33.692Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/b5/99/7b1adac7e97ce7bbda34792dc6e9b2f5cc5cffd1875883f78a818b2a2687/mypy_extensions-1.2.0-py3-none-any.whl", hash = "sha256:993e7a20aa5671eb41a7132cf555af30062da99729601601b9a8382b11cae768", size = 5114, upload-time = "2026-11-03T16:26:32.731Z" }, +] + [[package]] name = "packaging" -version = "25.0" +version = "26.3" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/a1/d4/1fc4078c65507b51b96ca8f8c3ba19e6a61c8253c72794544580a7b6c24d/packaging-25.0.tar.gz", hash = "sha256:d443872c98d677bf60f6a1f2f8c1cb748e8fe762d2bf9d3148b5599295b0fc4f", size = 165727, upload-time = "2025-04-19T11:48:59.673Z" } +sdist = { url = "https://files.pythonhosted.org/packages/7d/fa/3944b40b07da9ce895c0e6303a5ab7d53da063554f534556b134a54d6093/packaging-26.3.tar.gz", hash = "sha256:94edc256424af38762eb31306eed28beb9f0efc50a8837492c9d6fd6004aed79", size = 313412, upload-time = "2026-08-04T18:15:28.737Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/20/12/38679034af332785aac8774540895e234f4d07f7545804097de4b666afd8/packaging-25.0-py3-none-any.whl", hash = "sha256:29572ef2b1f17581046b3a2227d5c611fb25ec70ca1ba8554b24b0e69331a484", size = 66469, upload-time = "2025-04-19T11:48:57.875Z" }, + { url = "https://files.pythonhosted.org/packages/63/34/ba1c580383c9eada3711951fef0795c80b829a078d72188184bcab9dd527/packaging-26.3-py3-none-any.whl", hash = "sha256:d7193f7c8e4e93f444fde0262bf90af30e16fa0ad0ad44cb553c87339b23cd1c", size = 129956, upload-time = "2026-08-04T18:15:27.159Z" }, +] + +[[package]] +name = "pathspec" +version = "1.1.1" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/5a/82/42f767fc1c1143d6fd36efb827202a2d997a375e160a71eb2888a925aac1/pathspec-1.1.1.tar.gz", hash = "sha256:17db5ecd524104a120e173814c90367a96a98d07c45b2e10c2f3919fff91bf5a", size = 135180, upload-time = "2026-04-27T01:46:08.907Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/f1/d9/7fb5aa316bc299258e68c73ba3bddbc499654a07f151cba08f6153988714/pathspec-1.1.1-py3-none-any.whl", hash = "sha256:a00ce642f577bf7f473932318056212bc4f8bfdf53128c78bbd5af0b9b20b189", size = 57328, upload-time = "2026-04-27T01:46:07.06Z" }, ] [[package]] name = "pluggy" -version = "1.6.0" +version = "1.7.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" } +sdist = { url = "https://files.pythonhosted.org/packages/bf/db/7fc19e6f2dc92a966727031389fc2e08b558f0f25eb7403c1119ad4713cd/pluggy-1.7.0.tar.gz", hash = "sha256:d1eaa46ebb595891b860ab086b4d09c8588af65ebd4361b8e8f4bb8920b90ba8", size = 123304, upload-time = "2026-10-15T09:50:58.343Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" }, + { url = "https://files.pythonhosted.org/packages/40/9e/2b38731e0fc536806f16490e1a12d7f0dc2a1235aa8cc07bcc75416a7daa/pluggy-1.7.0-py3-none-any.whl", hash = "sha256:7dd7b0d8832ba3cb632c306926ded123429211b83641b35dc5c41ad2d34f9bec", size = 27082, upload-time = "2026-10-15T09:50:56.808Z" }, ] [[package]] name = "pydantic" -version = "2.12.5" +version = "2.14.3" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "annotated-types" }, @@ -200,120 +467,159 @@ dependencies = [ { name = "typing-extensions" }, { name = "typing-inspection" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/69/44/36f1a6e523abc58ae5f928898e4aca2e0ea509b5aa6f6f392a5d882be928/pydantic-2.12.5.tar.gz", hash = "sha256:4d351024c75c0f085a9febbb665ce8c0c6ec5d30e903bdb6394b7ede26aebb49", size = 821591, upload-time = "2025-11-26T15:11:46.471Z" } +sdist = { url = "https://files.pythonhosted.org/packages/b4/fc/1203d011145c98ddce3cd2f505bb54375ef8d43223053df6bfcf3c746f46/pydantic-2.14.3.tar.gz", hash = "sha256:1054f237f4d4733e5a30e1e2333bd33a2004ab9ab1510bd053a9a31bb48e232d", size = 925636, upload-time = "2026-11-05T09:17:04.686Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/5a/87/b70ad306ebb6f9b585f114d0ac2137d792b48be34d732d60e597c2f8465a/pydantic-2.12.5-py3-none-any.whl", hash = "sha256:e561593fccf61e8a20fc46dfc2dfe075b8be7d0188df33f221ad1f0139180f9d", size = 463580, upload-time = "2025-11-26T15:11:44.605Z" }, + { url = "https://files.pythonhosted.org/packages/72/b8/b864503789ef5c58597d2a7b4adbee62c26440ab1e682581fc6838df8947/pydantic-2.14.3-py3-none-any.whl", hash = "sha256:3f7b347782ab7e4cf4c798496ae3a82787d9f21ec12676a9c564355eeef8daa8", size = 494071, upload-time = "2026-11-05T09:17:02.426Z" }, ] [[package]] name = "pydantic-core" -version = "2.41.5" +version = "2.50.4" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "typing-extensions" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/71/70/23b021c950c2addd24ec408e9ab05d59b035b39d97cdc1130e1bce647bb6/pydantic_core-2.41.5.tar.gz", hash = "sha256:08daa51ea16ad373ffd5e7606252cc32f07bc72b28284b6bc9c6df804816476e", size = 460952, upload-time = "2025-11-04T13:43:49.098Z" } -wheels = [ - { url = "https://files.pythonhosted.org/packages/e8/72/74a989dd9f2084b3d9530b0915fdda64ac48831c30dbf7c72a41a5232db8/pydantic_core-2.41.5-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:a3a52f6156e73e7ccb0f8cced536adccb7042be67cb45f9562e12b319c119da6", size = 2105873, upload-time = "2025-11-04T13:39:31.373Z" }, - { url = "https://files.pythonhosted.org/packages/12/44/37e403fd9455708b3b942949e1d7febc02167662bf1a7da5b78ee1ea2842/pydantic_core-2.41.5-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:7f3bf998340c6d4b0c9a2f02d6a400e51f123b59565d74dc60d252ce888c260b", size = 1899826, upload-time = "2025-11-04T13:39:32.897Z" }, - { url = "https://files.pythonhosted.org/packages/33/7f/1d5cab3ccf44c1935a359d51a8a2a9e1a654b744b5e7f80d41b88d501eec/pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:378bec5c66998815d224c9ca994f1e14c0c21cb95d2f52b6021cc0b2a58f2a5a", size = 1917869, upload-time = "2025-11-04T13:39:34.469Z" }, - { url = "https://files.pythonhosted.org/packages/6e/6a/30d94a9674a7fe4f4744052ed6c5e083424510be1e93da5bc47569d11810/pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:e7b576130c69225432866fe2f4a469a85a54ade141d96fd396dffcf607b558f8", size = 2063890, upload-time = "2025-11-04T13:39:36.053Z" }, - { url = "https://files.pythonhosted.org/packages/50/be/76e5d46203fcb2750e542f32e6c371ffa9b8ad17364cf94bb0818dbfb50c/pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:6cb58b9c66f7e4179a2d5e0f849c48eff5c1fca560994d6eb6543abf955a149e", size = 2229740, upload-time = "2025-11-04T13:39:37.753Z" }, - { url = "https://files.pythonhosted.org/packages/d3/ee/fed784df0144793489f87db310a6bbf8118d7b630ed07aa180d6067e653a/pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:88942d3a3dff3afc8288c21e565e476fc278902ae4d6d134f1eeda118cc830b1", size = 2350021, upload-time = "2025-11-04T13:39:40.94Z" }, - { url = "https://files.pythonhosted.org/packages/c8/be/8fed28dd0a180dca19e72c233cbf58efa36df055e5b9d90d64fd1740b828/pydantic_core-2.41.5-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f31d95a179f8d64d90f6831d71fa93290893a33148d890ba15de25642c5d075b", size = 2066378, upload-time = "2025-11-04T13:39:42.523Z" }, - { url = "https://files.pythonhosted.org/packages/b0/3b/698cf8ae1d536a010e05121b4958b1257f0b5522085e335360e53a6b1c8b/pydantic_core-2.41.5-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:c1df3d34aced70add6f867a8cf413e299177e0c22660cc767218373d0779487b", size = 2175761, upload-time = "2025-11-04T13:39:44.553Z" }, - { url = "https://files.pythonhosted.org/packages/b8/ba/15d537423939553116dea94ce02f9c31be0fa9d0b806d427e0308ec17145/pydantic_core-2.41.5-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:4009935984bd36bd2c774e13f9a09563ce8de4abaa7226f5108262fa3e637284", size = 2146303, upload-time = "2025-11-04T13:39:46.238Z" }, - { url = "https://files.pythonhosted.org/packages/58/7f/0de669bf37d206723795f9c90c82966726a2ab06c336deba4735b55af431/pydantic_core-2.41.5-cp311-cp311-musllinux_1_1_armv7l.whl", hash = "sha256:34a64bc3441dc1213096a20fe27e8e128bd3ff89921706e83c0b1ac971276594", size = 2340355, upload-time = "2025-11-04T13:39:48.002Z" }, - { url = "https://files.pythonhosted.org/packages/e5/de/e7482c435b83d7e3c3ee5ee4451f6e8973cff0eb6007d2872ce6383f6398/pydantic_core-2.41.5-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:c9e19dd6e28fdcaa5a1de679aec4141f691023916427ef9bae8584f9c2fb3b0e", size = 2319875, upload-time = "2025-11-04T13:39:49.705Z" }, - { url = "https://files.pythonhosted.org/packages/fe/e6/8c9e81bb6dd7560e33b9053351c29f30c8194b72f2d6932888581f503482/pydantic_core-2.41.5-cp311-cp311-win32.whl", hash = "sha256:2c010c6ded393148374c0f6f0bf89d206bf3217f201faa0635dcd56bd1520f6b", size = 1987549, upload-time = "2025-11-04T13:39:51.842Z" }, - { url = "https://files.pythonhosted.org/packages/11/66/f14d1d978ea94d1bc21fc98fcf570f9542fe55bfcc40269d4e1a21c19bf7/pydantic_core-2.41.5-cp311-cp311-win_amd64.whl", hash = "sha256:76ee27c6e9c7f16f47db7a94157112a2f3a00e958bc626e2f4ee8bec5c328fbe", size = 2011305, upload-time = "2025-11-04T13:39:53.485Z" }, - { url = "https://files.pythonhosted.org/packages/56/d8/0e271434e8efd03186c5386671328154ee349ff0354d83c74f5caaf096ed/pydantic_core-2.41.5-cp311-cp311-win_arm64.whl", hash = "sha256:4bc36bbc0b7584de96561184ad7f012478987882ebf9f9c389b23f432ea3d90f", size = 1972902, upload-time = "2025-11-04T13:39:56.488Z" }, - { url = "https://files.pythonhosted.org/packages/5f/5d/5f6c63eebb5afee93bcaae4ce9a898f3373ca23df3ccaef086d0233a35a7/pydantic_core-2.41.5-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:f41a7489d32336dbf2199c8c0a215390a751c5b014c2c1c5366e817202e9cdf7", size = 2110990, upload-time = "2025-11-04T13:39:58.079Z" }, - { url = "https://files.pythonhosted.org/packages/aa/32/9c2e8ccb57c01111e0fd091f236c7b371c1bccea0fa85247ac55b1e2b6b6/pydantic_core-2.41.5-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:070259a8818988b9a84a449a2a7337c7f430a22acc0859c6b110aa7212a6d9c0", size = 1896003, upload-time = "2025-11-04T13:39:59.956Z" }, - { url = "https://files.pythonhosted.org/packages/68/b8/a01b53cb0e59139fbc9e4fda3e9724ede8de279097179be4ff31f1abb65a/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e96cea19e34778f8d59fe40775a7a574d95816eb150850a85a7a4c8f4b94ac69", size = 1919200, upload-time = "2025-11-04T13:40:02.241Z" }, - { url = "https://files.pythonhosted.org/packages/38/de/8c36b5198a29bdaade07b5985e80a233a5ac27137846f3bc2d3b40a47360/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ed2e99c456e3fadd05c991f8f437ef902e00eedf34320ba2b0842bd1c3ca3a75", size = 2052578, upload-time = "2025-11-04T13:40:04.401Z" }, - { url = "https://files.pythonhosted.org/packages/00/b5/0e8e4b5b081eac6cb3dbb7e60a65907549a1ce035a724368c330112adfdd/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:65840751b72fbfd82c3c640cff9284545342a4f1eb1586ad0636955b261b0b05", size = 2208504, upload-time = "2025-11-04T13:40:06.072Z" }, - { url = "https://files.pythonhosted.org/packages/77/56/87a61aad59c7c5b9dc8caad5a41a5545cba3810c3e828708b3d7404f6cef/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e536c98a7626a98feb2d3eaf75944ef6f3dbee447e1f841eae16f2f0a72d8ddc", size = 2335816, upload-time = "2025-11-04T13:40:07.835Z" }, - { url = "https://files.pythonhosted.org/packages/0d/76/941cc9f73529988688a665a5c0ecff1112b3d95ab48f81db5f7606f522d3/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:eceb81a8d74f9267ef4081e246ffd6d129da5d87e37a77c9bde550cb04870c1c", size = 2075366, upload-time = "2025-11-04T13:40:09.804Z" }, - { url = "https://files.pythonhosted.org/packages/d3/43/ebef01f69baa07a482844faaa0a591bad1ef129253ffd0cdaa9d8a7f72d3/pydantic_core-2.41.5-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d38548150c39b74aeeb0ce8ee1d8e82696f4a4e16ddc6de7b1d8823f7de4b9b5", size = 2171698, upload-time = "2025-11-04T13:40:12.004Z" }, - { url = "https://files.pythonhosted.org/packages/b1/87/41f3202e4193e3bacfc2c065fab7706ebe81af46a83d3e27605029c1f5a6/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:c23e27686783f60290e36827f9c626e63154b82b116d7fe9adba1fda36da706c", size = 2132603, upload-time = "2025-11-04T13:40:13.868Z" }, - { url = "https://files.pythonhosted.org/packages/49/7d/4c00df99cb12070b6bccdef4a195255e6020a550d572768d92cc54dba91a/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:482c982f814460eabe1d3bb0adfdc583387bd4691ef00b90575ca0d2b6fe2294", size = 2329591, upload-time = "2025-11-04T13:40:15.672Z" }, - { url = "https://files.pythonhosted.org/packages/cc/6a/ebf4b1d65d458f3cda6a7335d141305dfa19bdc61140a884d165a8a1bbc7/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:bfea2a5f0b4d8d43adf9d7b8bf019fb46fdd10a2e5cde477fbcb9d1fa08c68e1", size = 2319068, upload-time = "2025-11-04T13:40:17.532Z" }, - { url = "https://files.pythonhosted.org/packages/49/3b/774f2b5cd4192d5ab75870ce4381fd89cf218af999515baf07e7206753f0/pydantic_core-2.41.5-cp312-cp312-win32.whl", hash = "sha256:b74557b16e390ec12dca509bce9264c3bbd128f8a2c376eaa68003d7f327276d", size = 1985908, upload-time = "2025-11-04T13:40:19.309Z" }, - { url = "https://files.pythonhosted.org/packages/86/45/00173a033c801cacf67c190fef088789394feaf88a98a7035b0e40d53dc9/pydantic_core-2.41.5-cp312-cp312-win_amd64.whl", hash = "sha256:1962293292865bca8e54702b08a4f26da73adc83dd1fcf26fbc875b35d81c815", size = 2020145, upload-time = "2025-11-04T13:40:21.548Z" }, - { url = "https://files.pythonhosted.org/packages/f9/22/91fbc821fa6d261b376a3f73809f907cec5ca6025642c463d3488aad22fb/pydantic_core-2.41.5-cp312-cp312-win_arm64.whl", hash = "sha256:1746d4a3d9a794cacae06a5eaaccb4b8643a131d45fbc9af23e353dc0a5ba5c3", size = 1976179, upload-time = "2025-11-04T13:40:23.393Z" }, - { url = "https://files.pythonhosted.org/packages/87/06/8806241ff1f70d9939f9af039c6c35f2360cf16e93c2ca76f184e76b1564/pydantic_core-2.41.5-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:941103c9be18ac8daf7b7adca8228f8ed6bb7a1849020f643b3a14d15b1924d9", size = 2120403, upload-time = "2025-11-04T13:40:25.248Z" }, - { url = "https://files.pythonhosted.org/packages/94/02/abfa0e0bda67faa65fef1c84971c7e45928e108fe24333c81f3bfe35d5f5/pydantic_core-2.41.5-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:112e305c3314f40c93998e567879e887a3160bb8689ef3d2c04b6cc62c33ac34", size = 1896206, upload-time = "2025-11-04T13:40:27.099Z" }, - { url = "https://files.pythonhosted.org/packages/15/df/a4c740c0943e93e6500f9eb23f4ca7ec9bf71b19e608ae5b579678c8d02f/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0cbaad15cb0c90aa221d43c00e77bb33c93e8d36e0bf74760cd00e732d10a6a0", size = 1919307, upload-time = "2025-11-04T13:40:29.806Z" }, - { url = "https://files.pythonhosted.org/packages/9a/e3/6324802931ae1d123528988e0e86587c2072ac2e5394b4bc2bc34b61ff6e/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:03ca43e12fab6023fc79d28ca6b39b05f794ad08ec2feccc59a339b02f2b3d33", size = 2063258, upload-time = "2025-11-04T13:40:33.544Z" }, - { url = "https://files.pythonhosted.org/packages/c9/d4/2230d7151d4957dd79c3044ea26346c148c98fbf0ee6ebd41056f2d62ab5/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:dc799088c08fa04e43144b164feb0c13f9a0bc40503f8df3e9fde58a3c0c101e", size = 2214917, upload-time = "2025-11-04T13:40:35.479Z" }, - { url = "https://files.pythonhosted.org/packages/e6/9f/eaac5df17a3672fef0081b6c1bb0b82b33ee89aa5cec0d7b05f52fd4a1fa/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:97aeba56665b4c3235a0e52b2c2f5ae9cd071b8a8310ad27bddb3f7fb30e9aa2", size = 2332186, upload-time = "2025-11-04T13:40:37.436Z" }, - { url = "https://files.pythonhosted.org/packages/cf/4e/35a80cae583a37cf15604b44240e45c05e04e86f9cfd766623149297e971/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:406bf18d345822d6c21366031003612b9c77b3e29ffdb0f612367352aab7d586", size = 2073164, upload-time = "2025-11-04T13:40:40.289Z" }, - { url = "https://files.pythonhosted.org/packages/bf/e3/f6e262673c6140dd3305d144d032f7bd5f7497d3871c1428521f19f9efa2/pydantic_core-2.41.5-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:b93590ae81f7010dbe380cdeab6f515902ebcbefe0b9327cc4804d74e93ae69d", size = 2179146, upload-time = "2025-11-04T13:40:42.809Z" }, - { url = "https://files.pythonhosted.org/packages/75/c7/20bd7fc05f0c6ea2056a4565c6f36f8968c0924f19b7d97bbfea55780e73/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:01a3d0ab748ee531f4ea6c3e48ad9dac84ddba4b0d82291f87248f2f9de8d740", size = 2137788, upload-time = "2025-11-04T13:40:44.752Z" }, - { url = "https://files.pythonhosted.org/packages/3a/8d/34318ef985c45196e004bc46c6eab2eda437e744c124ef0dbe1ff2c9d06b/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:6561e94ba9dacc9c61bce40e2d6bdc3bfaa0259d3ff36ace3b1e6901936d2e3e", size = 2340133, upload-time = "2025-11-04T13:40:46.66Z" }, - { url = "https://files.pythonhosted.org/packages/9c/59/013626bf8c78a5a5d9350d12e7697d3d4de951a75565496abd40ccd46bee/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:915c3d10f81bec3a74fbd4faebe8391013ba61e5a1a8d48c4455b923bdda7858", size = 2324852, upload-time = "2025-11-04T13:40:48.575Z" }, - { url = "https://files.pythonhosted.org/packages/1a/d9/c248c103856f807ef70c18a4f986693a46a8ffe1602e5d361485da502d20/pydantic_core-2.41.5-cp313-cp313-win32.whl", hash = "sha256:650ae77860b45cfa6e2cdafc42618ceafab3a2d9a3811fcfbd3bbf8ac3c40d36", size = 1994679, upload-time = "2025-11-04T13:40:50.619Z" }, - { url = "https://files.pythonhosted.org/packages/9e/8b/341991b158ddab181cff136acd2552c9f35bd30380422a639c0671e99a91/pydantic_core-2.41.5-cp313-cp313-win_amd64.whl", hash = "sha256:79ec52ec461e99e13791ec6508c722742ad745571f234ea6255bed38c6480f11", size = 2019766, upload-time = "2025-11-04T13:40:52.631Z" }, - { url = "https://files.pythonhosted.org/packages/73/7d/f2f9db34af103bea3e09735bb40b021788a5e834c81eedb541991badf8f5/pydantic_core-2.41.5-cp313-cp313-win_arm64.whl", hash = "sha256:3f84d5c1b4ab906093bdc1ff10484838aca54ef08de4afa9de0f5f14d69639cd", size = 1981005, upload-time = "2025-11-04T13:40:54.734Z" }, - { url = "https://files.pythonhosted.org/packages/ea/28/46b7c5c9635ae96ea0fbb779e271a38129df2550f763937659ee6c5dbc65/pydantic_core-2.41.5-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:3f37a19d7ebcdd20b96485056ba9e8b304e27d9904d233d7b1015db320e51f0a", size = 2119622, upload-time = "2025-11-04T13:40:56.68Z" }, - { url = "https://files.pythonhosted.org/packages/74/1a/145646e5687e8d9a1e8d09acb278c8535ebe9e972e1f162ed338a622f193/pydantic_core-2.41.5-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:1d1d9764366c73f996edd17abb6d9d7649a7eb690006ab6adbda117717099b14", size = 1891725, upload-time = "2025-11-04T13:40:58.807Z" }, - { url = "https://files.pythonhosted.org/packages/23/04/e89c29e267b8060b40dca97bfc64a19b2a3cf99018167ea1677d96368273/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:25e1c2af0fce638d5f1988b686f3b3ea8cd7de5f244ca147c777769e798a9cd1", size = 1915040, upload-time = "2025-11-04T13:41:00.853Z" }, - { url = "https://files.pythonhosted.org/packages/84/a3/15a82ac7bd97992a82257f777b3583d3e84bdb06ba6858f745daa2ec8a85/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:506d766a8727beef16b7adaeb8ee6217c64fc813646b424d0804d67c16eddb66", size = 2063691, upload-time = "2025-11-04T13:41:03.504Z" }, - { url = "https://files.pythonhosted.org/packages/74/9b/0046701313c6ef08c0c1cf0e028c67c770a4e1275ca73131563c5f2a310a/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:4819fa52133c9aa3c387b3328f25c1facc356491e6135b459f1de698ff64d869", size = 2213897, upload-time = "2025-11-04T13:41:05.804Z" }, - { url = "https://files.pythonhosted.org/packages/8a/cd/6bac76ecd1b27e75a95ca3a9a559c643b3afcd2dd62086d4b7a32a18b169/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2b761d210c9ea91feda40d25b4efe82a1707da2ef62901466a42492c028553a2", size = 2333302, upload-time = "2025-11-04T13:41:07.809Z" }, - { url = "https://files.pythonhosted.org/packages/4c/d2/ef2074dc020dd6e109611a8be4449b98cd25e1b9b8a303c2f0fca2f2bcf7/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:22f0fb8c1c583a3b6f24df2470833b40207e907b90c928cc8d3594b76f874375", size = 2064877, upload-time = "2025-11-04T13:41:09.827Z" }, - { url = "https://files.pythonhosted.org/packages/18/66/e9db17a9a763d72f03de903883c057b2592c09509ccfe468187f2a2eef29/pydantic_core-2.41.5-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:2782c870e99878c634505236d81e5443092fba820f0373997ff75f90f68cd553", size = 2180680, upload-time = "2025-11-04T13:41:12.379Z" }, - { url = "https://files.pythonhosted.org/packages/d3/9e/3ce66cebb929f3ced22be85d4c2399b8e85b622db77dad36b73c5387f8f8/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:0177272f88ab8312479336e1d777f6b124537d47f2123f89cb37e0accea97f90", size = 2138960, upload-time = "2025-11-04T13:41:14.627Z" }, - { url = "https://files.pythonhosted.org/packages/a6/62/205a998f4327d2079326b01abee48e502ea739d174f0a89295c481a2272e/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_armv7l.whl", hash = "sha256:63510af5e38f8955b8ee5687740d6ebf7c2a0886d15a6d65c32814613681bc07", size = 2339102, upload-time = "2025-11-04T13:41:16.868Z" }, - { url = "https://files.pythonhosted.org/packages/3c/0d/f05e79471e889d74d3d88f5bd20d0ed189ad94c2423d81ff8d0000aab4ff/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:e56ba91f47764cc14f1daacd723e3e82d1a89d783f0f5afe9c364b8bb491ccdb", size = 2326039, upload-time = "2025-11-04T13:41:18.934Z" }, - { url = "https://files.pythonhosted.org/packages/ec/e1/e08a6208bb100da7e0c4b288eed624a703f4d129bde2da475721a80cab32/pydantic_core-2.41.5-cp314-cp314-win32.whl", hash = "sha256:aec5cf2fd867b4ff45b9959f8b20ea3993fc93e63c7363fe6851424c8a7e7c23", size = 1995126, upload-time = "2025-11-04T13:41:21.418Z" }, - { url = "https://files.pythonhosted.org/packages/48/5d/56ba7b24e9557f99c9237e29f5c09913c81eeb2f3217e40e922353668092/pydantic_core-2.41.5-cp314-cp314-win_amd64.whl", hash = "sha256:8e7c86f27c585ef37c35e56a96363ab8de4e549a95512445b85c96d3e2f7c1bf", size = 2015489, upload-time = "2025-11-04T13:41:24.076Z" }, - { url = "https://files.pythonhosted.org/packages/4e/bb/f7a190991ec9e3e0ba22e4993d8755bbc4a32925c0b5b42775c03e8148f9/pydantic_core-2.41.5-cp314-cp314-win_arm64.whl", hash = "sha256:e672ba74fbc2dc8eea59fb6d4aed6845e6905fc2a8afe93175d94a83ba2a01a0", size = 1977288, upload-time = "2025-11-04T13:41:26.33Z" }, - { url = "https://files.pythonhosted.org/packages/92/ed/77542d0c51538e32e15afe7899d79efce4b81eee631d99850edc2f5e9349/pydantic_core-2.41.5-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:8566def80554c3faa0e65ac30ab0932b9e3a5cd7f8323764303d468e5c37595a", size = 2120255, upload-time = "2025-11-04T13:41:28.569Z" }, - { url = "https://files.pythonhosted.org/packages/bb/3d/6913dde84d5be21e284439676168b28d8bbba5600d838b9dca99de0fad71/pydantic_core-2.41.5-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:b80aa5095cd3109962a298ce14110ae16b8c1aece8b72f9dafe81cf597ad80b3", size = 1863760, upload-time = "2025-11-04T13:41:31.055Z" }, - { url = "https://files.pythonhosted.org/packages/5a/f0/e5e6b99d4191da102f2b0eb9687aaa7f5bea5d9964071a84effc3e40f997/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3006c3dd9ba34b0c094c544c6006cc79e87d8612999f1a5d43b769b89181f23c", size = 1878092, upload-time = "2025-11-04T13:41:33.21Z" }, - { url = "https://files.pythonhosted.org/packages/71/48/36fb760642d568925953bcc8116455513d6e34c4beaa37544118c36aba6d/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:72f6c8b11857a856bcfa48c86f5368439f74453563f951e473514579d44aa612", size = 2053385, upload-time = "2025-11-04T13:41:35.508Z" }, - { url = "https://files.pythonhosted.org/packages/20/25/92dc684dd8eb75a234bc1c764b4210cf2646479d54b47bf46061657292a8/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5cb1b2f9742240e4bb26b652a5aeb840aa4b417c7748b6f8387927bc6e45e40d", size = 2218832, upload-time = "2025-11-04T13:41:37.732Z" }, - { url = "https://files.pythonhosted.org/packages/e2/09/f53e0b05023d3e30357d82eb35835d0f6340ca344720a4599cd663dca599/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:bd3d54f38609ff308209bd43acea66061494157703364ae40c951f83ba99a1a9", size = 2327585, upload-time = "2025-11-04T13:41:40Z" }, - { url = "https://files.pythonhosted.org/packages/aa/4e/2ae1aa85d6af35a39b236b1b1641de73f5a6ac4d5a7509f77b814885760c/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2ff4321e56e879ee8d2a879501c8e469414d948f4aba74a2d4593184eb326660", size = 2041078, upload-time = "2025-11-04T13:41:42.323Z" }, - { url = "https://files.pythonhosted.org/packages/cd/13/2e215f17f0ef326fc72afe94776edb77525142c693767fc347ed6288728d/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d0d2568a8c11bf8225044aa94409e21da0cb09dcdafe9ecd10250b2baad531a9", size = 2173914, upload-time = "2025-11-04T13:41:45.221Z" }, - { url = "https://files.pythonhosted.org/packages/02/7a/f999a6dcbcd0e5660bc348a3991c8915ce6599f4f2c6ac22f01d7a10816c/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:a39455728aabd58ceabb03c90e12f71fd30fa69615760a075b9fec596456ccc3", size = 2129560, upload-time = "2025-11-04T13:41:47.474Z" }, - { url = "https://files.pythonhosted.org/packages/3a/b1/6c990ac65e3b4c079a4fb9f5b05f5b013afa0f4ed6780a3dd236d2cbdc64/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_armv7l.whl", hash = "sha256:239edca560d05757817c13dc17c50766136d21f7cd0fac50295499ae24f90fdf", size = 2329244, upload-time = "2025-11-04T13:41:49.992Z" }, - { url = "https://files.pythonhosted.org/packages/d9/02/3c562f3a51afd4d88fff8dffb1771b30cfdfd79befd9883ee094f5b6c0d8/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:2a5e06546e19f24c6a96a129142a75cee553cc018ffee48a460059b1185f4470", size = 2331955, upload-time = "2025-11-04T13:41:54.079Z" }, - { url = "https://files.pythonhosted.org/packages/5c/96/5fb7d8c3c17bc8c62fdb031c47d77a1af698f1d7a406b0f79aaa1338f9ad/pydantic_core-2.41.5-cp314-cp314t-win32.whl", hash = "sha256:b4ececa40ac28afa90871c2cc2b9ffd2ff0bf749380fbdf57d165fd23da353aa", size = 1988906, upload-time = "2025-11-04T13:41:56.606Z" }, - { url = "https://files.pythonhosted.org/packages/22/ed/182129d83032702912c2e2d8bbe33c036f342cc735737064668585dac28f/pydantic_core-2.41.5-cp314-cp314t-win_amd64.whl", hash = "sha256:80aa89cad80b32a912a65332f64a4450ed00966111b6615ca6816153d3585a8c", size = 1981607, upload-time = "2025-11-04T13:41:58.889Z" }, - { url = "https://files.pythonhosted.org/packages/9f/ed/068e41660b832bb0b1aa5b58011dea2a3fe0ba7861ff38c4d4904c1c1a99/pydantic_core-2.41.5-cp314-cp314t-win_arm64.whl", hash = "sha256:35b44f37a3199f771c3eaa53051bc8a70cd7b54f333531c59e29fd4db5d15008", size = 1974769, upload-time = "2025-11-04T13:42:01.186Z" }, - { url = "https://files.pythonhosted.org/packages/11/72/90fda5ee3b97e51c494938a4a44c3a35a9c96c19bba12372fb9c634d6f57/pydantic_core-2.41.5-graalpy311-graalpy242_311_native-macosx_10_12_x86_64.whl", hash = "sha256:b96d5f26b05d03cc60f11a7761a5ded1741da411e7fe0909e27a5e6a0cb7b034", size = 2115441, upload-time = "2025-11-04T13:42:39.557Z" }, - { url = "https://files.pythonhosted.org/packages/1f/53/8942f884fa33f50794f119012dc6a1a02ac43a56407adaac20463df8e98f/pydantic_core-2.41.5-graalpy311-graalpy242_311_native-macosx_11_0_arm64.whl", hash = "sha256:634e8609e89ceecea15e2d61bc9ac3718caaaa71963717bf3c8f38bfde64242c", size = 1930291, upload-time = "2025-11-04T13:42:42.169Z" }, - { url = "https://files.pythonhosted.org/packages/79/c8/ecb9ed9cd942bce09fc888ee960b52654fbdbede4ba6c2d6e0d3b1d8b49c/pydantic_core-2.41.5-graalpy311-graalpy242_311_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:93e8740d7503eb008aa2df04d3b9735f845d43ae845e6dcd2be0b55a2da43cd2", size = 1948632, upload-time = "2025-11-04T13:42:44.564Z" }, - { url = "https://files.pythonhosted.org/packages/2e/1b/687711069de7efa6af934e74f601e2a4307365e8fdc404703afc453eab26/pydantic_core-2.41.5-graalpy311-graalpy242_311_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:f15489ba13d61f670dcc96772e733aad1a6f9c429cc27574c6cdaed82d0146ad", size = 2138905, upload-time = "2025-11-04T13:42:47.156Z" }, - { url = "https://files.pythonhosted.org/packages/09/32/59b0c7e63e277fa7911c2fc70ccfb45ce4b98991e7ef37110663437005af/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:7da7087d756b19037bc2c06edc6c170eeef3c3bafcb8f532ff17d64dc427adfd", size = 2110495, upload-time = "2025-11-04T13:42:49.689Z" }, - { url = "https://files.pythonhosted.org/packages/aa/81/05e400037eaf55ad400bcd318c05bb345b57e708887f07ddb2d20e3f0e98/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:aabf5777b5c8ca26f7824cb4a120a740c9588ed58df9b2d196ce92fba42ff8dc", size = 1915388, upload-time = "2025-11-04T13:42:52.215Z" }, - { url = "https://files.pythonhosted.org/packages/6e/0d/e3549b2399f71d56476b77dbf3cf8937cec5cd70536bdc0e374a421d0599/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c007fe8a43d43b3969e8469004e9845944f1a80e6acd47c150856bb87f230c56", size = 1942879, upload-time = "2025-11-04T13:42:56.483Z" }, - { url = "https://files.pythonhosted.org/packages/f7/07/34573da085946b6a313d7c42f82f16e8920bfd730665de2d11c0c37a74b5/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:76d0819de158cd855d1cbb8fcafdf6f5cf1eb8e470abe056d5d161106e38062b", size = 2139017, upload-time = "2025-11-04T13:42:59.471Z" }, - { url = "https://files.pythonhosted.org/packages/5f/9b/1b3f0e9f9305839d7e84912f9e8bfbd191ed1b1ef48083609f0dabde978c/pydantic_core-2.41.5-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:b2379fa7ed44ddecb5bfe4e48577d752db9fc10be00a6b7446e9663ba143de26", size = 2101980, upload-time = "2025-11-04T13:43:25.97Z" }, - { url = "https://files.pythonhosted.org/packages/a4/ed/d71fefcb4263df0da6a85b5d8a7508360f2f2e9b3bf5814be9c8bccdccc1/pydantic_core-2.41.5-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:266fb4cbf5e3cbd0b53669a6d1b039c45e3ce651fd5442eff4d07c2cc8d66808", size = 1923865, upload-time = "2025-11-04T13:43:28.763Z" }, - { url = "https://files.pythonhosted.org/packages/ce/3a/626b38db460d675f873e4444b4bb030453bbe7b4ba55df821d026a0493c4/pydantic_core-2.41.5-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:58133647260ea01e4d0500089a8c4f07bd7aa6ce109682b1426394988d8aaacc", size = 2134256, upload-time = "2025-11-04T13:43:31.71Z" }, - { url = "https://files.pythonhosted.org/packages/83/d9/8412d7f06f616bbc053d30cb4e5f76786af3221462ad5eee1f202021eb4e/pydantic_core-2.41.5-pp311-pypy311_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:287dad91cfb551c363dc62899a80e9e14da1f0e2b6ebde82c806612ca2a13ef1", size = 2174762, upload-time = "2025-11-04T13:43:34.744Z" }, - { url = "https://files.pythonhosted.org/packages/55/4c/162d906b8e3ba3a99354e20faa1b49a85206c47de97a639510a0e673f5da/pydantic_core-2.41.5-pp311-pypy311_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:03b77d184b9eb40240ae9fd676ca364ce1085f203e1b1256f8ab9984dca80a84", size = 2143141, upload-time = "2025-11-04T13:43:37.701Z" }, - { url = "https://files.pythonhosted.org/packages/1f/f2/f11dd73284122713f5f89fc940f370d035fa8e1e078d446b3313955157fe/pydantic_core-2.41.5-pp311-pypy311_pp73-musllinux_1_1_armv7l.whl", hash = "sha256:a668ce24de96165bb239160b3d854943128f4334822900534f2fe947930e5770", size = 2330317, upload-time = "2025-11-04T13:43:40.406Z" }, - { url = "https://files.pythonhosted.org/packages/88/9d/b06ca6acfe4abb296110fb1273a4d848a0bfb2ff65f3ee92127b3244e16b/pydantic_core-2.41.5-pp311-pypy311_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:f14f8f046c14563f8eb3f45f499cc658ab8d10072961e07225e507adb700e93f", size = 2316992, upload-time = "2025-11-04T13:43:43.602Z" }, - { url = "https://files.pythonhosted.org/packages/36/c7/cfc8e811f061c841d7990b0201912c3556bfeb99cdcb7ed24adc8d6f8704/pydantic_core-2.41.5-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:56121965f7a4dc965bff783d70b907ddf3d57f6eba29b6d2e5dabfaf07799c51", size = 2145302, upload-time = "2025-11-04T13:43:46.64Z" }, +sdist = { url = "https://files.pythonhosted.org/packages/9c/0f/34f9ce4ba701dd0b815033ef94d99b56f66200e578ee6052aa3ac26f064e/pydantic_core-2.50.4.tar.gz", hash = "sha256:aead3b74b68396bf0feab5d57e050b730ded7df55853c1e048a87e00aaf033c6", size = 522249, upload-time = "2026-11-05T09:15:26.774Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/df/00/85e80811834d7cbd9bc228f9b5cdf8ec0edd69b55351ad720aac8c412d8c/pydantic_core-2.50.4-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:3e547ceec1da7382f01f9e13963023e53367a71802c88778b21b9645a077cbdf", size = 2170584, upload-time = "2026-11-05T09:11:41.139Z" }, + { url = "https://files.pythonhosted.org/packages/a3/f1/438de1fb99d717dcc6521922478dc16ef7b757302d4fc1f7faba3aaeac09/pydantic_core-2.50.4-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:c813ada7a651193acda85b6bc1cf12abd4b37cd25c7c6a75d7183512cc374969", size = 2128471, upload-time = "2026-11-05T09:11:42.65Z" }, + { url = "https://files.pythonhosted.org/packages/b7/74/f21ab568c6d3f315988b40e53f809c95b63fafc5403332963aa6dfc2c054/pydantic_core-2.50.4-cp311-cp311-manylinux1_i686.manylinux_2_5_i686.whl", hash = "sha256:57fa0a9490785139f1a4e4f43891830d55dfe4408845c0c9cb5eff4aeaf75f69", size = 2281509, upload-time = "2026-11-05T09:11:44.359Z" }, + { url = "https://files.pythonhosted.org/packages/a1/42/24ed3ea8e2fb6463c9ba5b8b1f089e69040905c7fd81dcfa6f52fcc692d5/pydantic_core-2.50.4-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:30d4dc35bc0eea52202a90b3820445ee0072c820241bfa710a623a078c9b267b", size = 2128064, upload-time = "2026-11-05T09:11:46.01Z" }, + { url = "https://files.pythonhosted.org/packages/d6/d1/44f541b2c18a46df6f18281a557acefeb5bbf0733a0b80b0a5e835e10ee4/pydantic_core-2.50.4-cp311-cp311-manylinux2014_armv7l.manylinux_2_17_armv7l.whl", hash = "sha256:789f88dea57841cdebef392b5d6e90444d767117e9ff2e0d9172df5c9de6690c", size = 2214472, upload-time = "2026-11-05T09:11:47.503Z" }, + { url = "https://files.pythonhosted.org/packages/bd/1b/e9a9ad8733e8051abca9e4acce37ba3ddd13930fd3b8730f4c7816fa979a/pydantic_core-2.50.4-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:d690121e80ab16e623415351ab24713534d4e500b3cadff216409cb6826063d4", size = 2401153, upload-time = "2026-11-05T09:11:49.403Z" }, + { url = "https://files.pythonhosted.org/packages/79/84/d88e8e6aa42d4d677666d6625db9177ad6851be9e7564a25aeb0b0cbcaf2/pydantic_core-2.50.4-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:b42f64825f5d750228f08318a9bf4d723b7ecb4c472aedcb3013c3ec2dc1f949", size = 2453307, upload-time = "2026-11-05T09:11:51.118Z" }, + { url = "https://files.pythonhosted.org/packages/56/51/cbb7a1bc0196ff94d3478d265eed7449f811759988eb760d41f4edd0893b/pydantic_core-2.50.4-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:0574866e05f6adeecc520d87e87dd06210c0a51706341f6ef8421572f5a64444", size = 2253434, upload-time = "2026-11-05T09:11:52.997Z" }, + { url = "https://files.pythonhosted.org/packages/9e/04/206b4881d631033ae88f005da6e11bd610c850e1850217342c03053d253b/pydantic_core-2.50.4-cp311-cp311-manylinux_2_31_riscv64.whl", hash = "sha256:dcf2c7eaaa4cafe8e49b017e5bb49e76e084ab6f0cd712ee4019c812b5cf68b8", size = 2279365, upload-time = "2026-11-05T09:11:54.822Z" }, + { url = "https://files.pythonhosted.org/packages/a1/7c/d815b5a3f83069b283d3b6a2e61de6e14baac3b20c6cd3418e9e629551cf/pydantic_core-2.50.4-cp311-cp311-musllinux_1_1_aarch64.whl", hash = "sha256:3b8ee2589a082739c522c1fe4be227412fcf108b903abb6672ae2f5570558882", size = 2319407, upload-time = "2026-11-05T09:11:56.46Z" }, + { url = "https://files.pythonhosted.org/packages/ee/00/c9a483276d1052d5142e1e01eccac97d939f83a3a3fd94c4766495a9b807/pydantic_core-2.50.4-cp311-cp311-musllinux_1_1_armv7l.whl", hash = "sha256:aec3c2d741a8e3ee993de7f95f37afb51e31b169c95dbd29da4cf6688f340914", size = 2489900, upload-time = "2026-11-05T09:11:58.102Z" }, + { url = "https://files.pythonhosted.org/packages/2d/b5/8cd8ee29a1d63ad47f95593384df92476cef6896c644f280db0748b8e76b/pydantic_core-2.50.4-cp311-cp311-musllinux_1_1_x86_64.whl", hash = "sha256:8923fcd49f875e8a0448d7223d1fdf1a9973ae2d1f20d4158753ceb8909facd2", size = 2497732, upload-time = "2026-11-05T09:11:59.928Z" }, + { url = "https://files.pythonhosted.org/packages/60/31/050a48c0c373df16442ac07f3fa167414bb0e22f54a3e886f6d6cb7ad1d4/pydantic_core-2.50.4-cp311-cp311-win32.whl", hash = "sha256:fc04affef30be98c1f36f0c422a4061ef618fdc1dde79f5ad5458dd496fecffa", size = 2132347, upload-time = "2026-11-05T09:12:01.928Z" }, + { url = "https://files.pythonhosted.org/packages/c6/06/cebeeb7a8e87b42a3d8bc189d0d400e47df5d1736cb326764bae8a74c433/pydantic_core-2.50.4-cp311-cp311-win_amd64.whl", hash = "sha256:15bece43a02ad543c621c8305e67dedb5f27d378c5ba741e5a2c36523f8ef37f", size = 2255970, upload-time = "2026-11-05T09:12:03.888Z" }, + { url = "https://files.pythonhosted.org/packages/46/db/5b4bf14347da658c994483043fbabffedcab98929c41c261ec168c3c1f87/pydantic_core-2.50.4-cp311-cp311-win_arm64.whl", hash = "sha256:e498900bfbf7ddddd862f810440c09e9b81674739e8a11d619b40906dccd4a9a", size = 2196799, upload-time = "2026-11-05T09:12:05.389Z" }, + { url = "https://files.pythonhosted.org/packages/10/bf/d1f6b81709538f831ebe1c42f50fb89db3dfda06f9e9b1ea24e90fc69209/pydantic_core-2.50.4-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:32a991aebd165f227b7c7c60bb9d66c2c7de9c24308552da264c9938fde0f8d6", size = 2231444, upload-time = "2026-11-05T09:12:06.969Z" }, + { url = "https://files.pythonhosted.org/packages/c1/39/6618e541658d5a687a8d4962fc304350073a8f322bc4c62e8ed4c2d514d6/pydantic_core-2.50.4-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:1e20cbde2b6deb33a51d08cd168454dd9044ec7d4474056f4d98d63f51578783", size = 2108048, upload-time = "2026-11-05T09:12:08.85Z" }, + { url = "https://files.pythonhosted.org/packages/d9/54/1c941fffa4e14bfc9ab0cd4977075f0e03201447856130d08a33cd45e47b/pydantic_core-2.50.4-cp312-cp312-manylinux1_i686.manylinux_2_5_i686.whl", hash = "sha256:8cceae48ae7f94990c2f4e36291e9ec9868735e8b0f19e4489a17b0422338466", size = 2256866, upload-time = "2026-11-05T09:12:10.495Z" }, + { url = "https://files.pythonhosted.org/packages/61/a0/8028ef3e014be522ce43060aeac82a5be2288215e660866f5e6260acc123/pydantic_core-2.50.4-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:16902a147b3da4840612164a5e67947104d63e978f7a57c395877a5e26690b9c", size = 2125682, upload-time = "2026-11-05T09:12:12.278Z" }, + { url = "https://files.pythonhosted.org/packages/c3/f2/b98bb73b1734ec4e42e786a766abc24f3c89620a0ddbaf8aa14e4b4c628c/pydantic_core-2.50.4-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.whl", hash = "sha256:d6e3485a5e5c01fb5339c1ee3d4b9e21e2135a2a9d44caafb71acd994487ee7c", size = 2197108, upload-time = "2026-11-05T09:12:13.873Z" }, + { url = "https://files.pythonhosted.org/packages/f1/d1/7a7142786781400143e8806633fe5b65e2d407c311041fc9494490f05b18/pydantic_core-2.50.4-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:629eae995185540406e3635df5d5cf1d44f19ea240840b835d3f44541ff694d8", size = 2380521, upload-time = "2026-11-05T09:12:15.539Z" }, + { url = "https://files.pythonhosted.org/packages/b5/34/cf710ca48d4498b04a3ea605d45892675dc2b14a94a25121a8d03f56d3e9/pydantic_core-2.50.4-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:41b2cd8b29dbb5a4c9828a70f50d1abfc92011115c813213d3a91205c6f731b3", size = 2457436, upload-time = "2026-11-05T09:12:17.447Z" }, + { url = "https://files.pythonhosted.org/packages/91/23/e0c6e3cd09a0ac809953fea698c816b9f03bf0b35b6820c9553e4f5d85a8/pydantic_core-2.50.4-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:c81d98e27d9d9261909dcccab1ba5d6ea1c98b0bb9470e368604614fd1d36ddd", size = 2261727, upload-time = "2026-11-05T09:12:19.097Z" }, + { url = "https://files.pythonhosted.org/packages/f9/00/292a0ed96d5d2d6edb49468ef481336e5b7e54f13435d73b7c912c891c23/pydantic_core-2.50.4-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:ca83a32b2b41653d89f09a3d22b770bca96da72273bef8f7a68136bdd1e8b823", size = 2262071, upload-time = "2026-11-05T09:12:20.78Z" }, + { url = "https://files.pythonhosted.org/packages/f8/36/d4690faf8c082eacf7754e52ab6bebe1bc73b167272e28699c00480ee908/pydantic_core-2.50.4-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:817953730e4a73a09008b010c4a42396cefe799616a22df2ac21d3927b3080cf", size = 2298931, upload-time = "2026-11-05T09:12:22.614Z" }, + { url = "https://files.pythonhosted.org/packages/21/17/b180af6d17cf6c8e0d3d2661fc501a4a40959744ca4947d6ad0db81b1416/pydantic_core-2.50.4-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:664e74848c2f5fc27db8505fe24e1ecd3ac669412913bf73d176916f86cc08e2", size = 2474285, upload-time = "2026-11-05T09:12:24.842Z" }, + { url = "https://files.pythonhosted.org/packages/6e/bb/7e44d4ac6e1292f1859384c688713045bdf5448e0635c49c003d2be3bb6c/pydantic_core-2.50.4-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:219114f8dcdcbe4720d82ef016b1287ce5a0a67d7c69ca61524eb72e82aac344", size = 2498172, upload-time = "2026-11-05T09:12:26.434Z" }, + { url = "https://files.pythonhosted.org/packages/d8/84/5101f35294579c4bef7dc32fd4f097d91eedac2e195894266bdabc1e6dfd/pydantic_core-2.50.4-cp312-cp312-win32.whl", hash = "sha256:67f7cc397e1d5556a801d1cba74de0d27d827eb242e6c036c0ca273c745414f1", size = 2119592, upload-time = "2026-11-05T09:12:27.971Z" }, + { url = "https://files.pythonhosted.org/packages/82/88/d438a8fcf3738e9ff2670f724047ca3893ec899bcd5cdfc077a2aab133c6/pydantic_core-2.50.4-cp312-cp312-win_amd64.whl", hash = "sha256:ea2f61b0bc12f3592288503961b764579dea0658852d96a0b3d823614d808821", size = 2264064, upload-time = "2026-11-05T09:12:29.538Z" }, + { url = "https://files.pythonhosted.org/packages/77/d4/4a0c73dc3ef9e50b122b8c3527afcded15a44838f1c9668d2d4b72cc09f0/pydantic_core-2.50.4-cp312-cp312-win_arm64.whl", hash = "sha256:32d6dda86383645ec428ea64dfc277036f5cbc60a72238eab28b91a3fdb9a113", size = 2167792, upload-time = "2026-11-05T09:12:31.103Z" }, + { url = "https://files.pythonhosted.org/packages/1b/21/39f8d97e7ea8e3083606ee9bb1d7f3ec70ded780bb6a872aad76c7eb08b2/pydantic_core-2.50.4-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:0f87ae9db5ba8d8de40dcb93982cf8dd544e6552a80d3345af51941cc2146b80", size = 2232841, upload-time = "2026-11-05T09:12:32.617Z" }, + { url = "https://files.pythonhosted.org/packages/90/a9/fc89a632331882c4cb91b949003418e6f5085ddcf2c9b875d499682bca91/pydantic_core-2.50.4-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:1239daaf063e62213ca1f34d96663900bd7510c42a786e843fd328af70e46445", size = 2108326, upload-time = "2026-11-05T09:12:34.419Z" }, + { url = "https://files.pythonhosted.org/packages/5d/6d/4f6d00e9e4ba2a7bfb206ae49cb32a3ea90c4d658e62f8775277d75e8291/pydantic_core-2.50.4-cp313-cp313-manylinux1_i686.manylinux_2_5_i686.whl", hash = "sha256:1afefe44ec042fbabfb4483ea258c04cf75ff4ff328d754f09b321fdaa232aca", size = 2256276, upload-time = "2026-11-05T09:12:36.212Z" }, + { url = "https://files.pythonhosted.org/packages/b3/b8/936cb0d85a4082e902c7397db0f05c4372eac08372c8bd2d0b43088fcf17/pydantic_core-2.50.4-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:a9ee990bf2cfbd81574c5d4f9f6c9d480a14b5b43d2c4f2ca13f4c6f48089394", size = 2125469, upload-time = "2026-11-05T09:12:37.913Z" }, + { url = "https://files.pythonhosted.org/packages/66/a1/f3b551ce233dcac73286b8b2ae45c23232a9f41c68663e2dcce4bb2dbcfa/pydantic_core-2.50.4-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.whl", hash = "sha256:ab2822bcdcefb54d1e8ca29f5e3ec3afe160fb794bb3a3a73b09d11ed2671104", size = 2196397, upload-time = "2026-11-05T09:12:39.725Z" }, + { url = "https://files.pythonhosted.org/packages/3d/93/a8a6e7e20826567a73e6f52416667698aa3de704804d7a49d25272246af4/pydantic_core-2.50.4-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:0001d6920e3a5d92758cda460d6dc9f918a78ad6d5d092f1c8b5395e6b775356", size = 2380442, upload-time = "2026-11-05T09:12:41.196Z" }, + { url = "https://files.pythonhosted.org/packages/aa/ba/921d90c9d8ddfa653a35a92f2bbdcd650a9493f5c43f39cdfe4c56659cfa/pydantic_core-2.50.4-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:ad92d255a165cde5f9882ff69699eaf5495e0a1f32e97566bbbb80f11e46781f", size = 2457747, upload-time = "2026-11-05T09:12:42.723Z" }, + { url = "https://files.pythonhosted.org/packages/2b/c0/1c8f2c8f1b03d3fe2fdd7962df8f5a744fe48c90b4c49615e4eb77d04141/pydantic_core-2.50.4-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:fb2bb5b557080da398b866408117d98fe9731a12334afd0cdff221b458cdc5dc", size = 2260946, upload-time = "2026-11-05T09:12:44.185Z" }, + { url = "https://files.pythonhosted.org/packages/07/ab/5b78a78f0c0f11c8b54fac214ed49cbb4795c34881aa5e5a15715917936f/pydantic_core-2.50.4-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:92f8f63df729061bb14558ed740e7a222f6e2aa6c2e6a5bcfb4e706676562049", size = 2261921, upload-time = "2026-11-05T09:12:45.706Z" }, + { url = "https://files.pythonhosted.org/packages/b3/e8/dd5d154cf3401f836d8754fdc1b82ecadd37944e4355d855e5b54c7d8ae5/pydantic_core-2.50.4-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:2a60ec2a57ac3ef3767e526e9bf706ec75aa3d79c4ea134d9d4fcf7c62a297a7", size = 2298475, upload-time = "2026-11-05T09:12:47.183Z" }, + { url = "https://files.pythonhosted.org/packages/b7/49/af059d9c4483cba168b17e5f84f1090a3e4547a02fc7698ebc231d48298a/pydantic_core-2.50.4-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:a2f8716344bbbd10443391be0b1f2003b34949e3c4e6883005c2bc498ab6b64b", size = 2473226, upload-time = "2026-11-05T09:12:48.785Z" }, + { url = "https://files.pythonhosted.org/packages/71/ba/4e8cc3064e8bc2ea272cf80dfc57fa4e455f6835c1def21609a9b4f94135/pydantic_core-2.50.4-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:b300a30304c4c6aeab03ed06809819d9eceacdd58441d3c7dffe41edfd006091", size = 2498764, upload-time = "2026-11-05T09:12:50.316Z" }, + { url = "https://files.pythonhosted.org/packages/bf/96/0878499cfa88eb0b07762b488d3cc1b64cb156a4905db99a0d12096b2e17/pydantic_core-2.50.4-cp313-cp313-win32.whl", hash = "sha256:ef8a9ddb2e2a4eae4abb72dc0710eca6c2726779b0664bd10c3ce9fcfaed8c4e", size = 2119158, upload-time = "2026-11-05T09:12:51.834Z" }, + { url = "https://files.pythonhosted.org/packages/e7/e0/95b651213e79ffe0cbee855590bf5cfdf8e3a0d90a7fc73a080e63f7cc38/pydantic_core-2.50.4-cp313-cp313-win_amd64.whl", hash = "sha256:4c29b8f2d6417069bb1f257e6b9113f5d64dc2f554cc200ea90b4fe2c5cdb733", size = 2262887, upload-time = "2026-11-05T09:12:53.282Z" }, + { url = "https://files.pythonhosted.org/packages/08/d3/c3801dc75844a0b13d000bd575bf1b3b3a8aca9f63d19e1809f69c9c5121/pydantic_core-2.50.4-cp313-cp313-win_arm64.whl", hash = "sha256:a0c5210d038418a115e7cf8706bfa611bd14add2f5787274dba45aadca3155e0", size = 2167878, upload-time = "2026-11-05T09:12:54.677Z" }, + { url = "https://files.pythonhosted.org/packages/ee/ed/c9a4982ac3bbc78f27498d9efb85b3dabd739a1724db53c35cc4c018e1de/pydantic_core-2.50.4-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:5c074454dc6d4f6f4ba6561a56bf33a14db7651d882a5a5321ba3ae8868e082d", size = 2236841, upload-time = "2026-11-05T09:12:56.111Z" }, + { url = "https://files.pythonhosted.org/packages/56/32/92c174c17bfc5fc52d0c064e6a7969a727731e25829ede752fba8bacce0f/pydantic_core-2.50.4-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:a4bb174bd65f795c39ad6642d9d5bdc43351b306b7d0a654ab0d0abb38be245f", size = 2108348, upload-time = "2026-11-05T09:12:57.638Z" }, + { url = "https://files.pythonhosted.org/packages/cb/cb/9f637d424a04d3edce7dd527da941950cce05a74b025eef3d54427b86c8e/pydantic_core-2.50.4-cp314-cp314-manylinux1_i686.manylinux_2_5_i686.whl", hash = "sha256:0ec20aca2b067369913716847f7dfe5f4dddf16a46965b7a70bbad5defaaba86", size = 2261331, upload-time = "2026-11-05T09:12:59.154Z" }, + { url = "https://files.pythonhosted.org/packages/91/ff/1117a3cccabb67305bd98d992a84eaf275939a9a043b4f14126ed7252e4f/pydantic_core-2.50.4-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:70dbc9f83c41f37a4faa62dae5203853847223a891da446f48ef2efcfd5df806", size = 2128667, upload-time = "2026-11-05T09:13:00.614Z" }, + { url = "https://files.pythonhosted.org/packages/93/45/6de1b4a6e8c415cd547f90d1408a711e7975116423e3eb3046061c62d7c7/pydantic_core-2.50.4-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.whl", hash = "sha256:3de6c2a4df2af0ac9ab4dc1488746fe8b1a90e27955d870d9edda3187d20092b", size = 2198183, upload-time = "2026-11-05T09:13:02.259Z" }, + { url = "https://files.pythonhosted.org/packages/d0/bd/c6e64c315d35cc0783a0ea033a3dca062bc368905d0217eab6f6f63007de/pydantic_core-2.50.4-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:3a48a5254d15a0ad050318bfc7a9566d4ec740118187e8f303e47a6840287eb7", size = 2386279, upload-time = "2026-11-05T09:13:03.988Z" }, + { url = "https://files.pythonhosted.org/packages/33/ab/0d56280c89d3841381e9c699c3fa80e3dd3288edf5e7fe4d149136835dca/pydantic_core-2.50.4-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:0af56dbf8822ba9f4efcbbfdc15478f8b6fb08f1609860cb50aa2cc8476b3c34", size = 2464343, upload-time = "2026-11-05T09:13:05.98Z" }, + { url = "https://files.pythonhosted.org/packages/56/9c/621ad8f88590a92a086b1168dce09369d9c5e079e2e635e6646d248af55b/pydantic_core-2.50.4-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:f1d62fb172db35c6478c9323da34ff37d1f3d37d7d44337a9d94ba8c583e5730", size = 2265388, upload-time = "2026-11-05T09:13:07.808Z" }, + { url = "https://files.pythonhosted.org/packages/f3/7b/cef68a667bf29b86e293a80a601d488a84c8f45508915ad6201fcfe1a798/pydantic_core-2.50.4-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:5c1013647be741647895c102831dcf79c34209662dbb683df9efb864417ed7d5", size = 2267012, upload-time = "2026-11-05T09:13:09.273Z" }, + { url = "https://files.pythonhosted.org/packages/4b/9f/3ae4d163d8feda2b52de88b5cd96b1c40f79d11503003b061136d2ece6ab/pydantic_core-2.50.4-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:aeb2e123cbf978a905e9f55155c1b8316fbbfa7cf64d04521fe174bab302d100", size = 2300478, upload-time = "2026-11-05T09:13:10.758Z" }, + { url = "https://files.pythonhosted.org/packages/e8/72/41881d31f6452430ed6792679c5391795910f0a27a6aebd424683e504ed6/pydantic_core-2.50.4-cp314-cp314-musllinux_1_1_armv7l.whl", hash = "sha256:523466eba8ee10f7480f3c2057563145978011c583130d2cc01fb1e7af808e25", size = 2474874, upload-time = "2026-11-05T09:13:12.188Z" }, + { url = "https://files.pythonhosted.org/packages/05/ef/099874dd6d5ca1e49987dea87eecc05610183249450b1fff883d87f1e8eb/pydantic_core-2.50.4-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:c9e70012926e97069cdd09221861aff412aa94e4cac2e019055cdb79485b150c", size = 2502771, upload-time = "2026-11-05T09:13:13.981Z" }, + { url = "https://files.pythonhosted.org/packages/c6/07/a7d8615b8677bf69e24666bbce431299850c95a7b084649342582a1c3210/pydantic_core-2.50.4-cp314-cp314-pyemscripten_2026_0_wasm32.whl", hash = "sha256:e6da138a1ecc1341c8b788a5ee822670b03788e1f5decf7af9d461de6e508b8e", size = 1496509, upload-time = "2026-11-05T09:13:15.704Z" }, + { url = "https://files.pythonhosted.org/packages/ab/71/fdf2c25c3a4f89968263c1d896c933809ca8d2fb13443626648a17b2e296/pydantic_core-2.50.4-cp314-cp314-win32.whl", hash = "sha256:13b6dd62b5279f5b9d72f3bf918a35443ee8bd549241d9dc52d79a2c3b6d7016", size = 2122015, upload-time = "2026-11-05T09:13:17.09Z" }, + { url = "https://files.pythonhosted.org/packages/3a/9f/3554f0148b01ddaa5e678bf5fbce4679873534e5c0985cdf6c59c41dc9a9/pydantic_core-2.50.4-cp314-cp314-win_amd64.whl", hash = "sha256:b0cdb655fbd1562c2dfc9986f9103a106f7058cd0915afc6e656d4b1d73f3387", size = 2265109, upload-time = "2026-11-05T09:13:18.702Z" }, + { url = "https://files.pythonhosted.org/packages/ed/3c/196ef237d9ec5cca5ea9b773911dee1a387b9b1d4bfea05625b3e191a338/pydantic_core-2.50.4-cp314-cp314-win_arm64.whl", hash = "sha256:df1c174796cd63eb6b139f7daf783affe1f3ed659605850e843b24764c21bfc5", size = 2165745, upload-time = "2026-11-05T09:13:20.245Z" }, + { url = "https://files.pythonhosted.org/packages/36/12/0ee82a41a3995f0b531cf14e0b823dc2365ba4a22330670fccaa72753f12/pydantic_core-2.50.4-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:edbca8789fd10f0de534b660a6b4c71f1fd18039679c918dad392ab044bb37e4", size = 2223917, upload-time = "2026-11-05T09:13:21.623Z" }, + { url = "https://files.pythonhosted.org/packages/90/2c/592f8404abbcc65a70e6a802d1dc8f11412af44913e5146cf5c345370074/pydantic_core-2.50.4-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:33b21f69540a12c2053cd1d95766d8bd9667a3897f7c712a642de8aa37eb0865", size = 2087372, upload-time = "2026-11-05T09:13:23.16Z" }, + { url = "https://files.pythonhosted.org/packages/ea/1d/c7111757c84b5b8c19b1e39ceb5e131e6e48e14169ec6004e0f8f28f43f3/pydantic_core-2.50.4-cp314-cp314t-manylinux1_i686.manylinux_2_5_i686.whl", hash = "sha256:ffb616d8d55965839670301dc3bae3abacff560a7e137a89056058a8a9da4d96", size = 2275190, upload-time = "2026-11-05T09:13:24.634Z" }, + { url = "https://files.pythonhosted.org/packages/3d/ae/6c49cc9b8e66e61adee782d1763894bf64a357cddae82f725059b85bdc98/pydantic_core-2.50.4-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:6c5687b59b6ba0f663c4f2f15470f68507d6b45ccd3a19ee6d224f95cbee70d8", size = 2110343, upload-time = "2026-11-05T09:13:26.168Z" }, + { url = "https://files.pythonhosted.org/packages/ed/39/0ee5261d1daa9ad526371181c13696add0565251b2823f6e00a9a9af397d/pydantic_core-2.50.4-cp314-cp314t-manylinux2014_armv7l.manylinux_2_17_armv7l.whl", hash = "sha256:c733087ecf7dde06b1d071679bfd5f3ba03266ba77814c1c7253bc48c9adedd9", size = 2207887, upload-time = "2026-11-05T09:13:27.681Z" }, + { url = "https://files.pythonhosted.org/packages/ac/b5/a0652c0e99590107e111088b6d059044380a787da9ffdd0b458ab4cd9453/pydantic_core-2.50.4-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:94733cb447c37b0ce6f71b39ca1288d5f966a084023a5617b4cc35a852586859", size = 2404171, upload-time = "2026-11-05T09:13:29.864Z" }, + { url = "https://files.pythonhosted.org/packages/a3/85/d49f0b8e09a0ffc40dcefb604f9e6020e0d61b51a5f64a504f382fa84c39/pydantic_core-2.50.4-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:b26f39a5be3cd91a2035818be3d0ffdf5282c3e1f5f53d3b80b7024021acee52", size = 2466049, upload-time = "2026-11-05T09:13:31.658Z" }, + { url = "https://files.pythonhosted.org/packages/e6/76/f2b04d7c53edfd8136053c812ea49914fbf4091196cb7baf9ea326fa2ff8/pydantic_core-2.50.4-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:c856e439a9d54d514e81a7131229ba151cdf81df7c408e0f6c89340e5003dfe2", size = 2262062, upload-time = "2026-11-05T09:13:33.806Z" }, + { url = "https://files.pythonhosted.org/packages/24/60/016f14cea883adc33df90b8df220df934de49ded9640f45c8e92bb298494/pydantic_core-2.50.4-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:cbf0777d54672990b10cb8ca9b0523499e182d7e2ea39f86b138519a902aa601", size = 2263713, upload-time = "2026-11-05T09:13:35.337Z" }, + { url = "https://files.pythonhosted.org/packages/f1/3f/b05828e978512973e7e215bab69e65e70d223d6309a17bf48084a50692f4/pydantic_core-2.50.4-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:edc17549ab592e33cfcaf285f047bb75fcd98f608aa9309af1187fd736ce9641", size = 2305044, upload-time = "2026-11-05T09:13:37.043Z" }, + { url = "https://files.pythonhosted.org/packages/91/c1/fca6c5f623ac45ba284713c614b30173aa0794899a0a457f866fa6f5e886/pydantic_core-2.50.4-cp314-cp314t-musllinux_1_1_armv7l.whl", hash = "sha256:23a9ba564b2db709ff16eca990992ba95a19069972b34bff87c81d4b473cd755", size = 2483506, upload-time = "2026-11-05T09:13:40.524Z" }, + { url = "https://files.pythonhosted.org/packages/94/c2/ec41f68d1208e53e1a73ead940c050c4316bbb555ba42676a5e949fd529e/pydantic_core-2.50.4-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:41f4f8ae714e4fea1d635880f8a1af715ecf080eed4d13c5b04a0f3210f9c61a", size = 2512832, upload-time = "2026-11-05T09:13:43.361Z" }, + { url = "https://files.pythonhosted.org/packages/43/22/58583b86309f70cce854e0e77c412839a56ac6c682d6060f5794afeff315/pydantic_core-2.50.4-cp314-cp314t-win32.whl", hash = "sha256:601fce6cea9ddeaa85329e12e7f351def38d233075f42a3012b9c48071b02941", size = 2101977, upload-time = "2026-11-05T09:13:45.735Z" }, + { url = "https://files.pythonhosted.org/packages/6b/28/193bc0994f7fe15f2874c1dfe2f3bc7872aed8283ffda2cf05fb9a5a06b4/pydantic_core-2.50.4-cp314-cp314t-win_amd64.whl", hash = "sha256:22e874666bdbd96d6bf629d32cd8ab376fedf1fd62585b52a42b9fa9fa6c20b6", size = 2240461, upload-time = "2026-11-05T09:13:48.38Z" }, + { url = "https://files.pythonhosted.org/packages/00/ed/5615cfdd5620a4926440eb1a2b73db0dc895824ba565ccaa8d9eb3a8e974/pydantic_core-2.50.4-cp314-cp314t-win_arm64.whl", hash = "sha256:71395a43da5584bb70556f380387e15f845c0dcf76373c1afbfa0025737576ac", size = 2168505, upload-time = "2026-11-05T09:13:50.762Z" }, + { url = "https://files.pythonhosted.org/packages/6d/9f/e6673535165d965a11c1d5339f53995f90234019827eaecb41a57e6e463d/pydantic_core-2.50.4-cp315-cp315-macosx_10_12_x86_64.whl", hash = "sha256:7ac2769a7ddd661e07e26c12220adc31b17014c48234b2a5a88993b8d4109e09", size = 2241950, upload-time = "2026-11-05T09:13:53.055Z" }, + { url = "https://files.pythonhosted.org/packages/6f/02/65951efadbf7826e6a270843f97e3da2ef726de2b6d9cd7c5dfa4c48807e/pydantic_core-2.50.4-cp315-cp315-macosx_11_0_arm64.whl", hash = "sha256:930ad463d3fb7a340d323bcc496ec32dae469ec9974c29ff569f19806b6b03b4", size = 2112412, upload-time = "2026-11-05T09:13:55.309Z" }, + { url = "https://files.pythonhosted.org/packages/c9/d3/4fb6e2e4a9e4951f1e05b198366ed5330e0874e83d52077e8b985350fe0e/pydantic_core-2.50.4-cp315-cp315-manylinux1_i686.manylinux_2_5_i686.whl", hash = "sha256:b867f9fd183d76977f810c626d539265183c25b2284762893a31e8d6cacc81c0", size = 2263220, upload-time = "2026-11-05T09:13:57.555Z" }, + { url = "https://files.pythonhosted.org/packages/63/83/42e70436c523357b49393b73f161f2741acf36003c8efd2f941d2be56bae/pydantic_core-2.50.4-cp315-cp315-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:49eb1241a969a5994db6880c18c012b6cbe2340343d8f529721571806583e500", size = 2134716, upload-time = "2026-11-05T09:13:59.413Z" }, + { url = "https://files.pythonhosted.org/packages/36/66/ed9b87f4751fd07e472c62cfe151f575abdf4c452fab943d35ba8efdc6c4/pydantic_core-2.50.4-cp315-cp315-manylinux2014_armv7l.manylinux_2_17_armv7l.whl", hash = "sha256:477af785d1846e4e96bf56983b92ea7553aaeccdeb8acdaa55c7cee9eda0ae32", size = 2201901, upload-time = "2026-11-05T09:14:01.472Z" }, + { url = "https://files.pythonhosted.org/packages/2b/21/ff2e6ac7202b6d326e9f007c6082f6e6f3aaa063790ea2a355bdc985addc/pydantic_core-2.50.4-cp315-cp315-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:29358a8ca74e7d81158d14e2b10c904bd18773293ae3788716c0626fe0342347", size = 2389670, upload-time = "2026-11-05T09:14:03.431Z" }, + { url = "https://files.pythonhosted.org/packages/b9/34/e9348bc13d549641791a51843ed140fbb311d9066628e27477343412d5ad/pydantic_core-2.50.4-cp315-cp315-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:300753f71c73302e218124baf995f00058e085cd01869bd9610bcbd0bd4500c1", size = 2468951, upload-time = "2026-11-05T09:14:05.028Z" }, + { url = "https://files.pythonhosted.org/packages/ac/5e/145a02bf2b9f66981108caf6cc9e78917e31e4caca14d1e3ccd3ff2c7293/pydantic_core-2.50.4-cp315-cp315-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:26cb012c4b8ca9f847bd0ac15978bd3d0f55b050bfbe6c47355edfc7e945029b", size = 2272957, upload-time = "2026-11-05T09:14:06.587Z" }, + { url = "https://files.pythonhosted.org/packages/fd/38/b71c5b245e923f6cf144e948ed2a9d6b7fb97d8905784db8d860f5176b8b/pydantic_core-2.50.4-cp315-cp315-manylinux_2_31_riscv64.whl", hash = "sha256:9be1cfe715ecaa060ffd5d599ef410b94ef2697a0eed4cee562f788a2aa2175b", size = 2275028, upload-time = "2026-11-05T09:14:08.219Z" }, + { url = "https://files.pythonhosted.org/packages/ba/71/2504dacdc5cd3ea3ec5e68c9b6e097c979500bcff220b97046cc8ea3c1ad/pydantic_core-2.50.4-cp315-cp315-musllinux_1_1_aarch64.whl", hash = "sha256:c81e35862aced259177a537ce1a6264c3a97bae1ced184ca9dc10ea754563688", size = 2305447, upload-time = "2026-11-05T09:14:09.795Z" }, + { url = "https://files.pythonhosted.org/packages/2c/90/904233a6c148bcac9f30bb96a2761e5fb52682d0d6de31a40c74a3714ceb/pydantic_core-2.50.4-cp315-cp315-musllinux_1_1_armv7l.whl", hash = "sha256:b2f2d13239487cecaae98c9f4d5904ad0737643cdf8873c88ec6a78b12214f20", size = 2477852, upload-time = "2026-11-05T09:14:11.443Z" }, + { url = "https://files.pythonhosted.org/packages/72/33/1cbdcbf343ca23b507e967b21dddc4c8bf17a74c8b5cad59228c85ba4efc/pydantic_core-2.50.4-cp315-cp315-musllinux_1_1_x86_64.whl", hash = "sha256:e6b4b08d09054310a4dc389fa61ee22a7a5a292cb23ab8a985136ca8828bf924", size = 2506352, upload-time = "2026-11-05T09:14:13.165Z" }, + { url = "https://files.pythonhosted.org/packages/91/24/3ad9ea0876e6624c90967e5f1446e751b275cfdfaaf798a0d8e0b30025bc/pydantic_core-2.50.4-cp315-cp315-win32.whl", hash = "sha256:6619d49a89a15cd04334f76fec530c155923bfc60da74ff5d815a52629e1aa6c", size = 2127780, upload-time = "2026-11-05T09:14:17.52Z" }, + { url = "https://files.pythonhosted.org/packages/c0/3c/0582532b90a12492471977bdbca1317eca5144f6342ea581d2cee73ccd35/pydantic_core-2.50.4-cp315-cp315-win_amd64.whl", hash = "sha256:e5bd109d095aaae989a0463d5ef0fcc43e9ddd5de125e656d3c119a79e466380", size = 2270596, upload-time = "2026-11-05T09:14:20.955Z" }, + { url = "https://files.pythonhosted.org/packages/6c/50/967cfe4f7043a993c0c80cd3563c598b5281d2276aa775d0f6ff7f714271/pydantic_core-2.50.4-cp315-cp315-win_arm64.whl", hash = "sha256:6118e5a5550e36582e19bac1a403711a748f9f18251b054c326d3db02aaa7a18", size = 2170880, upload-time = "2026-11-05T09:14:24.822Z" }, + { url = "https://files.pythonhosted.org/packages/9e/71/3ec5bd8a82f792482f16d79fdbe8ce85aa71bf7147e556c5fc5f8546818d/pydantic_core-2.50.4-cp315-cp315t-macosx_10_12_x86_64.whl", hash = "sha256:d8201c9f9035520cdcc7dcad383b039ec8123969b87e01cf27c3dd883c02313b", size = 2233053, upload-time = "2026-11-05T09:14:27.942Z" }, + { url = "https://files.pythonhosted.org/packages/6e/2e/614dc37aedf8e9f811c1f2eedaf8eb09a7c196e2d137fe82bcc9d5662ca2/pydantic_core-2.50.4-cp315-cp315t-macosx_11_0_arm64.whl", hash = "sha256:1de7be9a66fc8536770481ab64a05aae5067c725f2b29a09543af00e6a417b97", size = 2090776, upload-time = "2026-11-05T09:14:30.281Z" }, + { url = "https://files.pythonhosted.org/packages/f9/14/aefc14e3e05013070ee959fc0b8703f6860a2776ed6e75b9c748f61aced0/pydantic_core-2.50.4-cp315-cp315t-manylinux1_i686.manylinux_2_5_i686.whl", hash = "sha256:789a6453e5ffd18a7ab6b8c3a0dd8403053829197ec258ecb90c604c21ffcc99", size = 2272481, upload-time = "2026-11-05T09:14:32.578Z" }, + { url = "https://files.pythonhosted.org/packages/13/c9/d56999aa7236dc9303091db2b1ef7303f0b022baf25ebf33cd200c0cb933/pydantic_core-2.50.4-cp315-cp315t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:6348ad12fa741bcc9c2f173e99fbf27cbc038826d8c31a4a7d836eca27878ba2", size = 2113069, upload-time = "2026-11-05T09:14:34.69Z" }, + { url = "https://files.pythonhosted.org/packages/b7/d5/a62da9e72f272f198f6118c5457332bbd4b9fdc4b77858448120569756de/pydantic_core-2.50.4-cp315-cp315t-manylinux2014_armv7l.manylinux_2_17_armv7l.whl", hash = "sha256:d49127f137f871cde3c5650af33bbbdcee02679dae76e020902fa106f522b8ae", size = 2202754, upload-time = "2026-11-05T09:14:36.49Z" }, + { url = "https://files.pythonhosted.org/packages/37/4a/e7f21577f96e42ac3082cd014df398c1c913d482afac1c8ef17b9e039198/pydantic_core-2.50.4-cp315-cp315t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:2f5cc5bcb94063fbbdfd285a2b302da34af07491337c10bb35de1d5220fa1583", size = 2411472, upload-time = "2026-11-05T09:14:38.63Z" }, + { url = "https://files.pythonhosted.org/packages/38/ad/c57c5e13bbfd3404ec1af519764aadbc52ee01e39f9f9ae9d28317f982f2/pydantic_core-2.50.4-cp315-cp315t-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:b99bed995ed7c41515c11fe2beb86f8a6cc298e5537cae2f736de2f982f74ef0", size = 2475330, upload-time = "2026-11-05T09:14:40.519Z" }, + { url = "https://files.pythonhosted.org/packages/6e/63/65cf0e1f1fd8cfaafee3c005712b8020e063b0f3e3571493ea68db5ec44f/pydantic_core-2.50.4-cp315-cp315t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:faa4e96385c820ce9d7f7a623486e23d4134ae3c9ba2071e44e0ab5a5a5002c4", size = 2265718, upload-time = "2026-11-05T09:14:42.379Z" }, + { url = "https://files.pythonhosted.org/packages/72/5d/fd9fdec9b25e2ef1f788970a84f749f0e28f166573c87654fd5387d8e5ce/pydantic_core-2.50.4-cp315-cp315t-manylinux_2_31_riscv64.whl", hash = "sha256:d6a166978f22f10cb91413f70519861605219346decf65bc79008f9257c94afe", size = 2273454, upload-time = "2026-11-05T09:14:44.286Z" }, + { url = "https://files.pythonhosted.org/packages/34/8c/19705c6d5eb72ff8c25006df8a375da7466176a5968781789e5415384f65/pydantic_core-2.50.4-cp315-cp315t-musllinux_1_1_aarch64.whl", hash = "sha256:a70d5effebd81ebd8e15a8aabdc7980832367b2b00c36543bac378977004cc80", size = 2314862, upload-time = "2026-11-05T09:14:45.97Z" }, + { url = "https://files.pythonhosted.org/packages/b8/fb/acefa27031aba2646b0d3026c4a1602e526489d39395ab17bc47f03234e3/pydantic_core-2.50.4-cp315-cp315t-musllinux_1_1_armv7l.whl", hash = "sha256:f8fd23653a252cefabea11cd041efd7b80bdf403e43a36dea53f9cb0aaa21f0f", size = 2479073, upload-time = "2026-11-05T09:14:47.526Z" }, + { url = "https://files.pythonhosted.org/packages/ef/e1/db08fa1e5edf1779fa0612f8d09f9030bdc513f593687c883cb781b86caa/pydantic_core-2.50.4-cp315-cp315t-musllinux_1_1_x86_64.whl", hash = "sha256:7646353a5a7c553c04167aca628e2550b538f492765b03ccf34321a560acc43c", size = 2521328, upload-time = "2026-11-05T09:14:49.042Z" }, + { url = "https://files.pythonhosted.org/packages/0d/51/bf1ec5b96c076d8d514b08f3bcffb3397df7a0fcc729eb960838a8bbe27f/pydantic_core-2.50.4-cp315-cp315t-win32.whl", hash = "sha256:65376dbe1ab4dbc768ca2b72b7c13993562c035f5925fd3bc7ff9c8c585c515d", size = 2107629, upload-time = "2026-11-05T09:14:50.891Z" }, + { url = "https://files.pythonhosted.org/packages/18/32/43d5db1824ec2314f737ff8d9962ff59954a74616d8656a8cc78790e45f1/pydantic_core-2.50.4-cp315-cp315t-win_amd64.whl", hash = "sha256:f08ee8248aad2d054e5bc4c73554d4505464698f6d754f16198dbc5764e9821d", size = 2244906, upload-time = "2026-11-05T09:14:53.056Z" }, + { url = "https://files.pythonhosted.org/packages/3a/c0/38c505004969c4641c3a077a8e72e354f02d5c06d8f51d7a103699704772/pydantic_core-2.50.4-cp315-cp315t-win_arm64.whl", hash = "sha256:da779ae50b46f3f7d1e1b5f362fdc0ad376a49fd55f6f3122dc2b6149936cdf7", size = 2179018, upload-time = "2026-11-05T09:14:54.448Z" }, + { url = "https://files.pythonhosted.org/packages/9a/18/2f6a25e9104d5af713d16671711927601da1f0db74e785be67bd590385c9/pydantic_core-2.50.4-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:c04e9d920e2674f54651fd260a15c5d2843526c73d5242ee4311325ddc9573b3", size = 2212591, upload-time = "2026-11-05T09:14:56.262Z" }, + { url = "https://files.pythonhosted.org/packages/4c/1b/ba8b721af10a7659e7fbbef320ff8eb55462557a72607858af5a9bd22cb1/pydantic_core-2.50.4-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:5bc1811ef2b4d4ba63e8e452f6e332b6374bd1d2cbbfdf66826c8cb1f71dd10d", size = 2048167, upload-time = "2026-11-05T09:14:57.681Z" }, + { url = "https://files.pythonhosted.org/packages/48/42/3f8638e7d90bdd9a7c7f3e5084723af59e7f43f15a292e242d35624073ce/pydantic_core-2.50.4-graalpy312-graalpy250_312_native-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:0b059a7968b1911be5a2d9a8234827ab0bef9d1e465d4b42da525894143550e8", size = 2119548, upload-time = "2026-11-05T09:14:59.317Z" }, + { url = "https://files.pythonhosted.org/packages/e0/8d/4bfbacaf191f7939893d165e18eb301731fa3366c59a6e57336c4f168fbd/pydantic_core-2.50.4-graalpy312-graalpy250_312_native-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:bee28aab5a580eec673f7b68dfa8dece3dd37bd207ef8d22fafe23a8e9837296", size = 2279952, upload-time = "2026-11-05T09:15:00.907Z" }, + { url = "https://files.pythonhosted.org/packages/9e/3a/d405a50e02ea81cd95e93fc97f43d351eeaa1707c28aa6fb58a9f1c1efa9/pydantic_core-2.50.4-graalpy313-graalpy253_313_native-macosx_11_0_arm64.whl", hash = "sha256:71e03d2ea1a221d020cfc5b6cc8bbbedef23a06704c70fcf4d0afb42965b22d1", size = 2049324, upload-time = "2026-11-05T09:15:02.379Z" }, + { url = "https://files.pythonhosted.org/packages/8f/3b/03e7992115e17cae4131ecd71aadb8fd5e4a04cc2aead72c3c27e9b453d1/pydantic_core-2.50.4-graalpy313-graalpy253_313_native-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:09450778e3ab58d3f565899fcfbf6c82926e31af29e28e799d1d50941316e0cb", size = 2119802, upload-time = "2026-11-05T09:15:03.901Z" }, + { url = "https://files.pythonhosted.org/packages/e3/d5/b76fc647e473377ca6e693c21549ee3a4a7677e4962c28ae4659337c5114/pydantic_core-2.50.4-graalpy313-graalpy253_313_native-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:4eb15be588407148ef5937dc8d9256a71f6b115e6cddadb7aa20b6ee384680dc", size = 2280639, upload-time = "2026-11-05T09:15:05.374Z" }, + { url = "https://files.pythonhosted.org/packages/d8/18/3ca5b3b8ce7a540305e6856d013e9c6b9c0fef93258fef6038db0beb233a/pydantic_core-2.50.4-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:39f489ce31272073e6e146f6781690f9c1ee8c126836e6403361ef91154d89fe", size = 2166960, upload-time = "2026-11-05T09:15:06.902Z" }, + { url = "https://files.pythonhosted.org/packages/a3/60/65d725001bffcde0170f6d37ae8bccce715e5311122eb6127f698115957e/pydantic_core-2.50.4-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:5b26e5f1793b96cdc60242bf38da86ff24a27a708aa396214cac9b534bf571c7", size = 2085636, upload-time = "2026-11-05T09:15:08.395Z" }, + { url = "https://files.pythonhosted.org/packages/ac/12/934cf1d44a3fee3c47231d4690dddee19264150c3aa59a3ddf66fa43454d/pydantic_core-2.50.4-pp311-pypy311_pp73-manylinux1_i686.manylinux_2_5_i686.whl", hash = "sha256:7210398a1607ad607dc73196e575b3148b00a333cbb602ddbe1b60ba54554f43", size = 2284621, upload-time = "2026-11-05T09:15:09.82Z" }, + { url = "https://files.pythonhosted.org/packages/c4/91/52248eee98d76f8d9239166d24928f805292df16729109f4f189cdb59be4/pydantic_core-2.50.4-pp311-pypy311_pp73-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:2f42584e5785385f681163a42506cab0d51295e17599a648396c52a7046c1372", size = 2277673, upload-time = "2026-11-05T09:15:11.236Z" }, + { url = "https://files.pythonhosted.org/packages/9f/89/900a7970ef19843aa79522a95b461e9c365b7fedd7ee80ef28a84dae9a41/pydantic_core-2.50.4-pp311-pypy311_pp73-musllinux_1_1_aarch64.whl", hash = "sha256:2039e323acee9abfec1fb5f661776e8965fe5928f3b7f8431900a774cba5c317", size = 2297354, upload-time = "2026-11-05T09:15:12.798Z" }, + { url = "https://files.pythonhosted.org/packages/de/ec/053d829437f70070cdd7116a0257cc0da651103328ff1e9e82954c45efd6/pydantic_core-2.50.4-pp311-pypy311_pp73-musllinux_1_1_armv7l.whl", hash = "sha256:71ade6d2e445839350d589ff99bbddfde16f3f32db28da5c894a09f99c8b2a03", size = 2469913, upload-time = "2026-11-05T09:15:14.319Z" }, + { url = "https://files.pythonhosted.org/packages/80/af/207c821cb0813e16d630660e0073491e3ab07370efaa6fa0b8b10fffb7b6/pydantic_core-2.50.4-pp311-pypy311_pp73-musllinux_1_1_x86_64.whl", hash = "sha256:d7d406709ae924cf0b08b8282ca2f0e1c90526911d93bc040557cbc83b74c55f", size = 2503746, upload-time = "2026-11-05T09:15:15.736Z" }, + { url = "https://files.pythonhosted.org/packages/e7/ca/8a053f24e22d8150349cabaecb2f35c89dcf07fbaadb5e48295184dd0e5b/pydantic_core-2.50.4-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:7472c39480ccc11dda69a196d1b7c7a6b48eb6594b77f05d945599d3e47f731c", size = 2333540, upload-time = "2026-11-05T09:15:17.883Z" }, + { url = "https://files.pythonhosted.org/packages/ac/9d/41b374c62cdb87f84081e2ef2963a115eacc6284a26dbc96bb83568e83ec/pydantic_core-2.50.4-pp311-pypy311_pp80-macosx_10_12_x86_64.whl", hash = "sha256:b67d38e8bb0ade7e6e84575e4bb153fab35b122458077273aeb08fdf12be9d2c", size = 2166962, upload-time = "2026-11-05T09:15:20.276Z" }, + { url = "https://files.pythonhosted.org/packages/9a/4f/51ef440ee346d4388a2c4a3ac4b271fcc7b1d3ff68be8da2ed2be4d488b0/pydantic_core-2.50.4-pp311-pypy311_pp80-macosx_11_0_arm64.whl", hash = "sha256:4eda7e3fdef382b7d4492745988a5baaf6953923a337f8b9dde5f76fa8afde20", size = 2085634, upload-time = "2026-11-05T09:15:21.953Z" }, + { url = "https://files.pythonhosted.org/packages/4b/5f/c9ed62b96beb9050db221d29e81856b6e28f277db601f8b0c3a08f8cf913/pydantic_core-2.50.4-pp311-pypy311_pp80-manylinux_2_28_x86_64.whl", hash = "sha256:474f7e598c7902165662a5d5160d3fce31037890a2975a9871ebf7c05862300b", size = 2277804, upload-time = "2026-11-05T09:15:23.836Z" }, + { url = "https://files.pythonhosted.org/packages/63/bd/b912a5e251ef10ed7be5e543a2bfbeebb0c79bf6302bee786f8dc3bf4341/pydantic_core-2.50.4-pp311-pypy311_pp80-win_amd64.whl", hash = "sha256:3e0b395648c6cb871bceb2906907f255dc876ec425f2d5b024e129985cea8519", size = 2333539, upload-time = "2026-11-05T09:15:25.354Z" }, ] [[package]] name = "pygments" -version = "2.19.2" +version = "2.21.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/b0/77/a5b8c569bf593b0140bde72ea885a803b82086995367bf2037de0159d924/pygments-2.19.2.tar.gz", hash = "sha256:636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887", size = 4968631, upload-time = "2025-06-21T13:39:12.283Z" } +sdist = { url = "https://files.pythonhosted.org/packages/49/2e/ced460408999b33da6b31b0021b0f37d329e202d4169aeb164493778f25b/pygments-2.21.0.tar.gz", hash = "sha256:610ca751c9bc2492b38eb9a38a7fbc93edbbb2d7182edaf34e66ae493dee5c8c", size = 5005329, upload-time = "2026-08-17T08:02:48.824Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b", size = 1225217, upload-time = "2025-06-21T13:39:07.939Z" }, + { url = "https://files.pythonhosted.org/packages/71/46/17f022dd3e953bf20a04a028a21ec746d942f8d2af30fa0f124fa0e6a684/pygments-2.21.0-py3-none-any.whl", hash = "sha256:2363c69b61c4a97c838da3b130dcd6468f4848992b21a82f2a63ec34377137d9", size = 1250147, upload-time = "2026-08-17T08:02:44.912Z" }, ] [[package]] name = "pytest" -version = "9.0.1" +version = "9.2.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "colorama", marker = "sys_platform == 'win32'" }, @@ -322,22 +628,47 @@ dependencies = [ { name = "pluggy" }, { name = "pygments" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/07/56/f013048ac4bc4c1d9be45afd4ab209ea62822fb1598f40687e6bf45dcea4/pytest-9.0.1.tar.gz", hash = "sha256:3e9c069ea73583e255c3b21cf46b8d3c56f6e3a1a8f6da94ccb0fcf57b9d73c8", size = 1564125, upload-time = "2025-11-12T13:05:09.333Z" } +sdist = { url = "https://files.pythonhosted.org/packages/79/42/bb4641652e58dedeac2ec51abc1f8cae4fee4ec63899a0999016229a0f2a/pytest-9.2.0.tar.gz", hash = "sha256:97c4f3b1f3c7414aa36465e09b8220f1d03627993bd51b1282e193753c80557b", size = 1797555, upload-time = "2026-10-27T21:30:20.728Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/0b/8b/6300fb80f858cda1c51ffa17075df5d846757081d11ab4aa35cef9e6258b/pytest-9.0.1-py3-none-any.whl", hash = "sha256:67be0030d194df2dfa7b556f2e56fb3c3315bd5c8822c6951162b92b32ce7dad", size = 373668, upload-time = "2025-11-12T13:05:07.379Z" }, + { url = "https://files.pythonhosted.org/packages/51/39/1f5d8c8877a0fa327db959c19341d4be61660de1ab6b7391f9eb805bcd67/pytest-9.2.0-py3-none-any.whl", hash = "sha256:07acdcf88ec174f907dc01af70bf52d49b014bbab03faeeade31c96b18c2e588", size = 411776, upload-time = "2026-10-27T21:30:19.131Z" }, ] [[package]] name = "rich" -version = "14.2.0" +version = "15.0.0" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "markdown-it-py" }, { name = "pygments" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/fb/d2/8920e102050a0de7bfabeb4c4614a49248cf8d5d7a8d01885fbb24dc767a/rich-14.2.0.tar.gz", hash = "sha256:73ff50c7c0c1c77c8243079283f4edb376f0f6442433aecb8ce7e6d0b92d1fe4", size = 219990, upload-time = "2025-10-09T14:16:53.064Z" } +sdist = { url = "https://files.pythonhosted.org/packages/c0/8f/0722ca900cc807c13a6a0c696dacf35430f72e0ec571c4275d2371fca3e9/rich-15.0.0.tar.gz", hash = "sha256:edd07a4824c6b40189fb7ac9bc4c52536e9780fbbfbddf6f1e2502c31b068c36", size = 230680, upload-time = "2026-04-12T08:24:00.75Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/25/7a/b0178788f8dc6cafce37a212c99565fa1fe7872c70c6c9c1e1a372d9d88f/rich-14.2.0-py3-none-any.whl", hash = "sha256:76bc51fe2e57d2b1be1f96c524b890b816e334ab4c1e45888799bfaab0021edd", size = 243393, upload-time = "2025-10-09T14:16:51.245Z" }, + { url = "https://files.pythonhosted.org/packages/82/3b/64d4899d73f91ba49a8c18a8ff3f0ea8f1c1d75481760df8c68ef5235bf5/rich-15.0.0-py3-none-any.whl", hash = "sha256:33bd4ef74232fb73fe9279a257718407f169c09b78a87ad3d296f548e27de0bb", size = 310654, upload-time = "2026-04-12T08:24:02.83Z" }, +] + +[[package]] +name = "ruff" +version = "0.17.5" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/86/cc/7b71512eb8b49926efb887cc66c74dd993642943c29eba51a877f6b85692/ruff-0.17.5.tar.gz", hash = "sha256:625e57d80cd43352d12ea81690f3eac46cddc8c0f35026d137fb0f157f94592e", size = 5368382, upload-time = "2026-11-12T17:54:55.04Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/d4/f2/61df414cb4338617290a9023ad09486e207fb9a6d09357a7be34f2e369a4/ruff-0.17.5-py3-none-linux_armv6l.whl", hash = "sha256:d511dd302982e46a285528942fa6557d57730edc4bdb9def95e86a2603d77396", size = 10231309, upload-time = "2026-11-12T17:54:09.314Z" }, + { url = "https://files.pythonhosted.org/packages/d1/72/8ed970f3361f7c8d3f8e1b3b1af27cf086bc4b3a6b62ec20e21a1aaaaff5/ruff-0.17.5-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:b72fbc232e328bdbb9cdddf4f1aedcd61bd1aa64d75fc012114b4add0bd7f26b", size = 10250018, upload-time = "2026-11-12T17:54:11.983Z" }, + { url = "https://files.pythonhosted.org/packages/dc/4b/8b10f6c9d0a18413301ae8dd2af9d180a81bb738b1b731d944a37404c523/ruff-0.17.5-py3-none-macosx_11_0_arm64.whl", hash = "sha256:6f0db748508f04a04e3fbebcc636a5c8b3bd76274f8ed28f497c44d75c2ea2d7", size = 9504737, upload-time = "2026-11-12T17:54:14.567Z" }, + { url = "https://files.pythonhosted.org/packages/b7/ea/1b3afa3943239dede7a0755ea139bdb51879f0f3f96f92894081d5c7d2e5/ruff-0.17.5-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6f6a7b138edf9cc402ca736a59d9525e6d766e5395760b72e7e146e6251ac963", size = 10168006, upload-time = "2026-11-12T17:54:17.195Z" }, + { url = "https://files.pythonhosted.org/packages/31/08/ee641daa45f83792f91274b65796cb011f1065f588911bfa3909ad9e31e7/ruff-0.17.5-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:e52622ecf3a0df9d03e796fe3eed4aa085adda65520db7e0619cbd2192a97342", size = 10043751, upload-time = "2026-11-12T17:54:19.815Z" }, + { url = "https://files.pythonhosted.org/packages/f8/cf/1c59fdb42d0b5671ad5b160636fab4005ee28db72cb06aef6e3f3c04f377/ruff-0.17.5-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:54c0f67d1be11b55d12c184a819fc229f5eee3ef45c16c4fcad41258e83b4882", size = 10690562, upload-time = "2026-11-12T17:54:22.789Z" }, + { url = "https://files.pythonhosted.org/packages/49/c5/578074716173fb0c1591e9648a9f85c469888d9530cb35b89b757dc1208b/ruff-0.17.5-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:dd0dfe7c6fe5a447fce467c58e69893be1d9a7e4378f5b9906432da33d94a97f", size = 11338465, upload-time = "2026-11-12T17:54:25.523Z" }, + { url = "https://files.pythonhosted.org/packages/aa/b9/d6428bcf5ed88f4dc1d6e3417ee350236ed36e7a35f9477b727c00e437bf/ruff-0.17.5-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:ec4ecf40fb4d6e1265b009dbe551727920926fc0f769070c452d6d84b422a74d", size = 10895501, upload-time = "2026-11-12T17:54:28.441Z" }, + { url = "https://files.pythonhosted.org/packages/f2/8a/1e29c0c3785ae7e5cd0d54ee8717a08867ef71545796340be4c653c57e24/ruff-0.17.5-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:40ca8afaac309b41a5b2e09e4e7beb1f824826b93c25697c4d74f573324fba4e", size = 10613231, upload-time = "2026-11-12T17:54:30.862Z" }, + { url = "https://files.pythonhosted.org/packages/32/b6/88944350c14bb90651014d678ad554e233ae2a79c14ad52101845f93d15b/ruff-0.17.5-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:8e85601bd6d9b6c3e3b95c0e0dccdbac1d23c6bcef006d187fbcddaf8225a5df", size = 10562789, upload-time = "2026-11-12T17:54:33.869Z" }, + { url = "https://files.pythonhosted.org/packages/6f/fd/2792e955b0bf54295cdcdddc4bb3f380c0790d7e60e789f528a9e6e48a31/ruff-0.17.5-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:f93d2b7d449ed9545304f6923699ca20d13c675b69f258481709a08ae61076db", size = 10069824, upload-time = "2026-11-12T17:54:36.663Z" }, + { url = "https://files.pythonhosted.org/packages/07/9c/d7cad341b4c19237948a6dd1fcea1c9c39c9d08b70f22f0e157d1236ebd6/ruff-0.17.5-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:0e5c125c5b31dc8efc948d41357496a4c4a312977565ccba740030efdff83580", size = 10038961, upload-time = "2026-11-12T17:54:39.452Z" }, + { url = "https://files.pythonhosted.org/packages/cc/a1/9cd0d4c371ddc70267d3bd557e718e2bdfb94c25e49d25605edfabb764bd/ruff-0.17.5-py3-none-musllinux_1_2_i686.whl", hash = "sha256:50dfc3c6b3ebd0a932f11dfd579bd42234b0b7137e68940eb6abdbfdb9d69697", size = 10385012, upload-time = "2026-11-12T17:54:41.808Z" }, + { url = "https://files.pythonhosted.org/packages/8f/a9/35f078ce98d4df318328ea5270382b5b65e680f7953b3db54f8e009c420c/ruff-0.17.5-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:86bd1f3b83c25f9b8055c6e796f0685b39d3127ce947322098c3108cf82fd586", size = 10793672, upload-time = "2026-11-12T17:54:44.342Z" }, + { url = "https://files.pythonhosted.org/packages/2c/a5/2e136dede2a88aaaf54498bbbdc81bc810f788ef6ef01efb97037d73cd1d/ruff-0.17.5-py3-none-win32.whl", hash = "sha256:e1546609b2ad73f1d6c5c076881b788672b7b3cc3283981182cbdbb6524ed88a", size = 9929908, upload-time = "2026-11-12T17:54:47.067Z" }, + { url = "https://files.pythonhosted.org/packages/ec/8c/e4db9ae1e0ee233c04df007ab6d0d42f799ae9abd95d352b6092ee7bc4bf/ruff-0.17.5-py3-none-win_amd64.whl", hash = "sha256:aa415d57c244299279901d776607fee3df7831c2a7435433fbfacde8632c6550", size = 10275454, upload-time = "2026-11-12T17:54:49.401Z" }, + { url = "https://files.pythonhosted.org/packages/e6/65/a1648bc1550e7683bf7bf1e2ce2485c9f8535cbca6cca9ec7b73cc12fb8e/ruff-0.17.5-py3-none-win_arm64.whl", hash = "sha256:64a6fd668a336df959c522991de33e9e3c8be463afc0c9ac8f029f9d19ef756e", size = 9849020, upload-time = "2026-11-12T17:54:52.055Z" }, ] [[package]] @@ -351,45 +682,62 @@ wheels = [ [[package]] name = "soupsieve" -version = "2.8" +version = "2.10" +source = { registry = "https://pypi.org/simple" } +resolution-markers = [ + "python_full_version < '3.11.5'", +] +sdist = { url = "https://files.pythonhosted.org/packages/71/c3/1b817965ac12dc002d7c9cd7dfffdd7d4fbf9b45763ef2ffe7b86ee94670/soupsieve-2.10.tar.gz", hash = "sha256:49e9380d7d2905463583bafe285e818c7366a9ed7b3aee221c1ac79c905d8bc0", size = 124337, upload-time = "2026-09-24T02:36:35.048Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/66/87/5ed59e1d0290564e2027ed066c52b059892c4637741337fc0967183c8d4d/soupsieve-2.10-py3-none-any.whl", hash = "sha256:8596eb8967d744174820280fa62b4542a2e955bfaccca73ed8a13c6eb8e9b502", size = 38019, upload-time = "2026-09-24T02:36:33.709Z" }, +] + +[[package]] +name = "soupsieve" +version = "4.1" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/6d/e6/21ccce3262dd4889aa3332e5a119a3491a95e8f60939870a3a035aabac0d/soupsieve-2.8.tar.gz", hash = "sha256:e2dd4a40a628cb5f28f6d4b0db8800b8f581b65bb380b97de22ba5ca8d72572f", size = 103472, upload-time = "2025-08-27T15:39:51.78Z" } +resolution-markers = [ + "python_full_version >= '3.15'", + "python_full_version >= '3.11.5' and python_full_version < '3.15'", +] +sdist = { url = "https://files.pythonhosted.org/packages/95/48/21a393ff731b8f928fa4f8176f9a7ceba2252ee60a5149f25b45c292aa5c/soupsieve-4.1.tar.gz", hash = "sha256:ca9abf7126667010d8f6e9b39bfc1bc3b23c8aed9bcb0f54a754dde969bb8aab", size = 161955, upload-time = "2026-11-10T01:59:50.399Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/14/a0/bb38d3b76b8cae341dad93a2dd83ab7462e6dbcdd84d43f54ee60a8dc167/soupsieve-2.8-py3-none-any.whl", hash = "sha256:0cc76456a30e20f5d7f2e14a98a4ae2ee4e5abdc7c5ea0aafe795f344bc7984c", size = 36679, upload-time = "2025-08-27T15:39:50.179Z" }, + { url = "https://files.pythonhosted.org/packages/88/73/6a2087c72975cfc07394623bca8d17654342ea4055ae368deafe5a81a542/soupsieve-4.1-py3-none-any.whl", hash = "sha256:e4d667b3974ce6e038e7390486b8093369854a1d345ffdd4c121dfc4a782e809", size = 52302, upload-time = "2026-11-10T01:59:48.571Z" }, ] [[package]] name = "typer" -version = "0.20.0" +version = "0.29.1" source = { registry = "https://pypi.org/simple" } dependencies = [ - { name = "click" }, + { name = "annotated-doc" }, + { name = "colorama", marker = "sys_platform == 'win32'" }, + { name = "pydantic" }, { name = "rich" }, { name = "shellingham" }, - { name = "typing-extensions" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/8f/28/7c85c8032b91dbe79725b6f17d2fffc595dff06a35c7a30a37bef73a1ab4/typer-0.20.0.tar.gz", hash = "sha256:1aaf6494031793e4876fb0bacfa6a912b551cf43c1e63c800df8b1a866720c37", size = 106492, upload-time = "2025-10-20T17:03:49.445Z" } +sdist = { url = "https://files.pythonhosted.org/packages/6c/aa/0de7986aa1fa856adb961c67345189b97d13f6e250b34ba68884df865f07/typer-0.29.1.tar.gz", hash = "sha256:ab6eb3880bf67ce96147734717f9ec333c06f66e361f3ea947d0be43da39f242", size = 205843, upload-time = "2026-11-11T09:18:39.782Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/78/64/7713ffe4b5983314e9d436a90d5bd4f63b6054e2aca783a3cfc44cb95bbf/typer-0.20.0-py3-none-any.whl", hash = "sha256:5b463df6793ec1dca6213a3cf4c0f03bc6e322ac5e16e13ddd622a889489784a", size = 47028, upload-time = "2025-10-20T17:03:47.617Z" }, + { url = "https://files.pythonhosted.org/packages/05/ff/51969745f31cea6bcd12151e668febcf979656316e67a7755942267c1273/typer-0.29.1-py3-none-any.whl", hash = "sha256:00dbc549c13428bec1be55fe1f4d0fb8c6637a310e4f178ef14abe9534ee7b58", size = 121064, upload-time = "2026-11-11T09:18:38.671Z" }, ] [[package]] name = "typing-extensions" -version = "4.15.0" +version = "4.16.0" source = { registry = "https://pypi.org/simple" } -sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391, upload-time = "2025-08-25T13:49:26.313Z" } +sdist = { url = "https://files.pythonhosted.org/packages/f6/cc/6253133b5bb138fc3306cebfbda2c520f545d36b5be2c7255cc528bb45d6/typing_extensions-4.16.0.tar.gz", hash = "sha256:dc983d19a509c94dba722ee6abd33940f7c05a89e243c47e907eb4db6f1a43e5", size = 113555, upload-time = "2026-07-02T08:40:05.92Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" }, + { url = "https://files.pythonhosted.org/packages/49/d3/b8441a820a491ddfc024b0b0cf0393375b75ea13866d9c66727e54c2fc80/typing_extensions-4.16.0-py3-none-any.whl", hash = "sha256:481caa481374e813c1b176ada14e97f1f67a4539ce9cfeb3f350d78d6370c2e8", size = 45571, upload-time = "2026-07-02T08:40:04.659Z" }, ] [[package]] name = "typing-inspection" -version = "0.4.2" +version = "0.4.5" source = { registry = "https://pypi.org/simple" } dependencies = [ { name = "typing-extensions" }, ] -sdist = { url = "https://files.pythonhosted.org/packages/55/e3/70399cb7dd41c10ac53367ae42139cf4b1ca5f36bb3dc6c9d33acdb43655/typing_inspection-0.4.2.tar.gz", hash = "sha256:ba561c48a67c5958007083d386c3295464928b01faa735ab8547c5692e87f464", size = 75949, upload-time = "2025-10-01T02:14:41.687Z" } +sdist = { url = "https://files.pythonhosted.org/packages/ff/50/0195198eb1d75bab716bb0a813abea4cc394bfa17a92a189f021a34859af/typing_inspection-0.4.5.tar.gz", hash = "sha256:7f16c411e7930dc79596d42ab44672a3fe5f60eb34b781a1647e7872363120c7", size = 81194, upload-time = "2026-11-04T14:13:23.774Z" } wheels = [ - { url = "https://files.pythonhosted.org/packages/dc/9b/47798a6c91d8bdb567fe2698fe81e0c6b7cb7ef4d13da4114b41d239f65d/typing_inspection-0.4.2-py3-none-any.whl", hash = "sha256:4ed1cacbdc298c220f1bd249ed5287caa16f34d44ef4e9c3d0cbad5b521545e7", size = 14611, upload-time = "2025-10-01T02:14:40.154Z" }, + { url = "https://files.pythonhosted.org/packages/de/0c/ea2544850a7c135e15033a5c7a8e7211136184b7ae63e2239d557c2b3019/typing_inspection-0.4.5-py3-none-any.whl", hash = "sha256:bc210535442b39e1bf2805e0c7a17dfd6a4ace760c84c7f7d16245d23a6b1c39", size = 14874, upload-time = "2026-11-04T14:13:22.616Z" }, ] From d68be35c021a73d99dce8b2cde1c937ecbd55a41 Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:26:33 -0500 Subject: [PATCH 05/45] Add GitHub Actions workflow for quality checks --- .github/workflows/quality.yml | 63 +++++++++++++++++++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 .github/workflows/quality.yml diff --git a/.github/workflows/quality.yml b/.github/workflows/quality.yml new file mode 100644 index 0000000..04b18b8 --- /dev/null +++ b/.github/workflows/quality.yml @@ -0,0 +1,63 @@ +name: Quality + +on: + push: + pull_request: + +permissions: + contents: read + +jobs: + test: + name: Python ${{ matrix.python-version }} on ${{ matrix.os }} + runs-on: ${{ matrix.os }} + strategy: + fail-fast: false + matrix: + include: + - os: ubuntu-latest + python-version: "3.11" + - os: ubuntu-latest + python-version: "3.12" + - os: ubuntu-latest + python-version: "3.13" + - os: ubuntu-latest + python-version: "3.14" + - os: macos-latest + python-version: "3.14" + - os: windows-latest + python-version: "3.14" + + steps: + - name: Check out repository + uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + + - name: Install uv and Python + uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3 + with: + python-version: ${{ matrix.python-version }} + + - name: Install project + run: uv sync --locked --group dev + + - name: Test + run: uv run pytest -q + + - name: Smoke-test diagnostics + run: uv run elf doctor + + - name: Lint + if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11' + run: uv run ruff check elf tests + + - name: Check formatting + if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11' + run: uv run ruff format --check elf tests + + - name: Type check + if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11' + run: uv run mypy + + - name: Build distributions + if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11' + run: uv build From e41bf3498a3fa7fdd0ba15e0a23801e350aa1cd8 Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:27:19 -0500 Subject: [PATCH 06/45] Add comprehensive tests for caching, submissions, and event handling - Enhance test coverage for answer guardrails with new scenarios for server retry deadlines and cache writing. - Introduce tests for cache safety to ensure isolation between accounts and proper handling of legacy cache files. - Implement tests for AOC client to verify user agent handling and session management. - Add tests for input and leaderboard caching to validate isolation and concurrent access. - Create tests for submission handling to ensure correct parsing of responses and error management. - Introduce tests for event handling to validate event day counts and defaults. - Ensure all tests maintain security by not exposing sensitive information in outputs. --- tests/fixtures/status_2015.html | 17 +++ tests/fixtures/status_2024.html | 23 +++ tests/fixtures/status_2025.html | 16 ++ tests/test_answer.py | 108 +++++++++++++- tests/test_answer_guardrails.py | 93 +++++++++++- tests/test_aoc_client.py | 40 ++++- tests/test_cache_safety.py | 104 +++++++++++++ tests/test_cli_commands.py | 19 ++- tests/test_client_api.py | 253 ++++++-------------------------- tests/test_doctor.py | 48 ++++++ tests/test_events.py | 43 ++++++ tests/test_guess_cache.py | 1 + tests/test_input_cache.py | 69 +++++++++ tests/test_leaderboard_cache.py | 112 ++++++++++++++ tests/test_parsing.py | 45 +++++- tests/test_submission_http.py | 127 ++++++++++++++++ 16 files changed, 888 insertions(+), 230 deletions(-) create mode 100644 tests/fixtures/status_2015.html create mode 100644 tests/fixtures/status_2024.html create mode 100644 tests/fixtures/status_2025.html create mode 100644 tests/test_cache_safety.py create mode 100644 tests/test_doctor.py create mode 100644 tests/test_events.py create mode 100644 tests/test_input_cache.py create mode 100644 tests/test_leaderboard_cache.py create mode 100644 tests/test_submission_http.py diff --git a/tests/fixtures/status_2015.html b/tests/fixtures/status_2015.html new file mode 100644 index 0000000..731a79d --- /dev/null +++ b/tests/fixtures/status_2015.html @@ -0,0 +1,17 @@ + + +
+
archive-user 3*
+ Settings +
+

2015

+
+    
+      1
+    
+    
+      2
+    
+    25
+  
+ diff --git a/tests/fixtures/status_2024.html b/tests/fixtures/status_2024.html new file mode 100644 index 0000000..a00fad0 --- /dev/null +++ b/tests/fixtures/status_2024.html @@ -0,0 +1,23 @@ + + +
+
+ current-user + AoC++ + 2* +
+ Settings +
+

2024

+
+    
+      1
+    
+    
+      2
+    
+    
+      25
+    
+  
+ diff --git a/tests/fixtures/status_2025.html b/tests/fixtures/status_2025.html new file mode 100644 index 0000000..82e5f92 --- /dev/null +++ b/tests/fixtures/status_2025.html @@ -0,0 +1,16 @@ + + +
+
reduced-user 1*
+ Settings +
+

2025

+
+    
+      1
+    
+    
+      12
+    
+  
+ diff --git a/tests/test_answer.py b/tests/test_answer.py index 56fead9..8a652cd 100644 --- a/tests/test_answer.py +++ b/tests/test_answer.py @@ -1,7 +1,12 @@ +import csv +import time +from concurrent.futures import ThreadPoolExecutor +from datetime import UTC, datetime, timedelta + import pytest -from elf.answer import check_cached_guesses, write_guess_cache -from elf.models import SubmissionStatus +from elf.answer import check_cached_guesses, submit_answer, write_guess_cache +from elf.models import SubmissionResult, SubmissionStatus @pytest.fixture @@ -57,3 +62,102 @@ def test_bounds_inferred_from_cache(cache_dir): assert result.status is SubmissionStatus.TOO_LOW assert result.previous_guess == 10 assert "highest low" in result.message + + +def test_correct_guess_blocks_a_different_answer_for_completed_part(cache_dir): + write_guess_cache(2025, 1, 1, 42, SubmissionStatus.CORRECT) + + result = check_cached_guesses( + year=2025, + day=1, + level=1, + answer=43, + numeric_answer=43, + ) + + assert result.status is SubmissionStatus.COMPLETED + assert "already completed" in result.message + + +def test_later_correct_guess_supersedes_older_failure_and_cooldown(cache_dir): + cache_file = cache_dir / "2025" / "01" / "guesses.csv" + cache_file.parent.mkdir(parents=True) + now = datetime.now(UTC) + with cache_file.open("w", newline="", encoding="utf-8") as file: + writer = csv.writer(file) + writer.writerow(["timestamp", "part", "guess", "status"]) + writer.writerow([(now - timedelta(seconds=20)).isoformat(), 1, 41, "INCORRECT"]) + writer.writerow([(now - timedelta(seconds=10)).isoformat(), 1, 42, "WAIT"]) + writer.writerow([now.isoformat(), 1, 43, "CORRECT"]) + + result = check_cached_guesses( + year=2025, + day=1, + level=1, + answer=41, + numeric_answer=41, + ) + + assert result.status is SubmissionStatus.COMPLETED + assert "already completed" in result.message + + +def test_submission_guardrails_are_isolated_between_accounts(cache_dir, monkeypatch): + write_guess_cache( + 2025, + 1, + 1, + 42, + SubmissionStatus.INCORRECT, + session_token="account-a", + ) + submitted = [] + + def fake_submit(year, day, level, answer, session_token): + submitted.append(session_token) + return "network-result" + + monkeypatch.setattr("elf.answer.submit_to_aoc", fake_submit) + + cached = submit_answer(2025, 1, 1, 42, "account-a") + fresh = submit_answer(2025, 1, 1, 42, "account-b") + + assert cached.is_cached is True + assert fresh == "network-result" + assert submitted == ["account-b"] + + +def test_concurrent_submissions_are_checked_and_sent_once(cache_dir, monkeypatch): + submitted = [] + + def fake_submit(year, day, level, answer, session_token): + submitted.append(answer) + time.sleep(0.02) + write_guess_cache( + year, + day, + level, + answer, + SubmissionStatus.CORRECT, + session_token=session_token, + ) + return SubmissionResult( + guess=answer, + result=SubmissionStatus.CORRECT, + message="correct", + is_correct=True, + is_cached=False, + ) + + monkeypatch.setattr("elf.answer.submit_to_aoc", fake_submit) + + with ThreadPoolExecutor(max_workers=4) as executor: + results = list( + executor.map( + lambda _index: submit_answer(2025, 1, 1, 42, "account"), + range(4), + ) + ) + + assert submitted == [42] + assert sum(not result.is_cached for result in results) == 1 diff --git a/tests/test_answer_guardrails.py b/tests/test_answer_guardrails.py index 36cdb83..3a0bb94 100644 --- a/tests/test_answer_guardrails.py +++ b/tests/test_answer_guardrails.py @@ -1,7 +1,9 @@ import csv -from datetime import datetime, timedelta, timezone +from datetime import UTC, datetime, timedelta -from elf.answer import check_cached_guesses +import pytest + +from elf.answer import check_cached_guesses, write_guess_cache from elf.cache import get_cache_guess_file from elf.models import SubmissionStatus @@ -18,7 +20,7 @@ def test_check_cached_guesses_respects_wait_ttl(monkeypatch, tmp_path): monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) cache_file = get_cache_guess_file(2025, 1) - wait_timestamp = (datetime.now(timezone.utc) - timedelta(seconds=30)).isoformat() + wait_timestamp = (datetime.now(UTC) - timedelta(seconds=30)).isoformat() _write_guess_csv( cache_file, [ @@ -43,6 +45,85 @@ def test_check_cached_guesses_respects_wait_ttl(monkeypatch, tmp_path): assert "Cached locally" in result.message +def test_server_retry_deadline_overrides_legacy_wait_ttl(monkeypatch, tmp_path): + monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) + cache_file = get_cache_guess_file(2025, 1) + now = datetime.now(UTC) + cache_file.parent.mkdir(parents=True, exist_ok=True) + with cache_file.open("w", newline="", encoding="utf-8") as file: + writer = csv.writer(file) + writer.writerow(["timestamp", "part", "guess", "status", "retry_at"]) + writer.writerow( + [ + (now - timedelta(minutes=5)).isoformat(), + "1", + "500", + "WAIT", + (now + timedelta(minutes=2)).isoformat(), + ] + ) + + result = check_cached_guesses(2025, 1, 1, "600", 600) + + assert result.status is SubmissionStatus.WAIT + assert result.retry_at is not None + assert result.retry_at > now + timedelta(minutes=1) + + +def test_expired_server_retry_deadline_does_not_block(monkeypatch, tmp_path): + monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) + cache_file = get_cache_guess_file(2025, 1) + now = datetime.now(UTC) + cache_file.parent.mkdir(parents=True, exist_ok=True) + with cache_file.open("w", newline="", encoding="utf-8") as file: + writer = csv.writer(file) + writer.writerow(["timestamp", "part", "guess", "status", "retry_at"]) + writer.writerow( + [ + now.isoformat(), + "1", + "500", + "WAIT", + (now - timedelta(seconds=1)).isoformat(), + ] + ) + + result = check_cached_guesses(2025, 1, 1, "600", 600) + + assert result.status is SubmissionStatus.UNKNOWN + + +def test_writing_upgrades_legacy_guess_csv_without_losing_rows(monkeypatch, tmp_path): + monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) + cache_file = get_cache_guess_file(2025, 1) + _write_guess_csv( + cache_file, + [(datetime.now(UTC).isoformat(), "1", "41", "INCORRECT")], + ) + + retry_at = datetime.now(UTC) + timedelta(minutes=3) + write_guess_cache(2025, 1, 1, 42, SubmissionStatus.WAIT, retry_at=retry_at) + + with cache_file.open(newline="", encoding="utf-8") as file: + rows = list(csv.DictReader(file)) + assert [row["guess"] for row in rows] == ["41", "42"] + assert rows[0]["retry_at"] == "" + assert datetime.fromisoformat(rows[1]["retry_at"]) == retry_at + + +def test_writing_refuses_to_overwrite_malformed_guess_cache(monkeypatch, tmp_path): + monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) + cache_file = get_cache_guess_file(2025, 1) + cache_file.parent.mkdir(parents=True) + original = "unexpected,columns\nkeep,this\n" + cache_file.write_text(original, encoding="utf-8") + + with pytest.raises(RuntimeError, match="malformed header"): + write_guess_cache(2025, 1, 1, 42, SubmissionStatus.INCORRECT) + + assert cache_file.read_text(encoding="utf-8") == original + + def test_check_cached_guesses_short_circuits_completed(monkeypatch, tmp_path): monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) cache_file = get_cache_guess_file(2025, 2) @@ -51,7 +132,7 @@ def test_check_cached_guesses_short_circuits_completed(monkeypatch, tmp_path): cache_file, [ ( - datetime.now(timezone.utc).isoformat(), + datetime.now(UTC).isoformat(), "1", "123", "COMPLETED", @@ -78,13 +159,13 @@ def test_check_cached_guesses_infers_bounds(monkeypatch, tmp_path): cache_file, [ ( - datetime.now(timezone.utc).isoformat(), + datetime.now(UTC).isoformat(), "1", "40", "TOO_LOW", ), ( - (datetime.now(timezone.utc) - timedelta(minutes=1)).isoformat(), + (datetime.now(UTC) - timedelta(minutes=1)).isoformat(), "1", "100", "TOO_HIGH", diff --git a/tests/test_aoc_client.py b/tests/test_aoc_client.py index 09d35ba..f7ca3bf 100644 --- a/tests/test_aoc_client.py +++ b/tests/test_aoc_client.py @@ -3,7 +3,6 @@ import httpx import pytest -import elf.aoc_client from elf.aoc_client import ( AOCClient, _default_user_agent, @@ -13,9 +12,8 @@ @pytest.fixture -def aoc_client(monkeypatch): +def aoc_client(): def _make(): - monkeypatch.setattr(elf.aoc_client, "_shared_client", None) return AOCClient("fake_session") return _make @@ -39,15 +37,13 @@ def test_user_agent_set_in_AOCClient(monkeypatch, aoc_client): user_agent_header = httpx_client.headers.get("User-Agent", "") assert user_agent in user_agent_header assert _user_agent_prefix in user_agent_header + client.close() def test_default_user_agent_set_in_AOCClient(monkeypatch, aoc_client): # Simulate no AOC_USER_AGENT set in the environment so we hit the default UA path monkeypatch.delenv("AOC_USER_AGENT", raising=False) - # Ensure we get a fresh client instead of reusing a previously-initialized one - monkeypatch.setattr(elf.aoc_client, "_shared_client", None) - with pytest.warns(RuntimeWarning): client = aoc_client() @@ -55,3 +51,35 @@ def test_default_user_agent_set_in_AOCClient(monkeypatch, aoc_client): user_agent_header = httpx_client.headers.get("User-Agent", "") assert _default_user_agent in user_agent_header assert _user_agent_prefix in user_agent_header + client.close() + + +def test_invalid_user_agent_warning_does_not_echo_value(monkeypatch, aoc_client): + secret = "not-an-email-secret-value" + monkeypatch.setenv("AOC_USER_AGENT", secret) + + with pytest.warns(RuntimeWarning) as warning_list: + client = aoc_client() + + assert secret not in str(warning_list[0].message) + client.close() + + +def test_context_manager_closes_owned_client(monkeypatch): + monkeypatch.setenv("AOC_USER_AGENT", "valid@email.com") + + with AOCClient("fake_session") as client: + assert client._client.is_closed is False + + assert client._client.is_closed is True + + +def test_injected_http_client_is_not_closed(monkeypatch): + monkeypatch.setenv("AOC_USER_AGENT", "valid@email.com") + transport = httpx.Client() + + with AOCClient("fake_session", http_client=transport): + pass + + assert transport.is_closed is False + transport.close() diff --git a/tests/test_cache_safety.py b/tests/test_cache_safety.py new file mode 100644 index 0000000..c908fe3 --- /dev/null +++ b/tests/test_cache_safety.py @@ -0,0 +1,104 @@ +import os +from concurrent.futures import ThreadPoolExecutor +from datetime import timedelta + +import pytest + +from elf.answer import write_guess_cache +from elf.cache import ( + CacheLockTimeoutError, + atomic_write_text, + cache_file_lock, + get_cache_guess_file, + get_cache_input_file, + get_cache_leaderboard_file, + migrate_legacy_cache_file, +) +from elf.models import SubmissionStatus +from elf.utils import read_guesses + + +def test_private_cache_paths_are_isolated_without_exposing_credentials(monkeypatch, tmp_path): + monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) + + first = get_cache_input_file(2024, 1, "account-one-secret") + second = get_cache_input_file(2024, 1, "account-two-secret") + view = get_cache_leaderboard_file( + 2025, + 123, + session_token=None, + view_key="private-view-key", + ) + + assert first != second + assert "account-one-secret" not in str(first) + assert "account-two-secret" not in str(second) + assert "private-view-key" not in str(view) + + +def test_legacy_cache_is_preserved_and_claimed_by_only_one_account(monkeypatch, tmp_path): + monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) + legacy = get_cache_guess_file(2024, 2) + first = get_cache_guess_file(2024, 2, "first-account") + second = get_cache_guess_file(2024, 2, "second-account") + atomic_write_text(legacy, "historical guesses") + + assert migrate_legacy_cache_file(legacy, first) is True + assert migrate_legacy_cache_file(legacy, second) is False + + assert legacy.read_text() == "historical guesses" + assert first.read_text() == "historical guesses" + assert not second.exists() + + +def test_atomic_cache_writes_replace_content_and_use_private_mode(monkeypatch, tmp_path): + monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) + path = get_cache_input_file(2024, 3, "account") + + atomic_write_text(path, "first") + atomic_write_text(path, "second") + + assert path.read_text() == "second" + if os.name == "posix": + assert path.stat().st_mode & 0o777 == 0o600 + + +def test_cache_lock_times_out_and_reclaims_stale_leases(monkeypatch, tmp_path): + monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) + path = get_cache_input_file(2024, 4, "account") + + with ( + cache_file_lock(path), + pytest.raises(CacheLockTimeoutError), + cache_file_lock(path, timeout=0.01, stale_after=60), + ): + pass + + lock_file = path.with_name(f".{path.name}.lock") + lock_file.write_text("abandoned", encoding="utf-8") + stale_time = lock_file.stat().st_mtime - timedelta(minutes=5).total_seconds() + os.utime(lock_file, (stale_time, stale_time)) + + with cache_file_lock(path, timeout=0.1, stale_after=1): + assert lock_file.exists() + assert not lock_file.exists() + + +def test_concurrent_guess_writes_do_not_lose_rows(monkeypatch, tmp_path): + monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) + + def write(guess: int) -> None: + write_guess_cache( + 2024, + 5, + 1, + guess, + SubmissionStatus.INCORRECT, + session_token="account", + ) + + with ThreadPoolExecutor(max_workers=8) as executor: + list(executor.map(write, range(20))) + + guesses = read_guesses(2024, 5, session_token="account") + assert {guess.guess for guess in guesses} == set(range(20)) diff --git a/tests/test_cli_commands.py b/tests/test_cli_commands.py index e3ee766..86958cf 100644 --- a/tests/test_cli_commands.py +++ b/tests/test_cli_commands.py @@ -89,15 +89,26 @@ def fake_get_leaderboard(year, session, board_id, view_key, fmt): assert captured["fmt"] == OutputFormat.JSON +def test_json_output_is_not_interpreted_as_rich_markup(monkeypatch): + payload = '{"name": "[red]literal[/red]"}' + monkeypatch.setattr("elf.cli.get_leaderboard", lambda *args, **kwargs: payload) + + result = runner.invoke( + app, + ["leaderboard", "2024", "12345", "--view-key", "secret", "--format", "json"], + ) + + assert result.exit_code == 0 + assert result.stdout == f"{payload}\n" + + def test_status_cmd_outputs(monkeypatch): def fake_get_status(year, session, fmt): return f"status-{year}-{fmt.value}" monkeypatch.setattr("elf.cli.get_status", fake_get_status) - result = runner.invoke( - app, ["status", "2023", "--format", "table", "--session", "token"] - ) + result = runner.invoke(app, ["status", "2023", "--format", "table", "--session", "token"]) assert result.exit_code == 0 assert "status-2023-table" in result.stdout @@ -113,7 +124,7 @@ def test_cache_cmd_handles_empty_dir(monkeypatch, tmp_path): def test_guesses_cmd_invokes_reader(monkeypatch): - monkeypatch.setattr("elf.cli.get_guesses", lambda year, day: "guess-history") + monkeypatch.setattr("elf.cli.get_guesses", lambda year, day, session: "guess-history") result = runner.invoke(app, ["guesses", "2024", "3"]) diff --git a/tests/test_client_api.py b/tests/test_client_api.py index 363e892..d144f76 100644 --- a/tests/test_client_api.py +++ b/tests/test_client_api.py @@ -9,263 +9,94 @@ from elf.models import OutputFormat -def test_get_puzzle_input_forwards_explicit_session(monkeypatch): - resolved = [] +def test_get_puzzle_input_forwards_session_once(monkeypatch): called = [] - def fake_resolve(session): - resolved.append(session) - return "resolved-token" - def fake_get_input(year, day, session): called.append((year, day, session)) return "input-data" - monkeypatch.setattr("elf.client.resolve_session", fake_resolve) monkeypatch.setattr("elf.client.get_input", fake_get_input) - result = get_puzzle_input(2023, 5, session="manual-session") - - assert result == "input-data" - assert resolved == ["manual-session"] - assert called == [(2023, 5, "resolved-token")] - - -def test_get_puzzle_input_uses_env_session_when_not_provided(monkeypatch): - captured = {} - - def fake_resolve(session): - captured["resolved_from"] = session - return "env-resolved-token" - - def fake_get_input(year, day, session): - captured.update({"year": year, "day": day, "session": session}) - return "input-data" - - monkeypatch.setenv("AOC_SESSION", "env-token") - monkeypatch.setattr("elf.client.resolve_session", fake_resolve) - monkeypatch.setattr("elf.client.get_input", fake_get_input) - - result = get_puzzle_input(2024, 1) - - assert result == "input-data" - # High-level helper passes None into resolve_session, letting it - # decide how to use env vars. - assert captured["resolved_from"] is None - assert captured["year"] == 2024 - assert captured["day"] == 1 - assert captured["session"] == "env-resolved-token" - - -def test_get_puzzle_input_raises_without_session(monkeypatch): - def fake_resolve(session): - raise RuntimeError("no session available") - - monkeypatch.delenv("AOC_SESSION", raising=False) - monkeypatch.setattr("elf.client.resolve_session", fake_resolve) - - with pytest.raises(RuntimeError, match="no session available"): - get_puzzle_input(2023, 1) + assert get_puzzle_input(2023, 5, session="manual-session") == "input-data" + assert get_puzzle_input(2024, 1) == "input-data" + assert called == [(2023, 5, "manual-session"), (2024, 1, None)] def test_submit_puzzle_answer_forwards_session_and_args(monkeypatch): - resolved = [] submitted = [] - def fake_resolve(session): - resolved.append(session) - return "resolved-token" - - def fake_submit(year, day, level, answer, session_token): - submitted.append((year, day, level, answer, session_token)) + def fake_submit(year, day, level, answer, session): + submitted.append((year, day, level, answer, session)) return "submission-result" - monkeypatch.setattr("elf.client.resolve_session", fake_resolve) monkeypatch.setattr("elf.client.submit_answer", fake_submit) result = submit_puzzle_answer( year=2023, day=2, part=1, - answer="12345", + answer=12345, session="manual-session", ) assert result == "submission-result" - assert resolved == ["manual-session"] - assert submitted == [(2023, 2, 1, "12345", "resolved-token")] + assert submitted == [(2023, 2, 1, 12345, "manual-session")] -def test_get_private_leaderboard_without_view_key(monkeypatch): - resolved = [] - captured = {} +def test_get_private_leaderboard_forwards_credentials(monkeypatch): + calls = [] - def fake_resolve(session): - resolved.append(session) - return "resolved-token" - - def fake_get_leaderboard(year, session_token, board_id, view_key, fmt): - captured.update( - { - "year": year, - "session_token": session_token, - "board_id": board_id, - "view_key": view_key, - "fmt": fmt, - } - ) + def fake_get_leaderboard(year, session, board_id, view_key, fmt): + calls.append((year, session, board_id, view_key, fmt)) return "leaderboard-data" - monkeypatch.setattr("elf.client.resolve_session", fake_resolve) monkeypatch.setattr("elf.client.get_leaderboard", fake_get_leaderboard) - result = get_private_leaderboard( - 2023, board_id=10, session="explicit-session", fmt=OutputFormat.JSON + assert ( + get_private_leaderboard( + 2023, + board_id=10, + session="explicit-session", + fmt=OutputFormat.JSON, + ) + == "leaderboard-data" ) - - assert result == "leaderboard-data" - assert resolved == ["explicit-session"] - assert captured == { - "year": 2023, - "session_token": "resolved-token", - "board_id": 10, - "view_key": None, - "fmt": OutputFormat.JSON, - } - - -def test_get_private_leaderboard_with_view_key_allows_none_session(monkeypatch): - """ - When a view_key is provided and no session is supplied, the current - implementation allows session_token to be None and does NOT call - resolve_session. This test encodes that behavior. - """ - captured = {} - - def fake_get_leaderboard(year, session_token, board_id, view_key, fmt): - captured.update( - { - "year": year, - "session_token": session_token, - "board_id": board_id, - "view_key": view_key, - "fmt": fmt, - } + assert ( + get_private_leaderboard( + 2024, + board_id=123, + view_key="view-key-abc", ) - return "leaderboard-data" - - # No env session, no explicit session - monkeypatch.delenv("AOC_SESSION", raising=False) - monkeypatch.setattr("elf.client.get_leaderboard", fake_get_leaderboard) - - result = get_private_leaderboard( - 2024, - board_id=123, - view_key="view-key-abc", - fmt=OutputFormat.JSON, + == "leaderboard-data" ) - - assert result == "leaderboard-data" - assert captured["year"] == 2024 - assert captured["board_id"] == 123 - assert captured["view_key"] == "view-key-abc" - # Key point: session_token is None in this scenario - assert captured["session_token"] is None - assert captured["fmt"] == OutputFormat.JSON + assert calls == [ + (2023, "explicit-session", 10, None, OutputFormat.JSON), + (2024, None, 123, "view-key-abc", OutputFormat.MODEL), + ] @pytest.mark.parametrize( - "year, board_id", - [ - (None, 123), - (2023, None), - (None, None), - ], + ("year", "board_id"), + [(None, 123), (2023, None), (None, None)], ) def test_get_private_leaderboard_invalid_inputs(year, board_id): - """ - With the current implementation, passing None for year or board_id - leads to a TypeError from underlying comparisons (e.g., year < 2015). - - If you later add explicit validation in get_private_leaderboard and - raise ValueError instead, you can update this test to expect ValueError. - """ with pytest.raises(TypeError): get_private_leaderboard(year, board_id=board_id) -def test_get_private_leaderboard_default_format_model(monkeypatch): - captured = {} - - def fake_resolve(session): - return "resolved-token" - - def fake_get_leaderboard(year, session_token, board_id, view_key, fmt): - captured.update( - { - "year": year, - "session_token": session_token, - "board_id": board_id, - "view_key": view_key, - "fmt": fmt, - } - ) - return "leaderboard-data" - - monkeypatch.setenv("AOC_SESSION", "env-token") - monkeypatch.setattr("elf.client.resolve_session", fake_resolve) - monkeypatch.setattr("elf.client.get_leaderboard", fake_get_leaderboard) - - result = get_private_leaderboard(2024, board_id=42) - - assert result == "leaderboard-data" - # Default for API is currently OutputFormat.MODEL - assert captured["fmt"] == OutputFormat.MODEL - assert captured["session_token"] == "resolved-token" - +def test_get_user_status_forwards_session_and_default_format(monkeypatch): + calls = [] -def test_get_user_status_forwards_explicit_session(monkeypatch): - resolved = [] - captured = {} - - def fake_resolve(session): - resolved.append(session) - return "resolved-token" - - def fake_get_status(year, session_token, fmt): - captured.update({"year": year, "session_token": session_token, "fmt": fmt}) - return "status-data" - - monkeypatch.setattr("elf.client.resolve_session", fake_resolve) - monkeypatch.setattr("elf.client.get_status", fake_get_status) - - result = get_user_status(2023, session="manual-session", fmt=OutputFormat.JSON) - - assert result == "status-data" - assert resolved == ["manual-session"] - assert captured["year"] == 2023 - assert captured["session_token"] == "resolved-token" - assert captured["fmt"] == OutputFormat.JSON - - -def test_get_user_status_uses_env_session(monkeypatch): - captured = {} - - def fake_resolve(session): - captured["resolved_from"] = session - return "env-resolved-token" - - def fake_get_status(year, session_token, fmt): - captured.update({"year": year, "session_token": session_token, "fmt": fmt}) + def fake_get_status(year, session, fmt): + calls.append((year, session, fmt)) return "status-data" - monkeypatch.setenv("AOC_SESSION", "env-token") - monkeypatch.setattr("elf.client.resolve_session", fake_resolve) monkeypatch.setattr("elf.client.get_status", fake_get_status) - result = get_user_status(2023) - - assert result == "status-data" - assert captured["resolved_from"] is None - assert captured["session_token"] == "env-resolved-token" - assert captured["fmt"] == OutputFormat.MODEL + assert get_user_status(2023, session="manual-session", fmt=OutputFormat.JSON) == "status-data" + assert get_user_status(2024) == "status-data" + assert calls == [ + (2023, "manual-session", OutputFormat.JSON), + (2024, None, OutputFormat.MODEL), + ] diff --git a/tests/test_doctor.py b/tests/test_doctor.py new file mode 100644 index 0000000..603136c --- /dev/null +++ b/tests/test_doctor.py @@ -0,0 +1,48 @@ +from datetime import datetime +from zoneinfo import ZoneInfo + +from typer.testing import CliRunner + +from elf.cli import app +from elf.doctor import CheckStatus, run_doctor + + +def test_doctor_reports_configuration_without_exposing_secrets(monkeypatch, tmp_path): + cache_dir = tmp_path / "cache" + monkeypatch.setenv("ELF_CACHE_DIR", str(cache_dir)) + monkeypatch.setenv("AOC_SESSION", "super-secret-session") + monkeypatch.setenv("AOC_USER_AGENT", "maintainer@example.com") + + result = CliRunner().invoke(app, ["doctor"]) + + assert result.exit_code == 0 + assert "default puzzle" in result.stdout + assert "AOC_SESSION is configured" in result.stdout + assert "super-secret-session" not in result.stdout + assert "maintainer@example.com" not in result.stdout + + +def test_doctor_uses_year_round_defaults_and_warns_for_missing_env(monkeypatch, tmp_path): + monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) + monkeypatch.delenv("AOC_SESSION", raising=False) + monkeypatch.delenv("AOC_USER_AGENT", raising=False) + now = datetime(2026, 7, 1, 12, tzinfo=ZoneInfo("America/New_York")) + + report = run_doctor(now=now) + + assert report.has_errors is False + assert any("2025-12-12" in check.detail for check in report.checks) + warnings = [check for check in report.checks if check.status is CheckStatus.WARNING] + assert {check.name for check in warnings} == {"Session", "User-Agent"} + + +def test_doctor_fails_when_cache_path_is_not_writable(monkeypatch, tmp_path): + blocker = tmp_path / "not-a-directory" + blocker.write_text("blocked", encoding="utf-8") + monkeypatch.setenv("ELF_CACHE_DIR", str(blocker / "cache")) + + result = CliRunner().invoke(app, ["doctor"]) + + assert result.exit_code == 1 + assert "ERROR" in result.stdout + assert "not writable" in result.stdout diff --git a/tests/test_events.py b/tests/test_events.py new file mode 100644 index 0000000..ead4b34 --- /dev/null +++ b/tests/test_events.py @@ -0,0 +1,43 @@ +from datetime import datetime +from zoneinfo import ZoneInfo + +import pytest + +from elf.events import ( + default_event_day, + default_event_year, + event_day_count, + validate_event_day, +) + +AOC_TZ = ZoneInfo("America/New_York") + + +def _aoc_time(year: int, month: int, day: int) -> datetime: + return datetime(year, month, day, 12, tzinfo=AOC_TZ) + + +def test_event_lengths_cover_full_and_reduced_formats(): + assert event_day_count(2015) == 25 + assert event_day_count(2024) == 25 + assert event_day_count(2025) == 12 + assert event_day_count(2026) == 12 + + validate_event_day(2024, 25) + validate_event_day(2025, 12) + with pytest.raises(ValueError, match="days 1–12"): + validate_event_day(2025, 13) + + +def test_defaults_use_latest_event_outside_december(): + now = _aoc_time(2026, 7, 1) + + assert default_event_year(now) == 2025 + assert default_event_day(now=now) == 12 + assert default_event_day(2024, now=now) == 25 + + +def test_defaults_follow_active_event_and_stop_at_its_last_day(): + assert default_event_year(_aoc_time(2026, 12, 5)) == 2026 + assert default_event_day(now=_aoc_time(2026, 12, 5)) == 5 + assert default_event_day(now=_aoc_time(2026, 12, 20)) == 12 diff --git a/tests/test_guess_cache.py b/tests/test_guess_cache.py index 04892e3..341ac51 100644 --- a/tests/test_guess_cache.py +++ b/tests/test_guess_cache.py @@ -57,6 +57,7 @@ def test_write_guess_cache_normalizes_guess(monkeypatch, tmp_path): "part": "1", "guess": "123", "status": "INCORRECT", + "retry_at": "", } ] diff --git a/tests/test_input_cache.py b/tests/test_input_cache.py new file mode 100644 index 0000000..50e0fb6 --- /dev/null +++ b/tests/test_input_cache.py @@ -0,0 +1,69 @@ +from typing import ClassVar + +import httpx +import pytest + +from elf.cache import atomic_write_text, get_cache_input_file +from elf.exceptions import InputFetchError +from elf.input import get_input + + +class _FakeInputClient: + responses: ClassVar[dict[str, httpx.Response]] = {} + calls: ClassVar[list[str]] = [] + + def __init__(self, session_token: str): + self.session_token = session_token + + def __enter__(self): + return self + + def __exit__(self, *args): + return None + + def fetch_input(self, year: int, day: int) -> httpx.Response: + type(self).calls.append(self.session_token) + return type(self).responses[self.session_token] + + +def _response(text: str, content_type: str = "text/plain") -> httpx.Response: + return httpx.Response( + 200, + text=text, + headers={"Content-Type": content_type}, + request=httpx.Request("GET", "https://adventofcode.com/test"), + ) + + +def test_input_cache_isolated_between_accounts(monkeypatch, tmp_path): + monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) + monkeypatch.setattr("elf.input.AOCClient", _FakeInputClient) + _FakeInputClient.calls = [] + _FakeInputClient.responses = {"account-b": _response("input-for-b\n")} + atomic_write_text( + get_cache_input_file(2024, 1, "account-a"), + "input-for-a\n", + ) + + assert get_input(2024, 1, "account-a") == "input-for-a\n" + assert get_input(2024, 1, "account-b") == "input-for-b\n" + assert _FakeInputClient.calls == ["account-b"] + + +def test_login_html_is_never_returned_or_cached_as_input(monkeypatch, tmp_path): + monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) + monkeypatch.setattr("elf.input.AOCClient", _FakeInputClient) + _FakeInputClient.calls = [] + _FakeInputClient.responses = { + "expired": _response( + 'Log in', + "text/html", + ) + } + cache_file = get_cache_input_file(2024, 1, "expired") + atomic_write_text(cache_file, "To play, please identify yourself") + + with pytest.raises(InputFetchError, match="invalid or expired"): + get_input(2024, 1, "expired") + + assert cache_file.read_text() == "To play, please identify yourself" diff --git a/tests/test_leaderboard_cache.py b/tests/test_leaderboard_cache.py new file mode 100644 index 0000000..e864d54 --- /dev/null +++ b/tests/test_leaderboard_cache.py @@ -0,0 +1,112 @@ +import json +import os +import time +from concurrent.futures import ThreadPoolExecutor + +import httpx +import pytest + +from elf.cache import atomic_write_text, get_cache_leaderboard_file +from elf.exceptions import LeaderboardFetchError +from elf.leaderboard import LEADERBOARD_CACHE_TTL, get_leaderboard +from elf.models import OutputFormat + + +def _payload(name: str = "Elf") -> dict: + return { + "num_days": 12, + "event": "2025", + "day1_ts": 1764565200, + "owner_id": 1, + "members": { + "1": { + "id": 1, + "name": name, + "last_star_ts": 1764565200, + "stars": 2, + "local_score": 10, + "completion_day_level": {}, + } + }, + } + + +class _FakeClient: + calls = 0 + + def __init__(self, session_token): + self.session_token = session_token + + def __enter__(self): + return self + + def __exit__(self, *args): + return None + + def fetch_leaderboard(self, year, board_id, view_key): + type(self).calls += 1 + request = httpx.Request("GET", "https://adventofcode.com/test") + return httpx.Response(200, json=_payload(), request=request) + + +def test_leaderboard_uses_fresh_persistent_cache(monkeypatch, tmp_path): + monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) + monkeypatch.setattr("elf.leaderboard.AOCClient", _FakeClient) + _FakeClient.calls = 0 + + first = get_leaderboard(2025, "session-a", 42, None, OutputFormat.MODEL) + second = get_leaderboard(2025, "session-a", 42, None, OutputFormat.JSON) + + assert first.members[1].name == "Elf" + assert json.loads(second)["members"]["1"]["name"] == "Elf" + assert _FakeClient.calls == 1 + + +def test_leaderboard_cache_is_scoped_by_account_and_view_key(monkeypatch, tmp_path): + monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) + monkeypatch.setattr("elf.leaderboard.AOCClient", _FakeClient) + _FakeClient.calls = 0 + + get_leaderboard(2025, "session-a", 42, None) + get_leaderboard(2025, "session-b", 42, None) + get_leaderboard(2025, None, 42, "view-key") + get_leaderboard(2024, "session-a", 42, None) + + assert _FakeClient.calls == 4 + + +def test_fresh_malformed_cache_does_not_trigger_an_early_request(monkeypatch, tmp_path): + monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) + monkeypatch.setattr("elf.leaderboard.AOCClient", _FakeClient) + _FakeClient.calls = 0 + cache_file = get_cache_leaderboard_file( + 2025, + 42, + session_token="session-a", + view_key=None, + ) + + atomic_write_text(cache_file, "not json") + with pytest.raises(LeaderboardFetchError, match="will not request"): + get_leaderboard(2025, "session-a", 42, None) + assert _FakeClient.calls == 0 + + stale_time = time.time() - LEADERBOARD_CACHE_TTL.total_seconds() - 1 + os.utime(cache_file, (stale_time, stale_time)) + get_leaderboard(2025, "session-a", 42, None) + assert _FakeClient.calls == 1 + + +def test_concurrent_leaderboard_reads_share_one_refresh(monkeypatch, tmp_path): + monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) + monkeypatch.setattr("elf.leaderboard.AOCClient", _FakeClient) + _FakeClient.calls = 0 + + def read(_index): + return get_leaderboard(2025, "session-a", 99, None) + + with ThreadPoolExecutor(max_workers=4) as executor: + results = list(executor.map(read, range(4))) + + assert all(result.members[1].name == "Elf" for result in results) + assert _FakeClient.calls == 1 diff --git a/tests/test_parsing.py b/tests/test_parsing.py index 693c519..8250777 100644 --- a/tests/test_parsing.py +++ b/tests/test_parsing.py @@ -1,8 +1,13 @@ -from elf import DayStatus +from pathlib import Path + +import pytest + from elf.leaderboard import format_leaderboard_as_table from elf.models import Leaderboard from elf.status import build_year_status_table, parse_login_state, parse_year_status +FIXTURES = Path(__file__).parent / "fixtures" + def test_leaderboard_model_accepts_string_keys_and_formats_table(): payload = { @@ -90,3 +95,41 @@ def test_status_parsing_handles_basic_calendar_html(): table = build_year_status_table(status) assert table.row_count == 4 assert table.title and "2025" in table.title + + +@pytest.mark.parametrize( + ("fixture_name", "year", "username", "expected_days"), + [ + ("status_2015.html", 2015, "archive-user", [(1, 2, False), (2, 1, False), (25, 0, True)]), + ("status_2024.html", 2024, "current-user", [(1, 2, False), (2, 0, False), (25, 0, True)]), + ("status_2025.html", 2025, "reduced-user", [(1, 1, False), (12, 0, True)]), + ], +) +def test_status_parser_handles_sanitized_historical_fixtures( + fixture_name, year, username, expected_days +): + html = (FIXTURES / fixture_name).read_text(encoding="utf-8") + + assert parse_login_state(html) is True + status = parse_year_status(html) + + assert status.year == year + assert status.username == username + assert [(day.day, day.stars, day.is_locked) for day in status.days] == expected_days + + +def test_status_parser_does_not_depend_on_calendar_class_order(): + html = """ +
elf 2*
+ Settings
+

2024

+
+      
+        1
+      
+    
+ """ + + status = parse_year_status(html) + + assert [(day.day, day.stars, day.is_locked) for day in status.days] == [(1, 2, False)] diff --git a/tests/test_submission_http.py b/tests/test_submission_http.py new file mode 100644 index 0000000..c1fc30e --- /dev/null +++ b/tests/test_submission_http.py @@ -0,0 +1,127 @@ +from datetime import UTC, datetime, timedelta +from typing import ClassVar + +import httpx +import pytest + +from elf.answer import submit_to_aoc +from elf.cache import get_cache_guess_file +from elf.exceptions import SubmissionError +from elf.models import SubmissionStatus +from elf.utils import read_guesses + + +class _FakeSubmissionClient: + response: ClassVar[httpx.Response | Exception] + + def __init__(self, session_token: str): + self.session_token = session_token + + def __enter__(self): + return self + + def __exit__(self, *args): + return None + + def submit_answer(self, year: int, day: int, answer: str, part: int): + if isinstance(self.response, Exception): + raise self.response + return self.response + + +def _response(status: int, text: str) -> httpx.Response: + return httpx.Response( + status, + text=text, + request=httpx.Request("POST", "https://adventofcode.com/test"), + ) + + +def test_correct_submission_is_parsed_and_cached_for_its_account(monkeypatch, tmp_path): + monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) + monkeypatch.setattr("elf.answer.AOCClient", _FakeSubmissionClient) + _FakeSubmissionClient.response = _response( + 200, + "
That's the right answer! You are one gold star closer.
", + ) + + result = submit_to_aoc(2025, 1, 1, "42", "account-a") + + assert result.result is SubmissionStatus.CORRECT + assert result.is_correct is True + assert result.is_cached is False + assert get_cache_guess_file(2025, 1, "account-a").exists() + assert not get_cache_guess_file(2025, 1, "account-b").exists() + + +@pytest.mark.parametrize( + "html", + [ + "
To play, please identify yourself.
", + '
', + ], +) +def test_authentication_html_is_rejected_without_caching(monkeypatch, tmp_path, html): + monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) + monkeypatch.setattr("elf.answer.AOCClient", _FakeSubmissionClient) + _FakeSubmissionClient.response = _response(200, html) + + with pytest.raises(SubmissionError, match="invalid or expired"): + submit_to_aoc(2025, 1, 1, "42", "expired") + + assert not get_cache_guess_file(2025, 1, "expired").exists() + + +@pytest.mark.parametrize( + ("response", "message"), + [ + (_response(500, "server error"), "Server error"), + (httpx.ReadTimeout("slow response"), "Timed out"), + ], +) +def test_submission_http_failures_are_wrapped(monkeypatch, response, message): + monkeypatch.setattr("elf.answer.AOCClient", _FakeSubmissionClient) + _FakeSubmissionClient.response = response + + with pytest.raises(SubmissionError, match=message): + submit_to_aoc(2025, 1, 1, "42", "account") + + +def test_cache_failure_does_not_hide_submission_result(monkeypatch): + monkeypatch.setattr("elf.answer.AOCClient", _FakeSubmissionClient) + monkeypatch.setattr( + "elf.answer.write_guess_cache", + lambda *args, **kwargs: (_ for _ in ()).throw(RuntimeError("read-only cache")), + ) + _FakeSubmissionClient.response = _response( + 200, + "
That's the right answer! You are one gold star closer.
", + ) + + with pytest.warns(RuntimeWarning, match="could not update"): + result = submit_to_aoc(2025, 1, 1, "42", "account") + + assert result.result is SubmissionStatus.CORRECT + + +def test_wait_response_persists_server_retry_deadline(monkeypatch, tmp_path): + monkeypatch.setenv("ELF_CACHE_DIR", str(tmp_path / "cache")) + monkeypatch.setattr("elf.answer.AOCClient", _FakeSubmissionClient) + _FakeSubmissionClient.response = _response( + 200, + ("
You gave an answer too recently. You have 2m 5s left to wait.
"), + ) + before = datetime.now(UTC) + + result = submit_to_aoc(2025, 1, 1, "42", "account") + + assert result.result is SubmissionStatus.WAIT + assert result.retry_at is not None + assert ( + before + timedelta(seconds=124) + <= result.retry_at + <= datetime.now(UTC) + timedelta(seconds=126) + ) + assert result.retry_at.strftime("%Y-%m-%d %H:%M:%S UTC") in result.message + [guess] = read_guesses(2025, 1, session_token="account") + assert guess.retry_at == result.retry_at From 2c08f706f56f7e143e34283f5244cef943dbdeff Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:27:32 -0500 Subject: [PATCH 07/45] Refactor answer submission logic and enhance caching mechanisms for improved performance and error handling --- elf/answer.py | 303 ++++++++++++++++++++++++++++++++++---------------- 1 file changed, 206 insertions(+), 97 deletions(-) diff --git a/elf/answer.py b/elf/answer.py index 5d51371..7bb5dd7 100644 --- a/elf/answer.py +++ b/elf/answer.py @@ -1,12 +1,22 @@ import csv -from datetime import datetime, timedelta, timezone +import io +import re +import warnings +from datetime import UTC, datetime, timedelta from enum import Enum, auto from html.parser import HTMLParser import httpx from .aoc_client import AOCClient -from .cache import get_cache_guess_file +from .cache import ( + CacheLockTimeoutError, + atomic_write_text, + cache_file_lock, + get_cache_guess_file, + migrate_legacy_cache_file, +) +from .events import validate_event_day from .exceptions import PuzzleLockedError, SubmissionError from .messages import ( get_already_completed_message, @@ -22,9 +32,18 @@ get_wrong_level_message, ) from .models import CachedGuessCheck, Guess, SubmissionResult, SubmissionStatus -from .utils import current_aoc_year, get_unlock_status, read_guesses, resolve_session +from .utils import ( + current_aoc_year, + get_unlock_status, + looks_like_login_content, + read_guesses, + resolve_session, +) WAIT_CACHE_TTL = timedelta(minutes=1) +_WAIT_TIME_PATTERN = re.compile(r"You have (?:(\d+)m )?(\d+)s left to wait") +_GUESS_CACHE_FIELDS = ["timestamp", "part", "guess", "status", "retry_at"] +_REQUIRED_GUESS_CACHE_FIELDS = {"timestamp", "part", "guess", "status"} class AocResponseParser(HTMLParser): @@ -103,7 +122,8 @@ def submit_answer( Returns: A SubmissionResult describing the outcome, including whether it was - served from the local guess cache or from Advent of Code. + served from the local guess cache or from Advent of Code. Cooldown + results include the exact retry deadline when AoC provides one. Raises: MissingSessionTokenError: If no session token was provided. @@ -111,11 +131,7 @@ def submit_answer( """ submission_answer, numeric_answer = _normalize_answer(answer) - if not 1 <= day <= 25: - raise ValueError(f"Invalid day {day!r}. Advent of Code days are 1–25.") - - if year < 2015: - raise ValueError(f"Invalid year {year!r}. Advent of Code started in 2015.") + validate_event_day(year, day) if level not in (1, 2): raise ValueError(f"Invalid level {level!r}. Puzzle parts are 1 or 2.") @@ -135,29 +151,44 @@ def submit_answer( session_token = resolve_session(session) - cache_file = get_cache_guess_file(year, day) - cache_file.parent.mkdir(parents=True, exist_ok=True) - - # Check cached guesses before hitting network - if cache_file.exists(): - cached = check_cached_guesses( - year=year, - day=day, - level=level, - answer=submission_answer, - numeric_answer=numeric_answer, - ) - - if cached.status != SubmissionStatus.UNKNOWN: - return SubmissionResult( - guess=submission_answer, - result=cached.status, - message=cached.message, - is_correct=cached.status == SubmissionStatus.CORRECT, - is_cached=True, - ) + legacy_cache_file = get_cache_guess_file(year, day) + cache_file = get_cache_guess_file(year, day, session_token) + try: + migrate_legacy_cache_file(legacy_cache_file, cache_file) + except OSError as exc: + raise SubmissionError(f"Failed to migrate guess cache at {legacy_cache_file}.") from exc + + # Serialize the cache check and submission for this account and puzzle. This + # prevents two elf processes from both submitting before either records the + # result. Guess-cache writes use their own shorter-lived lock. + submission_lock = cache_file.with_name(f"{cache_file.name}.submission") + try: + with cache_file_lock(submission_lock, timeout=30.0, stale_after=60.0): + if cache_file.exists(): + cached = check_cached_guesses( + year=year, + day=day, + level=level, + answer=submission_answer, + numeric_answer=numeric_answer, + session_token=session_token, + ) - return submit_to_aoc(year, day, level, submission_answer, session_token) + if cached.status != SubmissionStatus.UNKNOWN: + return SubmissionResult( + guess=submission_answer, + result=cached.status, + message=cached.message, + is_correct=cached.status == SubmissionStatus.CORRECT, + is_cached=True, + retry_at=cached.retry_at, + ) + + return submit_to_aoc(year, day, level, submission_answer, session_token) + except CacheLockTimeoutError as exc: + raise SubmissionError( + "Timed out waiting for another elf process to finish submitting an answer." + ) from exc def submit_to_aoc( @@ -178,9 +209,7 @@ def submit_to_aoc( ) from exc except httpx.RequestError as exc: - raise SubmissionError( - f"Network error while connecting to Advent of Code: {exc}" - ) from exc + raise SubmissionError(f"Network error while connecting to Advent of Code: {exc}") from exc # --- HTTP status handling ------------------------------------------------- @@ -194,25 +223,19 @@ def submit_to_aoc( else: raise SubmissionError( - f"Input not found for year={year}, day={day} (HTTP 404)." + f"Answer endpoint not found for year={year}, day={day} (HTTP 404)." ) if response.status_code == 400: - raise SubmissionError( - "Bad request (HTTP 400). Your session token may be invalid." - ) + raise SubmissionError("Bad request (HTTP 400). Your session token may be invalid.") if 500 <= response.status_code < 600: - raise SubmissionError( - f"Server error from Advent of Code (HTTP {response.status_code}). Your session token may be invalid." - ) + raise SubmissionError(f"Server error from Advent of Code (HTTP {response.status_code}).") if response.status_code != 200: - raise SubmissionError( - f"Unexpected HTTP status {response.status_code} from Advent of Code." - ) + raise SubmissionError(f"Unexpected HTTP status {response.status_code} from Advent of Code.") - if "To play, please identify yourself" in response.text: + if looks_like_login_content(response.text): raise SubmissionError( "Session cookie invalid or expired. " "Update AOC_SESSION with a valid 'session' cookie from your browser." @@ -225,6 +248,7 @@ def submit_to_aoc( # Determine result type message_type = classify_message(content) + retry_at: datetime | None = None match message_type: case AocMessageType.EMPTY: message = "Answer submitted, but no response message found." @@ -239,8 +263,9 @@ def submit_to_aoc( message = get_answer_too_low_message(answer) status = SubmissionStatus.TOO_LOW case AocMessageType.RECENT_SUBMISSION: - message = get_recent_submission_message() status = SubmissionStatus.WAIT + retry_at = _parse_wait_retry_at(content) or datetime.now(UTC) + WAIT_CACHE_TTL + message = _wait_message(retry_at, cached=False) case AocMessageType.ALREADY_COMPLETED: message = get_already_completed_message() status = SubmissionStatus.COMPLETED @@ -254,8 +279,24 @@ def submit_to_aoc( message = get_unexpected_response_message() status = SubmissionStatus.UNKNOWN - # Cache the guess (including WAIT, with TTL handling on read) - write_guess_cache(year, day, level, answer, status) + # The request has already happened, so a local cache failure must not hide + # Advent of Code's result and encourage an accidental retry. + try: + write_guess_cache( + year, + day, + level, + answer, + status, + session_token=session_token, + retry_at=retry_at, + ) + except RuntimeError as exc: + warnings.warn( + f"Answer was submitted, but elf could not update the guess cache: {exc}", + RuntimeWarning, + stacklevel=2, + ) return SubmissionResult( guess=answer, @@ -263,6 +304,7 @@ def submit_to_aoc( message=message, is_correct=status == SubmissionStatus.CORRECT, is_cached=False, + retry_at=retry_at, ) @@ -272,27 +314,25 @@ def write_guess_cache( part: int, guess: int | str, status: SubmissionStatus, + session_token: str | None = None, + retry_at: datetime | None = None, ) -> None: - cache_file = get_cache_guess_file(year, day) - - timestamp = datetime.now(timezone.utc).isoformat() + cache_file = get_cache_guess_file(year, day, session_token) + timestamp = datetime.now(UTC).isoformat() canonical_guess, _ = _normalize_answer(guess) row = { "timestamp": timestamp, "part": part, "guess": str(canonical_guess), "status": status.name, + "retry_at": retry_at.isoformat() if retry_at is not None else "", } try: - cache_file.parent.mkdir(parents=True, exist_ok=True) - file_exists = cache_file.exists() - with cache_file.open("a", newline="", encoding="utf-8") as f: - writer = csv.DictWriter(f, fieldnames=row.keys()) - if not file_exists: - writer.writeheader() - writer.writerow(row) + with cache_file_lock(cache_file, timeout=10.0, stale_after=30.0): + existing = cache_file.read_text(encoding="utf-8") if cache_file.exists() else "" + atomic_write_text(cache_file, _updated_guess_cache(existing, row)) except Exception as exc: raise RuntimeError(f"Failed to write guess cache {cache_file}: {exc}") from exc @@ -303,43 +343,40 @@ def check_cached_guesses( level: int, answer: int | str, numeric_answer: int | None, + session_token: str | None = None, ) -> CachedGuessCheck: - guesses = read_guesses(year, day) - now = datetime.now(timezone.utc) + guesses = read_guesses(year, day, session_token=session_token) + now = datetime.now(UTC) highest_low: Guess | None = None lowest_high: Guess | None = None - completed_guess: Guess | None = None # NEW + completed_guess: Guess | None = None wait_guess: Guess | None = None + duplicate_guess: Guess | None = None for g in guesses: if g.part != level: continue - # Honor recent WAIT responses for this part - if g.status is SubmissionStatus.WAIT and _within_wait_ttl(g.timestamp, now): + # A later response supersedes an earlier local cooldown entry. + if g.status is SubmissionStatus.WAIT and _wait_is_active(g, now): wait_guess = g - break + elif wait_guess is not None and g.timestamp >= wait_guess.timestamp: + wait_guess = None is_same_guess = g.guess == answer or ( - numeric_answer is not None - and isinstance(g.guess, int) - and g.guess == numeric_answer + numeric_answer is not None and isinstance(g.guess, int) and g.guess == numeric_answer ) - # Prevent repeating guess unless guess response was WAIT + # Remember the newest duplicate, but finish scanning so a later + # successful solve can take precedence over an older failed guess. if is_same_guess and g.status != SubmissionStatus.WAIT: - return CachedGuessCheck( - guess=answer, - previous_guess=g.guess, - previous_timestamp=g.timestamp, - status=g.status, - message=get_cached_duplicate_message(answer, g), - ) + duplicate_guess = g match g: - # Mark that this part is completed (any previous guess) - case Guess(status=SubmissionStatus.COMPLETED): + # A correct answer proves the part is complete just as surely as a + # later "already completed" response. + case Guess(status=SubmissionStatus.CORRECT | SubmissionStatus.COMPLETED): completed_guess = g # Bounds checking (int only) @@ -358,18 +395,17 @@ def check_cached_guesses( ): lowest_high = g - # Short-circuit on active cooldown - if wait_guess is not None: - retry_at = _retry_at(wait_guess.timestamp) + # Preserve the familiar result for an exact cached correct answer. + if duplicate_guess is not None and duplicate_guess.status is SubmissionStatus.CORRECT: return CachedGuessCheck( guess=answer, - previous_guess=None, - previous_timestamp=wait_guess.timestamp, - status=SubmissionStatus.WAIT, - message=_wait_cache_message(retry_at), + previous_guess=duplicate_guess.guess, + previous_timestamp=duplicate_guess.timestamp, + status=duplicate_guess.status, + message=get_cached_duplicate_message(answer, duplicate_guess), ) - # If we know this part is completed, short-circuit before bounds logic + # Completion supersedes earlier cooldown, duplicate, and bounds entries. if completed_guess is not None: return CachedGuessCheck( guess=answer, @@ -379,6 +415,26 @@ def check_cached_guesses( message=get_already_completed_message(), ) + if wait_guess is not None: + retry_at = _retry_at(wait_guess) + return CachedGuessCheck( + guess=answer, + previous_guess=None, + previous_timestamp=wait_guess.timestamp, + status=SubmissionStatus.WAIT, + message=_wait_message(retry_at, cached=True), + retry_at=retry_at, + ) + + if duplicate_guess is not None: + return CachedGuessCheck( + guess=answer, + previous_guess=duplicate_guess.guess, + previous_timestamp=duplicate_guess.timestamp, + status=duplicate_guess.status, + message=get_cached_duplicate_message(answer, duplicate_guess), + ) + # Infer bounds if numeric_answer is not None: match (highest_low, lowest_high): @@ -393,9 +449,7 @@ def check_cached_guesses( message=get_cached_low_message(answer, h_low), ) case (_, l_high) if ( - l_high - and isinstance(l_high.guess, int) - and numeric_answer >= l_high.guess + l_high and isinstance(l_high.guess, int) and numeric_answer >= l_high.guess ): return CachedGuessCheck( guess=answer, @@ -415,23 +469,78 @@ def check_cached_guesses( ) -def _retry_at(ts: datetime) -> datetime: - ts_aware = ts if ts.tzinfo is not None else ts.replace(tzinfo=timezone.utc) - return ts_aware + WAIT_CACHE_TTL +def _updated_guess_cache(existing: str, row: dict[str, object]) -> str: + """Append a row while upgrading old four-column CSV files safely.""" + fieldnames = list(_GUESS_CACHE_FIELDS) + existing_rows: list[dict[str, str | None]] = [] + + if existing: + reader = csv.DictReader(io.StringIO(existing, newline="")) + existing_fields = reader.fieldnames + if ( + existing_fields is None + or len(existing_fields) != len(set(existing_fields)) + or not _REQUIRED_GUESS_CACHE_FIELDS.issubset(existing_fields) + ): + raise ValueError("Guess cache has a malformed header; refusing to overwrite it.") + fieldnames = list(existing_fields) + if "retry_at" not in fieldnames: + fieldnames.append("retry_at") + for existing_row in reader: + if None in existing_row: + raise ValueError("Guess cache has a malformed row; refusing to overwrite it.") + existing_rows.append(existing_row) + + buffer = io.StringIO(newline="") + writer = csv.DictWriter(buffer, fieldnames=fieldnames) + writer.writeheader() + writer.writerows(existing_rows) + writer.writerow(row) + return buffer.getvalue() + + +def _parse_wait_retry_at(content: str, *, now: datetime | None = None) -> datetime | None: + match = _WAIT_TIME_PATTERN.search(content) + if match is None: + return None + minutes = int(match.group(1) or 0) + seconds = int(match.group(2)) + current = now or datetime.now(UTC) + if current.tzinfo is None: + current = current.replace(tzinfo=UTC) + return current + timedelta(minutes=minutes, seconds=seconds) + + +def _retry_at(guess: Guess) -> datetime: + if guess.retry_at is not None: + return ( + guess.retry_at + if guess.retry_at.tzinfo is not None + else guess.retry_at.replace(tzinfo=UTC) + ) + timestamp = ( + guess.timestamp + if guess.timestamp.tzinfo is not None + else guess.timestamp.replace(tzinfo=UTC) + ) + return timestamp + WAIT_CACHE_TTL -def _within_wait_ttl(ts: datetime, now: datetime) -> bool: - return _retry_at(ts) > now +def _wait_is_active(guess: Guess, now: datetime) -> bool: + return _retry_at(guess) > now -def _wait_cache_message(retry_at: datetime) -> str: - retry_str = retry_at.astimezone(timezone.utc).strftime("%Y-%m-%d %H:%M:%S UTC") - return f"{get_recent_submission_message()} Cached locally; try again after {retry_str}." +def _wait_message(retry_at: datetime, *, cached: bool) -> str: + retry_str = retry_at.astimezone(UTC).strftime("%Y-%m-%d %H:%M:%S UTC") + source = "Cached locally; " if cached else "" + return f"{get_recent_submission_message()} {source}try again after {retry_str}." def _normalize_answer(answer: int | str) -> tuple[int | str, int | None]: """ - Preserve the user's answer text but still provide a numeric variant for bounds/duplicate guardrails. + Preserve answer text while providing a numeric variant for duplicate and bounds + guardrails. + Returns (submission_answer, numeric_answer). """ if isinstance(answer, str): From b0af0109f6303822010e4667dacbf1d81a1c35d0 Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:27:42 -0500 Subject: [PATCH 08/45] Refactor HTTP client management and user agent validation for improved clarity and functionality --- elf/aoc_client.py | 115 +++++++++++++++++++--------------------------- 1 file changed, 47 insertions(+), 68 deletions(-) diff --git a/elf/aoc_client.py b/elf/aoc_client.py index 3642de3..a7316d7 100644 --- a/elf/aoc_client.py +++ b/elf/aoc_client.py @@ -1,73 +1,48 @@ from __future__ import annotations -import atexit import os import re import time import warnings from types import TracebackType +from typing import Self import httpx from .constants import VERSION -_shared_client: httpx.Client | None = None - _user_agent_prefix = f"elf/{VERSION}" _default_user_agent = "+https://github.com/cak/elf" -def _get_http_client() -> httpx.Client: - """ - Return a process-global httpx.Client with sane limits/timeouts. - - The shared client keeps connections warm for CLI calls. If you make - heavy concurrent requests from multiple threads, construct your own - AOCClient instances to avoid sharing this global session. - """ - global _shared_client - if _shared_client is None: - user_agent = os.getenv("AOC_USER_AGENT") - - # Strip whitespace and control characters if present - if user_agent is not None: - user_agent = user_agent.replace("\r", "").replace("\n", "").strip() - - if not _validate_user_agent(user_agent): - # Missing vs invalid message - if user_agent is None: - warnings.warn( - "User-Agent should include an email address. " - "Please set AOC_USER_AGENT in your environment.", - RuntimeWarning, - ) - else: - warnings.warn( - f"Invalid User-Agent header: {user_agent!r}\n\n" - "User-Agent should include an email address. " - "Please set AOC_USER_AGENT in your environment.", - RuntimeWarning, - ) - user_agent = _default_user_agent - - # Ensure user_agent is not None at this point - assert user_agent is not None - - _shared_client = httpx.Client( - headers={"User-Agent": _construct_user_agent(user_agent)}, - follow_redirects=True, - timeout=httpx.Timeout(connect=5.0, read=15.0, write=10.0, pool=20.0), - limits=httpx.Limits(max_keepalive_connections=10, max_connections=20), - ) - return _shared_client - - -def _close_http_client() -> None: - if _shared_client is not None: - _shared_client.close() - - -atexit.register(_close_http_client) +def _build_http_client() -> httpx.Client: + """Create an HTTP client with elf's headers, timeouts, and limits.""" + user_agent = os.getenv("AOC_USER_AGENT") + if user_agent is not None: + user_agent = user_agent.replace("\r", "").replace("\n", "").strip() + + if not _validate_user_agent(user_agent): + if user_agent is None: + warning = ( + "User-Agent should include an email address. " + "Please set AOC_USER_AGENT in your environment." + ) + else: + warning = ( + "AOC_USER_AGENT is invalid (value hidden). " + "It should include an email address. " + "Please set AOC_USER_AGENT in your environment." + ) + warnings.warn(warning, RuntimeWarning, stacklevel=2) + user_agent = _default_user_agent + + assert user_agent is not None + return httpx.Client( + headers={"User-Agent": _construct_user_agent(user_agent)}, + follow_redirects=True, + timeout=httpx.Timeout(connect=5.0, read=15.0, write=10.0, pool=20.0), + limits=httpx.Limits(max_keepalive_connections=10, max_connections=20), + ) def _construct_user_agent(user_agent: str) -> str: @@ -79,22 +54,24 @@ def _validate_user_agent(user_agent: str | None) -> bool: Very minimal check that the user agent string contains something that looks like an email address so Eric Wastl can contact the user. """ - return ( - user_agent is not None and re.search(r"[^@]+@[^.]+\..+", user_agent) is not None - ) + return user_agent is not None and re.search(r"[^@]+@[^.]+\..+", user_agent) is not None class AOCClient: - def __init__(self, session_token: str | None) -> None: + def __init__( + self, + session_token: str | None, + *, + http_client: httpx.Client | None = None, + ) -> None: self.base_url = "https://adventofcode.com" self.session_token = session_token - self._client = _get_http_client() + self._client = http_client if http_client is not None else _build_http_client() + self._owns_client = http_client is None def _get(self, path: str, params: dict[str, str] | None = None) -> httpx.Response: cookies = {"session": self.session_token} if self.session_token else None - return self._client.get( - f"{self.base_url}{path}", params=params, cookies=cookies - ) + return self._client.get(f"{self.base_url}{path}", params=params, cookies=cookies) def _post(self, path: str, data: dict[str, str]) -> httpx.Response: cookies = {"session": self.session_token} if self.session_token else None @@ -121,7 +98,7 @@ def _get_with_retries( time.sleep(backoff * (2**attempt)) attempt += 1 - def __enter__(self) -> "AOCClient": + def __enter__(self) -> Self: return self def __exit__( @@ -130,8 +107,12 @@ def __exit__( exc: BaseException | None, tb: TracebackType | None, ) -> None: - # Shared client is closed via atexit; no-op here to keep connections warm. - return None + self.close() + + def close(self) -> None: + """Close the internally owned HTTP client.""" + if self._owns_client and not self._client.is_closed: + self._client.close() def fetch_input(self, year: int, day: int) -> httpx.Response: """ @@ -139,9 +120,7 @@ def fetch_input(self, year: int, day: int) -> httpx.Response: """ return self._get_with_retries(f"/{year}/day/{day}/input") - def submit_answer( - self, year: int, day: int, answer: str, part: int - ) -> httpx.Response: + def submit_answer(self, year: int, day: int, answer: str, part: int) -> httpx.Response: """ Submit an answer for a specific year, day, and part. """ From 1f2c7347e2f9df542e38c7db5052a388fe75f55c Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:27:48 -0500 Subject: [PATCH 09/45] Enhance caching mechanism with session token support and implement atomic file operations --- elf/cache.py | 209 ++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 205 insertions(+), 4 deletions(-) diff --git a/elf/cache.py b/elf/cache.py index 0e81685..ebe5cf6 100644 --- a/elf/cache.py +++ b/elf/cache.py @@ -1,7 +1,20 @@ +import hashlib import os import platform +import secrets +import tempfile +import time +from collections.abc import Iterator +from contextlib import contextmanager, suppress from pathlib import Path +_PRIVATE_DIR_MODE = 0o700 +_PRIVATE_FILE_MODE = 0o600 + + +class CacheLockTimeoutError(TimeoutError): + """Raised when another process holds a cache lock for too long.""" + def get_cache_dir() -> Path: """Return the platform-appropriate cache directory for elf. @@ -25,11 +38,199 @@ def get_cache_dir() -> Path: return base / "elf" -def get_cache_guess_file(year: int, day: int) -> Path: +def _credential_fingerprint(kind: str, credential: str) -> str: + """Return a stable cache identifier without exposing a credential.""" + value = f"elf-cache-v2\0{kind}\0{credential}".encode() + return hashlib.sha256(value).hexdigest()[:24] + + +def get_account_cache_dir(session_token: str) -> Path: + """Return the private cache namespace for one AoC account.""" + fingerprint = _credential_fingerprint("session", session_token) + return get_cache_dir() / "accounts" / fingerprint + + +def get_cache_guess_file(year: int, day: int, session_token: str | None = None) -> Path: """Return path to guesses cache CSV.""" - return get_cache_dir() / f"{year:04d}" / f"{day:02d}" / "guesses.csv" + root = get_account_cache_dir(session_token) if session_token else get_cache_dir() + return root / f"{year:04d}" / f"{day:02d}" / "guesses.csv" -def get_cache_input_file(year: int, day: int) -> Path: +def get_cache_input_file(year: int, day: int, session_token: str | None = None) -> Path: """Return path to input cache file.""" - return get_cache_dir() / f"{year:04d}" / f"{day:02d}" / "input.txt" + root = get_account_cache_dir(session_token) if session_token else get_cache_dir() + return root / f"{year:04d}" / f"{day:02d}" / "input.txt" + + +def get_cache_leaderboard_file( + year: int, + board_id: int, + *, + session_token: str | None, + view_key: str | None, +) -> Path: + """Return a leaderboard path scoped to its authentication mechanism.""" + if view_key: + scope = "views" + fingerprint = _credential_fingerprint("view-key", view_key) + elif session_token: + scope = "accounts" + fingerprint = _credential_fingerprint("session", session_token) + else: + raise ValueError("A session token or view key is required for caching.") + + return ( + get_cache_dir() / "leaderboards" / scope / fingerprint / f"{year:04d}" / f"{board_id}.json" + ) + + +def migrate_legacy_cache_file(legacy_file: Path, scoped_file: Path) -> bool: + """Claim and copy an old unscoped cache file into one private namespace.""" + if not legacy_file.is_file(): + return False + _make_private(legacy_file, _PRIVATE_FILE_MODE) + + marker_file = legacy_file.with_name(f".{legacy_file.name}.migrated") + try: + claim = scoped_file.relative_to(get_cache_dir()).as_posix() + except ValueError: + claim = scoped_file.as_posix() + + try: + _ensure_private_directory(marker_file.parent) + marker_descriptor = os.open( + marker_file, + os.O_WRONLY | os.O_CREAT | os.O_EXCL, + _PRIVATE_FILE_MODE, + ) + except FileExistsError: + try: + if marker_file.read_text(encoding="utf-8").strip() != claim: + return False + except (OSError, UnicodeError): + return False + else: + with os.fdopen(marker_descriptor, "w", encoding="utf-8") as marker: + marker.write(f"{claim}\n") + marker.flush() + os.fsync(marker.fileno()) + + if scoped_file.exists(): + return False + atomic_write_bytes(scoped_file, legacy_file.read_bytes()) + return True + + +def atomic_write_text(path: Path, content: str) -> None: + """Atomically replace a UTF-8 text cache file with private permissions.""" + atomic_write_bytes(path, content.encode("utf-8")) + + +def atomic_write_bytes(path: Path, content: bytes) -> None: + """Atomically replace a cache file, avoiding partial writes on interruption.""" + _ensure_private_directory(path.parent) + + file_descriptor, temporary_name = tempfile.mkstemp( + dir=path.parent, + prefix=f".{path.name}.", + ) + temporary_path = Path(temporary_name) + try: + _make_private(temporary_path, _PRIVATE_FILE_MODE) + with os.fdopen(file_descriptor, "wb") as temporary_file: + temporary_file.write(content) + temporary_file.flush() + os.fsync(temporary_file.fileno()) + os.replace(temporary_path, path) + _make_private(path, _PRIVATE_FILE_MODE) + except BaseException: + with suppress(OSError): + os.close(file_descriptor) + temporary_path.unlink(missing_ok=True) + raise + + +@contextmanager +def cache_file_lock( + cache_file: Path, + *, + timeout: float = 30.0, + stale_after: float = 120.0, + poll_interval: float = 0.05, +) -> Iterator[None]: + """Hold a cross-process lease while reading and replacing a cache file.""" + lock_file = cache_file.with_name(f".{cache_file.name}.lock") + _ensure_private_directory(lock_file.parent) + deadline = time.monotonic() + timeout + token = secrets.token_hex(16) + lock_identity: tuple[int, int] | None = None + + while lock_identity is None: + try: + descriptor = os.open( + lock_file, + os.O_WRONLY | os.O_CREAT | os.O_EXCL, + _PRIVATE_FILE_MODE, + ) + except FileExistsError: + if _remove_stale_lock(lock_file, stale_after): + continue + if time.monotonic() >= deadline: + raise CacheLockTimeoutError( + f"Timed out waiting for cache lock {lock_file}." + ) from None + time.sleep(poll_interval) + continue + + try: + lock_stat = os.fstat(descriptor) + lock_identity = (lock_stat.st_dev, lock_stat.st_ino) + with os.fdopen(descriptor, "w", encoding="utf-8") as lock: + lock.write(f"{token} {os.getpid()} {time.time()}\n") + lock.flush() + os.fsync(lock.fileno()) + except BaseException: + with suppress(OSError): + os.close(descriptor) + lock_file.unlink(missing_ok=True) + raise + + try: + yield + finally: + try: + current_stat = lock_file.stat() + current_identity = (current_stat.st_dev, current_stat.st_ino) + if current_identity == lock_identity: + lock_file.unlink(missing_ok=True) + except OSError: + pass + + +def _remove_stale_lock(lock_file: Path, stale_after: float) -> bool: + try: + if time.time() - lock_file.stat().st_mtime <= stale_after: + return False + lock_file.unlink() + return True + except FileNotFoundError: + return True + except OSError: + return False + + +def _make_private(path: Path, mode: int) -> None: + """Apply private POSIX permissions where chmod is supported.""" + with suppress(OSError): + path.chmod(mode) + + +def _ensure_private_directory(path: Path) -> None: + path.mkdir(parents=True, exist_ok=True, mode=_PRIVATE_DIR_MODE) + cache_root = get_cache_dir() + current = path + while current == cache_root or cache_root in current.parents: + _make_private(current, _PRIVATE_DIR_MODE) + if current == cache_root: + break + current = current.parent From d22224ab0094038bff61bce5d4102a224f63a382 Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:27:54 -0500 Subject: [PATCH 10/45] Refactor CLI commands to improve year and day handling, enhance output formatting, and add a doctor command for local configuration checks --- elf/cli.py | 80 ++++++++++++++++++++++++++++++++++++------------------ 1 file changed, 54 insertions(+), 26 deletions(-) diff --git a/elf/cli.py b/elf/cli.py index ae56bb2..0a2dfc6 100644 --- a/elf/cli.py +++ b/elf/cli.py @@ -1,13 +1,15 @@ -from datetime import datetime from functools import wraps from typing import Annotated import typer from rich.console import Console +from rich.text import Text from .answer import submit_answer from .cache import get_cache_dir -from .constants import AOC_TZ, VERSION +from .constants import VERSION +from .doctor import format_doctor_report, run_doctor +from .events import default_event_day, default_event_year from .exceptions import ElfError from .guesses import get_guesses from .input import get_input @@ -27,13 +29,16 @@ _DEBUG = False -def _current_year() -> int: - return datetime.now(tz=AOC_TZ).year +def _print_formatted_output(data: object, output_format: OutputFormat) -> None: + """Keep JSON byte-for-byte intact while allowing Rich renderables elsewhere.""" + if output_format is OutputFormat.JSON and isinstance(data, str): + typer.echo(data) + else: + console.print(data) -def _current_day() -> int: - today = datetime.now(tz=AOC_TZ) - return min(today.day, 25) if today.month == 12 else 1 +def _current_year() -> int: + return default_event_year() YearArg = Annotated[ @@ -44,13 +49,27 @@ def _current_day() -> int: default_factory=_current_year, ), ] +RequiredYearArg = Annotated[ + int, + typer.Argument( + help="Year of the Advent of Code event (2015 or later)", + min=2015, + ), +] DayArg = Annotated[ int, typer.Argument( - help="Day of the event (1–25)", + help="Day of the selected event", + min=1, + max=25, + ), +] +DefaultDayArg = Annotated[ + int | None, + typer.Argument( + help="Day of the selected event (defaults to its latest relevant day)", min=1, max=25, - default_factory=_current_day, ), ] PartArg = Annotated[ @@ -89,18 +108,16 @@ def wrapper(*args, **kwargs): return func(*args, **kwargs) except typer.Exit: raise - except KeyboardInterrupt: - raise typer.Exit(code=130) + except KeyboardInterrupt as exc: + raise typer.Exit(code=130) from exc except ElfError as exc: if _DEBUG: raise - error_console.print(f"[red]❄️ {exc}[/red]") + error_console.print(Text(f"❄️ {exc}", style="red")) except Exception as exc: if _DEBUG: raise - error_console.print( - f"[red]Unexpected {exc.__class__.__name__}: {exc}[/red]" - ) + error_console.print(Text(f"Unexpected {exc.__class__.__name__}: {exc}", style="red")) raise typer.Exit(code=1) return wrapper @@ -145,20 +162,20 @@ def cli_root( @handle_cli_errors def input_cmd( year: YearArg, - day: DayArg, + day: DefaultDayArg = None, session: SessionOpt = None, ) -> None: """ Fetch the input for a given year and day. """ - input_data = get_input(year, day, session) + input_data = get_input(year, day or default_event_day(year), session) typer.echo(input_data, nl=False) @app.command("answer") @handle_cli_errors def answer_cmd( - year: YearArg, + year: RequiredYearArg, day: DayArg, part: PartArg, answer: AnswerArg, @@ -175,7 +192,7 @@ def answer_cmd( answer=answer, session=session, ) - console.print(submit_result.message) + console.print(Text(submit_result.message)) exit_code = 0 if submit_result.result is SubmissionStatus.WAIT: exit_code = 2 @@ -190,7 +207,7 @@ def answer_cmd( @app.command("leaderboard") @handle_cli_errors def leaderboard_cmd( - year: YearArg, + year: RequiredYearArg, board_id: Annotated[int, typer.Argument(help="Private leaderboard ID")], view_key: Annotated[ str | None, @@ -210,19 +227,20 @@ def leaderboard_cmd( fmt=output_format, ) - console.print(leaderboard_data) + _print_formatted_output(leaderboard_data, output_format) @app.command("guesses") @handle_cli_errors def guesses_cmd( year: YearArg, - day: DayArg, + day: DefaultDayArg = None, + session: SessionOpt = None, ) -> None: """ Display cached guesses for a given year and day. """ - guesses_data = get_guesses(year, day) + guesses_data = get_guesses(year, day or default_event_day(year), session) console.print(guesses_data) @@ -242,14 +260,14 @@ def status_cmd( fmt=output_format, ) - console.print(status_data) + _print_formatted_output(status_data, output_format) @app.command("open") @handle_cli_errors def open_cmd( year: YearArg, - day: DayArg, + day: DefaultDayArg = None, kind: Annotated[ OpenKind, typer.Option( @@ -263,7 +281,7 @@ def open_cmd( """ Open an Advent of Code page (puzzle, input, or website) in the default web browser. """ - open_msg = open_page(year, day, kind) + open_msg = open_page(year, day or default_event_day(year), kind) console.print(open_msg) @@ -285,6 +303,16 @@ def cache_cmd() -> None: console.print("[dim]To clear the cache, delete this directory manually.[/dim]") +@app.command("doctor") +@handle_cli_errors +def doctor_cmd() -> None: + """Check local configuration without contacting Advent of Code.""" + report = run_doctor() + console.print(format_doctor_report(report)) + if report.has_errors: + raise typer.Exit(code=1) + + def main() -> None: app() From c893b3c78c871aeb5d782d839bb4fe4c7fdf1479 Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:27:59 -0500 Subject: [PATCH 11/45] Refactor session handling in puzzle input and answer submission functions for improved clarity and consistency --- elf/client.py | 41 +++++++++++++++-------------------------- 1 file changed, 15 insertions(+), 26 deletions(-) diff --git a/elf/client.py b/elf/client.py index 9309de3..389be76 100644 --- a/elf/client.py +++ b/elf/client.py @@ -1,13 +1,10 @@ -import os - from rich.table import Table from .answer import submit_answer from .input import get_input from .leaderboard import get_leaderboard -from .models import Leaderboard, OutputFormat, SubmissionResult +from .models import Leaderboard, OutputFormat, SubmissionResult, YearStatus from .status import get_status -from .utils import resolve_session def get_puzzle_input(year: int, day: int, session: str | None = None) -> str: @@ -23,7 +20,8 @@ def get_puzzle_input(year: int, day: int, session: str | None = None) -> str: year: The Advent of Code event year (e.g., ``2024``). day: - The puzzle day number (``1``–``25``). + The puzzle day number (``1``–``25`` for 2015–2024; ``1``–``12`` + for reduced-format events). session: An Advent of Code session token. If omitted, the value of the ``AOC_SESSION`` environment variable will be used instead. @@ -45,15 +43,14 @@ def get_puzzle_input(year: int, day: int, session: str | None = None) -> str: - This function performs an authenticated HTTP request. - Advent of Code input pages are personalized per user. """ - session_token = resolve_session(session) - return get_input(year, day, session_token) + return get_input(year, day, session) def submit_puzzle_answer( year: int, day: int, part: int, - answer: str, + answer: int | str, session: str | None = None, ) -> SubmissionResult: """ @@ -72,7 +69,7 @@ def submit_puzzle_answer( part: The puzzle part (``1`` or ``2``). answer: - The answer to submit, as a string. + The answer to submit, as an integer or string. session: An Advent of Code session token. If omitted, ``AOC_SESSION`` is used. @@ -93,8 +90,7 @@ def submit_puzzle_answer( - Advent of Code enforces a submission cooldown after incorrect answers. - This function does **not** retry automatically. """ - session_token = resolve_session(session) - return submit_answer(year, day, part, answer, session_token) + return submit_answer(year, day, part, answer, session) def get_private_leaderboard( @@ -129,9 +125,9 @@ def get_private_leaderboard( Returns ------- - Any - A structured leaderboard model, a JSON string, or a formatted - table representation, depending on ``fmt``. + Leaderboard | str | Table + A structured leaderboard model, JSON string, or formatted table, + depending on ``fmt``. Raises ------ @@ -150,19 +146,14 @@ def get_private_leaderboard( if board_id <= 0: raise ValueError("Board ID must be a positive integer.") - session_token = ( - resolve_session(session) - if view_key is None - else session or os.getenv("AOC_SESSION") - ) - return get_leaderboard(year, session_token, board_id, view_key, fmt) + return get_leaderboard(year, session, board_id, view_key, fmt) def get_user_status( year: int, session: str | None = None, fmt: OutputFormat = OutputFormat.MODEL, -): +) -> YearStatus | str | Table: """ Retrieve the user's Advent of Code progress for the specified year. @@ -181,9 +172,8 @@ def get_user_status( Returns ------- - Any - A ``YearStatus`` model, JSON string, or Rich table depending on - ``fmt``. + YearStatus | str | Table + A status model, JSON string, or Rich table depending on ``fmt``. Raises ------ @@ -195,5 +185,4 @@ def get_user_status( - Status is parsed directly from the calendar HTML on the event page. - Some features (e.g., star colors) may vary between years. """ - session_token = resolve_session(session) - return get_status(year, session_token, fmt) + return get_status(year, session, fmt) From be9eeec3eabb2505e73b55b1b2294db8dc340c8c Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:28:04 -0500 Subject: [PATCH 12/45] Add doctor command for local configuration checks and enhance reporting --- elf/doctor.py | 142 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 142 insertions(+) create mode 100644 elf/doctor.py diff --git a/elf/doctor.py b/elf/doctor.py new file mode 100644 index 0000000..c91fafc --- /dev/null +++ b/elf/doctor.py @@ -0,0 +1,142 @@ +import os +import secrets +import stat +import tempfile +from contextlib import suppress +from dataclasses import dataclass +from datetime import datetime +from enum import StrEnum +from pathlib import Path + +from rich.table import Table +from rich.text import Text + +from .aoc_client import _validate_user_agent +from .cache import get_cache_dir +from .constants import AOC_TZ, VERSION +from .events import default_event_day, default_event_year + + +class CheckStatus(StrEnum): + OK = "ok" + WARNING = "warning" + ERROR = "error" + + +@dataclass(frozen=True, slots=True) +class DoctorCheck: + name: str + status: CheckStatus + detail: str + + +@dataclass(frozen=True, slots=True) +class DoctorReport: + checks: tuple[DoctorCheck, ...] + + @property + def has_errors(self) -> bool: + return any(check.status is CheckStatus.ERROR for check in self.checks) + + +def run_doctor(*, now: datetime | None = None) -> DoctorReport: + """Inspect local elf configuration without contacting Advent of Code.""" + current = now.astimezone(AOC_TZ) if now else datetime.now(tz=AOC_TZ) + year = default_event_year(current) + day = default_event_day(year, current) + checks = [ + DoctorCheck("Version", CheckStatus.OK, f"elf {VERSION}"), + DoctorCheck( + "AoC clock", + CheckStatus.OK, + f"{current.isoformat(timespec='seconds')}; default puzzle {year}-12-{day:02d}", + ), + _session_check(), + _user_agent_check(), + _cache_check(get_cache_dir()), + ] + return DoctorReport(tuple(checks)) + + +def format_doctor_report(report: DoctorReport) -> Table: + table = Table(title="Elf doctor", show_lines=False) + table.add_column("Check", style="cyan", no_wrap=True) + table.add_column("Status", no_wrap=True) + table.add_column("Details") + + labels = { + CheckStatus.OK: "[green]OK[/green]", + CheckStatus.WARNING: "[yellow]WARNING[/yellow]", + CheckStatus.ERROR: "[red]ERROR[/red]", + } + for check in report.checks: + table.add_row(check.name, labels[check.status], Text(check.detail)) + return table + + +def _session_check() -> DoctorCheck: + session = os.getenv("AOC_SESSION") + if session and session.strip(): + return DoctorCheck( + "Session", + CheckStatus.OK, + "AOC_SESSION is configured (value hidden).", + ) + return DoctorCheck( + "Session", + CheckStatus.WARNING, + "AOC_SESSION is not configured; authenticated commands will fail.", + ) + + +def _user_agent_check() -> DoctorCheck: + value = os.getenv("AOC_USER_AGENT") + sanitized = value.replace("\r", "").replace("\n", "").strip() if value else None + if _validate_user_agent(sanitized): + return DoctorCheck( + "User-Agent", + CheckStatus.OK, + "AOC_USER_AGENT contains a contact email (value hidden).", + ) + return DoctorCheck( + "User-Agent", + CheckStatus.WARNING, + "Set AOC_USER_AGENT to a contact email recommended by Advent of Code.", + ) + + +def _cache_check(cache_dir: Path) -> DoctorCheck: + probe = cache_dir / f".doctor-{secrets.token_hex(8)}" + try: + cache_dir.mkdir(parents=True, exist_ok=True, mode=0o700) + descriptor, probe_name = tempfile.mkstemp( + dir=cache_dir, + prefix=probe.name, + ) + os.close(descriptor) + probe = Path(probe_name) + probe.unlink() + mode_detail = "" + if os.name == "posix": + mode = stat.S_IMODE(cache_dir.stat().st_mode) + if mode & 0o077: + return DoctorCheck( + "Cache", + CheckStatus.WARNING, + f"{cache_dir} is writable but permissions are {mode:04o}; expected 0700.", + ) + mode_detail = f", permissions {mode:04o}" + file_count = sum(1 for path in cache_dir.rglob("*") if path.is_file()) + return DoctorCheck( + "Cache", + CheckStatus.OK, + f"{cache_dir} is writable ({file_count} cached files{mode_detail}).", + ) + except OSError as exc: + with suppress(OSError): + probe.unlink(missing_ok=True) + return DoctorCheck( + "Cache", + CheckStatus.ERROR, + f"{cache_dir} is not writable: {exc}", + ) From df6a567b072df23e1644bfef571a14396604926e Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:28:16 -0500 Subject: [PATCH 13/45] Add event handling functions for Advent of Code, including day count and validation --- elf/events.py | 45 +++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 45 insertions(+) create mode 100644 elf/events.py diff --git a/elf/events.py b/elf/events.py new file mode 100644 index 0000000..56dcc98 --- /dev/null +++ b/elf/events.py @@ -0,0 +1,45 @@ +from datetime import datetime + +from .constants import AOC_TZ + +FIRST_EVENT_YEAR = 2015 +LAST_FULL_LENGTH_EVENT_YEAR = 2024 +FULL_EVENT_DAYS = 25 +REDUCED_EVENT_DAYS = 12 + + +def event_day_count(year: int) -> int: + """Return the number of puzzle days in an Advent of Code event.""" + if year < FIRST_EVENT_YEAR: + raise ValueError(f"Invalid year {year!r}. Advent of Code started in {FIRST_EVENT_YEAR}.") + if year <= LAST_FULL_LENGTH_EVENT_YEAR: + return FULL_EVENT_DAYS + return REDUCED_EVENT_DAYS + + +def validate_event_day(year: int, day: int) -> None: + """Validate a year/day pair against that event's published format.""" + last_day = event_day_count(year) + if not 1 <= day <= last_day: + raise ValueError( + f"Invalid day {day!r} for Advent of Code {year}. That event has days 1–{last_day}." + ) + + +def default_event_year(now: datetime | None = None) -> int: + """Return the active event in December, otherwise the latest past event.""" + current = now.astimezone(AOC_TZ) if now else datetime.now(tz=AOC_TZ) + return current.year if current.month == 12 else current.year - 1 + + +def default_event_day(year: int | None = None, now: datetime | None = None) -> int: + """Return a useful default day for the selected event.""" + current = now.astimezone(AOC_TZ) if now else datetime.now(tz=AOC_TZ) + selected_year = default_event_year(current) if year is None else year + last_day = event_day_count(selected_year) + + if selected_year < current.year: + return last_day + if selected_year > current.year or current.month < 12: + return 1 + return min(current.day, last_day) From d7de7b9e6460099f91c3f7ddb3b3a9ab42f39779 Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:28:21 -0500 Subject: [PATCH 14/45] Refactor guess handling to support session tokens and improve error messaging for cached guesses --- elf/guesses.py | 44 +++++++++++++++++++++++++++++++++++--------- 1 file changed, 35 insertions(+), 9 deletions(-) diff --git a/elf/guesses.py b/elf/guesses.py index 8bbc11c..396ce80 100644 --- a/elf/guesses.py +++ b/elf/guesses.py @@ -1,27 +1,48 @@ -from datetime import datetime, timezone +from datetime import UTC, datetime +from pathlib import Path from rich.console import Group from rich.table import Table from rich.text import Text -from .cache import get_cache_guess_file +from .cache import get_cache_dir, get_cache_guess_file from .exceptions import ElfError from .models import Guess, SubmissionStatus from .utils import read_guesses -def get_guesses(year: int, day: int) -> Group: - cache_file = get_cache_guess_file(year, day) +def get_guesses(year: int, day: int, session: str | None = None) -> Group: + cache_file = _resolve_guess_file(year, day, session) if not cache_file.exists(): raise ElfError( f"No cached guesses found yet for {year}-12-{day:02d}. " "Submit an answer before viewing guess history." ) - cached_guesses = read_guesses(year, day) + cached_guesses = read_guesses(year, day, session_token=session, cache_file=cache_file) return render_guess_tables(cached_guesses) +def _resolve_guess_file(year: int, day: int, session: str | None) -> Path: + if session: + return get_cache_guess_file(year, day, session) + + legacy_file = get_cache_guess_file(year, day) + if legacy_file.exists(): + return legacy_file + + pattern = f"accounts/*/{year:04d}/{day:02d}/guesses.csv" + matches = list(get_cache_dir().glob(pattern)) + if len(matches) == 1: + return matches[0] + if len(matches) > 1: + raise ElfError( + "Guess history exists for multiple accounts. " + "Set AOC_SESSION or pass --session to choose one." + ) + return legacy_file + + def render_guess_tables(guesses: list[Guess]) -> Group: # normalize datetimes guesses = sorted(guesses, key=lambda g: _ensure_aware(g.timestamp)) @@ -56,7 +77,12 @@ def _render_single_table(guesses: list[Guess], title: str) -> Table: elif guess.status is SubmissionStatus.INCORRECT: status_text = Text("Incorrect", style="red") elif guess.status is SubmissionStatus.WAIT: - status_text = Text("Wait", style="magenta") + if guess.retry_at is None: + label = "Wait" + else: + retry_at = _ensure_aware(guess.retry_at).strftime("%H:%M:%S UTC") + label = f"Wait until {retry_at}" + status_text = Text(label, style="magenta") elif guess.status is SubmissionStatus.TOO_HIGH: status_text = Text("Too High", style="purple") elif guess.status is SubmissionStatus.TOO_LOW: @@ -64,7 +90,7 @@ def _render_single_table(guesses: list[Guess], title: str) -> Table: else: status_text = Text(guess.status.value) - table.add_row(ts, str(guess.guess), status_text) + table.add_row(ts, Text(str(guess.guess)), status_text) return table @@ -72,5 +98,5 @@ def _render_single_table(guesses: list[Guess], title: str) -> Table: def _ensure_aware(dt: datetime) -> datetime: """Make any datetime UTC-aware.""" if dt.tzinfo is None: - return dt.replace(tzinfo=timezone.utc) - return dt.astimezone(timezone.utc) + return dt.replace(tzinfo=UTC) + return dt.astimezone(UTC) From 7f5f69ce90cdc8380e59d4b53713a8d1e167f898 Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:28:26 -0500 Subject: [PATCH 15/45] Refactor timer function to simplify message formatting and improve readability in error handling --- elf/helpers.py | 8 ++------ 1 file changed, 2 insertions(+), 6 deletions(-) diff --git a/elf/helpers.py b/elf/helpers.py index 64d5bd8..9351c5f 100644 --- a/elf/helpers.py +++ b/elf/helpers.py @@ -38,9 +38,7 @@ def wrapper(*args: P.args, **kwargs: P.kwargs) -> R: if enabled: end_time = time.perf_counter() duration = end_time - start_time if start_time is not None else 0.0 - message = ( - f"⏱️ Function '{func.__name__}' took {duration:.6f}s to complete 🎅." - ) + message = f"⏱️ Function '{func.__name__}' took {duration:.6f}s to complete 🎅." if logger: logger(message) else: @@ -55,8 +53,6 @@ def wrapper(*args: P.args, **kwargs: P.kwargs) -> R: def read_input(path: Path) -> str: """Read input from a file and return its contents.""" if not path.is_file(): - raise FileNotFoundError( - f"Input file not found: {path}. Please add the missing file." - ) + raise FileNotFoundError(f"Input file not found: {path}. Please add the missing file.") return path.read_text(encoding="utf-8").strip() From 2d1ece41d0a040ae4c65cc26c109e7f002ce06d7 Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:28:30 -0500 Subject: [PATCH 16/45] Refactor input fetching to improve cache handling and error management --- elf/input.py | 46 +++++++++++++++++++++++++++++----------------- 1 file changed, 29 insertions(+), 17 deletions(-) diff --git a/elf/input.py b/elf/input.py index fdee89f..a66aff7 100644 --- a/elf/input.py +++ b/elf/input.py @@ -1,12 +1,18 @@ import httpx from .aoc_client import AOCClient -from .cache import get_cache_input_file +from .cache import ( + atomic_write_text, + get_cache_input_file, + migrate_legacy_cache_file, +) +from .events import validate_event_day from .exceptions import InputFetchError, PuzzleLockedError from .utils import ( current_aoc_year, get_unlock_status, handle_http_errors, + looks_like_login_content, looks_like_login_page, resolve_session, ) @@ -29,15 +35,21 @@ def get_input(year: int, day: int, session: str | None) -> str: InputFetchError: If there is an issue fetching the puzzle input. ValueError: If the year/day are out of range. """ - if not 1 <= day <= 25: - raise ValueError(f"Invalid day {day!r}. Advent of Code days are 1–25.") + validate_event_day(year, day) - if year < 2015: - raise ValueError(f"Invalid year {year!r}. Advent of Code started in 2015.") + session_token = resolve_session(session) + legacy_cache_file = get_cache_input_file(year, day) + cache_file = get_cache_input_file(year, day, session_token) - cache_file = get_cache_input_file(year, day) - if cache_file.exists(): - return cache_file.read_text(encoding="utf-8") + try: + migrate_legacy_cache_file(legacy_cache_file, cache_file) + if cache_file.exists(): + cached_input = cache_file.read_text(encoding="utf-8") + if not looks_like_login_content(cached_input): + return cached_input + except (OSError, UnicodeError): + # A damaged or inaccessible cache should not prevent a fresh fetch. + pass if year >= current_aoc_year(): status = get_unlock_status(year, day) @@ -49,8 +61,6 @@ def get_input(year: int, day: int, session: str | None) -> str: unlock_time=status.unlock_time, ) - session_token = resolve_session(session) - # --- Network layer -------------------------------------------------------- try: @@ -63,9 +73,7 @@ def get_input(year: int, day: int, session: str | None) -> str: ) from exc except httpx.RequestError as exc: - raise InputFetchError( - f"Network error while connecting to Advent of Code: {exc}" - ) from exc + raise InputFetchError(f"Network error while connecting to Advent of Code: {exc}") from exc # --- HTTP status handling ------------------------------------------------- handle_http_errors( @@ -73,7 +81,10 @@ def get_input(year: int, day: int, session: str | None) -> str: exc_cls=InputFetchError, not_found_message=f"Input not found for year={year}, day={day} (HTTP 404).", bad_request_message="Bad request (HTTP 400). Your session token may be invalid.", - server_error_message="Server error from Advent of Code (HTTP {status_code}). Your session token may be invalid.", + server_error_message=( + "Server error from Advent of Code (HTTP {status_code}). " + "Your session token may be invalid." + ), unexpected_status_message="Unexpected HTTP error: {status_code}.", ) @@ -87,8 +98,9 @@ def get_input(year: int, day: int, session: str | None) -> str: input_data = text - # Ensure the cache directory exists - cache_file.parent.mkdir(parents=True, exist_ok=True) - cache_file.write_text(input_data, encoding="utf-8") + try: + atomic_write_text(cache_file, input_data) + except OSError as exc: + raise InputFetchError(f"Failed to cache puzzle input at {cache_file}.") from exc return input_data From 537c0eb10ebdc99fb3e5e53d3efa44a5f58ec793 Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:28:35 -0500 Subject: [PATCH 17/45] Enhance leaderboard fetching with improved caching and error handling --- elf/leaderboard.py | 138 +++++++++++++++++++++++++++++++++++++-------- 1 file changed, 115 insertions(+), 23 deletions(-) diff --git a/elf/leaderboard.py b/elf/leaderboard.py index 34c05b4..f1221a1 100644 --- a/elf/leaderboard.py +++ b/elf/leaderboard.py @@ -1,16 +1,29 @@ import json import os -from datetime import datetime, timezone +import time +import warnings +from datetime import UTC, datetime, timedelta +from pathlib import Path +from typing import Any import httpx from pydantic import ValidationError from rich.table import Table +from rich.text import Text from .aoc_client import AOCClient +from .cache import ( + CacheLockTimeoutError, + atomic_write_text, + cache_file_lock, + get_cache_leaderboard_file, +) from .exceptions import LeaderboardFetchError, MissingSessionTokenError from .models import Leaderboard, OutputFormat from .utils import handle_http_errors, resolve_session +LEADERBOARD_CACHE_TTL = timedelta(minutes=15) + def get_leaderboard( year: int, @@ -37,13 +50,68 @@ def get_leaderboard( # Resolve session token from explicit arg or environment for consistency with other APIs. session_token = ( - resolve_session(session) - if view_key is None - else session or os.getenv("AOC_SESSION") + resolve_session(session) if view_key is None else session or os.getenv("AOC_SESSION") ) if not session_token and not view_key: raise MissingSessionTokenError(env_var="AOC_SESSION") + cache_file = get_cache_leaderboard_file( + year, + board_id, + session_token=session_token, + view_key=view_key, + ) + payload = _read_fresh_cache(cache_file) + + if payload is None: + try: + with cache_file_lock(cache_file, timeout=60.0, stale_after=120.0): + payload = _read_fresh_cache(cache_file) + if payload is None: + payload = _fetch_leaderboard_payload( + year=year, + board_id=board_id, + session_token=session_token, + view_key=view_key, + ) + try: + atomic_write_text( + cache_file, + json.dumps(payload, separators=(",", ":")), + ) + except OSError as exc: + warnings.warn( + f"Could not write leaderboard cache {cache_file}: {exc}", + RuntimeWarning, + stacklevel=2, + ) + except CacheLockTimeoutError as exc: + raise LeaderboardFetchError( + "Timed out waiting for another elf process to refresh the leaderboard cache." + ) from exc + + leaderboard = _validate_leaderboard(payload) + + match fmt: + case OutputFormat.MODEL: + return leaderboard + case OutputFormat.JSON: + return json.dumps(payload, indent=2) + case OutputFormat.TABLE: + return format_leaderboard_as_table(leaderboard) + case _: + raise ValueError(f"Unsupported output format: {fmt}") + + +def _fetch_leaderboard_payload( + *, + year: int, + board_id: int, + session_token: str | None, + view_key: str | None, +) -> dict[str, Any]: + """Fetch and decode a private leaderboard response.""" + try: with AOCClient(session_token=session_token) as client: response = client.fetch_leaderboard(year, board_id, view_key) @@ -60,8 +128,13 @@ def get_leaderboard( response, exc_cls=LeaderboardFetchError, not_found_message=f"Leaderboard not found for year={year}, board_id={board_id} (HTTP 404).", - bad_request_message="Bad request (HTTP 400). Your session token or view key may be invalid.", - server_error_message="Server error from Advent of Code (HTTP {status_code}). Your session token may be invalid.", + bad_request_message=( + "Bad request (HTTP 400). Your session token or view key may be invalid." + ), + server_error_message=( + "Server error from Advent of Code (HTTP {status_code}). " + "Your session token may be invalid." + ), unexpected_status_message="Unexpected HTTP error: {status_code}.", ) @@ -72,26 +145,47 @@ def get_leaderboard( "Failed to decode leaderboard JSON. Your session/view key may be invalid." ) from exc + if not isinstance(payload, dict): + raise LeaderboardFetchError("Unexpected leaderboard schema from Advent of Code.") + _validate_leaderboard(payload) + return payload + + +def _read_fresh_cache(cache_file: Path) -> dict[str, Any] | None: + """Return a valid cache entry within AoC's 15-minute request interval.""" try: - leaderboard = Leaderboard.model_validate(payload) - except ValidationError as exc: + age_seconds = time.time() - cache_file.stat().st_mtime + except FileNotFoundError: + return None + except OSError as exc: + raise LeaderboardFetchError(f"Could not inspect leaderboard cache {cache_file}.") from exc + + if age_seconds > LEADERBOARD_CACHE_TTL.total_seconds(): + return None + + try: + payload = json.loads(cache_file.read_text(encoding="utf-8")) + if not isinstance(payload, dict): + raise ValueError("Leaderboard cache must contain a JSON object.") + _validate_leaderboard(payload) + return payload + except (OSError, ValueError, ValidationError, LeaderboardFetchError) as exc: raise LeaderboardFetchError( - "Unexpected leaderboard schema from Advent of Code." + "The fresh leaderboard cache is unreadable or malformed. " + "Elf will not request the leaderboard again within AoC's 15-minute interval; " + f"retry after the interval has elapsed. Cache: {cache_file}." ) from exc - match fmt: - case OutputFormat.MODEL: - return leaderboard - case OutputFormat.JSON: - return json.dumps(payload, indent=2) - case OutputFormat.TABLE: - return format_leaderboard_as_table(leaderboard) - case _: - raise ValueError(f"Unsupported output format: {fmt}") + +def _validate_leaderboard(payload: dict[str, Any]) -> Leaderboard: + try: + return Leaderboard.model_validate(payload) + except ValidationError as exc: + raise LeaderboardFetchError("Unexpected leaderboard schema from Advent of Code.") from exc def format_leaderboard_as_table(leaderboard: Leaderboard) -> Table: - table = Table(title=f"Advent of Code {leaderboard.event} – Private Leaderboard") + table = Table(title=Text(f"Advent of Code {leaderboard.event} – Private Leaderboard")) table.add_column("Rank", justify="right", style="bold") table.add_column("Name", style="cyan") @@ -107,16 +201,14 @@ def format_leaderboard_as_table(leaderboard: Leaderboard) -> Table: for rank, member in enumerate(members, start=1): last_star = ( - datetime.fromtimestamp(member.last_star_ts, tz=timezone.utc).strftime( - "%Y-%m-%d %H:%M:%S" - ) + datetime.fromtimestamp(member.last_star_ts, tz=UTC).strftime("%Y-%m-%d %H:%M:%S") if member.last_star_ts else "-" ) table.add_row( str(rank), - member.name or "", + Text(member.name or ""), str(member.stars), str(member.local_score), last_star, From 9128ea6992d5b21877166177e8f86ad01747e012 Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:28:40 -0500 Subject: [PATCH 18/45] Refactor cached low message formatting for improved readability --- elf/messages.py | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/elf/messages.py b/elf/messages.py index 34fdb94..ce05813 100644 --- a/elf/messages.py +++ b/elf/messages.py @@ -47,7 +47,9 @@ def get_cached_low_message( ) -> str: """User guessed too low and we know their previous highest “too low” guess.""" time_str = highest_low_guess.timestamp.strftime("%B %d at %I:%M %p") - return f"{answer} is still too low. Your highest low was {highest_low_guess.guess} on {time_str}." + return ( + f"{answer} is still too low. Your highest low was {highest_low_guess.guess} on {time_str}." + ) def get_cached_high_message( From 30eaabbabb3fbdaf5e47ec354c19a81048ea47d4 Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:28:45 -0500 Subject: [PATCH 19/45] Refactor models to use built-in dict type and enhance SubmissionResult with retry_at field --- elf/models.py | 45 ++++++++++----------------------------------- 1 file changed, 10 insertions(+), 35 deletions(-) diff --git a/elf/models.py b/elf/models.py index d6d42a8..9f42468 100644 --- a/elf/models.py +++ b/elf/models.py @@ -3,7 +3,6 @@ from dataclasses import dataclass from datetime import datetime from enum import Enum, StrEnum, auto -from typing import Dict from pydantic import BaseModel, ConfigDict, Field @@ -33,7 +32,7 @@ class Member(BaseModel): last_star_ts: int stars: int local_score: int - completion_day_level: Dict[int, Dict[int, StarCompletion]] = Field( + completion_day_level: dict[int, dict[int, StarCompletion]] = Field( default_factory=dict, description="Mapping of day -> part -> StarCompletion.", ) @@ -49,27 +48,7 @@ class Leaderboard(BaseModel): day1_ts: int owner_id: int # member_id -> Member (keys in JSON are numeric strings; parsed as ints) - members: Dict[int, Member] - - -@dataclass(frozen=True, slots=True) -class TestResult: - part: int - passed: bool - expected: str - actual: str - message: str - - def __repr__(self): - return ( - f"TestResult(\n" - f" part={self.part},\n" - f" passed={self.passed},\n" - f" expected='{self.expected}',\n" - f" actual='{self.actual}',\n" - f" message='{self.message}'\n" - f")" - ) + members: dict[int, Member] class SubmissionStatus(StrEnum): @@ -84,20 +63,24 @@ class SubmissionStatus(StrEnum): @dataclass(frozen=True, slots=True) class SubmissionResult: + """Outcome of an answer attempt, including a cooldown deadline when applicable.""" + guess: int | str result: SubmissionStatus message: str is_correct: bool is_cached: bool + retry_at: datetime | None = None def __repr__(self): return ( f"SubmissionResult(\n" - f" guess={self.guess},\n" + f" guess={self.guess!r},\n" f" result={self.result.name},\n" f" is_correct={self.is_correct},\n" f" is_cached={self.is_cached},\n" - f" message='{self.message}'\n" + f" retry_at={self.retry_at!r},\n" + f" message={self.message!r}\n" f")" ) @@ -108,16 +91,7 @@ class Guess: part: int guess: int | str status: SubmissionStatus - - def is_too_low(self, answer: int | str) -> bool: - if isinstance(self.guess, int) and isinstance(answer, int): - return self.guess < answer and self.status == SubmissionStatus.TOO_LOW - return False - - def is_too_high(self, answer: int | str) -> bool: - if isinstance(self.guess, int) and isinstance(answer, int): - return self.guess > answer and self.status == SubmissionStatus.TOO_HIGH - return False + retry_at: datetime | None = None @dataclass(frozen=True, slots=True) @@ -127,6 +101,7 @@ class CachedGuessCheck: previous_timestamp: datetime | None status: SubmissionStatus message: str + retry_at: datetime | None = None @dataclass(slots=True) From 898efd4da23e03627496e4b22c106ddac4a706f4 Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:28:51 -0500 Subject: [PATCH 20/45] Refactor open_page function to validate event day using a dedicated function --- elf/open.py | 6 ++---- 1 file changed, 2 insertions(+), 4 deletions(-) diff --git a/elf/open.py b/elf/open.py index dbf9f65..752ffd7 100644 --- a/elf/open.py +++ b/elf/open.py @@ -1,13 +1,11 @@ import webbrowser +from .events import validate_event_day from .models import OpenKind def open_page(year: int, day: int, kind: OpenKind) -> str: - if year < 2015: - raise ValueError(f"Invalid year {year!r}. Advent of Code started in 2015.") - if not 1 <= day <= 25: - raise ValueError(f"Invalid day {day!r}. Advent of Code days are 1–25.") + validate_event_day(year, day) url = "https://adventofcode.com/" From d77f3fc1066a132f3d31dbcae16a7441071ae98a Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:28:57 -0500 Subject: [PATCH 21/45] Refactor get_status and related functions for improved readability and error handling --- elf/status.py | 62 +++++++++++++++++++++++++-------------------------- 1 file changed, 31 insertions(+), 31 deletions(-) diff --git a/elf/status.py b/elf/status.py index 2dcd100..7fa0279 100644 --- a/elf/status.py +++ b/elf/status.py @@ -5,6 +5,7 @@ from bs4 import BeautifulSoup from bs4.element import Tag from rich.table import Table +from rich.text import Text from .aoc_client import AOCClient from .exceptions import StatusFetchError @@ -12,16 +13,12 @@ from .utils import current_aoc_year, handle_http_errors, resolve_session -def get_status( - year: int, session: str | None, fmt: OutputFormat -) -> YearStatus | str | Table: +def get_status(year: int, session: str | None, fmt: OutputFormat) -> YearStatus | str | Table: session_token = resolve_session(session) now_year = current_aoc_year() if year > now_year: - raise ValueError( - f"Invalid year {year!r}. Advent of Code years are up to {now_year}." - ) + raise ValueError(f"Invalid year {year!r}. Advent of Code years are up to {now_year}.") if year < 2015: raise ValueError(f"Invalid year {year!r}. Advent of Code started in 2015.") @@ -42,7 +39,10 @@ def get_status( exc_cls=StatusFetchError, not_found_message=f"Event page not found for year={year} (HTTP 404).", bad_request_message="Bad request (HTTP 400). Your session token may be invalid.", - server_error_message="Server error from Advent of Code (HTTP {status_code}). Your session token may be invalid.", + server_error_message=( + "Server error from Advent of Code (HTTP {status_code}). " + "Your session token may be invalid." + ), unexpected_status_message="Unexpected HTTP error: {status_code}.", ) @@ -132,6 +132,15 @@ def _stars_from_aria_and_classes( return 0 +def _element_classes(element: Tag) -> list[str]: + classes = element.get("class") + if isinstance(classes, str): + return classes.split() + if isinstance(classes, list): + return [str(value) for value in classes] + return [] + + def _parse_day_status(element: Tag, *, is_locked: bool) -> DayStatus | None: aria_label = element.get("aria-label", "") or "" aria_label_str = str(aria_label) if aria_label else None @@ -152,11 +161,7 @@ def _parse_day_status(element: Tag, *, is_locked: bool) -> DayStatus | None: href_raw = element.get("href", "") href = str(href_raw) if href_raw else "" - classes = element.get("class") or [] - if isinstance(classes, str): - classes = classes.split() - elif not isinstance(classes, list): - classes = list(classes) if classes else [] + classes = _element_classes(element) stars = _stars_from_aria_and_classes(aria_label_str, classes) return DayStatus( @@ -192,15 +197,14 @@ def parse_year_status(html: str) -> YearStatus: day_statuses: list[DayStatus] = [] - # Each unlocked day is an with class "calendar-dayN" - for a in calendar.select("a[class^='calendar-day']"): - day_status = _parse_day_status(a, is_locked=False) - if day_status: - day_statuses.append(day_status) - - # Each locked day is an with class "calendar-dayN" - for span in calendar.select("span[class^='calendar-day']"): - day_status = _parse_day_status(span, is_locked=True) + # Match the numbered container class explicitly so parsing does not depend + # on CSS class order and does not mistake a nested ``span.calendar-day`` + # label for another day. + for element in calendar.find_all(["a", "span"]): + classes = _element_classes(element) + if not any(re.fullmatch(r"calendar-day\d+", value) for value in classes): + continue + day_status = _parse_day_status(element, is_locked=element.name == "span") if day_status: day_statuses.append(day_status) @@ -221,7 +225,10 @@ def build_year_status_table(status: YearStatus) -> Table: Build a Rich Table summarizing a user's AoC progress for a year. """ supporter_suffix = " (AoC++)" if status.is_supporter else "" - title = f"Advent of Code {status.year} – {status.username}{supporter_suffix} [{status.total_stars}⭐]" + title = Text( + f"Advent of Code {status.year} – {status.username}{supporter_suffix} " + f"[{status.total_stars}⭐]" + ) table = Table(title=title, show_lines=False) @@ -230,9 +237,7 @@ def build_year_status_table(status: YearStatus) -> Table: for day in sorted(status.days, key=lambda d: d.day): # Render stars as a 2-star gauge: ★ for earned, ☆ for missing - stars_str = ( - "★" * day.stars + "☆" * (2 - day.stars) if not day.is_locked else "🔒" - ) + stars_str = "★" * day.stars + "☆" * (2 - day.stars) if not day.is_locked else "🔒" # Row coloring based on completion if day.stars == 2: @@ -254,9 +259,4 @@ def parse_login_state(html: str) -> bool: has_login = "/auth/login" in html has_settings = "/settings" in html - # Logged in = settings visible AND login missing - if has_settings and not has_login: - return True - - # Otherwise assume logged out - return False + return has_settings and not has_login From 58c3516d2af818ed65881a69425eeb9d0f4b3fb5 Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:29:01 -0500 Subject: [PATCH 22/45] Refactor read_guesses function for improved error handling and add _parse_cache_datetime utility --- elf/utils.py | 64 +++++++++++++++++++++++++++++++--------------------- 1 file changed, 38 insertions(+), 26 deletions(-) diff --git a/elf/utils.py b/elf/utils.py index a12d908..aa0e62a 100644 --- a/elf/utils.py +++ b/elf/utils.py @@ -1,18 +1,26 @@ import csv import os import warnings -from datetime import datetime, timezone +from datetime import UTC, datetime +from pathlib import Path import httpx from .cache import get_cache_guess_file from .constants import AOC_TZ +from .events import validate_event_day from .exceptions import ElfError, MissingSessionTokenError from .models import Guess, SubmissionStatus, UnlockStatus -def read_guesses(year: int, day: int) -> list[Guess]: - cache_file = get_cache_guess_file(year, day) +def read_guesses( + year: int, + day: int, + session_token: str | None = None, + *, + cache_file: Path | None = None, +) -> list[Guess]: + cache_file = cache_file or get_cache_guess_file(year, day, session_token) if not cache_file.exists(): return [] @@ -25,15 +33,10 @@ def read_guesses(year: int, day: int) -> list[Guess]: for row in reader: try: status_raw = (row.get("status") or "UNKNOWN").upper() - status = SubmissionStatus.__members__.get( - status_raw, SubmissionStatus.UNKNOWN - ) + status = SubmissionStatus.__members__.get(status_raw, SubmissionStatus.UNKNOWN) guess_raw = row.get("guess", "") - if isinstance(guess_raw, str): - guess_str = guess_raw.strip() - else: - guess_str = str(guess_raw) + guess_str = guess_raw.strip() if isinstance(guess_raw, str) else str(guess_raw) if guess_str.lstrip("+-").isdigit(): guess_val: int | str = int(guess_str) @@ -41,16 +44,12 @@ def read_guesses(year: int, day: int) -> list[Guess]: guess_val = guess_str timestamp_raw = row.get("timestamp", "") or "" - try: - if timestamp_raw: - timestamp = datetime.fromisoformat(timestamp_raw) - # Normalize to tz-aware (assume UTC if missing) - if timestamp.tzinfo is None: - timestamp = timestamp.replace(tzinfo=timezone.utc) - else: - timestamp = datetime.now(timezone.utc) - except Exception: - timestamp = datetime.now(timezone.utc) + timestamp = _parse_cache_datetime(timestamp_raw) + if timestamp is None: + timestamp = datetime.fromtimestamp(0, UTC) + + retry_at_raw = row.get("retry_at", "") or "" + retry_at = _parse_cache_datetime(retry_at_raw) part_raw = row.get("part") if part_raw is None: @@ -62,9 +61,10 @@ def read_guesses(year: int, day: int) -> list[Guess]: part=int(part_raw), guess=guess_val, status=status, + retry_at=retry_at, ) ) - except Exception: + except (TypeError, ValueError, OverflowError): skipped_rows += 1 continue except Exception as exc: @@ -85,6 +85,16 @@ def read_guesses(year: int, day: int) -> list[Guess]: return sorted_guesses +def _parse_cache_datetime(value: str) -> datetime | None: + if not value: + return None + try: + parsed = datetime.fromisoformat(value) + except (ValueError, OverflowError): + return None + return parsed if parsed.tzinfo is not None else parsed.replace(tzinfo=UTC) + + def current_aoc_year() -> int: """Return the current year in the AoC timezone.""" return datetime.now(tz=AOC_TZ).year @@ -96,9 +106,7 @@ def get_unlock_status(year: int, day: int) -> UnlockStatus: AoC unlocks each day at midnight local time (Y-12-D 00:00 in America/New_York). """ - if not 1 <= day <= 25: - # Let existing validation handle out-of-range days elsewhere - raise ValueError(f"Invalid day {day!r}. Advent of Code days are 1–25.") + validate_event_day(year, day) # Current time in AoC timezone now = datetime.now(tz=AOC_TZ) @@ -164,10 +172,14 @@ def looks_like_login_page(response: httpx.Response) -> bool: if "text/plain" in content_type: return False - html = response.text + return looks_like_login_content(response.text) + + +def looks_like_login_content(content: str) -> bool: + """Detect AoC authentication HTML in a response or historical cache file.""" markers = ( "To play, please identify yourself", "/auth/login", 'name="session"', ) - return any(marker in html for marker in markers) + return any(marker in content for marker in markers) From bc0f661dba81d79c6b90ebb85b6b5bee84c698b6 Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:29:09 -0500 Subject: [PATCH 23/45] Add fixture to block external network access during tests --- tests/conftest.py | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 tests/conftest.py diff --git a/tests/conftest.py b/tests/conftest.py new file mode 100644 index 0000000..d3582b9 --- /dev/null +++ b/tests/conftest.py @@ -0,0 +1,15 @@ +import socket + +import pytest + + +@pytest.fixture(autouse=True) +def block_external_network(monkeypatch): + """Make accidental HTTP calls fail before they can leave the test process.""" + + def blocked(*args, **kwargs): + pytest.fail("Network access is disabled during tests; mock the HTTP interaction.") + + monkeypatch.setattr(socket, "getaddrinfo", blocked) + monkeypatch.setattr(socket.socket, "connect", blocked) + monkeypatch.setattr(socket.socket, "connect_ex", blocked) From 97996d1c57ad59d3d0150509cef6b1e8efb8d55b Mon Sep 17 00:00:00 2001 From: cak Date: Fri, 13 Nov 2026 11:29:14 -0500 Subject: [PATCH 24/45] Fix parameter order and default values for get_private_leaderboard in the public API --- elf/__init__.py | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/elf/__init__.py b/elf/__init__.py index 7354152..ed787a1 100644 --- a/elf/__init__.py +++ b/elf/__init__.py @@ -5,7 +5,7 @@ - get_puzzle_input(year, day, session=None) -> str - submit_puzzle_answer(year, day, part, answer, session=None) -> SubmissionResult -- get_private_leaderboard(year, session, board_id, view_key, fmt=OutputFormat.MODEL) +- get_private_leaderboard(year, board_id, session=None, view_key=None, fmt=OutputFormat.MODEL) - get_user_status(year, session=None, fmt=OutputFormat.MODEL) The session token can be passed explicitly or via the AOC_SESSION environment variable. @@ -30,13 +30,13 @@ ) __all__ = [ - "get_puzzle_input", - "submit_puzzle_answer", - "get_private_leaderboard", - "get_user_status", + "DayStatus", + "Leaderboard", "OutputFormat", "SubmissionResult", - "DayStatus", "YearStatus", - "Leaderboard", + "get_private_leaderboard", + "get_puzzle_input", + "get_user_status", + "submit_puzzle_answer", ] From e054038690cb33660ea9bc1d7c94a1fdda6581d6 Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 11:04:29 -0500 Subject: [PATCH 25/45] Add tzdata dependency for Windows platform and update changelog URL in pyproject.toml --- pyproject.toml | 2 ++ uv.lock | 11 +++++++++++ 2 files changed, 13 insertions(+) diff --git a/pyproject.toml b/pyproject.toml index 5569924..f0653dc 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -16,6 +16,7 @@ dependencies = [ "pydantic>=2.12.4", "rich>=14.2.0", "typer>=0.20.0", + "tzdata>=2025.2; sys_platform == 'win32'", ] keywords = [ @@ -44,6 +45,7 @@ Homepage = "https://github.com/cak/elf" Documentation = "https://github.com/cak/elf/" Repository = "https://github.com/cak/elf" Issue-Tracker = "https://github.com/cak/elf/issues" +Changelog = "https://github.com/cak/elf/blob/main/CHANGELOG.md" [project.scripts] elf = "elf.cli:main" diff --git a/uv.lock b/uv.lock index 2d97f96..f789340 100644 --- a/uv.lock +++ b/uv.lock @@ -144,6 +144,7 @@ dependencies = [ { name = "pydantic" }, { name = "rich" }, { name = "typer" }, + { name = "tzdata", marker = "sys_platform == 'win32'" }, ] [package.dev-dependencies] @@ -160,6 +161,7 @@ requires-dist = [ { name = "pydantic", specifier = ">=2.12.4" }, { name = "rich", specifier = ">=14.2.0" }, { name = "typer", specifier = ">=0.20.0" }, + { name = "tzdata", marker = "sys_platform == 'win32'", specifier = ">=2025.2" }, ] [package.metadata.requires-dev] @@ -741,3 +743,12 @@ sdist = { url = "https://files.pythonhosted.org/packages/ff/50/0195198eb1d75bab7 wheels = [ { url = "https://files.pythonhosted.org/packages/de/0c/ea2544850a7c135e15033a5c7a8e7211136184b7ae63e2239d557c2b3019/typing_inspection-0.4.5-py3-none-any.whl", hash = "sha256:bc210535442b39e1bf2805e0c7a17dfd6a4ace760c84c7f7d16245d23a6b1c39", size = 14874, upload-time = "2026-11-04T14:13:22.616Z" }, ] + +[[package]] +name = "tzdata" +version = "2026.6" +source = { registry = "https://pypi.org/simple" } +sdist = { url = "https://files.pythonhosted.org/packages/7a/29/6a1391d31cd00ff9e927215a224a880e1e84e826b64ba80a499e51c074d8/tzdata-2026.6.tar.gz", hash = "sha256:85d2cd9c09f81f0bb29db27759fc83af4f1e620efb814f8c5bf8b4cc4feece6d", size = 201017, upload-time = "2026-10-28T09:57:09.137Z" } +wheels = [ + { url = "https://files.pythonhosted.org/packages/0a/66/9a06c2227fedfd4919f0eaaa8b94377d9730882a7e4f95823c9a331ab5e1/tzdata-2026.6-py2.py3-none-any.whl", hash = "sha256:0a10eec6e13ef16b627fabed9a5f2ba61a62b1c67f327305f4e7e412a70b4aec", size = 348210, upload-time = "2026-10-28T09:57:07.276Z" }, +] From 7305b6fd8fafcecc1992af336e71b396a7057f39 Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 11:04:38 -0500 Subject: [PATCH 26/45] Add initial changelog for version 1.2.0 with notable user-facing changes --- CHANGELOG.md | 36 ++++++++++++++++++++++++++++++++++++ 1 file changed, 36 insertions(+) create mode 100644 CHANGELOG.md diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..bef7a6a --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,36 @@ +# Changelog + +Notable user-facing changes to elf are documented here. + +## 1.2.0 — 2026-11-15 + +### Added + +- Calendar-aware defaults for archived, active, and reduced-length Advent of Code events. +- Persistent private-leaderboard caching with the required 15-minute refresh interval. +- `elf doctor` for offline configuration, version, clock, and cache diagnostics. +- Account-scoped input and submission caches, atomic writes, private permissions, and safe legacy-cache migration. +- Cross-process protection for leaderboard refreshes, guess history, and answer submission. +- Exact server-provided submission cooldown deadlines, exposed as `SubmissionResult.retry_at`. +- Ruff, mypy, network-blocked tests, and Linux, macOS, and Windows CI coverage. + +### Changed + +- Default commands select the latest relevant puzzle outside December while explicit year and day arguments remain authoritative. +- Internally created HTTP clients now have explicit ownership and are closed reliably; injected clients remain caller-owned. +- JSON and user-provided text are emitted without Rich markup interpretation. +- Existing four-column guess histories are upgraded safely on their next write. + +### Fixed + +- Cache sharing between different Advent of Code accounts. +- Partial cache files and lost rows during interrupted or concurrent writes. +- Duplicate concurrent submissions and submissions to a locally known completed part. +- Authentication-page handling, malformed cache handling, historical calendar parsing, and several HTTP error messages. +- Windows startup failures on systems without an operating-system timezone database. + +### Compatibility + +- The documented top-level Python API remains compatible. +- Existing inputs and guess histories are preserved; legacy files remain available for manual recovery. +- `SubmissionResult.retry_at` is an additive optional field and is `None` outside cooldown responses. From 216440f5df6143dbdece161eae0f1023674f8fed Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 11:04:47 -0500 Subject: [PATCH 27/45] Include CHANGELOG.md in MANIFEST.in for package distribution --- MANIFEST.in | 1 + 1 file changed, 1 insertion(+) diff --git a/MANIFEST.in b/MANIFEST.in index c871591..d8c8196 100644 --- a/MANIFEST.in +++ b/MANIFEST.in @@ -1,2 +1,3 @@ +include CHANGELOG.md include tests/conftest.py recursive-include tests/fixtures *.html From 7fa201ea6229056413d841df62677f324c282f18 Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 11:11:59 -0500 Subject: [PATCH 28/45] Add enhance member timestamp handling, address issue #5 --- elf/leaderboard.py | 95 ++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 80 insertions(+), 15 deletions(-) diff --git a/elf/leaderboard.py b/elf/leaderboard.py index f1221a1..9164997 100644 --- a/elf/leaderboard.py +++ b/elf/leaderboard.py @@ -1,8 +1,10 @@ +import csv import json import os import time import warnings from datetime import UTC, datetime, timedelta +from io import StringIO from pathlib import Path from typing import Any @@ -19,7 +21,7 @@ get_cache_leaderboard_file, ) from .exceptions import LeaderboardFetchError, MissingSessionTokenError -from .models import Leaderboard, OutputFormat +from .models import Leaderboard, Member, OutputFormat from .utils import handle_http_errors, resolve_session LEADERBOARD_CACHE_TTL = timedelta(minutes=15) @@ -97,6 +99,8 @@ def get_leaderboard( return leaderboard case OutputFormat.JSON: return json.dumps(payload, indent=2) + case OutputFormat.CSV: + return format_leaderboard_as_csv(leaderboard, year=year, board_id=board_id) case OutputFormat.TABLE: return format_leaderboard_as_table(leaderboard) case _: @@ -184,6 +188,77 @@ def _validate_leaderboard(payload: dict[str, Any]) -> Leaderboard: raise LeaderboardFetchError("Unexpected leaderboard schema from Advent of Code.") from exc +def _first_star_timestamp(member: Member) -> int | None: + """Return the member's earliest star completion timestamp, if any.""" + return min( + ( + completion.get_star_ts + for parts in member.completion_day_level.values() + for completion in parts.values() + ), + default=None, + ) + + +def _format_utc_timestamp(timestamp: int | None) -> str: + if not timestamp: + return "-" + return datetime.fromtimestamp(timestamp, tz=UTC).strftime("%Y-%m-%d %H:%M:%S") + + +def _format_csv_timestamp(timestamp: int | None) -> str: + if not timestamp: + return "" + return datetime.fromtimestamp(timestamp, tz=UTC).strftime("%Y-%m-%dT%H:%M:%SZ") + + +def _ranked_members(leaderboard: Leaderboard) -> list[Member]: + return sorted( + leaderboard.members.values(), + key=lambda member: (-member.local_score, -member.stars, member.id), + ) + + +def format_leaderboard_as_csv( + leaderboard: Leaderboard, + *, + year: int, + board_id: int, +) -> str: + """Serialize one deterministic summary row per leaderboard member.""" + output = StringIO(newline="") + fieldnames = ( + "year", + "board_id", + "rank", + "member_id", + "name", + "stars", + "local_score", + "first_star_utc", + "last_star_utc", + ) + writer = csv.DictWriter(output, fieldnames=fieldnames, lineterminator="\n") + writer.writeheader() + + for rank, member in enumerate(_ranked_members(leaderboard), start=1): + writer.writerow( + { + "year": year, + "board_id": board_id, + "rank": rank, + "member_id": member.id, + "name": member.name or "", + "stars": member.stars, + "local_score": member.local_score, + "first_star_utc": _format_csv_timestamp(_first_star_timestamp(member)), + "last_star_utc": _format_csv_timestamp(member.last_star_ts), + } + ) + + return output.getvalue() + + def format_leaderboard_as_table(leaderboard: Leaderboard) -> Table: table = Table(title=Text(f"Advent of Code {leaderboard.event} – Private Leaderboard")) @@ -191,27 +266,17 @@ def format_leaderboard_as_table(leaderboard: Leaderboard) -> Table: table.add_column("Name", style="cyan") table.add_column("Stars", justify="right", style="yellow") table.add_column("Local Score", justify="right", style="green") + table.add_column("First Star (UTC)", style="magenta") table.add_column("Last Star (UTC)", style="magenta") - # sort: highest local_score, then highest stars - members = sorted( - leaderboard.members.values(), - key=lambda m: (-m.local_score, -m.stars, m.id), - ) - - for rank, member in enumerate(members, start=1): - last_star = ( - datetime.fromtimestamp(member.last_star_ts, tz=UTC).strftime("%Y-%m-%d %H:%M:%S") - if member.last_star_ts - else "-" - ) - + for rank, member in enumerate(_ranked_members(leaderboard), start=1): table.add_row( str(rank), Text(member.name or ""), str(member.stars), str(member.local_score), - last_star, + _format_utc_timestamp(_first_star_timestamp(member)), + _format_utc_timestamp(member.last_star_ts), ) return table From a1ebd8de08f3053c7bea026c8bc781265904ddf7 Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 11:14:10 -0500 Subject: [PATCH 29/45] Refactor output format handling for leaderboard and status commands, adding CSV support and improving type annotations --- elf/cli.py | 35 ++++++++++++++++++++++++++++------- 1 file changed, 28 insertions(+), 7 deletions(-) diff --git a/elf/cli.py b/elf/cli.py index 0a2dfc6..460d9a1 100644 --- a/elf/cli.py +++ b/elf/cli.py @@ -1,3 +1,4 @@ +from enum import Enum from functools import wraps from typing import Annotated @@ -30,8 +31,10 @@ def _print_formatted_output(data: object, output_format: OutputFormat) -> None: - """Keep JSON byte-for-byte intact while allowing Rich renderables elsewhere.""" - if output_format is OutputFormat.JSON and isinstance(data, str): + """Print machine-readable strings without Rich interpretation.""" + if output_format is OutputFormat.CSV and isinstance(data, str): + typer.echo(data, nl=False) + elif output_format is OutputFormat.JSON and isinstance(data, str): typer.echo(data) else: console.print(data) @@ -81,8 +84,25 @@ def _current_year() -> int: ), ] AnswerArg = Annotated[str, typer.Argument(help="Your answer to submit")] -FormatOpt = Annotated[ + + +class _StatusOutputFormat(str, Enum): + MODEL = OutputFormat.MODEL.value + TABLE = OutputFormat.TABLE.value + JSON = OutputFormat.JSON.value + + +LeaderboardFormatOpt = Annotated[ OutputFormat, + typer.Option( + "--format", + "-f", + help="Output format: table, csv, json, model", + case_sensitive=False, + ), +] +StatusFormatOpt = Annotated[ + _StatusOutputFormat, typer.Option( "--format", "-f", @@ -214,7 +234,7 @@ def leaderboard_cmd( typer.Option(help="View key for the private leaderboard, if required"), ] = None, session: SessionOpt = None, - output_format: FormatOpt = OutputFormat.TABLE, + output_format: LeaderboardFormatOpt = OutputFormat.TABLE, ) -> None: """ Fetch and display a private leaderboard for a given year. @@ -249,18 +269,19 @@ def guesses_cmd( def status_cmd( year: YearArg, session: SessionOpt = None, - output_format: FormatOpt = OutputFormat.TABLE, + output_format: StatusFormatOpt = _StatusOutputFormat.TABLE, ) -> None: """ Fetch and display your Advent of Code status for a given year. """ + resolved_format = OutputFormat(output_format.value) status_data = get_status( year=year, session=session, - fmt=output_format, + fmt=resolved_format, ) - _print_formatted_output(status_data, output_format) + _print_formatted_output(status_data, resolved_format) @app.command("open") From c29766629d531b4e3ca4d9a34c0dd7f87fbff7fc Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 11:14:14 -0500 Subject: [PATCH 30/45] Update get_private_leaderboard to support CSV output format --- elf/client.py | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/elf/client.py b/elf/client.py index 389be76..84f22f0 100644 --- a/elf/client.py +++ b/elf/client.py @@ -105,8 +105,8 @@ def get_private_leaderboard( Private leaderboards allow groups to track each other's progress. This function fetches the leaderboard’s current state and optionally formats it - as a Python object, JSON string, or a human-readable representation. You - can provide either a session token (full access) or just a view key + as a Python object, CSV or JSON string, or a human-readable representation. + You can provide either a session token (full access) or just a view key (read-only share link). Parameters @@ -121,12 +121,12 @@ def get_private_leaderboard( The read-only “share code” for the leaderboard. When present, a session token is optional. fmt: - The desired output format (``MODEL`` | ``JSON`` | ``TABLE``). + The desired output format (``MODEL`` | ``CSV`` | ``JSON`` | ``TABLE``). Returns ------- Leaderboard | str | Table - A structured leaderboard model, JSON string, or formatted table, + A structured leaderboard model, CSV or JSON string, or formatted table, depending on ``fmt``. Raises From bcc09480a7a95df27da9a6a7afce906a7642a885 Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 11:14:18 -0500 Subject: [PATCH 31/45] Add CSV output format to OutputFormat enum --- elf/models.py | 1 + 1 file changed, 1 insertion(+) diff --git a/elf/models.py b/elf/models.py index 9f42468..f96cece 100644 --- a/elf/models.py +++ b/elf/models.py @@ -115,6 +115,7 @@ class OutputFormat(str, Enum): MODEL = "model" TABLE = "table" JSON = "json" + CSV = "csv" class OpenKind(str, Enum): From 3a4af5e00ef7b8acc67e7629c51bbc42f8cde981 Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 11:14:24 -0500 Subject: [PATCH 32/45] Add CSV output tests and enhance model output format validation --- tests/test_cli_commands.py | 44 ++++++++++ tests/test_leaderboard_csv.py | 151 ++++++++++++++++++++++++++++++++ tests/test_leaderboard_table.py | 144 ++++++++++++++++++++++++++++++ tests/test_models.py | 12 +-- 4 files changed, 345 insertions(+), 6 deletions(-) create mode 100644 tests/test_leaderboard_csv.py create mode 100644 tests/test_leaderboard_table.py diff --git a/tests/test_cli_commands.py b/tests/test_cli_commands.py index 86958cf..c292b5e 100644 --- a/tests/test_cli_commands.py +++ b/tests/test_cli_commands.py @@ -1,3 +1,7 @@ +import csv +import io +import json + from typer.testing import CliRunner from elf.cli import app @@ -100,6 +104,46 @@ def test_json_output_is_not_interpreted_as_rich_markup(monkeypatch): assert result.exit_code == 0 assert result.stdout == f"{payload}\n" + assert json.loads(result.stdout) == {"name": "[red]literal[/red]"} + + +def test_csv_output_is_raw_machine_readable_data(monkeypatch): + payload = 'name,stars\n"[red]Elf, One[/red]",2\n' + monkeypatch.setattr("elf.cli.get_leaderboard", lambda *args, **kwargs: payload) + + result = runner.invoke( + app, + ["leaderboard", "2025", "12345", "--view-key", "secret", "--format", "csv"], + ) + + assert result.exit_code == 0 + assert result.stdout == payload + assert list(csv.DictReader(io.StringIO(result.stdout))) == [ + {"name": "[red]Elf, One[/red]", "stars": "2"} + ] + + +def test_leaderboard_authentication_errors_stay_on_stderr(monkeypatch): + monkeypatch.delenv("AOC_SESSION", raising=False) + + result = runner.invoke(app, ["leaderboard", "2025", "12345", "--format", "csv"]) + + assert result.exit_code == 1 + assert result.stdout == "" + assert "AOC_SESSION" in result.stderr + + +def test_status_rejects_csv_without_advertising_it(): + help_result = runner.invoke(app, ["status", "--help"]) + csv_result = runner.invoke( + app, + ["status", "2025", "--session", "token", "--format", "csv"], + ) + + assert help_result.exit_code == 0 + assert "csv" not in help_result.stdout.lower() + assert csv_result.exit_code == 2 + assert "invalid value" in csv_result.stderr.lower() def test_status_cmd_outputs(monkeypatch): diff --git a/tests/test_leaderboard_csv.py b/tests/test_leaderboard_csv.py new file mode 100644 index 0000000..a5fb9ff --- /dev/null +++ b/tests/test_leaderboard_csv.py @@ -0,0 +1,151 @@ +import csv +import io +import json + +from rich.table import Table + +from elf import OutputFormat, get_private_leaderboard +from elf.leaderboard import format_leaderboard_as_csv +from elf.models import Leaderboard + +CSV_FIELDS = [ + "year", + "board_id", + "rank", + "member_id", + "name", + "stars", + "local_score", + "first_star_utc", + "last_star_utc", +] + + +def _payload(): + return { + "num_days": 12, + "event": "2025", + "day1_ts": 1764565200, + "owner_id": 1, + "members": { + "30": { + "id": 30, + "name": "Zero", + "last_star_ts": 0, + "stars": 0, + "local_score": 0, + }, + "20": { + "id": 20, + "name": None, + "last_star_ts": 1764567000, + "stars": 1, + "local_score": 50, + "completion_day_level": {"1": {"1": {"get_star_ts": 1764567000, "star_index": 5}}}, + }, + "10": { + "id": 10, + "name": 'Doe, "Elf"\nJr.', + "last_star_ts": 1765005300, + "stars": 3, + "local_score": 100, + "completion_day_level": { + "6": {"1": {"get_star_ts": 1765005300, "star_index": 4}}, + "1": { + "2": {"get_star_ts": 1764567900, "star_index": 2}, + "1": {"get_star_ts": 1764565800, "star_index": 1}, + }, + }, + }, + "1": { + "id": 1, + "name": "Alice", + "last_star_ts": 1764567900, + "stars": 3, + "local_score": 100, + "completion_day_level": {"1": {"1": {"get_star_ts": 1764566100, "star_index": 3}}}, + }, + "5": { + "id": 5, + "name": "Five", + "last_star_ts": 1764568000, + "stars": 2, + "local_score": 100, + "completion_day_level": {}, + }, + }, + } + + +def _read_csv(data: str): + reader = csv.DictReader(io.StringIO(data)) + return reader.fieldnames, list(reader) + + +def test_csv_schema_values_escaping_and_deterministic_sorting(): + leaderboard = Leaderboard.model_validate(_payload()) + + csv_data = format_leaderboard_as_csv(leaderboard, year=2025, board_id=123456) + fieldnames, rows = _read_csv(csv_data) + + assert fieldnames == CSV_FIELDS + assert [row["member_id"] for row in rows] == ["1", "10", "5", "20", "30"] + assert [row["rank"] for row in rows] == ["1", "2", "3", "4", "5"] + assert rows[1]["name"] == 'Doe, "Elf"\nJr.' + assert rows[1]["first_star_utc"] == "2025-12-01T05:10:00Z" + assert rows[1]["last_star_utc"] == "2025-12-06T07:15:00Z" + assert rows[2]["first_star_utc"] == "" + assert rows[2]["last_star_utc"] == "2025-12-01T05:46:40Z" + assert rows[3]["name"] == "" + assert rows[4]["stars"] == "0" + assert rows[4]["first_star_utc"] == "" + assert rows[4]["last_star_utc"] == "" + assert csv_data == format_leaderboard_as_csv(leaderboard, year=2025, board_id=123456) + + +def test_empty_leaderboard_csv_contains_stable_header(): + payload = _payload() + payload["members"] = {} + + fieldnames, rows = _read_csv( + format_leaderboard_as_csv(Leaderboard.model_validate(payload), year=2025, board_id=123456) + ) + + assert fieldnames == CSV_FIELDS + assert rows == [] + + +def test_public_api_returns_csv_and_unchanged_other_formats(monkeypatch): + payload = _payload() + monkeypatch.setattr("elf.leaderboard._read_fresh_cache", lambda _path: payload) + + csv_output = get_private_leaderboard( + 2025, + board_id=123456, + session="session", + fmt=OutputFormat.CSV, + ) + json_output = get_private_leaderboard( + 2025, + board_id=123456, + session="session", + fmt=OutputFormat.JSON, + ) + model_output = get_private_leaderboard( + 2025, + board_id=123456, + session="session", + fmt=OutputFormat.MODEL, + ) + table_output = get_private_leaderboard( + 2025, + board_id=123456, + session="session", + fmt=OutputFormat.TABLE, + ) + + assert isinstance(csv_output, str) + assert isinstance(json_output, str) + assert json.loads(json_output) == payload + assert isinstance(model_output, Leaderboard) + assert isinstance(table_output, Table) diff --git a/tests/test_leaderboard_table.py b/tests/test_leaderboard_table.py new file mode 100644 index 0000000..25b7f25 --- /dev/null +++ b/tests/test_leaderboard_table.py @@ -0,0 +1,144 @@ +import json +import time + +import pytest +from rich.console import Console + +from elf.leaderboard import ( + _first_star_timestamp, + _format_utc_timestamp, + format_leaderboard_as_table, + get_leaderboard, +) +from elf.models import Leaderboard, Member, OutputFormat + + +def _member( + *, + member_id: int = 1, + name: str = "Elf", + last_star_ts: int = 0, + stars: int = 0, + local_score: int = 0, + completion_day_level=None, +) -> Member: + data = { + "id": member_id, + "name": name, + "last_star_ts": last_star_ts, + "stars": stars, + "local_score": local_score, + } + if completion_day_level is not None: + data["completion_day_level"] = completion_day_level + return Member.model_validate(data) + + +def _leaderboard_payload(): + return { + "num_days": 12, + "event": "2025", + "day1_ts": 1764565200, + "owner_id": 1, + "members": { + "1": { + "id": 1, + "name": "Alice", + "last_star_ts": 1765005300, + "stars": 4, + "local_score": 150, + "completion_day_level": { + "6": { + "2": {"get_star_ts": 1765005300, "star_index": 4}, + "1": {"get_star_ts": 1765004400, "star_index": 3}, + }, + "1": { + "2": {"get_star_ts": 1764567900, "star_index": 2}, + "1": {"get_star_ts": 1764565800, "star_index": 1}, + }, + }, + }, + "2": { + "id": 2, + "name": "Bob", + "last_star_ts": 1764567000, + "stars": 1, + "local_score": 80, + "completion_day_level": {"1": {"1": {"get_star_ts": 1764567000, "star_index": 5}}}, + }, + "3": { + "id": 3, + "name": "Carol", + "last_star_ts": 0, + "stars": 0, + "local_score": 0, + }, + }, + } + + +def _render_table(leaderboard: Leaderboard) -> str: + console = Console(record=True, width=140, color_system=None) + console.print(format_leaderboard_as_table(leaderboard)) + return console.export_text() + + +def test_first_star_uses_earliest_completion_independent_of_mapping_order(): + member = _member( + completion_day_level={ + 5: { + 2: {"get_star_ts": 500, "star_index": 4}, + 1: {"get_star_ts": 400, "star_index": 3}, + }, + 1: { + 2: {"get_star_ts": 200, "star_index": 2}, + 1: {"get_star_ts": 100, "star_index": 1}, + }, + } + ) + + assert _first_star_timestamp(member) == 100 + + +@pytest.mark.parametrize("completion_day_level", [None, {}]) +def test_first_star_handles_missing_or_empty_completion_data(completion_day_level): + member = _member(completion_day_level=completion_day_level) + + assert _first_star_timestamp(member) is None + + +def test_table_displays_first_and_last_stars_and_preserves_ranking(): + output = _render_table(Leaderboard.model_validate(_leaderboard_payload())) + + assert "First Star (UTC)" in output + assert "Last Star (UTC)" in output + assert "2025-12-01 05:10:00" in output + assert output.count("2025-12-01 05:30:00") == 2 + assert output.index("Alice") < output.index("Bob") < output.index("Carol") + assert "│ 1 │ Alice" in output + assert "│ 2 │ Bob" in output + assert "│ 3 │ Carol" in output + assert "│ Carol │ 0 │ 0 │ -" in output + + +def test_timestamp_formatting_is_utc_regardless_of_machine_timezone(monkeypatch): + if hasattr(time, "tzset"): + with monkeypatch.context() as timezone: + timezone.setenv("TZ", "Pacific/Honolulu") + time.tzset() + assert _format_utc_timestamp(1764565800) == "2025-12-01 05:10:00" + time.tzset() + else: + assert _format_utc_timestamp(1764565800) == "2025-12-01 05:10:00" + + +def test_json_and_model_outputs_are_unchanged(monkeypatch): + payload = _leaderboard_payload() + monkeypatch.setattr("elf.leaderboard._read_fresh_cache", lambda _path: payload) + + json_output = get_leaderboard(2025, "session", 1, None, OutputFormat.JSON) + model_output = get_leaderboard(2025, "session", 1, None, OutputFormat.MODEL) + + assert json.loads(json_output) == payload + assert isinstance(model_output, Leaderboard) + assert not hasattr(model_output.members[1], "first_star_ts") diff --git a/tests/test_models.py b/tests/test_models.py index 74db921..cc13416 100644 --- a/tests/test_models.py +++ b/tests/test_models.py @@ -2,12 +2,12 @@ def test_output_format_members_cover_known_values(): - # Your existing code uses TABLE, JSON, and MODEL. - members = {fmt for fmt in OutputFormat} - assert OutputFormat.JSON in members - assert OutputFormat.MODEL in members - # TABLE may or may not be used in the CLI yet, but it exists. - assert OutputFormat.TABLE in members + assert set(OutputFormat) == { + OutputFormat.CSV, + OutputFormat.JSON, + OutputFormat.MODEL, + OutputFormat.TABLE, + } def test_submission_status_has_known_members(): From 6db8eb303808440654f666dfb5a4cd3feb3ca552 Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 11:14:28 -0500 Subject: [PATCH 33/45] Update README to include CSV format support for leaderboard and enhance export options --- README.md | 40 +++++++++++++++++++++++++++++++--------- 1 file changed, 31 insertions(+), 9 deletions(-) diff --git a/README.md b/README.md index 9da90ab..a7b0cae 100644 --- a/README.md +++ b/README.md @@ -29,7 +29,7 @@ If Advent of Code is part of your December ritual too, I hope this little elf ma - Fetch inputs instantly with **automatic caching** - Submit answers safely with **smart guardrails** (duplicate, low, high, locked, cooldown) -- Explore private leaderboards as **tables**, **JSON**, or **Pydantic models** +- Explore private leaderboards as **tables**, **CSV**, **JSON**, or **Pydantic models** - View your **status calendar** (table, JSON, or model) - Inspect your **guess history** with timestamps and per-part details - Diagnose local configuration safely with **`elf doctor`** @@ -265,12 +265,13 @@ Usage: elf leaderboard YEAR BOARD_ID Options: --view-key TEXT --session TEXT - --format table|json|model + --format table|csv|json|model ``` Supports: - **table:** pretty Rich table +- **csv:** one summary row per member - **json:** raw JSON - **model:** structured Pydantic model @@ -401,13 +402,13 @@ from elf.helpers import parse_input, read_input, timer ```sh ❯ elf leaderboard 2025 3913340 Advent of Code 2025 – Private Leaderboard -┏━━━━━━┳━━━━━━━━━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━┓ -┃ Rank ┃ Name ┃ Stars ┃ Local Score ┃ Last Star (UTC) ┃ -┡━━━━━━╇━━━━━━━━━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━┩ -│ 1 │ User A │ 24 │ 900 │ 2025-12-12 00:53:17 │ -│ 2 │ User B │ 24 │ 855 │ 2025-12-12 00:53:56 │ -│ 3 │ User C │ 18 │ 622 │ 2025-12-12 03:29:21 │ -└──────┴────────────────┴───────┴─────────────┴─────────────────────┘ +┏━━━━━━┳━━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━┓ +┃ Rank ┃ Name ┃ Stars ┃ Local Score ┃ First Star (UTC) ┃ Last Star (UTC) ┃ +┡━━━━━━╇━━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━┩ +│ 1 │ User A │ 24 │ 900 │ 2025-12-01 00:04:21 │ 2025-12-12 00:53:17 │ +│ 2 │ User B │ 24 │ 855 │ 2025-12-01 00:05:02 │ 2025-12-12 00:53:56 │ +│ 3 │ User C │ 18 │ 622 │ 2025-12-01 00:07:45 │ 2025-12-12 03:29:21 │ +└──────┴────────┴───────┴─────────────┴─────────────────────┴─────────────────────┘ ``` JSON format: @@ -424,6 +425,27 @@ members = sorted(lb.members.values(), key=lambda m: (-m.local_score, -m.stars)) print(members[0].name, members[0].stars) ``` +### Exporting Leaderboard Data + +CSV provides one summary row per member for tabular analysis. JSON preserves the complete Advent of Code response, including individual star completions. The Python model remains available for more advanced processing, and all formats work with any tool that understands standard CSV or JSON. + +```sh +elf leaderboard 2025 123456 --format csv > leaderboard.csv +elf leaderboard 2025 123456 --format json > leaderboard.json +``` + +```python +from elf import OutputFormat, get_private_leaderboard + +csv_data = get_private_leaderboard( + 2025, board_id=123456, fmt=OutputFormat.CSV +) + +json_data = get_private_leaderboard( + 2025, board_id=123456, fmt=OutputFormat.JSON +) +``` + ### Status Example ```sh From 583c47bca34255b091aa212366a73c8bb4dcc0b8 Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 11:27:32 -0500 Subject: [PATCH 34/45] Add command to create interactive Python solution files and enhance template handling - Introduced `new` command to create a puzzle solution file interactively. - Added `create_day_template` function to manage template creation safely. - Implemented `TemplateCreationError` for better error handling during template creation. - Updated `get_status` to restrict CSV output for private leaderboards only. - Set default value for `is_locked` in `DayStatus` model. - Added a new day template for puzzle solutions. --- elf/cli.py | 22 ++++++++++++++++ elf/exceptions.py | 4 +++ elf/models.py | 2 +- elf/scaffold.py | 39 ++++++++++++++++++++++++++++ elf/status.py | 3 +++ elf/templates/day_template.py | 49 +++++++++++++++++++++++++++++++++++ 6 files changed, 118 insertions(+), 1 deletion(-) create mode 100644 elf/scaffold.py create mode 100644 elf/templates/day_template.py diff --git a/elf/cli.py b/elf/cli.py index 460d9a1..1490c76 100644 --- a/elf/cli.py +++ b/elf/cli.py @@ -1,5 +1,6 @@ from enum import Enum from functools import wraps +from pathlib import Path from typing import Annotated import typer @@ -17,6 +18,7 @@ from .leaderboard import get_leaderboard from .models import OpenKind, OutputFormat, SubmissionStatus from .open import open_page +from .scaffold import create_day_template from .status import get_status app = typer.Typer( @@ -119,6 +121,14 @@ class _StatusOutputFormat(str, Enum): envvar="AOC_SESSION", ), ] +OutputPathOpt = Annotated[ + Path | None, + typer.Option( + "--output", + "-o", + help="Destination path (defaults to YEAR/dayDD.py)", + ), +] def handle_cli_errors(func): @@ -306,6 +316,18 @@ def open_cmd( console.print(open_msg) +@app.command("new") +@handle_cli_errors +def new_cmd( + year: RequiredYearArg, + day: DayArg, + output: OutputPathOpt = None, +) -> None: + """Create an interactive Python solution file for a puzzle.""" + destination = create_day_template(year, day, output) + console.print(Text(f"Created {destination}", style="green")) + + @app.command("cache") @handle_cli_errors def cache_cmd() -> None: diff --git a/elf/exceptions.py b/elf/exceptions.py index 9c1efa0..5779fc8 100644 --- a/elf/exceptions.py +++ b/elf/exceptions.py @@ -37,6 +37,10 @@ def __init__(self, message: str | None = None) -> None: super().__init__(message or default) +class TemplateCreationError(ElfError): + """Raised when a puzzle template cannot be created safely.""" + + class MissingSessionTokenError(ElfError): """Raised when the Advent of Code session token is missing.""" diff --git a/elf/models.py b/elf/models.py index f96cece..8fb39a0 100644 --- a/elf/models.py +++ b/elf/models.py @@ -129,7 +129,7 @@ class DayStatus(BaseModel): stars: int = Field(..., ge=0, le=2) href: str aria_label: str - is_locked: bool + is_locked: bool = False model_config = { "frozen": True, # makes objects hashable/immutable diff --git a/elf/scaffold.py b/elf/scaffold.py new file mode 100644 index 0000000..523fb0b --- /dev/null +++ b/elf/scaffold.py @@ -0,0 +1,39 @@ +from importlib.resources import files +from pathlib import Path + +from .events import validate_event_day +from .exceptions import TemplateCreationError + +_TEMPLATE = "templates/day_template.py" + + +def render_day_template(year: int, day: int) -> str: + """Render the canonical interactive template for a puzzle.""" + try: + validate_event_day(year, day) + except ValueError as exc: + raise TemplateCreationError(str(exc)) from exc + + template = files("elf").joinpath(_TEMPLATE).read_text(encoding="utf-8") + return template.replace("YEAR = 2025", f"YEAR = {year}", 1).replace( + "DAY = 1", f"DAY = {day}", 1 + ) + + +def create_day_template(year: int, day: int, output: Path | None = None) -> Path: + """Create a puzzle file without overwriting an existing path.""" + destination = output or Path(str(year)) / f"day{day:02d}.py" + source = render_day_template(year, day) + + try: + destination.parent.mkdir(parents=True, exist_ok=True) + with destination.open("x", encoding="utf-8", newline="\n") as template_file: + template_file.write(source) + except FileExistsError as exc: + raise TemplateCreationError(f"Refusing to overwrite existing path: {destination}") from exc + except OSError as exc: + raise TemplateCreationError( + f"Could not create puzzle template at {destination}: {exc}" + ) from exc + + return destination diff --git a/elf/status.py b/elf/status.py index 7fa0279..817d255 100644 --- a/elf/status.py +++ b/elf/status.py @@ -14,6 +14,9 @@ def get_status(year: int, session: str | None, fmt: OutputFormat) -> YearStatus | str | Table: + if fmt == OutputFormat.CSV: + raise ValueError("CSV output is only supported for private leaderboards.") + session_token = resolve_session(session) now_year = current_aoc_year() diff --git a/elf/templates/day_template.py b/elf/templates/day_template.py new file mode 100644 index 0000000..58881c1 --- /dev/null +++ b/elf/templates/day_template.py @@ -0,0 +1,49 @@ +# %% Setup +from elf import get_puzzle_input + +YEAR = 2025 +DAY = 1 +USE_SAMPLE = False + +# %% Load Input +sample = """\ +""".strip() + +raw = sample if USE_SAMPLE else get_puzzle_input(YEAR, DAY) +lines = raw.splitlines() + +# %% Parse Input +# Adapt this to the puzzle. +data = lines + +# %% Explore +# Keep scratch variables here so they are easy to inspect and reuse. +# preview = data[:5] + + +# %% Part 1 +def solve_part1(data): + # Implement your solution. + return None + + +part1_answer = solve_part1(data) +print("Part 1:", part1_answer) + + +# %% Part 2 +def solve_part2(data): + # Implement your solution, reusing the parsed data where helpful. + return None + + +part2_answer = solve_part2(data) +print("Part 2:", part2_answer) + +# %% Submit Answers +# Run either line manually only after checking the corresponding answer. +# from elf import submit_puzzle_answer +# assert part1_answer is not None +# part1_submission = submit_puzzle_answer(YEAR, DAY, 1, part1_answer) +# assert part2_answer is not None +# part2_submission = submit_puzzle_answer(YEAR, DAY, 2, part2_answer) From 93ebf46da04404c281a3717e9aba3c2b10e2e7f3 Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 11:27:40 -0500 Subject: [PATCH 35/45] Add tests for template creation, CSV output handling, and model compatibility --- tests/test_cli_commands.py | 20 +++++ tests/test_client_api.py | 7 ++ tests/test_day_template.py | 150 ++++++++++++++++++++++++++++++++++ tests/test_leaderboard_csv.py | 4 +- tests/test_models.py | 8 +- 5 files changed, 186 insertions(+), 3 deletions(-) create mode 100644 tests/test_day_template.py diff --git a/tests/test_cli_commands.py b/tests/test_cli_commands.py index c292b5e..cb5c632 100644 --- a/tests/test_cli_commands.py +++ b/tests/test_cli_commands.py @@ -183,3 +183,23 @@ def test_open_cmd_prints_message(monkeypatch): assert result.exit_code == 0 assert "opened" in result.stdout + + +def test_new_cmd_creates_template_and_refuses_overwrite(monkeypatch, tmp_path): + monkeypatch.chdir(tmp_path) + + created = runner.invoke(app, ["new", "2025", "1"]) + customized = runner.invoke( + app, + ["new", "2025", "2", "--output", "solutions/custom.py"], + ) + duplicate = runner.invoke(app, ["new", "2025", "1"]) + + assert created.exit_code == 0 + assert "Created 2025/day01.py" in created.stdout + assert (tmp_path / "2025" / "day01.py").is_file() + assert customized.exit_code == 0 + assert (tmp_path / "solutions" / "custom.py").is_file() + assert duplicate.exit_code == 1 + assert duplicate.stdout == "" + assert "Refusing to overwrite" in duplicate.stderr diff --git a/tests/test_client_api.py b/tests/test_client_api.py index d144f76..17f3b42 100644 --- a/tests/test_client_api.py +++ b/tests/test_client_api.py @@ -100,3 +100,10 @@ def fake_get_status(year, session, fmt): (2023, "manual-session", OutputFormat.JSON), (2024, None, OutputFormat.MODEL), ] + + +def test_status_csv_is_rejected_before_authentication(monkeypatch): + monkeypatch.delenv("AOC_SESSION", raising=False) + + with pytest.raises(ValueError, match="only supported for private leaderboards"): + get_user_status(2025, fmt=OutputFormat.CSV) diff --git a/tests/test_day_template.py b/tests/test_day_template.py new file mode 100644 index 0000000..5fe65d1 --- /dev/null +++ b/tests/test_day_template.py @@ -0,0 +1,150 @@ +import ast +import importlib.util +import re +import runpy +from pathlib import Path + +import pytest + +import elf +from elf.exceptions import TemplateCreationError +from elf.scaffold import create_day_template, render_day_template + +TEMPLATE = Path(__file__).parents[1] / "elf" / "templates" / "day_template.py" +CELL_MARKERS = [ + "# %% Setup", + "# %% Load Input", + "# %% Parse Input", + "# %% Explore", + "# %% Part 1", + "# %% Part 2", + "# %% Submit Answers", +] + + +def _mock_template_api(monkeypatch): + submissions = [] + monkeypatch.setattr(elf, "get_puzzle_input", lambda year, day: "10\n20\n") + monkeypatch.setattr( + elf, + "submit_puzzle_answer", + lambda *args, **kwargs: submissions.append((args, kwargs)), + ) + return submissions + + +def test_template_is_valid_python_with_expected_cells_and_api_usage(): + source = TEMPLATE.read_text(encoding="utf-8") + tree = ast.parse(source, filename=str(TEMPLATE)) + + assert [line for line in source.splitlines() if line.startswith("# %%")] == CELL_MARKERS + assert "from elf import get_puzzle_input" in source + assert "# from elf import submit_puzzle_answer" in source + assert "raw = sample if USE_SAMPLE else get_puzzle_input(YEAR, DAY)" in source + assert "# part1_submission = submit_puzzle_answer(YEAR, DAY, 1, part1_answer)" in source + assert "# part2_submission = submit_puzzle_answer(YEAR, DAY, 2, part2_answer)" in source + + called_names = { + call.func.id + for call in ast.walk(tree) + if isinstance(call, ast.Call) and isinstance(call.func, ast.Name) + } + assert "get_puzzle_input" in called_names + assert "submit_puzzle_answer" not in called_names + + +def test_template_renderer_sets_year_and_day(): + source = render_day_template(2024, 25) + + ast.parse(source) + assert "YEAR = 2024" in source + assert "DAY = 25" in source + + +def test_template_sample_mode_does_not_fetch_real_input(monkeypatch, capsys): + source = render_day_template(2025, 1) + source = source.replace("USE_SAMPLE = False", "USE_SAMPLE = True", 1) + source = source.replace('sample = """\\\n""".strip()', 'sample = """\\\n1\n2\n""".strip()', 1) + monkeypatch.setattr( + elf, + "get_puzzle_input", + lambda *args, **kwargs: pytest.fail("Sample mode fetched the real puzzle input."), + ) + namespace = {"__name__": "__main__"} + + exec(compile(source, "day01.py", "exec"), namespace) + + assert namespace["raw"] == "1\n2" + assert namespace["lines"] == ["1", "2"] + assert namespace["data"] == ["1", "2"] + assert capsys.readouterr().out == "Part 1: None\nPart 2: None\n" + + +def test_template_creation_uses_default_name_and_refuses_overwrite(monkeypatch, tmp_path): + monkeypatch.chdir(tmp_path) + + destination = create_day_template(2025, 2) + + assert destination == Path("2025/day02.py") + assert "YEAR = 2025" in destination.read_text(encoding="utf-8") + assert "DAY = 2" in destination.read_text(encoding="utf-8") + with pytest.raises(TemplateCreationError, match="Refusing to overwrite"): + create_day_template(2025, 2) + + +def test_template_creation_supports_nested_output_and_validates_day(tmp_path): + destination = tmp_path / "solutions" / "day01.py" + + assert create_day_template(2025, 1, destination) == destination + assert destination.is_file() + with pytest.raises(TemplateCreationError, match="days 1–12"): + create_day_template(2025, 13, tmp_path / "day13.py") + + +def test_template_runs_as_a_script_with_visible_unsolved_variables(monkeypatch, capsys): + submissions = _mock_template_api(monkeypatch) + + namespace = runpy.run_path(str(TEMPLATE), run_name="__main__") + + assert namespace["raw"] == "10\n20\n" + assert namespace["lines"] == ["10", "20"] + assert namespace["data"] == ["10", "20"] + assert namespace["sample"] == "" + assert namespace["USE_SAMPLE"] is False + assert namespace["part1_answer"] is None + assert namespace["part2_answer"] is None + assert submissions == [] + assert capsys.readouterr().out == "Part 1: None\nPart 2: None\n" + + +def test_template_cells_share_an_interactive_namespace(monkeypatch, capsys): + submissions = _mock_template_api(monkeypatch) + source = TEMPLATE.read_text(encoding="utf-8") + cells = [cell for cell in re.split(r"(?=^# %% )", source, flags=re.MULTILINE) if cell] + namespace = {"__name__": "__main__"} + + for cell in cells: + exec(compile(cell, str(TEMPLATE), "exec"), namespace) + + assert namespace["raw"] == "10\n20\n" + assert namespace["lines"] == ["10", "20"] + assert namespace["data"] == ["10", "20"] + assert namespace["sample"] == "" + assert namespace["part1_answer"] is None + assert namespace["part2_answer"] is None + assert submissions == [] + assert capsys.readouterr().out == "Part 1: None\nPart 2: None\n" + + +def test_importing_template_never_submits_answers(monkeypatch, capsys): + submissions = _mock_template_api(monkeypatch) + spec = importlib.util.spec_from_file_location("elf_day_template", TEMPLATE) + assert spec is not None and spec.loader is not None + module = importlib.util.module_from_spec(spec) + + spec.loader.exec_module(module) + + assert module.part1_answer is None + assert module.part2_answer is None + assert submissions == [] + assert capsys.readouterr().out == "Part 1: None\nPart 2: None\n" diff --git a/tests/test_leaderboard_csv.py b/tests/test_leaderboard_csv.py index a5fb9ff..10b7b22 100644 --- a/tests/test_leaderboard_csv.py +++ b/tests/test_leaderboard_csv.py @@ -45,7 +45,7 @@ def _payload(): }, "10": { "id": 10, - "name": 'Doe, "Elf"\nJr.', + "name": 'Døe, "Elf" 🎄\nJr.', "last_star_ts": 1765005300, "stars": 3, "local_score": 100, @@ -91,7 +91,7 @@ def test_csv_schema_values_escaping_and_deterministic_sorting(): assert fieldnames == CSV_FIELDS assert [row["member_id"] for row in rows] == ["1", "10", "5", "20", "30"] assert [row["rank"] for row in rows] == ["1", "2", "3", "4", "5"] - assert rows[1]["name"] == 'Doe, "Elf"\nJr.' + assert rows[1]["name"] == 'Døe, "Elf" 🎄\nJr.' assert rows[1]["first_star_utc"] == "2025-12-01T05:10:00Z" assert rows[1]["last_star_utc"] == "2025-12-06T07:15:00Z" assert rows[2]["first_star_utc"] == "" diff --git a/tests/test_models.py b/tests/test_models.py index cc13416..3014dc5 100644 --- a/tests/test_models.py +++ b/tests/test_models.py @@ -1,4 +1,4 @@ -from elf.models import OutputFormat, SubmissionResult, SubmissionStatus +from elf.models import DayStatus, OutputFormat, SubmissionResult, SubmissionStatus def test_output_format_members_cover_known_values(): @@ -10,6 +10,12 @@ def test_output_format_members_cover_known_values(): } +def test_day_status_new_field_is_backward_compatible(): + status = DayStatus(day=1, stars=2, href="/2025/day/1", aria_label="Day 1, two stars") + + assert status.is_locked is False + + def test_submission_status_has_known_members(): # These are the statuses already referenced by your tests. members = {status for status in SubmissionStatus} From 11f80dfc3519ce4083b61feedf2198f88edb59f2 Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 11:27:44 -0500 Subject: [PATCH 36/45] Update CHANGELOG to include new features for interactive Python puzzle file creation and CSV exports --- CHANGELOG.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/CHANGELOG.md b/CHANGELOG.md index bef7a6a..f39caee 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -9,6 +9,8 @@ Notable user-facing changes to elf are documented here. - Calendar-aware defaults for archived, active, and reduced-length Advent of Code events. - Persistent private-leaderboard caching with the required 15-minute refresh interval. - `elf doctor` for offline configuration, version, clock, and cache diagnostics. +- `elf new YEAR DAY` for safe creation of interactive Python puzzle files with `# %%` cells. +- First-star leaderboard timestamps and deterministic one-row-per-member CSV exports. - Account-scoped input and submission caches, atomic writes, private permissions, and safe legacy-cache migration. - Cross-process protection for leaderboard refreshes, guess history, and answer submission. - Exact server-provided submission cooldown deadlines, exposed as `SubmissionResult.retry_at`. From fee8dc2afc73f0367c8bc730bf0069fd4dffe038 Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 11:27:48 -0500 Subject: [PATCH 37/45] Include day_template.py in MANIFEST.in for packaging --- MANIFEST.in | 1 + 1 file changed, 1 insertion(+) diff --git a/MANIFEST.in b/MANIFEST.in index d8c8196..b73cd1d 100644 --- a/MANIFEST.in +++ b/MANIFEST.in @@ -1,3 +1,4 @@ include CHANGELOG.md +include elf/templates/day_template.py include tests/conftest.py recursive-include tests/fixtures *.html From 19537215f8a34ba5c2907e4eefd52329dddb1533 Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 11:27:52 -0500 Subject: [PATCH 38/45] Update package data to include template files in pyproject.toml --- pyproject.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pyproject.toml b/pyproject.toml index f0653dc..fa26b62 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -54,7 +54,7 @@ elf = "elf.cli:main" include = ["elf*"] [tool.setuptools.package-data] -elf = ["py.typed"] +elf = ["py.typed", "templates/*.py"] [build-system] requires = ["setuptools>=77", "wheel"] From 91f177c6049a6cf2697663f1a04e0d2d2f65abcd Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 11:27:56 -0500 Subject: [PATCH 39/45] Update README to include interactive puzzle file creation instructions and command details --- README.md | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/README.md b/README.md index a7b0cae..545d339 100644 --- a/README.md +++ b/README.md @@ -30,6 +30,7 @@ If Advent of Code is part of your December ritual too, I hope this little elf ma - Fetch inputs instantly with **automatic caching** - Submit answers safely with **smart guardrails** (duplicate, low, high, locked, cooldown) - Explore private leaderboards as **tables**, **CSV**, **JSON**, or **Pydantic models** +- Start interactive puzzle files with **`# %%` code cells** using **`elf new`** - View your **status calendar** (table, JSON, or model) - Inspect your **guess history** with timestamps and per-part details - Diagnose local configuration safely with **`elf doctor`** @@ -167,6 +168,7 @@ Commands: guesses Show cached guesses status Show yearly star status open Open puzzle/input/website + new Create an interactive Python solution file cache Show cache information doctor Check local configuration without contacting Advent of Code ``` @@ -389,6 +391,25 @@ status = get_user_status(2023, fmt=OutputFormat.TABLE) print(status) ``` +### Interactive Puzzle Template + +Create a solution file from elf's [interactive template](https://github.com/cak/elf/blob/main/elf/templates/day_template.py): + +```sh +elf new 2025 1 +elf new 2025 2 --output solutions/2025/day02.py +``` + +By default this creates `YEAR/dayDD.py`; parent directories are created as needed, and elf refuses to overwrite an existing path. Configure `AOC_SESSION` as described above, open the generated file in Positron, VS Code, Spyder, or another Python editor, and run the `# %%` cells from top to bottom. The first input cell retrieves the puzzle input through elf's private, account-scoped cache instead of writing input into your project tree. `raw`, `lines`, `data`, `part1_answer`, and `part2_answer` remain at module scope so they appear in the active session's Variables pane and can be inspected between runs. + +The same file works as a normal script: + +```sh +python 2025/day01.py +``` + +Running it in a separate terminal process does not populate an IDE's existing interactive session because the Variables pane reflects only its active Python process. Answer submission is intentionally commented out in the final cell; run a submission line manually only after checking the corresponding answer. + ### Puzzle Helpers `elf.helpers` includes some small utilities you can use in your own AoC solutions: From 1f9449c73a5697626ab8099166bf232145b67118 Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 11:27:59 -0500 Subject: [PATCH 40/45] Add validation step for distribution packages in CI workflow --- .github/workflows/quality.yml | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/.github/workflows/quality.yml b/.github/workflows/quality.yml index 04b18b8..6761943 100644 --- a/.github/workflows/quality.yml +++ b/.github/workflows/quality.yml @@ -61,3 +61,9 @@ jobs: - name: Build distributions if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11' run: uv build + + - name: Validate distributions + if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.11' + run: | + uvx --from twine twine check dist/* + uvx check-wheel-contents dist/*.whl From c61b4c653778d2d4c730b0a6efe8ba1cd153494a Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 15:02:36 -0500 Subject: [PATCH 41/45] Refactor output message in new command test to use Path for file creation --- tests/test_cli_commands.py | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/tests/test_cli_commands.py b/tests/test_cli_commands.py index cb5c632..0c0ca8b 100644 --- a/tests/test_cli_commands.py +++ b/tests/test_cli_commands.py @@ -1,6 +1,7 @@ import csv import io import json +from pathlib import Path from typer.testing import CliRunner @@ -196,7 +197,7 @@ def test_new_cmd_creates_template_and_refuses_overwrite(monkeypatch, tmp_path): duplicate = runner.invoke(app, ["new", "2025", "1"]) assert created.exit_code == 0 - assert "Created 2025/day01.py" in created.stdout + assert f"Created {Path('2025') / 'day01.py'}" in created.stdout assert (tmp_path / "2025" / "day01.py").is_file() assert customized.exit_code == 0 assert (tmp_path / "solutions" / "custom.py").is_file() From a8f730f9d80c70978e2c3c8871837f0d8a2115cb Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 15:15:53 -0500 Subject: [PATCH 42/45] Add GitHub Actions workflow for publishing to PyPI --- .github/workflows/publish.yml | 51 +++++++++++++++++++++++++++++++++++ 1 file changed, 51 insertions(+) create mode 100644 .github/workflows/publish.yml diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml new file mode 100644 index 0000000..f5896fe --- /dev/null +++ b/.github/workflows/publish.yml @@ -0,0 +1,51 @@ +name: Publish + +on: + release: + types: [published] + +permissions: + contents: read + +jobs: + build: + runs-on: ubuntu-latest + steps: + - name: Check out repository + uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + + - name: Install uv + uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3 + + - name: Build distributions + run: uv build --no-sources + + - name: Validate distributions + run: uvx --from twine twine check dist/* + + - name: Upload distributions + uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1 + with: + name: distributions + path: dist/ + + publish: + needs: build + runs-on: ubuntu-latest + environment: pypi + permissions: + id-token: write + steps: + - name: Install uv + uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3 + with: + enable-cache: false + + - name: Download distributions + uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1 + with: + name: distributions + path: dist/ + + - name: Publish to PyPI + run: uv publish From 72188d08f327eab1a371f499221bef6e751040b1 Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 15:15:58 -0500 Subject: [PATCH 43/45] Update default user agent URL in aoc_client.py --- elf/aoc_client.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/elf/aoc_client.py b/elf/aoc_client.py index a7316d7..18860d3 100644 --- a/elf/aoc_client.py +++ b/elf/aoc_client.py @@ -12,7 +12,7 @@ from .constants import VERSION _user_agent_prefix = f"elf/{VERSION}" -_default_user_agent = "+https://github.com/cak/elf" +_default_user_agent = "+https://github.com/snally-dev/elf" def _build_http_client() -> httpx.Client: From 63182d23454dd46bc5d21066240993c72bc89622 Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 15:16:03 -0500 Subject: [PATCH 44/45] Update User-Agent URL and fix links in README for new repository --- README.md | 12 ++++-------- 1 file changed, 4 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index 545d339..cee43fe 100644 --- a/README.md +++ b/README.md @@ -123,7 +123,7 @@ If this variable is not set or does not look like an email address, elf falls ba Your User-Agent header will look like `elf/ (you@example.com)`. This helps Eric identify the person sending the traffic while still including the library name. -If the warning fires, elf instead sends `elf/ (+https://github.com/cak/elf)` so AoC still sees a recognizable identifier even without your email. +If the warning fires, elf instead sends `elf/ (+https://github.com/snally-dev/elf)` so AoC still sees a recognizable identifier even without your email. ## Quick Start @@ -393,7 +393,7 @@ print(status) ### Interactive Puzzle Template -Create a solution file from elf's [interactive template](https://github.com/cak/elf/blob/main/elf/templates/day_template.py): +Create a solution file from elf's [interactive template](https://github.com/snally-dev/elf/blob/main/elf/templates/day_template.py): ```sh elf new 2025 1 @@ -458,13 +458,9 @@ elf leaderboard 2025 123456 --format json > leaderboard.json ```python from elf import OutputFormat, get_private_leaderboard -csv_data = get_private_leaderboard( - 2025, board_id=123456, fmt=OutputFormat.CSV -) +csv_data = get_private_leaderboard(2025, board_id=123456, fmt=OutputFormat.CSV) -json_data = get_private_leaderboard( - 2025, board_id=123456, fmt=OutputFormat.JSON -) +json_data = get_private_leaderboard(2025, board_id=123456, fmt=OutputFormat.JSON) ``` ### Status Example From 0048e51764c43997e9f4ac77ec9cf48f02dfb104 Mon Sep 17 00:00:00 2001 From: cak Date: Sun, 15 Nov 2026 15:16:07 -0500 Subject: [PATCH 45/45] Update project URLs in pyproject.toml to reflect new repository ownership --- pyproject.toml | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/pyproject.toml b/pyproject.toml index fa26b62..3223b57 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -41,11 +41,11 @@ classifiers = [ ] [project.urls] -Homepage = "https://github.com/cak/elf" -Documentation = "https://github.com/cak/elf/" -Repository = "https://github.com/cak/elf" -Issue-Tracker = "https://github.com/cak/elf/issues" -Changelog = "https://github.com/cak/elf/blob/main/CHANGELOG.md" +Homepage = "https://github.com/snally-dev/elf" +Documentation = "https://github.com/snally-dev/elf/" +Repository = "https://github.com/snally-dev/elf" +Issue-Tracker = "https://github.com/snally-dev/elf/issues" +Changelog = "https://github.com/snally-dev/elf/blob/main/CHANGELOG.md" [project.scripts] elf = "elf.cli:main"