Skip to content

Entity

Fluent, read-only navigation rooted at one entity id.

Obtained via tp.entity(entity_id). Provides :meth:get for the entity record, :meth:children for direct children, :meth:live for current wait/queue data, :meth:walk for an iterator over every descendant (one API call), and .schedule for upcoming / month / range helpers. All calls flow through the shared :class:~themeparks._raw.RawClient and therefore share the client's cache.

Example

with ThemeParks() as tp: ... mk = tp.entity("75ea578a-adc8-4116-a54d-dccb60765ef9") ... live = mk.live()

walk

walk() -> Iterator[EntityChild]

Yield every descendant of this entity in a single API call.

The ThemeParks API's /children endpoint returns the entire subtree in one response — this method just exposes it as an iterator. The root entity itself is not yielded.

Asynchronous mirror of :class:EntityHandle.

Same method set (get, children, live, walk, schedule) but all network-bound methods are coroutines. :meth:walk exposes the recursive /children response as an async iterator, and schedule.range fans out month fetches via asyncio.gather.

Example

async with AsyncThemeParks() as tp: ... async for child in tp.entity(root_id).walk(): ... ...

walk async

walk() -> AsyncIterator[EntityChild]

Yield every descendant of this entity in a single API call.

The ThemeParks API's /children endpoint returns the entire subtree in one response — this method just exposes it as an async iterator. The root entity itself is not yielded.