PyClasher

PyClasher is the name of the asynchronous ClashOfClans API. It is
an object-oriented wrapper client that provides easy access to the
requested data.

I am planning to release the package on pypi.org after my exams. This is
probably in the first week of september.

The package is still in development and will be finished as short as
possible for me. When the package covers the whole ClashOfClans API, the
repository will be transformed into a python package and will be available for
everyone.

If you have any questions, feel free to join my discord server to ask your
question.

Installation

The package is available on pypi.org. It is possible to install it via the
following command:

pip install pyclasher

Documentation

The documentation of this project is available on
PyClasher's GitHub pages.

NOTE: The documentation is not fully completed yet. It is still in
progress.

Features

• Asynchronous and parallel requesting
• Possibility to use multiple tokens and to login via email address and
  password of the ClashOfClans developer portal
• Control over the number of requests per second and the number of used tokens
• Open source
• Type hinted
• Supports Python 3.8 -> 3.11

Contributing

Feel free to contribute to the repository.

You can fork the repository and commit your changes in a pull request. Please
consider to check out the Discord server if so.

For more information, please see the CONTRIBUTING.md file

Future

I'm planning to keep the API wrapper up to date and improve it as good as I can.

Planned features

• more bulk requests
• events

Planned utils

• documentation
• real example (HeadhunterBot is in development)

Planned code implementations (ToDo-list)

• attributes king, queen, warden, royal_champion for the
  Player.heroes attribute
• events and an EventClient

If you find a bug, an error or want custom functionality, please tell me via
Discord or open an issue or start a discussion on the GitHub-repository.

Disclaimer

This material is unofficial and is not endorsed by Supercell. For more
information see Supercell's Fan Content Policy:
www.supercell.com/fan-content-policy.