# achallonge
*async Challonge for Python 3.5+*
[![Build Status](https://travis-ci.org/fp12/achallonge.svg?branch=master)](https://travis-ci.org/fp12/achallonge)
[![Documentation Status](https://readthedocs.org/projects/achallonge/badge/?version=latest)](http://achallonge.readthedocs.io/en/latest/?badge=latest)
[![Coverage Status](https://coveralls.io/repos/github/fp12/achallonge/badge.svg?branch=master)](https://coveralls.io/github/fp12/achallonge?branch=master)
Modern library that is more than just a wrapper for the Challonge web API
# Requirements
* `aiohttp`
Optional:
* `cchardet` faster replacement for chardet, as mentionned on the aiohttp page
* `aiodns` for speeding up DNS resolving, highly recommended by aiohttp
# Python version support
* `3.5`
* `3.6`
* `3.7`
# Installation
pip install achallonge
If you want to have the optional dependencies for aiohttp, you can:
pip install achallonge[speed]
# Usage
```python
import challonge
async def foo():
# Log in into Challonge with your CHALLONGE! API credentials (https://challonge.com/settings/developer).
user = await challonge.get_user('your_challonge_username', 'your_api_key')
# Retrieve your tournaments
tournaments = await user.get_tournaments()
# Tournaments, matches, and participants are all represented as Python classes
for t in tournaments:
print(t.id) # 3272
print(t.name) # 'My Awesome Tournament'
print(t.status) # 'open'
# Retrieve the participants for a given tournament.
participants = await tournaments[0].get_participants()
print(len(participants)) # 13
```
# Documentation
The full documentation can be found on [Read the docs](http://achallonge.readthedocs.io/en/latest/index.html)
# Author / License
Distributed under MIT license. See `LICENSE` for details
Fabien Poupineau (fp12) - 2017-2019
Twitter: [@fp12gaming](https://twitter.com/fp12gaming)
Join the [Discord Server](https://discord.gg/KSRxBav) and discuss about this lib!
Raw data
{
"_id": null,
"home_page": "https://github.com/l9kd1/achallonge",
"name": "achallonge-compat-fork",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "challonge,tournament,match",
"author": "Fabien Poupineau (fp12)",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/d8/7d/fda90ad898b9038994c15e809ed039afe2a0309b6c1ad78ec6b7a5cd9490/achallonge-compat-fork-1.9.0.tar.gz",
"platform": null,
"description": "# achallonge\n*async Challonge for Python 3.5+*\n\n[![Build Status](https://travis-ci.org/fp12/achallonge.svg?branch=master)](https://travis-ci.org/fp12/achallonge)\n[![Documentation Status](https://readthedocs.org/projects/achallonge/badge/?version=latest)](http://achallonge.readthedocs.io/en/latest/?badge=latest)\n[![Coverage Status](https://coveralls.io/repos/github/fp12/achallonge/badge.svg?branch=master)](https://coveralls.io/github/fp12/achallonge?branch=master)\n\n\nModern library that is more than just a wrapper for the Challonge web API\n\n\n# Requirements\n\n* `aiohttp`\n\nOptional:\n * `cchardet` faster replacement for chardet, as mentionned on the aiohttp page\n * `aiodns` for speeding up DNS resolving, highly recommended by aiohttp\n\n# Python version support\n\n* `3.5`\n* `3.6`\n* `3.7`\n\n# Installation\n\n pip install achallonge\n\nIf you want to have the optional dependencies for aiohttp, you can:\n\n pip install achallonge[speed]\n\n# Usage\n\n```python\nimport challonge\n\nasync def foo():\n # Log in into Challonge with your CHALLONGE! API credentials (https://challonge.com/settings/developer).\n user = await challonge.get_user('your_challonge_username', 'your_api_key')\n\n # Retrieve your tournaments\n tournaments = await user.get_tournaments()\n\n # Tournaments, matches, and participants are all represented as Python classes\n for t in tournaments:\n print(t.id) # 3272\n print(t.name) # 'My Awesome Tournament'\n print(t.status) # 'open'\n\n # Retrieve the participants for a given tournament.\n participants = await tournaments[0].get_participants()\n print(len(participants)) # 13\n```\n\n# Documentation\n\nThe full documentation can be found on [Read the docs](http://achallonge.readthedocs.io/en/latest/index.html)\n\n# Author / License\n\nDistributed under MIT license. See `LICENSE` for details\n\nFabien Poupineau (fp12) - 2017-2019\n\nTwitter: [@fp12gaming](https://twitter.com/fp12gaming)\n\nJoin the [Discord Server](https://discord.gg/KSRxBav) and discuss about this lib!\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A python library to use the Challonge API",
"version": "1.9.0",
"project_urls": {
"Homepage": "https://github.com/l9kd1/achallonge"
},
"split_keywords": [
"challonge",
"tournament",
"match"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "a499376dfb259878f242c0c37ac79d8d24627cd7dda3d4ef54abd6827208bf81",
"md5": "425bd1592d096109bf7576bb617e932e",
"sha256": "ec21593bb7f851d630b6310c705a50dfcaadad35fbb17675bfaad071d1aa2107"
},
"downloads": -1,
"filename": "achallonge_compat_fork-1.9.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "425bd1592d096109bf7576bb617e932e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 19274,
"upload_time": "2023-08-17T22:52:06",
"upload_time_iso_8601": "2023-08-17T22:52:06.595092Z",
"url": "https://files.pythonhosted.org/packages/a4/99/376dfb259878f242c0c37ac79d8d24627cd7dda3d4ef54abd6827208bf81/achallonge_compat_fork-1.9.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "d87dfda90ad898b9038994c15e809ed039afe2a0309b6c1ad78ec6b7a5cd9490",
"md5": "763608f6b004185bc82f07c13ad96e6c",
"sha256": "44982cd421bdab410977acdd0de090b53ade6b1f956fcf79bc62de41f5bc2413"
},
"downloads": -1,
"filename": "achallonge-compat-fork-1.9.0.tar.gz",
"has_sig": false,
"md5_digest": "763608f6b004185bc82f07c13ad96e6c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 15834,
"upload_time": "2023-08-17T22:52:08",
"upload_time_iso_8601": "2023-08-17T22:52:08.087881Z",
"url": "https://files.pythonhosted.org/packages/d8/7d/fda90ad898b9038994c15e809ed039afe2a0309b6c1ad78ec6b7a5cd9490/achallonge-compat-fork-1.9.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-17 22:52:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "l9kd1",
"github_project": "achallonge",
"travis_ci": true,
"coveralls": false,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "achallonge-compat-fork"
}