themeparks 2.0.0a1__tar.gz → 3.0.0__tar.gz

themeparks-3.0.0/CHANGELOG.md

@@ -0,0 +1,126 @@
+# Changelog
+
+## [3.0.0] - 2026-09-08
+
+### Fixed
+
+- **Schedule entries now carry `purchases`.** The upstream spec described a
+  park's schedule two different ways: precisely when nested under a
+  destination, loosely when fetched directly. This client uses the direct
+  path, so `purchases` was absent from the model entirely. Magic Kingdom
+  serves 26 entries carrying purchases.
+
+  ```python
+  sched = client.entity(park_id).schedule()
+  for day in sched.schedule or []:
+      for p in day.purchases or []:
+          print(p.name, p.price.amount, p.price.currency)
+  ```
+
+- **A null price on a schedule purchase no longer rejects the response.**
+  2.0.1 made `PriceData.amount` nullable, but the schedule path used a
+  second, inline price model that kept `amount` non-nullable. Both now use
+  `PriceData`. Tokyo Disneyland serves six Premier Access rows with a null
+  amount, and this client raised `ValidationError` on every one of them.
+
+- Schedule entries gained the `description` field the API has always sent.
+
+### Changed
+
+- **BREAKING — `ScheduleEntry.type` is an enum, not a `str`.** It was
+  `type: str`; it is now a `Type` enum. This breaks *silently*: the comparison
+  does not raise, it just stops being true.
+
+  ```python
+  # before: True.  now: False, with no error.
+  if day.type == "OPERATING":
+      ...
+
+  # use one of these instead
+  if day.type.value == "OPERATING":
+      ...
+  from themeparks._generated.models import Type
+  if day.type is Type.OPERATING:
+      ...
+  ```
+
+  Audit any comparison of `.type` against a string literal before upgrading.
+  This is the one change here that will not announce itself.
+
+- **BREAKING — the `PricedScheduleEntry` and `Price` models are gone.**
+  `PricedScheduleEntry` is now `ScheduleEntry`, and the inline `Price` model
+  is replaced by `PriceData`. Neither was exported from the package root, so
+  this only affects code importing from `themeparks._generated.models`
+  directly — a private module.
+
+- The duplicate `EntityType1` and `EntityType2` enums collapse into
+  `EntityType`. Same members, same values.
+
+## [2.0.1] - 2026-09-01
+### Fixed
+- `PriceData.amount` is now nullable. The API returns `null` when a paid queue
+  exists but the provider does not publish a price, and `0` only when the queue
+  is genuinely free. Both previously arrived as `0`, so an unknown price was
+  indistinguishable from a free one.
+
+  Before this, a single null amount on one attraction made pydantic reject the
+  **entire** live response for that park, not just the one field.
+
+  Code testing `if price.amount:` or `if not price.amount:` now conflates
+  "free" with "price unknown" — the exact confusion this change exists to
+  remove. Switch to an explicit check:
+
+  ```python
+  if price.amount is None:
+      label = "price not published"
+  else:
+      label = f"{price.currency} {price.amount / 100:.2f}"
+  ```
+
+  `price.formatted` is optional and may be absent when the amount is unknown,
+  so do not rely on it alone to detect the case.
+
+## [2.0.0] - 2026-04-15
+First stable v2 release. Identical surface to `2.0.0a1` after a brief alpha
+soak; no code changes since `2.0.0a1`. Bumped `Development Status` classifier
+to `Production/Stable`.
+
+## [2.0.0a1] - 2026-04-15
+### Added
+- MkDocs Material documentation site with full API reference and a cookbook
+  (recipes for sorted wait times, 7-day schedules, geo-locations grouped by
+  entity type, every queue variant, and HTTP debugging).
+- Top-level exports for `current_wait_time`, `iter_queues`, `parse_api_datetime`.
+- Class-level docstrings on every public surface for readable API reference rendering.
+- README sections explaining every queue variant (STANDBY, PAID_RETURN_TIME,
+  BOARDING_GROUP, etc.) and how to enable the httpx logger for HTTP debugging.
+
+### Fixed
+- `walk()` now makes a single API call instead of one per descendant — the
+  `/children` endpoint already returns the entire subtree recursively. Walking
+  Walt Disney World dropped from ~250 requests to 1.
+- `get_entity_schedule_month` now zero-pads the month (`/schedule/2026/05`,
+  not `/schedule/2026/5`) per the API requirement.
+- `RetryConfig` field renamed `max_attempts` → `max_retries` to match its
+  actual semantics (N retries beyond the first attempt = N+1 total calls).
+- `APIError` now includes a server-body excerpt in the exception message;
+  `RateLimitError.__repr__` includes `retry_after`.
+- `destinations.find()` now performs the loose, case-insensitive substring
+  match it had always promised in its docstring (was exact equality).
+- Generated queue variant classes renamed (`STANDBY` → `StandbyQueue` etc.)
+  so users access `queue.STANDBY` instead of the awkward `queue.STANDBY_1`.
+- `eval-type-backport` is now a conditional dep on Python 3.9 so pydantic
+  can evaluate PEP 604 union syntax in the generated models.
+
+## [2.0.0a0] - 2026-04-14
+### Added
+- Full rewrite on pydantic v2 + httpx.
+- Sync `ThemeParks` and `AsyncThemeParks` clients with shared core.
+- Ergonomic `client.entity(id)` navigation, `walk()`, `schedule.range()`.
+- Typed pydantic models, correctly handling nullable queue fields (fixes #1, #2).
+- Default-on caching with per-endpoint TTLs and pluggable adapter.
+- 429 `Retry-After` handling.
+
+### Removed
+- Legacy `openapi_client` top-level import and generated surface. See MIGRATION.md.
+- `urllib3`-based transport.

{themeparks-2.0.0a1 → themeparks-3.0.0}/MIGRATION.md

@@ -170,7 +170,7 @@ The async surface mirrors the sync surface method-for-method.
 
 ## New in v2 (not in v1)
 
-- `tp.entity(id).walk()` — breadth-first iterator over every descendant.
+- `tp.entity(id).walk()` — iterator over every descendant in a single API call (the `/children` endpoint already returns the full subtree).
 - `tp.entity(id).schedule.range(start, end)` — stitches monthly schedule
   responses into a single sorted, filtered list.
 - `tp.destinations.find(query)` — case-insensitive lookup by slug or name.

{themeparks-2.0.0a1 → themeparks-3.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: themeparks
-Version: 2.0.0a1
+Version: 3.0.0
 Summary: Official SDK for the ThemeParks.wiki API
 Project-URL: Homepage, https://api.themeparks.wiki
 Project-URL: Source, https://github.com/ThemeParks/ThemeParks_Python
@@ -9,7 +9,7 @@ Author: ThemeParks.wiki contributors
 License: MIT
 License-File: LICENSE
 Keywords: api,disney,themeparks,universal,wait-times
-Classifier: Development Status :: 4 - Beta
+Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
@@ -30,7 +30,7 @@ Requires-Dist: mypy>=1.10; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
 Requires-Dist: pytest-recording>=0.13; extra == 'dev'
 Requires-Dist: pytest>=8; extra == 'dev'
-Requires-Dist: ruff>=0.4; extra == 'dev'
+Requires-Dist: ruff<0.17,>=0.4; extra == 'dev'
 Provides-Extra: docs
 Requires-Dist: mkdocs-material>=9.5; extra == 'docs'
 Requires-Dist: mkdocs>=1.5; extra == 'docs'

{themeparks-2.0.0a1 → themeparks-3.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "themeparks"
-version = "2.0.0a1"
+version = "3.0.0"
 description = "Official SDK for the ThemeParks.wiki API"
 readme = "README.md"
 requires-python = ">=3.9"
@@ -12,7 +12,7 @@ license = { text = "MIT" }
 authors = [{ name = "ThemeParks.wiki contributors" }]
 keywords = ["themeparks", "disney", "universal", "wait-times", "api"]
 classifiers = [
-  "Development Status :: 4 - Beta",
+  "Development Status :: 5 - Production/Stable",
   "Intended Audience :: Developers",
   "License :: OSI Approved :: MIT License",
   "Programming Language :: Python :: 3",
@@ -40,7 +40,9 @@ dev = [
   "pytest>=8",
   "pytest-asyncio>=0.23",
   "pytest-recording>=0.13",
-  "ruff>=0.4",
+  # Upper-bounded: an unpinned minor bump is what started reformatting
+  # Markdown code blocks and turned CI red on unrelated PRs.
+  "ruff>=0.4,<0.17",
   "mypy>=1.10",
   "datamodel-code-generator[http]>=0.25",
 ]
@@ -63,6 +65,11 @@ asyncio_mode = "auto"
 [tool.ruff]
 line-length = 100
 target-version = "py39"
+# Markdown is documentation, not source. Ruff 0.16 began formatting Python
+# blocks inside it, which rewrites hand-written examples in README.md,
+# MIGRATION.md and docs/ — CI has been failing `ruff format --check .` on
+# those four files regardless of what any PR changes. Prose stays ours.
+extend-exclude = ["*.md"]
 
 [tool.ruff.lint]
 select = ["E", "F", "W", "I", "N", "UP", "B", "A", "SIM", "PL"]
@@ -72,7 +79,9 @@ select = ["E", "F", "W", "I", "N", "UP", "B", "A", "SIM", "PL"]
 "themeparks/_errors.py" = ["A001", "UP045"]
 "themeparks/_transport.py" = ["A004"]
 "themeparks/__init__.py" = ["A004"]
-"themeparks/_generated/*.py" = ["N815", "F401"]
+# E501: field descriptions come from the upstream spec, so line length is not
+# this repo's to choose. The PriceData.amount description is already over.
+"themeparks/_generated/*.py" = ["N815", "F401", "E501"]
 
 [tool.mypy]
 python_version = "3.9"

{themeparks-2.0.0a1 → themeparks-3.0.0}/themeparks/_client.py

@@ -13,7 +13,7 @@ from themeparks._raw import AsyncRawClient, RawClient
 from themeparks._transport import AsyncTransport, RetryConfig, SyncTransport
 
 DEFAULT_BASE_URL = "https://api.themeparks.wiki/v1"
-PACKAGE_VERSION = "2.0.0a1"
+PACKAGE_VERSION = "2.0.0"
 
 
 def _default_user_agent() -> str:
@@ -118,6 +118,9 @@ class ThemeParks:
     def __exit__(self, exc_type: Any, exc: Any, tb: Any) -> None:
         self.close()
 
+    def __repr__(self) -> str:
+        return f"ThemeParks(base_url={str(self._client.base_url).rstrip('/')!r})"
+
 
 class AsyncThemeParks:
     """Asynchronous mirror of :class:`ThemeParks`.
@@ -171,3 +174,6 @@ class AsyncThemeParks:
 
     async def __aexit__(self, exc_type: Any, exc: Any, tb: Any) -> None:
         await self.close()
+
+    def __repr__(self) -> str:
+        return f"AsyncThemeParks(base_url={str(self._client.base_url).rstrip('/')!r})"

{themeparks-2.0.0a1 → themeparks-3.0.0}/themeparks/_generated/models.py

@@ -9,139 +9,355 @@ from typing import Annotated, Any
 from pydantic import AwareDatetime, BaseModel, Field
 
 
-class EntityType(Enum):
-    DESTINATION = "DESTINATION"
-    PARK = "PARK"
-    ATTRACTION = "ATTRACTION"
-    RESTAURANT = "RESTAURANT"
-    HOTEL = "HOTEL"
-    SHOW = "SHOW"
-
+class BoardingGroupState(Enum):
+    """
+    State of boarding group availability
+    """
 
-class LiveStatusType(Enum):
-    OPERATING = "OPERATING"
-    DOWN = "DOWN"
+    AVAILABLE = "AVAILABLE"
+    PAUSED = "PAUSED"
     CLOSED = "CLOSED"
-    REFURBISHMENT = "REFURBISHMENT"
 
 
-class ReturnTimeState(Enum):
-    AVAILABLE = "AVAILABLE"
-    TEMP_FULL = "TEMP_FULL"
-    FINISHED = "FINISHED"
+class DiningAvailability(BaseModel):
+    partySize: float | None = None
+    """
+    Available party size
+    """
+    waitTime: float | None = None
+    """
+    Current wait time in minutes
+    """
 
 
-class BoardingGroupState(Enum):
-    AVAILABLE = "AVAILABLE"
-    PAUSED = "PAUSED"
-    CLOSED = "CLOSED"
+class EntityLocation(BaseModel):
+    latitude: float | None = None
+    """
+    Latitude coordinate of the entity location
+    """
+    longitude: float | None = None
+    """
+    Longitude coordinate of the entity location
+    """
 
 
-class PriceData(BaseModel):
-    amount: float
-    currency: str
-    formatted: str | None = None
+class EntityType(Enum):
+    """
+    Type of entity in the theme park system
+    """
+
+    DESTINATION = "DESTINATION"
+    PARK = "PARK"
+    ATTRACTION = "ATTRACTION"
+    RESTAURANT = "RESTAURANT"
+    HOTEL = "HOTEL"
+    SHOW = "SHOW"
 
 
 class StandbyQueue(BaseModel):
     waitTime: float | None = None
+    """
+    Current standby wait time in minutes
+    """
 
 
 class SingleRiderQueue(BaseModel):
     waitTime: float | None = None
-
-
-class ReturnTimeQueue(BaseModel):
-    state: ReturnTimeState | None = None
-    returnStart: AwareDatetime | None = None
-    returnEnd: AwareDatetime | None = None
-
-
-class PaidReturnTimeQueue(BaseModel):
-    state: ReturnTimeState | None = None
-    returnStart: AwareDatetime | None = None
-    returnEnd: AwareDatetime | None = None
-    price: PriceData | None = None
+    """
+    Current single rider wait time in minutes
+    """
 
 
 class BoardingGroupQueue(BaseModel):
     allocationStatus: BoardingGroupState | None = None
     currentGroupStart: float | None = None
+    """
+    Current boarding group start number
+    """
     currentGroupEnd: float | None = None
+    """
+    Current boarding group end number
+    """
     nextAllocationTime: AwareDatetime | None = None
+    """
+    Next boarding group allocation time
+    """
     estimatedWait: float | None = None
+    """
+    Estimated wait time in minutes
+    """
 
 
 class PaidStandbyQueue(BaseModel):
     waitTime: float | None = None
-
-
-class LiveQueue(BaseModel):
-    STANDBY: StandbyQueue | None = None
-    SINGLE_RIDER: SingleRiderQueue | None = None
-    RETURN_TIME: ReturnTimeQueue | None = None
-    PAID_RETURN_TIME: PaidReturnTimeQueue | None = None
-    BOARDING_GROUP: BoardingGroupQueue | None = None
-    PAID_STANDBY: PaidStandbyQueue | None = None
+    """
+    Current paid standby wait time in minutes
+    """
 
 
 class LiveShowTime(BaseModel):
     type: str
+    """
+    Type of show time entry
+    """
     startTime: AwareDatetime | None = None
+    """
+    Start time of the show
+    """
     endTime: AwareDatetime | None = None
+    """
+    End time of the show
+    """
 
 
-class DiningAvailability(BaseModel):
-    partySize: float | None = None
-    waitTime: float | None = None
+class LiveStatusType(Enum):
+    """
+    Current operating status of an entity
+    """
+
+    OPERATING = "OPERATING"
+    DOWN = "DOWN"
+    CLOSED = "CLOSED"
+    REFURBISHMENT = "REFURBISHMENT"
+
+
+class Park(BaseModel):
+    id: str
+    """
+    Unique identifier of the park
+    """
+    name: str
+    """
+    Name of the park
+    """
+
+
+class PriceData(BaseModel):
+    amount: float | None = None
+    """
+    Numerical price amount, in the currency's lowest denomination (e.g. cents). null when the item costs money but the provider does not publish an amount; 0 means genuinely free
+    """
+    currency: str
+    """
+    Currency code
+    """
+    formatted: str | None = None
+    """
+    Formatted price string
+    """
+
+
+class ReturnTimeState(Enum):
+    """
+    State of return time availability
+    """
+
+    AVAILABLE = "AVAILABLE"
+    TEMP_FULL = "TEMP_FULL"
+    FINISHED = "FINISHED"
+
+
+class Type(Enum):
+    """
+    Type of schedule entry
+    """
+
+    OPERATING = "OPERATING"
+    TICKETED_EVENT = "TICKETED_EVENT"
+    PRIVATE_EVENT = "PRIVATE_EVENT"
+    EXTRA_HOURS = "EXTRA_HOURS"
+    INFO = "INFO"
+
+
+class SchedulePriceType(Enum):
+    """
+    Type of schedule price
+    """
+
+    ADMISSION = "ADMISSION"
+    PACKAGE = "PACKAGE"
+    ATTRACTION = "ATTRACTION"
 
 
 class TagData(BaseModel):
     tag: str
+    """
+    Tag identifier
+    """
     tagName: str
+    """
+    Human readable tag name
+    """
     id: str | None = None
-    value: str | float | dict[str, Any] | None = None
-
-
-class Location(BaseModel):
-    latitude: float | None = None
-    longitude: float | None = None
+    """
+    Unique identifier
+    """
+    value: Any | None = None
+    """
+    Tag value - can be string, number or object
+    """
 
 
-class EntityData(BaseModel):
+class DestinationEntry(BaseModel):
     id: str
+    """
+    Unique identifier of the destination
+    """
     name: str
-    entityType: EntityType
-    parentId: str | None = None
-    destinationId: str | None = None
-    timezone: str
-    location: Location | None = None
-    tags: list[TagData] | None = None
+    """
+    Name of the destination
+    """
+    slug: str | None = None
+    """
+    URL-friendly slug for the destination
+    """
+    externalId: str | None = None
+    """
+    External entity ID from the source data provider
+    """
+    parks: list[Park]
+    """
+    Array of parks within this destination
+    """
+
+
+class DestinationsResponse(BaseModel):
+    destinations: list[DestinationEntry]
+    """
+    Array of all destinations
+    """
 
 
 class EntityChild(BaseModel):
     id: str
+    """
+    Unique entity identifier
+    """
     name: str
+    """
+    Entity name
+    """
     entityType: EntityType
     externalId: str | None = None
+    """
+    External identifier
+    """
     parentId: str | None = None
-    location: Location | None = None
+    """
+    Parent entity identifier
+    """
+    location: EntityLocation | None = None
 
 
 class EntityChildrenResponse(BaseModel):
     id: str | None = None
+    """
+    Parent entity identifier
+    """
     name: str | None = None
+    """
+    Parent entity name
+    """
     entityType: EntityType | None = None
     timezone: str | None = None
+    """
+    Entity timezone
+    """
     children: list[EntityChild] | None = None
 
 
+class EntityData(BaseModel):
+    id: str
+    """
+    Unique entity identifier
+    """
+    name: str
+    """
+    Entity name
+    """
+    entityType: EntityType
+    parentId: str | None = None
+    """
+    Parent entity identifier
+    """
+    destinationId: str | None = None
+    """
+    DestinationEntry identifier
+    """
+    timezone: str
+    """
+    Entity timezone
+    """
+    location: EntityLocation | None = None
+    tags: list[TagData] | None = None
+
+
+class ReturnTimeQueue(BaseModel):
+    state: ReturnTimeState | None = None
+    returnStart: AwareDatetime | None = None
+    """
+    Start time of return window
+    """
+    returnEnd: AwareDatetime | None = None
+    """
+    End time of return window
+    """
+
+
+class PaidReturnTimeQueue(BaseModel):
+    state: ReturnTimeState | None = None
+    returnStart: AwareDatetime | None = None
+    returnEnd: AwareDatetime | None = None
+    price: PriceData | None = None
+
+
+class LiveQueue(BaseModel):
+    STANDBY: StandbyQueue | None = None
+    SINGLE_RIDER: SingleRiderQueue | None = None
+    RETURN_TIME: ReturnTimeQueue | None = None
+    PAID_RETURN_TIME: PaidReturnTimeQueue | None = None
+    BOARDING_GROUP: BoardingGroupQueue | None = None
+    PAID_STANDBY: PaidStandbyQueue | None = None
+
+
+class SchedulePriceObject(BaseModel):
+    type: SchedulePriceType | None = None
+    """
+    Type of price object
+    """
+    id: str | None = None
+    """
+    Unique identifier
+    """
+    name: str | None = None
+    """
+    Name of the price object
+    """
+    price: PriceData | None = None
+    """
+    Price of this purchase option
+    """
+    available: bool | None = None
+    """
+    Whether this price option is available
+    """
+
+
 class EntityLiveData(BaseModel):
     id: str
+    """
+    Entity identifier
+    """
     name: str
+    """
+    Entity name
+    """
     entityType: EntityType
     status: LiveStatusType | None = None
     lastUpdated: AwareDatetime
+    """
+    Last update timestamp
+    """
     queue: LiveQueue | None = None
     showtimes: list[LiveShowTime] | None = None
     operatingHours: list[LiveShowTime] | None = None
@@ -150,72 +366,87 @@ class EntityLiveData(BaseModel):
 
 class EntityLiveDataResponse(BaseModel):
     id: str | None = None
+    """
+    Entity identifier
+    """
     name: str | None = None
+    """
+    Entity name
+    """
     entityType: EntityType | None = None
     timezone: str | None = None
+    """
+    Entity timezone
+    """
     liveData: list[EntityLiveData] | None = None
 
 
-class Type(Enum):
-    ADMISSION = "ADMISSION"
-    PACKAGE = "PACKAGE"
-    ATTRACTION = "ATTRACTION"
-
-
-class SchedulePriceObject(BaseModel):
-    type: Type | None = None
-    id: str | None = None
-    name: str | None = None
-    price: PriceData | None = None
-    available: bool | None = None
-
-
-class Type1(Enum):
-    OPERATING = "OPERATING"
-    TICKETED_EVENT = "TICKETED_EVENT"
-    PRIVATE_EVENT = "PRIVATE_EVENT"
-    EXTRA_HOURS = "EXTRA_HOURS"
-    INFO = "INFO"
-
-
 class ScheduleEntry(BaseModel):
     date: str
+    """
+    Schedule date
+    """
     openingTime: AwareDatetime
+    """
+    Opening time
+    """
     closingTime: AwareDatetime
-    type: Type1
+    """
+    Closing time
+    """
+    type: Type
+    """
+    Type of schedule entry
+    """
+    description: str | None = None
+    """
+    Optional description of the schedule entry
+    """
     purchases: list[SchedulePriceObject] | None = None
+    """
+    Available purchases for this schedule entry
+    """
 
 
-class EntityScheduleResponse(BaseModel):
+class ParkSchedule(BaseModel):
     id: str | None = None
+    """
+    Entity identifier
+    """
     name: str | None = None
+    """
+    Entity name
+    """
     entityType: EntityType | None = None
+    """
+    Type of entity
+    """
     timezone: str | None = None
-    schedule: list[ScheduleEntry] | None = None
-    parks: list[EntityScheduleResponse] | None = None
     """
-    Only included for destinations, this will list all parks within the destination
+    Entity timezone
     """
+    schedule: list[ScheduleEntry] | None = None
 
 
-class DestinationParkEntry(BaseModel):
-    id: str | None = None
-    name: str | None = None
-
-
-class DestinationEntry(BaseModel):
+class EntityScheduleResponse(BaseModel):
     id: str | None = None
+    """
+    Entity identifier
+    """
     name: str | None = None
-    slug: str | None = None
-    externalId: str | None = None
     """
-    External entity ID from the source data provider
+    Entity name
+    """
+    entityType: EntityType | None = None
+    """
+    Type of entity
+    """
+    timezone: str | None = None
+    """
+    Entity timezone
+    """
+    schedule: list[ScheduleEntry] | None = None
+    parks: list[ParkSchedule] | None = None
+    """
+    Only included for destinations, lists all parks within the destination
     """
-    parks: list[DestinationParkEntry] | None = None
-
-
-class DestinationsResponse(BaseModel):
-    destinations: list[DestinationEntry] | None = None
-
-
-EntityScheduleResponse.model_rebuild()

themeparks-2.0.0a1/CHANGELOG.md

@@ -1,41 +0,0 @@
-# Changelog
-
-## [2.0.0a1] - 2026-04-15
-### Added
-- MkDocs Material documentation site with full API reference and a cookbook
-  (recipes for sorted wait times, 7-day schedules, geo-locations grouped by
-  entity type, every queue variant, and HTTP debugging).
-- Top-level exports for `current_wait_time`, `iter_queues`, `parse_api_datetime`.
-- Class-level docstrings on every public surface for readable API reference rendering.
-- README sections explaining every queue variant (STANDBY, PAID_RETURN_TIME,
-  BOARDING_GROUP, etc.) and how to enable the httpx logger for HTTP debugging.
-
-### Fixed
-- `walk()` now makes a single API call instead of one per descendant — the
-  `/children` endpoint already returns the entire subtree recursively. Walking
-  Walt Disney World dropped from ~250 requests to 1.
-- `get_entity_schedule_month` now zero-pads the month (`/schedule/2026/05`,
-  not `/schedule/2026/5`) per the API requirement.
-- `RetryConfig` field renamed `max_attempts` → `max_retries` to match its
-  actual semantics (N retries beyond the first attempt = N+1 total calls).
-- `APIError` now includes a server-body excerpt in the exception message;
-  `RateLimitError.__repr__` includes `retry_after`.
-- `destinations.find()` now performs the loose, case-insensitive substring
-  match it had always promised in its docstring (was exact equality).
-- Generated queue variant classes renamed (`STANDBY` → `StandbyQueue` etc.)
-  so users access `queue.STANDBY` instead of the awkward `queue.STANDBY_1`.
-- `eval-type-backport` is now a conditional dep on Python 3.9 so pydantic
-  can evaluate PEP 604 union syntax in the generated models.
-
-## [2.0.0a0] - 2026-04-14
-### Added
-- Full rewrite on pydantic v2 + httpx.
-- Sync `ThemeParks` and `AsyncThemeParks` clients with shared core.
-- Ergonomic `client.entity(id)` navigation, `walk()`, `schedule.range()`.
-- Typed pydantic models, correctly handling nullable queue fields (fixes #1, #2).
-- Default-on caching with per-endpoint TTLs and pluggable adapter.
-- 429 `Retry-After` handling.
-
-### Removed
-- Legacy `openapi_client` top-level import and generated surface. See MIGRATION.md.
-- `urllib3`-based transport.