A statically typed, asynchronous API wrapper that supports Bungie's REST API for Python 3.
Currently Python 3.10, 3.11 and 3.12 are supported.
Latest Release using pip
.
pip install aiobungie
Development via github master.
pip install git+https://github.com/nxtlo/aiobungie@master
See Examples for advance usage
import aiobungie
import asyncio
client = aiobungie.Client('YOUR_API_KEY')
async def main() -> None:
# Search for Destiny 2 players.
async with client.rest:
users = await client.search_users("Fate")
for user in users:
# Print all Destiny 2 memberships for this user.
print(user.memberships)
asyncio.run(main())
aiobungie also provides a stand-alone RESTClient
/ RESTPool
which's what Client
built on top of, These clients just provide a lower-level abstraction.
A key note is that any Client
based user can access the RESTClient
instance bound to it with .rest
property.
- Lower level, allows to read and deserialize the JSON objects yourself.
RESTClient
s do not turn response payloads into one ofaiobungie.crates
object.- RESTful, You can use this as your REST API client in backend directly.
- Both manifest and OAuth2 methods are usable directly.
import aiobungie
import asyncio
# Single REST client connection.
client = aiobungie.RESTClient("YOUR_API_KEY")
async def main() -> None:
async with client:
# Download and open the JSON manifest.
manifest = await client.download_json_manifest(name="latest_manifest")
with manifest.open("r") as file:
data = file.read()
# OAuth2 API. 2 simple methods for fetching and refreshing tokens.
tokens = await client.fetch_oauth2_tokens('code')
refreshed_tokens = await client.refresh_access_token(tokens.refresh_token)
# Testing your own requests.
response = await client.static_request(
"GET", # Method.
"Destiny2/path/to/route", # Route.
auth="optional_access_token", # If the method requires OAuth2.
json={"some_key": "some_value"} # If you need to pass JSON data.
)
asyncio.run(main())
- aiohttp
- attrs
sain
, this is a dependency free utility package.backports.datetime_fromisoformat
, required forPython 3.10
only.
aiobungie features are extra dependencies that replaces the standard library with either faster/neater pkgs.
speedup
This will include and uses orjson or ujson as the defaultjson
parser. They provide faster json serialization and de-serialization than the standard Python JSON pkg.full
: This will include all of the features above.
For installing the specified feature, type pip install aiobungie[feature-name]
Please read this manual
If you have used aiobungie and want to show your work, Feel free to Open a PR including it.
- Fated: A Discord BOT that uses aiobungie.
- Discord Username:
vfate
- aiobungie Documentation: Here.
- BungieAPI Discord: Here
- Official Bungie Documentation: Here
- Bungie Developer Portal: Here
- I need help with something related to this project: Consider opening a blank issue, discussion or checkout the
useful resources
above. - aiobungie doesn't support
fetch_xxx
route, what now? aiobungie's REST client exposes a method calledstatic_request
which allows you to make your own requests, check outexamples/custom_client
example.