MouseTools 2.1.3__tar.gz → 3.0.0.dev2__tar.gz

{mousetools-2.1.3 → mousetools-3.0.0.dev2}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2021 Scott Caratozzolo
+Copyright (c) 2024 Scott Caratozzolo
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

mousetools-3.0.0.dev2/MouseTools.egg-info/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.1
+Name: MouseTools
+Version: 3.0.0.dev2
+Summary: An unofficial Python wrapper for Disney's API
+Author: Scott Caratozzolo
+Project-URL: repository, https://gitlab.com/caratozzoloxyz/public/MouseTools
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27.2
+Requires-Dist: tzdata>=2024.1
+
+# MouseTools
+[![PyPI version](https://badge.fury.io/py/MouseTools.svg)](https://badge.fury.io/py/MouseTools) [![Downloads](https://pepy.tech/badge/mousetools)](https://pepy.tech/project/mousetools)
+
+
+An unofficial Python wrapper for the Disney API. Data is pulled directly from Disney. This package supports Walt Disney World and Disneyland.
+
+Read the [documentation](https://caratozzoloxyz.gitlab.io/public/MouseTools/).
+
+
+### Installation
+You can install using pip:
+```bash
+pip install MouseTools
+```
+You can also install directly from this repo in case of any changes not uploaded to Pypi.
+```bash
+pip install git+https://gitlab.com/caratozzoloxyz/public/MouseTools
+```
+
+### Quick Start
+
+Define an entity object directly.
+
+```python
+from mousetools.entities import Attraction
+
+big_thunder = Attraction("80010110")
+
+print(big_thunder.name)
+#> 'Big Thunder Mountain Railroad'
+
+print(big_thunder.ancestor_theme_park_id)
+#> '80007944'
+
+print(big_thunder.get_status())
+#> 'OPERATING'
+
+print(big_thunder.get_wait_time())
+#> 45
+
+```
+
+Use the already created destination objects to get children entities.
+
+```python
+from mousetools.entities import WALT_DISNEY_WORLD_DESTINATION, DISNEYLAND_RESORT_DESTINATION
+from mousetools.ids import FacilityServiceEntityTypes
+
+print(WALT_DISNEY_WORLD_DESTINATION.get_children_entity_ids(FacilityServiceEntityTypes.ENTERTAINMENT_VENUES))
+#> ['10460', '80008033', '80008259']
+
+print(DISNEYLAND_RESORT_DESTINATION.get_children_entity_ids(FacilityServiceEntityTypes.RESORT_AREAS))
+#> ['330338', '15597760']
+```
+
+### License
+This project is distributed under the MIT license. For more information see [LICENSE](https://gitlab.com/caratozzoloxyz/public/MouseTools/-/blob/master/LICENSE?ref_type=heads)
+
+### Disclaimer
+This project is in no way affiliated with The Walt Disney Company and all use of Disney Services is subject to the [Disney Terms of Use](https://disneytermsofuse.com/).
+
+This package uses the [ThemeParks.wiki API](https://themeparks.wiki/). 

mousetools-3.0.0.dev2/MouseTools.egg-info/SOURCES.txt

@@ -0,0 +1,38 @@
+LICENSE
+README.md
+pyproject.toml
+MouseTools.egg-info/PKG-INFO
+MouseTools.egg-info/SOURCES.txt
+MouseTools.egg-info/dependency_links.txt
+MouseTools.egg-info/requires.txt
+MouseTools.egg-info/top_level.txt
+mousetools/__init__.py
+mousetools/auth.py
+mousetools/exceptions.py
+mousetools/ids.py
+mousetools/urls.py
+mousetools/entities/__init__.py
+mousetools/entities/attraction.py
+mousetools/entities/base.py
+mousetools/entities/character.py
+mousetools/entities/destination.py
+mousetools/entities/dining_event.py
+mousetools/entities/dinner_show.py
+mousetools/entities/entertainment.py
+mousetools/entities/entertainment_venue.py
+mousetools/entities/event.py
+mousetools/entities/guest_services.py
+mousetools/entities/land.py
+mousetools/entities/menu.py
+mousetools/entities/merchandise_facility.py
+mousetools/entities/park.py
+mousetools/entities/point_of_interest.py
+mousetools/entities/resort.py
+mousetools/entities/resort_area.py
+mousetools/entities/restaurant.py
+mousetools/mixins/__init__.py
+mousetools/mixins/disney.py
+mousetools/mixins/themeparksapi.py
+tests/test_auth.py
+tests/test_entities.py
+tests/test_ids.py

mousetools-3.0.0.dev2/MouseTools.egg-info/requires.txt

@@ -0,0 +1,2 @@
+httpx>=0.27.2
+tzdata>=2024.1

mousetools-3.0.0.dev2/PKG-INFO

@@ -0,0 +1,77 @@
+Metadata-Version: 2.1
+Name: MouseTools
+Version: 3.0.0.dev2
+Summary: An unofficial Python wrapper for Disney's API
+Author: Scott Caratozzolo
+Project-URL: repository, https://gitlab.com/caratozzoloxyz/public/MouseTools
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.27.2
+Requires-Dist: tzdata>=2024.1
+
+# MouseTools
+[![PyPI version](https://badge.fury.io/py/MouseTools.svg)](https://badge.fury.io/py/MouseTools) [![Downloads](https://pepy.tech/badge/mousetools)](https://pepy.tech/project/mousetools)
+
+
+An unofficial Python wrapper for the Disney API. Data is pulled directly from Disney. This package supports Walt Disney World and Disneyland.
+
+Read the [documentation](https://caratozzoloxyz.gitlab.io/public/MouseTools/).
+
+
+### Installation
+You can install using pip:
+```bash
+pip install MouseTools
+```
+You can also install directly from this repo in case of any changes not uploaded to Pypi.
+```bash
+pip install git+https://gitlab.com/caratozzoloxyz/public/MouseTools
+```
+
+### Quick Start
+
+Define an entity object directly.
+
+```python
+from mousetools.entities import Attraction
+
+big_thunder = Attraction("80010110")
+
+print(big_thunder.name)
+#> 'Big Thunder Mountain Railroad'
+
+print(big_thunder.ancestor_theme_park_id)
+#> '80007944'
+
+print(big_thunder.get_status())
+#> 'OPERATING'
+
+print(big_thunder.get_wait_time())
+#> 45
+
+```
+
+Use the already created destination objects to get children entities.
+
+```python
+from mousetools.entities import WALT_DISNEY_WORLD_DESTINATION, DISNEYLAND_RESORT_DESTINATION
+from mousetools.ids import FacilityServiceEntityTypes
+
+print(WALT_DISNEY_WORLD_DESTINATION.get_children_entity_ids(FacilityServiceEntityTypes.ENTERTAINMENT_VENUES))
+#> ['10460', '80008033', '80008259']
+
+print(DISNEYLAND_RESORT_DESTINATION.get_children_entity_ids(FacilityServiceEntityTypes.RESORT_AREAS))
+#> ['330338', '15597760']
+```
+
+### License
+This project is distributed under the MIT license. For more information see [LICENSE](https://gitlab.com/caratozzoloxyz/public/MouseTools/-/blob/master/LICENSE?ref_type=heads)
+
+### Disclaimer
+This project is in no way affiliated with The Walt Disney Company and all use of Disney Services is subject to the [Disney Terms of Use](https://disneytermsofuse.com/).
+
+This package uses the [ThemeParks.wiki API](https://themeparks.wiki/). 

mousetools-3.0.0.dev2/README.md

@@ -0,0 +1,62 @@
+# MouseTools
+[![PyPI version](https://badge.fury.io/py/MouseTools.svg)](https://badge.fury.io/py/MouseTools) [![Downloads](https://pepy.tech/badge/mousetools)](https://pepy.tech/project/mousetools)
+
+
+An unofficial Python wrapper for the Disney API. Data is pulled directly from Disney. This package supports Walt Disney World and Disneyland.
+
+Read the [documentation](https://caratozzoloxyz.gitlab.io/public/MouseTools/).
+
+
+### Installation
+You can install using pip:
+```bash
+pip install MouseTools
+```
+You can also install directly from this repo in case of any changes not uploaded to Pypi.
+```bash
+pip install git+https://gitlab.com/caratozzoloxyz/public/MouseTools
+```
+
+### Quick Start
+
+Define an entity object directly.
+
+```python
+from mousetools.entities import Attraction
+
+big_thunder = Attraction("80010110")
+
+print(big_thunder.name)
+#> 'Big Thunder Mountain Railroad'
+
+print(big_thunder.ancestor_theme_park_id)
+#> '80007944'
+
+print(big_thunder.get_status())
+#> 'OPERATING'
+
+print(big_thunder.get_wait_time())
+#> 45
+
+```
+
+Use the already created destination objects to get children entities.
+
+```python
+from mousetools.entities import WALT_DISNEY_WORLD_DESTINATION, DISNEYLAND_RESORT_DESTINATION
+from mousetools.ids import FacilityServiceEntityTypes
+
+print(WALT_DISNEY_WORLD_DESTINATION.get_children_entity_ids(FacilityServiceEntityTypes.ENTERTAINMENT_VENUES))
+#> ['10460', '80008033', '80008259']
+
+print(DISNEYLAND_RESORT_DESTINATION.get_children_entity_ids(FacilityServiceEntityTypes.RESORT_AREAS))
+#> ['330338', '15597760']
+```
+
+### License
+This project is distributed under the MIT license. For more information see [LICENSE](https://gitlab.com/caratozzoloxyz/public/MouseTools/-/blob/master/LICENSE?ref_type=heads)
+
+### Disclaimer
+This project is in no way affiliated with The Walt Disney Company and all use of Disney Services is subject to the [Disney Terms of Use](https://disneytermsofuse.com/).
+
+This package uses the [ThemeParks.wiki API](https://themeparks.wiki/). 

mousetools-3.0.0.dev2/mousetools/__init__.py

@@ -0,0 +1,7 @@
+import logging
+
+logger = logging.getLogger(__name__)
+logger.addHandler(logging.NullHandler())
+
+__version__ = "3.0.0-dev.2"  # will be set at runtime
+logger.info(f"MouseTools version: {__version__}")

mousetools-3.0.0.dev2/mousetools/auth.py

@@ -0,0 +1,70 @@
+import typing
+from datetime import datetime, timedelta
+
+import httpx
+
+
+class Authentication:
+    def __init__(self):
+        self.time_of_expire: typing.Optional[datetime] = None
+        self.access_token: typing.Optional[str] = None
+
+    @staticmethod
+    def authenticate() -> typing.Tuple[str, int]:
+        """Gets an access token from Disney and the token's expiration time
+
+        Returns:
+            (typing.Tuple[str, int]): Access token to the api and how long until it expires
+        """
+
+        headers = {
+            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36",
+            "Accept-Language": "en-US,en;q=0.9",
+            "Cache-Control": "max-age=0",
+            "Accept": "application/json",
+            "Content-Type": "application/x-www-form-urlencoded",
+            "Connection": "keep-alive",
+            "Proxy-Connection": "keep-alive",
+            "Accept-Encoding": "gzip, deflate",
+        }
+
+        body = {
+            "grant_type": "assertion",
+            "assertion_type": "public",
+            "client_id": "TPR-DLR-LBSDK.AND-PROD",
+        }
+
+        response = httpx.post(
+            "https://authorization.go.com/token",
+            headers=headers,
+            params=body,
+            timeout=10,
+        )
+        response.raise_for_status()
+        auth = response.json()
+
+        return auth["access_token"], int(auth["expires_in"])
+
+    def get_headers(self) -> typing.Dict[str, str]:
+        """Creates the headers to send during the request
+
+        Returns:
+            (typing.Dict[str, str]): Headers for the request
+        """
+
+        if self.time_of_expire is None or (datetime.now() > self.time_of_expire):
+            access_token, expires_in = self.authenticate()
+            self.time_of_expire = datetime.now() + timedelta(seconds=(expires_in - 10))
+            self.access_token = access_token
+
+        headers = {
+            "Authorization": f"BEARER {self.access_token}",
+            "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/108.0.0.0 Safari/537.36",
+            "Content-Type": "application/json",
+            "Accept": "*/*",
+        }
+
+        return headers
+
+
+auth_obj = Authentication()

mousetools-3.0.0.dev2/mousetools/entities/__init__.py

@@ -0,0 +1,41 @@
+from mousetools.entities.attraction import Attraction
+from mousetools.entities.character import Character
+from mousetools.entities.destination import Destination
+from mousetools.entities.dining_event import DiningEvent
+from mousetools.entities.dinner_show import DinnerShow
+from mousetools.entities.entertainment import Entertainment
+from mousetools.entities.entertainment_venue import EntertainmentVenue
+from mousetools.entities.event import Event
+from mousetools.entities.guest_services import GuestServices
+from mousetools.entities.land import Land
+from mousetools.entities.merchandise_facility import MerchandiseFacility
+from mousetools.entities.park import ThemePark, WaterPark
+from mousetools.entities.point_of_interest import PointOfInterest
+from mousetools.entities.resort import Resort
+from mousetools.entities.resort_area import ResortArea
+from mousetools.entities.restaurant import Restaurant
+from mousetools.ids import DestinationIds
+
+WALT_DISNEY_WORLD_DESTINATION = Destination(DestinationIds.WALT_DISNEY_WORLD)
+DISNEYLAND_RESORT_DESTINATION = Destination(DestinationIds.DISNEYLAND_RESORT)
+
+
+__all__ = [
+    "Attraction",
+    "Character",
+    "GuestServices",
+    "Entertainment",
+    "Destination",
+    "ThemePark",
+    "WaterPark",
+    "EntertainmentVenue",
+    "MerchandiseFacility",
+    "Restaurant",
+    "Resort",
+    "ResortArea",
+    "DiningEvent",
+    "DinnerShow",
+    "Event",
+    "Land",
+    "PointOfInterest",
+]

mousetools-3.0.0.dev2/mousetools/entities/attraction.py

@@ -0,0 +1,12 @@
+from mousetools.entities.base import EntityBase
+from mousetools.ids import FacilityServiceEntityTypes
+
+
+class Attraction(EntityBase):
+    """Class for Attraction Entities."""
+
+    def __init__(self, entity_id: str):
+        super().__init__(
+            entity_id=entity_id,
+            facility_service_entity_type=FacilityServiceEntityTypes.ATTRACTIONS,
+        )