mctiers.py
==========

An async Python wrapper for the public MCTiers API.

mctiers.py uses ``aiohttp`` and exposes a small object-oriented client for
fetching gamemodes, rankings, player profiles, and test history.

Features
--------

- Modern async API using ``async`` and ``await``
- Built-in retry handling for temporary server errors
- Rate-limit handling for ``429`` responses and ``Retry-After`` headers
- Typed model objects for common API payloads
- Proxy and custom ``aiohttp`` session support

Installing
----------

.. code-block:: bash

   python -m pip install mctiers

Quick Example
-------------

.. code-block:: python

   import asyncio
   import mctiers


   async def main() -> None:
       async with mctiers.Client() as client:
           profile = await client.fetch_player_profile_by_name(
               "ItzRealMe",
               badges=True,
               tests=True,
           )

           print(profile.name)
           print(profile.points)


   asyncio.run(main())

Contents
--------

.. toctree::
   :maxdepth: 2

   quickstart
   api