Metadata-Version: 2.4
Name: ATG-lib
Version: 1.7.2
Summary: Python library to process solo queue game data with comprehensive database models to additionally store LoL Esports data
Keywords: lol-esports,riot-games-api
Author: Allan Cao
Author-email: Allan Cao <allan@allancao.ca>
License-Expression: GPL-3.0-or-later
License-File: LICENSE
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: 3.15
Requires-Dist: sqlalchemy>=2.0.41,<3.0.0
Requires-Dist: tqdm>=4.67.1,<5.0.0
Requires-Dist: psycopg[binary]>=3.2.9,<4.0.0
Requires-Dist: httpx2>=2.14.0
Requires-Dist: alembic>=1.20.1
Requires-Dist: python-dotenv>=1.2.4
Requires-Python: >=3.11
Project-URL: Repository, https://github.com/Allan-Cao/ATG.git
Project-URL: Documentation, https://atg.readthedocs.io/en/latest/
Project-URL: Issues, https://github.com/Allan-Cao/ATG/issues
Description-Content-Type: text/x-rst

===================
ATG - All The Games
===================

.. image:: https://img.shields.io/pypi/v/ATG-lib?label=latest
   :target: https://pypi.org/project/ATG-lib/
   :alt: Latest Version

.. image:: https://img.shields.io/pypi/pyversions/ATG-lib
   :target: https://pypi.org/project/ATG-lib/
   :alt: Python Versions

.. image:: https://img.shields.io/pypi/l/ATG-lib
   :target: https://github.com/Allan-Cao/ATG/blob/main/LICENSE
   :alt: License

**ATG makes it easy to collect, store League of Legends data.**

ATG is an opinionated but flexible library that handles the complexities of the Riot API
and the data it returns. It provides region-aware functions and rate limiters for the Riot API,
PostgreSQL database models to store solo queue and competitive games, players and teams,
and functions to ingest and manage that data.

  This library is currently under `active development <https://atg.readthedocs.io/en/latest/development/todo.html>`_; expect breaking changes before 2.0.

Features
========

- Functions for the League of Legends Riot API endpoints with platform to regional routing handled for you
- Header-based rate limiting
- SQLAlchemy database models compatible with both solo queue & esports games
- Database models to store Riot esports game event (JSONL) data
- Ingestion of Match-V5 data, with unmapped fields kept in JSONB columns
- Functions to update solo queue account names & store new solo queue games

For more information on this library, refer to `the documentation <https://atg.readthedocs.io/en/latest/>`_

Installation
============

The following command will install ATG from the `Python Package Index <https://pypi.org/project/ATG-lib/>`_. You will
need a working installation of Python and pip.

.. code-block:: shell

    pip install -U ATG-lib

