.. image:: https://i.imgur.com/5uUkTrn.png :alt: Brawl Stats

Brawl Stats

.. image:: https://img.shields.io/pypi/v/brawlstats.svg :target: https://pypi.org/project/brawlstats/ :alt: PyPi

.. image:: https://travis-ci.com/SharpBit/brawlstats.svg?branch=master :target: https://travis-ci.com/SharpBit/brawlstats :alt: Travis-CI build

.. image:: https://img.shields.io/pypi/pyversions/brawlstats.svg :target: https://pypi.org/project/brawlstats/ :alt: Supported Versions

.. image:: https://img.shields.io/github/license/SharpBit/brawlstats.svg :target: https://github.com/SharpBit/brawlstats/blob/master/LICENSE :alt: MIT License

• This library is a sync and async wrapper for the Brawl Stars API.
• Python 3.5.3 or later is required.

Features

- Easy to use with an object oriented design.
- Use the same client for sync and async usage.
- Get a player profile and battlelog.
- Get a club and its members.
- Get the top 200 rankings for players, clubs, or a specific brawler.
- Get information about maps, brawlers, and more!

Installation

Install the latest stable build:

::

pip install brawlstats

Install the development build:

::

pip install git+https://github.com/SharpBit/brawlstats@development

Documentation

Documentation is being hosted on `Read the Docs`_.

Examples
~~~~~~~~
Examples are in the `examples folder`_.

- ``sync.py`` shows you basic sync usage
- ``async.py`` shows you basic async usage
- ``discord_cog.py`` shows an example Discord Bot cog using `discord.py`_

Misc
~~~~

- If you are currently using this wrapper, please star this repository :)
- If you come across an issue in the wrapper, please `create an issue`_.
- If you need an API key, visit https://developer.brawlstars.com

Contributing
~~~~~~~~~~~~
Special thanks to this project's contributors ❤️

- `4JR`_
- `golbu`_
- `kawaii banana`_
- `kjkui`_
- `Kyber`_
- `Papiersnipper`_
- `Pollen`_
- `OrangutanGaming`_
- `Stitch`_

If you want to contribute, whether it be a bug fix or new feature, make sure to follow the `contributing guidelines`_.
This project is no longer actively maintained. No new features will be added, only bugfixes and security fixes will be accepted.

.. _create an issue: https://github.com/SharpBit/brawlstats/issues
.. _Read the Docs: https://brawlstats.rtfd.io/
.. _examples folder: https://github.com/SharpBit/brawlstats/tree/master/examples
.. _discord.py: https://github.com/rapptz/discord.py
.. _contributing guidelines: https://github.com/SharpBit/brawlstats/blob/master/CONTRIBUTING.md

.. _4JR: https://github.com/fourjr
.. _OrangutanGaming: https://github.com/OrangutanGaming
.. _Stitch: https://github.com/Soumil07
.. _kjkui: https://github.com/kjkui
.. _Kyber: https://github.com/kyb3r
.. _Papiersnipper: https://github.com/robinmahieu
.. _Pollen: https://github.com/pollen5
.. _kawaii banana: https://github.com/bananaboy21
.. _golbu: https://github.com/0dminnimda