A full-functionality wrapper for the https://ballchasing.com API
Project description
A full-functionality wrapper for the https://ballchasing.com API.
Install
pip install pychasing
pychasing.Client
The main object used to interact with the API.
import pychasing
pychasing_client = pychasing.Client(
token = "your_token",
auto_rate_limit = True,
patreon_tier = pychasing.types.PatreonTier.Regular # regular = no patreon tier
)
The pychasing.Client
object has the below methods:
ping
- pings the ballchasing servers.upload_replay
- uploads a replay to the token-holder's account.- NOTE: this takes a
BinaryIO
object. For example:
with open("my_replay.replay", "rb") as replay_file: ...upload_replay(replay_file, ...)
- NOTE: this takes a
list_replays
- list replays (basic information only) filtered on various criteria.get_replay
- get the in-depth information of a specific replay.delete_replay
- delete a specific replay, so long as it is owned by the token-holder.- NOTE: this operation is permenant and cannot be undone.
patch_replay
- edit thetitle
,visibility
or parentgroup
of a specific replay.download_replay
- download the raw bytes of a specific replay, so long as it is not private (unless it is owned by the token-holder).- NOTE: since replays are relatively large, they should be downloaded in chunks. For example:
with ...download_replay(...) as data_stream: with open("my_replay.replay", "wb") as replay_file: for chunk in data_stream.iter_content(chunk_size=4096): replay_file.write(chunk)
create_group
- create a replay group.list_groups
- list groups (basic information only) filtered on various criteria.get_group
- get in-depth information of a specific replay group.delete_group
- delete a specific group, so long as it is owned by the token-holder.- NOTE: this operation is permenant and cannot be undone.
patch_group
- edit theplayer-identification
,team-identification
,parent
, orshared
status of a specific replay group, so long as it owned by the token-holder.maps
- list all the maps in the game.get_threejs
- get basic locational data (among other data) of a specific replay. This does not require- NOTE: this functionality is highly experimental. It accesses a back-end API used for populating site data (that notably does not require authorization headers). At any time, this API could become restricted or its functionality could change.
get_timeline
- get basic timeline data of a specific replay.- NOTE: this functionality is highly experimental. It accesses a back-end API used for populating site data (that notably does not require authorization headers). At any time, this API could become restricted or its functionality could change.
export_csv
- get group statistics formatted as semi-colon-separated values.
Helper types
pychasing.types.Rank
- represents an in-game rank (Unranked to SSL).pychasing.types.Playlist
- represents an in-game playlist, e.g. Hoops, Rumble, Ranked Duels.pychasing.types.Platform
- represents the current playable platforms (Steam, Epic, XBox, PlayStation, Switch).pychasing.types.Map
- represents an in-game map, e.g. Starbase Arc, arc_p.pychasing.types.PatreonTier
- represents a patreon tier for Ballchasing's Patreon. Tiers include Grand Champion, Champion, Diamond, Gold, and Regular (no patreon tier).pychasing.types.Visibility
- represents the visibility of a replay or group, i.e. public, unlisted, and private.pychasing.types.PlayerIdentification
- represents a type of player identification for groups, i.e. by id and by name.pychasing.types.TeamIdentification
- represents a type of team identification for groups, i.e. by distinct players and by player clusters.pychasing.types.MatchResult
- represents a result of a match, i.e. win or losspychasing.types.SortBy
- represents a sorting method, e.g. **replay date`, group creation date, group name.pychasing.types.SortDir
- represents a sort direction, i.e. ascending and descending.pychasing.types.GroupStats
- represents a stat group when exporting CSV, e.g. players, teams.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
pychasing-0.0.4.tar.gz
(13.8 kB
view hashes)
Built Distribution
pychasing-0.0.4-py3-none-any.whl
(13.4 kB
view hashes)
Close
Hashes for pychasing-0.0.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | eace8723ca320f6d1335e45945c3e471e690d3a603d83aeee22b456ca6f02f89 |
|
MD5 | 4bd85f663fee2576baccfc95a9b76b3c |
|
BLAKE2b-256 | 513f84c62492a79830c62c11839c9219205a6de13b0249392ef07e962da1571c |