ambr-py
Introduction
ambr-py is an async API wrapper for Project Ambr written in Python.
Project Ambr is a beautiful website that displays Genshin Impact game data.
Developing something for Hoyoverse games? You might be interested in other API wrappers written by me.
Note: I am not the developer of Project Ambr.
Features
- Fully typed.
- Fully asynchronous by using
aiofiles,aiohttp, andasyncio, suitable for Discord bots. - Provides direct icon URLs.
- Supports Python 3.11+.
- Supports all game languages.
- Supports persistent caching using SQLite.
- Supports Pydantic V2, this also means full autocomplete support.
Installation
# poetry
poetry add ambr-py
# pip
pip install ambr-py
Quick Example
import ambr
import asyncio
async def main() -> None:
async with ambr.AmbrAPI(ambr.Language.CHT) as client:
await client.fetch_characters()
asyncio.run(main())
Getting Started
Read the documentation to learn more about on how to use this wrapper.
Questions, Issues, Feedback, Contributions
Whether you want to make any bug reports, feature requests, or contribute to the wrapper, simply open an issue or pull request in this repository.
If GitHub is not your type, you can find me on Discord, my username is @seria_ati.
1 maintainer
Metadata
1 maintainer
Release files for ambr-py 1.9.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ambr_py-1.9.0.tar.gz | 154.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ambr_py-1.9.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 217.9 kB
Release files / ambr_py-1.9.0.tar.gz
| Download URL | ambr_py-1.9.0.tar.gz |
|---|---|
| Size | 154.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
0702e88265a564a300e8469c01e95200a1f57007c23b2e7e1671b2c80d32180b
|
|
BLAKE2b-256 checksum How to use checksums |
1aefa318649884fad791a7661d9aceb6733302be2cc1cbadaf9c9928ce229354
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / ambr_py-1.9.0-py3-none-any.whl
| Download URL | ambr_py-1.9.0-py3-none-any.whl |
|---|---|
| Size | 63.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
dbb8fc216c13eb660e89a52fe55263c3d1b31679c800303dc02708cb52327ea8
|
|
BLAKE2b-256 checksum How to use checksums |
0217465317ef26bf2864ada9728b7452eff7855e1dfdaa7ebdaabeb3a073ef82
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
