skip to navigation
skip to content

achallonge 1.6.1

A python library to use the Challonge API

# 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)
[![Code Issues](https://www.quantifiedcode.com/api/v1/project/cd2c13493bdf461695ada40356a9d3a1/badge.svg)](https://www.quantifiedcode.com/app/project/cd2c13493bdf461695ada40356a9d3a1)


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`

# 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

Twitter: [@fp12gaming](https://twitter.com/fp12gaming)

Join the [Discord Server](https://discord.gg/KSRxBav) and discuss about this lib!  
File Type Py Version Uploaded on Size
achallonge-1.6.1-py3-none-any.whl (md5) Python Wheel py3 2017-06-07 19KB
achallonge-1.6.1.tar.gz (md5) Source 2017-06-07 16KB