scaratozzolo / mousetools Goto Github PK

A Python wrapper for Disney's API

License: MIT License

Python 100.00%

disney api unofficial library python3 disneyworld disneyland wrapper wrapper-api disney-api

mousetools's Introduction

MouseTools

A Python wrapper for the Disney API. Data is pulled directly from Disney. This package supports Walt Disney World and Disneyland.

Installation

You can install using pip:

pip install MouseTools

You can also install directly from this repo in case of any changes not uploaded to Pypi.

pip install git+https://github.com/scaratozzolo/MouseTools

Example usage:

import mousetools

wdw_dest = mousetools.Destination(80007798)
print(wdw_dest.get_park_ids())

dlr_dest = mousetools.Destination(80008297)
print(dlr_dest.get_attraction_ids())

mk = mousetools.Park(80007944)
print(mk.get_wait_times())

pirates = mousetools.Attraction(80010177)
print(pirates.get_wait_time())


# You don't have to know any ids to get started.
mousetools.ids.WDW_ID     # Walt Disney World Resort
mousetools.ids.DLR_ID     # Disneyland Resort

# Single park ids
mousetools.ids.MK_ID      # Magic Kingdom
mousetools.ids.EPCOT_ID   # EPCOT
mousetools.ids.HS_ID      # Hollywood Studios
mousetools.ids.AK_ID      # Animal Kingdom
mousetools.ids.TL_ID      # Typhoon Lagoon
mousetools.ids.BB_ID      # Blizzard Beach
mousetools.ids.DLP_ID     # Disneyland Park
mousetools.ids.CA_ID      # California Adventure

# List of ids
# Parks
mousetools.ids.WDW_PARK_IDS
mousetools.ids.DLR_PARK_IDS

# Entertainment Venues
mousetools.ids.WDW_EV_IDS
mousetools.ids.DLR_EV_IDS

# Attractions
mousetools.ids.WDW_ATTRACTION_IDS
mousetools.ids.DLR_ATTRACTION_IDS

# Entertainments
mousetools.ids.WDW_ENTERTAINMENT_IDS
mousetools.ids.DLR_ENTERTAINMENT_IDS

For more documentation go to the wiki or run the following command from a termainal:

python -m pydoc mousetools

I created this project to help with another project found here. Some parts of the wrapper were created with that in mind.

If you notice any issues please open a new issue with a "bug" label. Furthermore, if you have any feature requests, open a new issue with a "feature request" label.

This package uses the ThemeParks.wiki API.

License

This project is distributed under the MIT license. For more information see LICENSE

https://github.com/scaratozzolo/MouseTools

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.

mousetools's People

Contributors

Stargazers

Watchers

Forkers

bourgonlaurent toddrob99 cloneforyou m2nx thomasma13 havulv

mousetools's Issues

Hangs on import MouseTools

Hello,

I found your project while looking for a way to get realtime Disney wait times to display on an LED matrix. Thought this would be a fun way to bring some Disney magic into my home during COVID.

I have been fighting with this for two nights now and feel really stupid. After installing and running it hangs on import MouseTools. I was patient the first few times as instructed and after an hour I noticed that MouseTools.db stays at 0KB so I'm not sure if it's even getting to Disney's site. I know that's not much to go on but any tips would be greatly appreciated.

Thanks!
Steve

Name Error

As of a couple weeks ago, a script I have been using for a couple years now accessing mousetools is dead. It's no longer able to find park ids and is now telling me there's a NameError when I try to call MouseTools. Is mousetools dead?

update get_hours

return a dictionary with all the schedules
current implementation ignores Early entry or extended evening
disney API has been updated

Associated characters url has been updated

['links']['associatedCharacters']

List of Id's

I find the work you've done here extremely useful. I'm doing some work attempting to gather disney wait times and do some analysis followed by doing some live predictions on wait times. I had issues sourcing the wait times as I started first with looking for web sites to scrape but hoping that those web sites would maintain their wait times as new rides were added proved to be futile.

As I'm looking through your work, I notice you have a list of Id's for attractions, parks, and the works. Instead of just copying your work I'm attempting to recreate it and am wondering how you got this list of Id's. Where did they come from and how did you source them?