themeparks 2.0.1__tar.gz → 3.0.0__tar.gz

{themeparks-2.0.1 → themeparks-3.0.0}/CHANGELOG.md

@@ -1,5 +1,61 @@
 # 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

{themeparks-2.0.1 → themeparks-3.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: themeparks
-Version: 2.0.1
+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

{themeparks-2.0.1 → themeparks-3.0.0}/pyproject.toml

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

{themeparks-2.0.1 → themeparks-3.0.0}/themeparks/_generated/models.py

@@ -6,7 +6,7 @@ from __future__ import annotations
 from enum import Enum
 from typing import Annotated, Any
 
-from pydantic import AwareDatetime, BaseModel, ConfigDict, Field
+from pydantic import AwareDatetime, BaseModel, Field
 
 
 class BoardingGroupState(Enum):
@@ -41,49 +41,6 @@ class EntityLocation(BaseModel):
     """
 
 
-class ScheduleEntry(BaseModel):
-    """
-    Represents a single schedule entry
-    """
-
-    model_config = ConfigDict(
-        extra="allow",
-    )
-    date: str
-    """
-    The date of the schedule entry
-    """
-    type: str
-    """
-    Type of schedule entry e.g. OPERATING, EXTRA_HOURS, etc.
-    """
-    description: str | None = None
-    """
-    Optional description of the schedule entry
-    """
-    openingTime: str
-    """
-    Opening time for this schedule entry
-    """
-    closingTime: str
-    """
-    Closing time for this schedule entry
-    """
-
-
-class EntityType1(Enum):
-    """
-    Type of entity
-    """
-
-    DESTINATION = "DESTINATION"
-    PARK = "PARK"
-    ATTRACTION = "ATTRACTION"
-    RESTAURANT = "RESTAURANT"
-    HOTEL = "HOTEL"
-    SHOW = "SHOW"
-
-
 class EntityType(Enum):
     """
     Type of entity in the theme park system
@@ -175,19 +132,6 @@ class Park(BaseModel):
     """
 
 
-class EntityType2(Enum):
-    """
-    Type of entity
-    """
-
-    DESTINATION = "DESTINATION"
-    PARK = "PARK"
-    ATTRACTION = "ATTRACTION"
-    RESTAURANT = "RESTAURANT"
-    HOTEL = "HOTEL"
-    SHOW = "SHOW"
-
-
 class PriceData(BaseModel):
     amount: float | None = None
     """
@@ -203,18 +147,6 @@ class PriceData(BaseModel):
     """
 
 
-class Type(Enum):
-    """
-    Type of schedule entry
-    """
-
-    OPERATING = "OPERATING"
-    TICKETED_EVENT = "TICKETED_EVENT"
-    PRIVATE_EVENT = "PRIVATE_EVENT"
-    EXTRA_HOURS = "EXTRA_HOURS"
-    INFO = "INFO"
-
-
 class ReturnTimeState(Enum):
     """
     State of return time availability
@@ -225,20 +157,17 @@ class ReturnTimeState(Enum):
     FINISHED = "FINISHED"
 
 
-class Price(BaseModel):
-    amount: float
-    """
-    Price amount
-    """
-    currency: str
-    """
-    Currency code
-    """
-    formatted: str | None = None
+class Type(Enum):
     """
-    Formatted price string
+    Type of schedule entry
     """
 
+    OPERATING = "OPERATING"
+    TICKETED_EVENT = "TICKETED_EVENT"
+    PRIVATE_EVENT = "PRIVATE_EVENT"
+    EXTRA_HOURS = "EXTRA_HOURS"
+    INFO = "INFO"
+
 
 class SchedulePriceType(Enum):
     """
@@ -404,7 +333,10 @@ class SchedulePriceObject(BaseModel):
     """
     Name of the price object
     """
-    price: Price | None = None
+    price: PriceData | None = None
+    """
+    Price of this purchase option
+    """
     available: bool | None = None
     """
     Whether this price option is available
@@ -449,7 +381,7 @@ class EntityLiveDataResponse(BaseModel):
     liveData: list[EntityLiveData] | None = None
 
 
-class PricedScheduleEntry(BaseModel):
+class ScheduleEntry(BaseModel):
     date: str
     """
     Schedule date
@@ -466,6 +398,10 @@ class PricedScheduleEntry(BaseModel):
     """
     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
@@ -481,7 +417,7 @@ class ParkSchedule(BaseModel):
     """
     Entity name
     """
-    entityType: EntityType2 | None = None
+    entityType: EntityType | None = None
     """
     Type of entity
     """
@@ -489,7 +425,7 @@ class ParkSchedule(BaseModel):
     """
     Entity timezone
     """
-    schedule: list[PricedScheduleEntry] | None = None
+    schedule: list[ScheduleEntry] | None = None
 
 
 class EntityScheduleResponse(BaseModel):
@@ -501,7 +437,7 @@ class EntityScheduleResponse(BaseModel):
     """
     Entity name
     """
-    entityType: EntityType1 | None = None
+    entityType: EntityType | None = None
     """
     Type of entity
     """