Getting Started¶
Usage¶
Tokage is an asynchronous library. This means you must use some kind of async library to handle the HTTP requests to the API.
Tokage supports asyncio, which is provided in the standard python library.
Additionally, Tokage also supports curio and trio, two awesome libraries which solve many of the problems asyncio has. multio, a library that brings the two together, is required in order to use them.
Whichever you prefer, tokage will adapt to it. For more info on how to use each type of library, refer to the examples below.
Examples¶
Basic Asyncio Example¶
import asyncio
import tokage
async def main():
client = tokage.Client() # Create a new Client instance. Default lib is asyncio.
anime_id = await client.search_id("anime", "Steins Gate") # Search for an ID of an Anime called "Steins gate"
anime = await client.get_anime(anime_id) # Get the Anime object from the API
manga_id = await client.search_id("manga", "my hero academia") # Search for an ID of a Manga called "my hero academia"
manga = await client.get_manga(manga_id) # Get the Manga object from the API
print("Anime title:", anime.title) # Print the title of the Anime
print("Manga title:", manga.title) # Print the title of the Manga
await client.cleanup() # Finally, clean up
loop = asyncio.get_event_loop() # Get the event loop
loop.run_until_complete(main()) # Run main
Prints:
Anime title: Steins;Gate
Manga title: Boku no Hero Academia
Basic Multio Example¶
import multio
import tokage
multio.init('trio') # initialize multio to use trio. Also works the same with curio
async def main():
client = tokage.Client(lib='multio') # Create a client instance. Tell tokage to use multio (in this case trio)
anime = await client.get_anime(1) # Get the Anime with ID `1`, which is Cowboy Bebop
print("Anime title:", anime.title) # Print the title and premiere season of the Anime
print("Started airing:", anime.premiered)
await client.cleanup() # Finally, clean up (currently, this does nothing in curio/trio mode, so it can be omitted)
multio.run(main) # Run main
Prints:
Anime title: Cowboy Bebop
Started airing: Spring 1998