Metadata-Version: 2.1
Name: apisports_football
Version: 1.0.3.3
Summary: Asynchronous wrapper for football API from API-SPORTS
Author: h3ave
Author-email: noth3ave@yandex.ru
Project-URL: CHANGELOG, https://github.com/h3ave/apisports_football/blob/main/CHANGELOG.md
Project-URL: Documentation, https://github.com/h3ave/apisports_football/blob/main/README.md
Project-URL: Repository, https://github.com/h3ave/apisports_football
Keywords: football api wrapper apisports
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: aiohttp>=3.8.6
Requires-Dist: pydantic>=2.5.3
Requires-Dist: typing-extensions>=4.7.1

# apisports_football

[![PyPI version](https://img.shields.io/pypi/v/apisports-football)](https://pypi.org/project/apisports-football)
[![python](https://img.shields.io/pypi/pyversions/apisports-football)](https://pypi.org/project/apisports-football)

[Russian version](https://github.com/h3ave/apisports_football/blob/main/README.ru.md)

It's a handy API wrapper that makes it easy to work with <https://www.api-football.com/>.

Official documentation: <https://www.api-football.com/documentation-v3>

## Installing

* With git

```console
git clone https://github.com/h3ave/apisports_football
cd apisports_football
pip install -r requirements.txt
```

* With pip

```console
pip install apisports-football
```

### Dependencies

* Python >= 3.7
* aiohttp
* pydantic
* typing-extensions

### Getting API Key

[Register](https://dashboard.api-football.com/register) on API-Sports.

Go to [profile](https://dashboard.api-football.com/profile?access) and copy key from API-Key field.

### Usage example

```python
import asyncio
from apisports_football import Wrapper

api = Wrapper('TOKEN_HERE')

async def main() -> None:
    data = await api.leagues().leagues(
        country = 'Spain',
        season = 2024
    )
    print(data)

if __name__ == '__main__':
    asyncio.run(main())
```
