themeparks 4.0.0__tar.gz → 4.0.1__tar.gz

{themeparks-4.0.0 → themeparks-4.0.1}/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## [4.0.1] - 2026-09-28
+
+### Fixed
+
+- **A run with no API key now says so when it finishes**, not only when it
+  starts. Without a key the command SUCCEEDS: it reads the 7 days anonymous
+  access allows, writes 433 rows of Magic Kingdom instead of about 94,000, and
+  exits 0. The notice was printed before a run that takes minutes, so it scrolled
+  away, and the last thing on screen was `done: 433 rows` -- which for someone
+  who has just paid for 400 days is indistinguishable from success. There is a
+  file, there is no error, and the number means nothing unless you already know
+  what it should have been.
+
+  The README and the command's own `--help` now `export THEMEPARKS_API_KEY`
+  before the example that needs it, and still say `--list` does not: finding a
+  park before you have paid is the point of that flag.
+
+### Added
+
+- **A committed mutant list** (`tests/mutation/mutants.json`) and a nightly,
+  non-gating job that runs it. An author-written mutant list contains the
+  mutations that author's tests already catch -- one scored 14/14 on this package
+  while an independent sweep found 27 survivors, including the defect 4.0.0
+  exists to fix. The list is committed so a reviewer can see what is checked and,
+  more usefully, what is not. Its first run found two gaps, both closed here: a
+  spent hourly budget on a resumed run deleted the accumulated archive, and
+  `str(EntityType.SHOW)` reached a CSV cell as `EntityType.SHOW` rather than
+  `SHOW`.
+
 ## [4.0.0] - 2026-09-28
 
 **3.3.0 was yanked: incomplete CSV export and a resume defect.**

{themeparks-4.0.0 → themeparks-4.0.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: themeparks
-Version: 4.0.0
+Version: 4.0.1
 Summary: Official SDK for the ThemeParks.wiki API
 Project-URL: Homepage, https://api.themeparks.wiki
 Project-URL: Source, https://github.com/ThemeParks/ThemeParks_Python
@@ -356,9 +356,13 @@ Installing the library installs `themeparks-backfill`, which does all of the
 above and stops before the walls:
 
 ```bash
+# How far back it reaches is your plan, so set the key first: without one you get
+# the 7 days anonymous access allows, and the run still succeeds, quietly.
+export THEMEPARKS_API_KEY=tpw_your_key
+
 themeparks-backfill "Disneyland Park"           # a park, by name or id
 themeparks-backfill "Walt Disney World Resort"  # a destination: every park in it
-themeparks-backfill --list disney               # find an id. Needs no key.
+themeparks-backfill --list disney               # find an id. This part needs no key.
 ```
 
 It reads how far back your own key may ask and starts there, writes NDJSON or

{themeparks-4.0.0 → themeparks-4.0.1}/README.md

@@ -317,9 +317,13 @@ Installing the library installs `themeparks-backfill`, which does all of the
 above and stops before the walls:
 
 ```bash
+# How far back it reaches is your plan, so set the key first: without one you get
+# the 7 days anonymous access allows, and the run still succeeds, quietly.
+export THEMEPARKS_API_KEY=tpw_your_key
+
 themeparks-backfill "Disneyland Park"           # a park, by name or id
 themeparks-backfill "Walt Disney World Resort"  # a destination: every park in it
-themeparks-backfill --list disney               # find an id. Needs no key.
+themeparks-backfill --list disney               # find an id. This part needs no key.
 ```
 
 It reads how far back your own key may ask and starts there, writes NDJSON or

{themeparks-4.0.0 → themeparks-4.0.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "themeparks"
-version = "4.0.0"
+version = "4.0.1"
 description = "Official SDK for the ThemeParks.wiki API"
 readme = "README.md"
 requires-python = ">=3.9"

{themeparks-4.0.0 → themeparks-4.0.1}/themeparks/backfill.py

@@ -1090,6 +1090,10 @@ def _print_list(catalogue: list[tuple[str, str, str, str]], needle: str | None)
 
 
 EPILOG = """examples:
+  export THEMEPARKS_API_KEY=tpw_your_key
+      how far back this reaches is your plan, so without a key you get the 7
+      days anonymous access allows -- and the run still succeeds, quietly.
+
   themeparks-backfill "Disneyland Park"
       the whole daily history your plan reaches, as NDJSON, into the current
       directory
@@ -1248,7 +1252,21 @@ def main(argv: list[str] | None = None) -> int:
                 file=sys.stderr,
             )
 
-        return _run_all(tp, targets, args)
+        status = _run_all(tp, targets, args)
+        # SAID AGAIN AT THE END, and this is the point of it. The warning above
+        # is printed before a run that takes minutes, so it scrolls away, and the
+        # last thing on screen is "done: 433 rows" -- which for a customer who
+        # thought they were downloading five years is indistinguishable from
+        # success. They paid for 400 days and got seven, exit 0, no complaint.
+        if not args.api_key:
+            print(
+                "\nthat was ANONYMOUS ACCESS: the last 7 days only.\n"
+                "  a free key reads 30 days, Pro 400, Business the whole archive\n"
+                "  set THEMEPARKS_API_KEY and run the same command again\n"
+                "  keys: https://www.themeparks.wiki/profile",
+                file=sys.stderr,
+            )
+        return status
     return 0