Metadata-Version: 2.2
Name: EasySoccerData
Version: 0.0.3
Summary: A simple python package for extracting real-time soccer data from diverse online sources, providing essential statistics and insights.
Home-page: https://github.com/manucabral/EasySoccerData
Author: Manuel Cabral
License: GPL-3.0
Project-URL: Bug Tracker, https://github.com/manucabral/EasySoccerData/issues
Project-URL: Documentation, https://github.com/manucabral/EasySoccerData/readme.md
Project-URL: Source Code, https://github.com/manucabral/EasySoccerData/esd
Keywords: fifa,ranking,soccer,data,soccerdata,football,worldcup,fifaranking,footballdata,europaleague,championsleague,scraper,webscraper,soccerstats,soccerstatistics,socceranalysis,footballstats,footballstatistics,footballanalysis,soccerapi,footballapi,soccerdatabase
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx==0.28.1
Dynamic: author
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: project-url
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

<h1 align="center">EasySoccerData</h1>
<p align="center">
A simple python package for extracting real-time soccer data from diverse online sources, providing essential statistics and insights.
</p>


> [!IMPORTANT]  
> Currently in the early development phase. Please take this into consideration.

# Installation
```
pip install EasySoccerData
```

# Usage

Simple demonstration of a live table using Sofascore module (see [source code](https://github.com/manucabral/EasySoccerData/blob/main/examples/live_table.py))
<p align="center">
<img src="https://github.com/manucabral/EasySoccerData/blob/main/assets/sofascore-live-table.gif" width="550" title="LiveTableUsingSofascore">
</p>

Another example
```py
import esd

# get live events
client = esd.SofascoreClient()
events = client.get_events(live=True)
for event in events:
    print(event)
```

[How to search for matches, teams, tournaments, and players](https://github.com/manucabral/EasySoccerData/blob/main/examples/search_matchs.py)

[How to get lineups for a match](https://github.com/manucabral/EasySoccerData/blob/main/examples/match_lineups.py)

[How to get live match statistics](https://github.com/manucabral/EasySoccerData/blob/main/examples/get_live_matchs.py)


And more! Check out [examples](https://github.com/manucabral/EasySoccerData/tree/main/examples)

# Supported modules

| Name | Implemented |
| :---  | :---: |
| Sofascore   | ✔️ |
| FBref    | ❌ |
| Understat | ❌ |
...

### Constributions
All constributions, bug reports or fixes and ideas are welcome.
