MouseTools 2.1.2.dev2__py3-none-any.whl → 3.0.0.dev1__py3-none-any.whl

{MouseTools-2.1.2.dev2.dist-info → MouseTools-3.0.0.dev1.dist-info}/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.dev1.dist-info/METADATA

@@ -0,0 +1,39 @@
+Metadata-Version: 2.1
+Name: MouseTools
+Version: 3.0.0.dev1
+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
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests
+
+# 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
+```
+
+### 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.dev1.dist-info/RECORD

@@ -0,0 +1,25 @@
+mousetools/__init__.py,sha256=83vn73ueEi1KaPISFpdHB5AmMwieJJmVEpV4ko9SZBE,581
+mousetools/auth.py,sha256=XBCeD_hQaFPcSgKWWxYXpxwx2QxUk72adU4H8O5G-YY,2177
+mousetools/exceptions.py,sha256=F94ohI_xDi0dLtTFInGhJL4u9TLY259OLmiiV6gcE_Q,538
+mousetools/ids.py,sha256=k7pl9zeWSNUobr6RAJlQpEiwtH37RS4r6jZwvn0D0wI,3743
+mousetools/urls.py,sha256=9GX9WYqfbg6Mv70Sz7WkqifFKUCvdYM3R7yZuQddvp4,302
+mousetools/entities/__init__.py,sha256=g_USz0PsavrhDpUAuSz9eMBvxS1upJRgFoz9xLQl1kQ,742
+mousetools/entities/attraction.py,sha256=R3Ju7hzdIu4kxzoSQRrSprOWoREu89AUN0Wc26R7iEQ,190
+mousetools/entities/base.py,sha256=IVAAwszx-MgmwP5TIo-7aN_i2AysRXONS5UTDFOx-1g,13223
+mousetools/entities/destination.py,sha256=_UUATQz_sdlWEYg1aAZeespPNkS7thzURbzZb5dvFWE,193
+mousetools/entities/dining_event.py,sha256=OCHKiqmdzoraYxKxZs1EtfZRkqKCJdtMZNY3GOlbN-E,340
+mousetools/entities/entertainment.py,sha256=CmgiJMShsph0gFbvMQzrmD5PaRp5mxeO9lUBY59cQBU,199
+mousetools/entities/entertainment_venue.py,sha256=8xeYnjgrgK2kiXHDx_Qw-Q_u9DdKZFGuuXmS5cQ0-0g,214
+mousetools/entities/event.py,sha256=R-6osBRaCj5AYLbmSOcd5JLcQBN_X-suP3bbEcTCWI0,175
+mousetools/entities/merchandise_facility.py,sha256=YRcAJlcmKf7s-Khy2V42a4v1n4q_LXRE1h5JhSe3fqA,217
+mousetools/entities/park.py,sha256=Tr_0HGwePXCV8rMiBrjyqdbCun40pDWSnf3mhLEyx9w,172
+mousetools/entities/resort.py,sha256=6NS1UIxzL_t7reoPQ5Da-T070MuJ4tp9pIxiREECX6s,178
+mousetools/entities/restaurant.py,sha256=TWbgp5e-Sw_EV9WrzyEebqbBeVtU7Jp_hb36i7hD-aE,190
+mousetools/mixins/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+mousetools/mixins/disney.py,sha256=PnEpaR1s-yMV2YLJO_pF440p_qOBWu1V9fF5UEMECLY,2045
+mousetools/mixins/themeparksapi.py,sha256=6Zeo0QDnfT4ovHrlycA-SDQiES6vXOivLWFUAn8AG0g,4123
+MouseTools-3.0.0.dev1.dist-info/LICENSE,sha256=xX4HoDU-zdafl3yEfIaspkvqHPaaXhuDwkJ6qhDMUIo,1074
+MouseTools-3.0.0.dev1.dist-info/METADATA,sha256=VUCidYBzR9DG3tyRq7pXjjJKGx9Q9B1hbAPvrSOQtWs,1570
+MouseTools-3.0.0.dev1.dist-info/WHEEL,sha256=Mdi9PDNwEZptOjTlUcAth7XJDFtKrHYaQMPulZeBCiQ,91
+MouseTools-3.0.0.dev1.dist-info/top_level.txt,sha256=7nanLN103J_xJn6HK6yuyqqlDgltCsQY2-ArRXx1Ukk,11
+MouseTools-3.0.0.dev1.dist-info/RECORD,,

{MouseTools-2.1.2.dev2.dist-info → MouseTools-3.0.0.dev1.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (72.1.0)
+Generator: setuptools (73.0.1)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

mousetools/__init__.py

@@ -1,27 +1,13 @@
-"""
-init
-expose classes and modules
-"""
-from mousetools.parks import Park
-from mousetools.entertainmentvenues import EntertainmentVenue
-from mousetools.attractions import Attraction
-from mousetools.entertainments import Entertainment
-from mousetools.characters import Character
-from mousetools.facilities import Facility
-from mousetools.pointsofinterest import PointOfInterest
-from mousetools.destinations import Destination
-import mousetools.ids as ids
+import logging
+from mousetools.ids import ancestor_entities, DestinationIds
 
-__version__ = "2.1.2-dev.2" # will be set at runtime
+logger = logging.getLogger(__name__)
+logger.addHandler(logging.NullHandler())
 
+__version__ = "3.0.0-dev.1"  # will be set at runtime
+logger.info(f"MouseTools version: {__version__}")
 
-__all__ = [
-    "Destination",
-    "Park",
-    "EntertainmentVenue",
-    "Attraction",
-    "Entertainment",
-    "Facility",
-    "Character",
-    "PointOfInterest",
-    ]
+WALT_DISNEY_WORLD_ENTITIES = ancestor_entities(DestinationIds.WALT_DISNEY_WORLD)
+logger.debug("%s Walt Disney World Entities", len(WALT_DISNEY_WORLD_ENTITIES))
+DISNEYLAND_RESORT_ENTITIES = ancestor_entities(DestinationIds.DISNEYLAND_RESORT)
+logger.debug("%s Disneyland Resort Entities", len(DISNEYLAND_RESORT_ENTITIES))

mousetools/auth.py

@@ -1,42 +1,60 @@
-import requests
-import json
-from datetime import datetime, timedelta
-
-
-def disney_authentication():
-    """Gets an authentication (access) token from Disney and returns it"""
-
-    headers = {
-        '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',
-        'Accept-Language' : 'en_US',
-        'Cache-Control' : '0',
-        'Accept' : 'application/json',
-        'Content-Type' : 'application/x-www-form-urlencoded',
-        'Connection' : 'keep-alive',
-        'Proxy-Connection' : 'keep-alive',
-        'Accept-Encoding' : 'gzip, deflate'
-    }
-    auth = requests.get("https://disneyworld.disney.go.com/authentication/get-client-token", headers=headers, timeout=10).json()
-    return auth['access_token'], auth['expires_in']
-
-
-time_of_expire = None
-access_token = None
-
-def get_headers():
-    """Creates the headers to send during the request and returns it"""
-
-    global time_of_expire
-    global access_token
-
-    if time_of_expire == None or (datetime.now() > time_of_expire):
-        access_token, expires_in = disney_authentication()
-        time_of_expire = datetime.now() + timedelta(seconds=(expires_in-10))
-
-    headers = {"Authorization":"BEARER {}".format(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;charset=UTF-8","Accept":"*/*"}
-
-    return headers
-
-if __name__ == '__main__':
-
-    print(get_headers())
+import typing
+import requests
+from datetime import datetime, timedelta
+
+
+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",
+        }
+        response = requests.get(
+            "https://disneyworld.disney.go.com/authentication/get-client-token",
+            headers=headers,
+            timeout=10,
+        )
+        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/entities/__init__.py

@@ -0,0 +1,13 @@
+from mousetools.entities.attraction import Attraction
+from mousetools.entities.entertainment import Entertainment
+from mousetools.entities.destination import Destination
+from mousetools.entities.park import Park
+from mousetools.entities.entertainment_venue import EntertainmentVenue
+from mousetools.entities.merchandise_facility import MerchandiseFacility
+from mousetools.entities.restaurant import Restaurant
+from mousetools.entities.resort import Resort
+from mousetools.entities.dining_event import DiningEvent, DinnerShow
+from mousetools.entities.event import Event
+
+
+__all__ = ["Attraction", "Entertainment", "Destination", "Park", "EntertainmentVenue" ,"MerchandiseFacility", "Restaurant", "Resort", "DiningEvent", "DinnerShow", "Event"]

mousetools/entities/attraction.py

@@ -0,0 +1,8 @@
+from mousetools.entities.base import Entity
+
+
+class Attraction(Entity):
+    """Class for Attraction Entities."""
+
+    def __repr__(self) -> str:
+        return f"Attraction(id='{self.id}')"

mousetools/entities/base.py

@@ -0,0 +1,381 @@
+import logging
+import typing
+from datetime import datetime
+from zoneinfo import ZoneInfo
+from mousetools.mixins.disney import DisneyAPIMixin
+from mousetools.mixins.themeparksapi import ThemeParkAPIMixin
+from mousetools.ids import DestinationIds
+from mousetools.urls import ENTITY_DETAILS_SIMPLE_BASE_URL
+from mousetools.exceptions import AncestorDestinationMissing
+
+
+logger = logging.getLogger(__name__)
+
+
+class Entity(DisneyAPIMixin, ThemeParkAPIMixin):
+    def __init__(self, id: str):
+        self.id: str = id
+        self.disney_data: typing.Optional[dict] = None
+
+    @property
+    def name(self) -> typing.Optional[str]:
+        """
+        The name of the entity.
+
+        Returns:
+            (typing.Optional[str]): The name of the entity, or None if it was not found.
+        """
+
+        if self.disney_data is None:
+            self.disney_data = self.get_disney_data()
+        try:
+            return self.disney_data["name"]
+        except KeyError:
+            logger.debug("No name found for %s", self.id)
+            return None
+
+    @property
+    def entity_type(self) -> typing.Optional[str]:
+        """
+        The type of entity this is.
+
+        Returns:
+            (typing.Optional[str]): The type of entity this is, or None if it was not found.
+        """
+
+        if self.disney_data is None:
+            self.disney_data = self.get_disney_data()
+        try:
+            return self.disney_data["entityType"]
+        except KeyError:
+            logger.debug("No entity type found for %s", self.id)
+            return None
+
+    @property
+    def entity_type_name(self) -> typing.Optional[str]:
+        """
+        The name of the type of entity.
+
+        Returns:
+            (typing.Optional[str]): The name of the type of entity, or None if it was not found.
+        """
+        if self.disney_data is None:
+            self.disney_data = self.get_disney_data()
+        try:
+            return self.disney_data["entityTypeName"]
+        except KeyError:
+            logger.debug("No entity type name found for %s", self.id)
+            return None
+
+    @property
+    def url_friendly_id(self) -> typing.Optional[str]:
+        """
+        The url friendly id of the entity.
+
+        Returns:
+            (typing.Optional[str]): The url friendly id of the entity, or None if not found.
+        """
+        if self.disney_data is None:
+            self.disney_data = self.get_disney_data()
+        try:
+            id = self.disney_data["urlFriendlyId"]
+            # for some reason pirates in wdw has a -wdw and its wrong
+            id = id.replace("-wdw", "").replace("-dlr", "")
+            return id
+        except KeyError:
+            logger.debug("No url friendly id found for %s", self.id)
+            return None
+
+    @property
+    def coordinates(self) -> typing.Optional[dict[str, float]]:
+        """
+        The coordinates of this entity
+
+        Returns:
+            (typing.Optional[dict[str, float]]): A dict with "lat" and "lng" keys containing the coordinates of this entity as floats, or None if no coordinates are found
+        """
+        if self.disney_data is None:
+            self.disney_data = self.get_disney_data()
+        try:
+            return {
+                "lat": float(self.disney_data["marker"]["lat"]),
+                "lng": float(self.disney_data["marker"]["lng"]),
+            }
+        except KeyError:
+            logger.debug("No coordinates found for %s", self.id)
+            return None
+
+    @property
+    def ancestor_destination_id(self) -> typing.Optional[str]:
+        """
+        The id of the ancestor destination of this entity.
+
+        Returns:
+            (typing.Optional[str]): The id of the ancestor destination of this entity, or None if it was not found.
+        """
+
+        if self.disney_data is None:
+            self.disney_data = self.get_disney_data()
+        try:
+            return self._ancestor_destination_id
+        except KeyError:
+            logger.debug("No ancestor destination id found for %s", self.id)
+            return None
+
+    @ancestor_destination_id.setter
+    def ancestor_destination_id(self, value: typing.Optional[str]):
+        """
+        Set the ancestor destination id
+
+        Required for ThemeParkAPIMixin
+
+        Args:
+            value (typing.Optional[str]): Str to set ancestor_destination_id to
+        """
+        self.ancestor_destination_id = value
+
+    @property
+    def ancestor_park_ids(self) -> typing.Optional[list[str]]:
+        """
+        The ids of parks that are ancestors of this entity.
+
+        Returns:
+            (typing.Optional[list[str]]): A list of park ids that are ancestors of this entity, or None if no such ids are found.
+        """
+        if self.disney_data is None:
+            self.disney_data = self.get_disney_data()
+        try:
+            return [
+                i
+                for i in self.disney_data["parkIds"]
+                if any(j in i for j in ["theme-park", "water-park"])
+            ]
+        except KeyError:
+            logger.debug("No ancestor park ids found for %s", self.id)
+            return None
+
+    @property
+    def ancestor_resort_ids(self) -> typing.Optional[list[str]]:
+        """
+        The ids of resorts that are ancestors of this entity.
+
+        Returns:
+            (typing.Optional[list[str]]): A list of resort ids that are ancestors of this entity, or None if no such ids are found.
+        """
+
+        if self.disney_data is None:
+            self.disney_data = self.get_disney_data()
+        try:
+            return [i for i in self.disney_data["parkIds"] if "resort" in i]
+        except KeyError:
+            logger.debug("No ancestor resort ids found for %s", self.id)
+            return None
+
+    @property
+    def ancestor_land_id(self) -> typing.Optional[str]:
+        """
+        The id of the land that is an ancestor of this entity.
+
+        Returns:
+            (typing.Optional[str]): The id of the land that is an ancestor of this entity, or None if no such id is found.
+        """
+        if self.disney_data is None:
+            self.disney_data = self.get_disney_data()
+        try:
+            return self.disney_data["landId"]
+        except KeyError:
+            logger.debug("No ancestor land id found for %s", self.id)
+            return None
+
+    @property
+    def ancestor_resort_area_ids(self) -> typing.Optional[list[str]]:
+        """
+        The ids of resort areas that are ancestors of this entity.
+
+        Returns:
+            (typing.Optional[list[str]]): A list of resort area ids that are ancestors of this entity, or None if no such ids are found.
+        """
+        if self.disney_data is None:
+            self.disney_data = self.get_disney_data()
+        try:
+            return [i for i in self.disney_data["parkIds"] if "resort-area" in i]
+        except KeyError:
+            logger.debug("No ancestor resort area ids found for %s", self.id)
+            return None
+
+    @property
+    def ancestor_entertainment_venue_ids(self) -> typing.Optional[list[str]]:
+        """
+        The ids of entertainment venues that are ancestors of this entity.
+
+        Returns:
+            (typing.Optional[list[str]]): A list of entertainment venue ids that are ancestors of this entity, or None if no such ids are found.
+        """
+        if self.disney_data is None:
+            self.disney_data = self.get_disney_data()
+        try:
+            return [
+                i for i in self.disney_data["parkIds"] if "Entertainment-Venue" in i
+            ]
+        except KeyError:
+            logger.debug("No ancestor entertainment venue ids found for %s", self.id)
+            return None
+
+    @property
+    def ancestor_restaurant_ids(self) -> typing.Optional[list[str]]:
+        """
+        The ids of restaurants that are ancestors of this entity.
+
+        Returns:
+            (typing.Optional[list[str]]): A list of restaurant ids that are ancestors of this entity, or None if no such ids are found.
+        """
+        if self.disney_data is None:
+            self.disney_data = self.get_disney_data()
+        try:
+            return [i["id"] for i in self.disney_data["restaurants"]]
+        except KeyError:
+            logger.debug("No ancestor restaurant ids found for %s", self.id)
+            return None
+
+    @property
+    def time_zone(self) -> ZoneInfo:
+        """
+        The time zone of the entity.
+
+        Returns:
+            (ZoneInfo): The time zone of the entity.
+        """
+
+        if self.ancestor_destination_id == DestinationIds.WALT_DISNEY_WORLD:
+            return ZoneInfo("America/New_York")
+        elif self.ancestor_destination_id == DestinationIds.DISNEYLAND_RESORT:
+            return ZoneInfo("America/Los_Angeles")
+        else:
+            return ZoneInfo("UTC")
+
+    def details_simple_url(self) -> str:
+        """
+        Gets the simple details url for this entity
+
+        Returns:
+            (str): The simple details url
+
+        Raises:
+            AncestorDestinationMissing: If the ancestor destination id is not
+                either Walt Disney World or Disneyland Resort
+        """
+        if self.ancestor_destination_id == DestinationIds.WALT_DISNEY_WORLD:
+            dest_url_friendly_id = "wdw"
+        elif self.ancestor_destination_id == DestinationIds.DISNEYLAND_RESORT:
+            dest_url_friendly_id = "dlr"
+        else:
+            raise AncestorDestinationMissing
+        return f"{ENTITY_DETAILS_SIMPLE_BASE_URL}/{dest_url_friendly_id}/{self.url_friendly_id}/{datetime.now().strftime('%Y-%m-%d')}"
+
+    def status(self) -> typing.Optional[str]:
+        """
+        The current status of the entity.
+
+        Returns:
+            (typing.Optional[str]): The current status of the entity, or None if no such data exists.
+        """
+
+        live_data = self.get_entity_live_tp()
+        try:
+            return live_data["liveData"][0]["status"]
+        except (KeyError, IndexError):
+            logger.debug("No status found for %s", self.id)
+            return None
+
+    def wait_time(self) -> typing.Optional[int]:
+        """
+        The current wait time for the entity.
+
+        Returns:
+            (typing.Optional[int]): The current wait time for the entity, or None if no such data exists.
+        """
+        live_data = self.get_entity_live_tp()
+        try:
+            return live_data["liveData"][0]["queue"]["STANDBY"]["waitTime"]
+        except (KeyError, IndexError):
+            logger.debug("No wait time found for %s", self.id)
+            return None
+
+    def last_updated(self) -> typing.Optional[datetime]:
+        """
+        The last time the entity's data was updated.
+
+        Returns:
+            (typing.Optional[datetime]): The last time the entity's data was updated, or None if no such data exists.
+        """
+        live_data = self.get_entity_live_tp()
+        try:
+            return datetime.strptime(
+                live_data["liveData"][0]["lastUpdated"], "%Y-%m-%dT%H:%M:%SZ"
+            ).replace(tzinfo=ZoneInfo("UTC"))
+        except (KeyError, IndexError):
+            logger.debug("No last updated found for %s", self.id)
+            return None
+
+    def today_operating_hours(self) -> typing.Optional[dict[str, dict[str, datetime]]]:
+        """
+        The operating hours for today for the entity.
+
+        Returns:
+            (typing.Optional[dict[str, dict[str, datetime]]]): A dictionary of the operating hours for today, or None if no such data exists.
+        """
+
+        live_data = self.get_entity_live_tp()
+        temp = {}
+
+        try:
+            for i in live_data["liveData"][0]["operatingHours"]:
+                temp[i["type"]] = {
+                    "start_time": datetime.strptime(
+                        i["startTime"], "%Y-%m-%dT%H:%M:%S%z"
+                    ).replace(tzinfo=self.time_zone),
+                    "end_time": datetime.strptime(
+                        i["endTime"], "%Y-%m-%dT%H:%M:%S%z"
+                    ).replace(tzinfo=self.time_zone),
+                }
+        except (KeyError, IndexError):
+            logger.debug("No operating hours found for %s", self.id)
+            return None
+
+        return temp
+
+    def today_showtimes(self) -> typing.Optional[list[datetime]]:
+        """
+        The showtimes for today for the entity.
+
+        Returns:
+            (typing.Optional[list[datetime]]): A list of the showtimes for today, or None if no such data exists.
+        """
+        live_data = self.get_entity_live_tp()
+        temp = []
+
+        try:
+            for i in live_data["liveData"][0]["showtimes"]:
+                temp.append(
+                    datetime.strptime(i["startTime"], "%Y-%m-%dT%H:%M:%S%z").replace(
+                        tzinfo=self.time_zone
+                    )
+                )
+        except (KeyError, IndexError):
+            logger.debug("No showtimes found for %s", self.id)
+            return None
+
+        return temp
+
+    def __str__(self) -> str:
+        return f"{self.entity_type}: {self.name} ({self.id})"
+
+    def __repr__(self) -> str:
+        return f"Entity(id='{self.id}')"
+
+    def __eq__(self, other) -> bool:
+        if isinstance(other, Entity):
+            return self.id == other.id
+        return False
+
+    # TODO virtual queue

mousetools/entities/destination.py

@@ -0,0 +1,8 @@
+from mousetools.entities.base import Entity
+
+
+class Destination(Entity):
+    """Class for Destination Entities."""
+
+    def __repr__(self) -> str:
+        return f"Destination(id='{self.id}')"

mousetools/entities/dining_event.py

@@ -0,0 +1,15 @@
+from mousetools.entities.base import Entity
+
+
+class DiningEvent(Entity):
+    """Class for DiningEvent Entities."""
+
+    def __repr__(self) -> str:
+        return f"DiningEvent(id='{self.id}')"
+
+
+class DinnerShow(Entity):
+    """Class for DiningEvent Entities."""
+
+    def __repr__(self) -> str:
+        return f"DinnerShow(id='{self.id}')"

mousetools/entities/entertainment.py

@@ -0,0 +1,8 @@
+from mousetools.entities.base import Entity
+
+
+class Entertainment(Entity):
+    """Class for Entertainment Entities."""
+
+    def __repr__(self) -> str:
+        return f"Entertainment(id='{self.id}')"

mousetools/entities/entertainment_venue.py

@@ -0,0 +1,8 @@
+from mousetools.entities.base import Entity
+
+
+class EntertainmentVenue(Entity):
+    """Class for EntertainmentVenue Entities."""
+
+    def __repr__(self) -> str:
+        return f"EntertainmentVenue(id='{self.id}')"