MouseTools

An unofficial, async Python wrapper for Disney's undocumented API. Data is pulled directly from Disney, and this package makes no attempt to access data that would require individual user authentication — public data only. Supports Walt Disney World and Disneyland Resort.

Install

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://gitlab.com/caratozzoloxyz/public/MouseTools

Quick example

import asyncio
import mousetools
from mousetools import WALT_DISNEY_WORLD

async def main() -> None:
    # Build an unloaded handle via the destination front-door (no I/O yet).
    attraction = WALT_DISNEY_WORLD.get_attraction("80010177")  # Pirates of the Caribbean

    # Loading is EXPLICIT — attribute access does NOT auto-load.
    await attraction.load()

    print(attraction.name)                    # str
    wait = attraction.wait_time               # WaitTime | None
    if wait is not None:
        print("Standby (min):", wait.standby_minutes)
        print("Status:", wait.status)

    park = await attraction.theme_park()      # ThemePark | None
    if park is not None:
        print("In park:", park.name)

    await mousetools.aclose()                 # close the shared default client(s)

asyncio.run(main())

📖 Full documentation

License

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

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.

About Project

MouseTools is a passion project I've been working on since 2018 when I was first learning Python. The package has evolved and been rewritten multiple times as I've become a better developer and as the Disney API has changed. There is a lot of time exploring Disney's API and figuring out how all the pieces work before any code is even written. I work on this project when I have time or when I have an idea for another project that could use this data.