- Notifications
You must be signed in to change notification settings - Fork75
API wrapper for HoYoLAB/Miyoushe API built on asyncio and pydantic.
License
thesadru/genshin.py
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
Modern API wrapper for Genshin Impact & Honkai Impact 3rd built on asyncio and pydantic.
Documentation:https://thesadru.github.io/genshin.py
API Reference:https://thesadru.github.io/genshin.py/pdoc/genshin
Source Code:https://github.com/thesadru/genshin.py
The primary focus of genshin.py is convenience. The entire project is fully type-hinted and abstracts a large amount of the api to be easier to use.
Key features:
- All data is in the form of Pydantic Models which means full autocompletion and linter support.
- Requests are significantly faster thanks to proper usage of asyncio.
- Chinese and Engrish names returned by the API are renamed to simpler English fields.
- Supports the majority of the popular endpoints.
- Cleanly integrates with frameworks like FastAPI out of the box.
Note: This library is a successor togenshinstats - an unofficial wrapper for the Genshin Impact api.
- Python 3.9+
- aiohttp
- Pydantic
pip install genshin
A very simple example of how genshin.py would be used:
importasyncioimportgenshinasyncdefmain():cookies= {"ltuid":119480035,"ltoken":"cnF7TiZqHAAvYqgCBoSPx5EjwezOh1ZHoqSHf7dT"}client=genshin.Client(cookies)data=awaitclient.get_genshin_user(710785423)print(f"User has a total of{data.stats.characters} characters")asyncio.run(main())
Any kind of contribution is welcome.Please readCONTRIBUTING.md to see what you need to do to make a contribution.
About
API wrapper for HoYoLAB/Miyoushe API built on asyncio and pydantic.