Metadata-Version: 2.1
Name: soccerdata
Version: 1.0.0
Summary: A collection of wrappers over soccer data from various websites / APIs.
Home-page: https://github.com/probberechts/soccerdata
License: Apache-2.0
Keywords: soccer,football,soccer data,web scraping,soccer analytics
Author: Pieter Robberechts
Author-email: pieter.robberechts@kuleuven.be
Requires-Python: >=3.7,<4.0.0
Classifier: License :: OSI Approved :: Apache Software License
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: PySocks (>=1.7.1,<2.0.0)
Requires-Dist: Unidecode (>=1.2.0,<2.0.0)
Requires-Dist: fake_useragent (>=0.1.11,<0.2.0)
Requires-Dist: html5lib (>=1.1,<2.0)
Requires-Dist: lxml (>=4.6,<5.0)
Requires-Dist: pandas (>=1.0,<2.0)
Requires-Dist: pretty-errors (>=1.2.25,<2.0.0)
Requires-Dist: requests (>=2.23,<3.0)
Requires-Dist: rich (>=12.0.0,<13.0.0)
Requires-Dist: selenium (>=4.0.0,<5.0.0)
Requires-Dist: undetected-chromedriver (>=3.1.3,<4.0.0)
Requires-Dist: unicode (>=2.7,<3.0)
Project-URL: Repository, https://github.com/probberechts/soccerdata
Description-Content-Type: text/x-rst

.. image:: https://raw.githubusercontent.com/probberechts/soccerdata/master/docs/_static/logo2.png
   :align: center
   :alt: SoccerData
   :width: 600px

.. badges-begin

|PyPI| |Python Version| |License| |Read the Docs| |Tests| |Codecov| |pre-commit| |Black|

.. |PyPI| image:: https://img.shields.io/pypi/v/soccerdata.svg
   :target: https://pypi.org/project/soccerdata/
   :alt: PyPI
.. |Python Version| image:: https://img.shields.io/pypi/pyversions/soccerdata
   :target: https://pypi.org/project/soccerdata
   :alt: Python Version
.. |License| image:: https://img.shields.io/pypi/l/soccerdata.svg
   :target: https://opensource.org/licenses/Apache-2.0
   :alt: License
.. |Read the Docs| image:: https://img.shields.io/readthedocs/soccerdata/latest.svg?label=Read%20the%20Docs
   :target: https://soccerdata.readthedocs.io/
   :alt: Read the documentation at https://soccerdata.readthedocs.io/
.. |Tests| image:: https://github.com/probberechts/soccerdata/workflows/CI/badge.svg
   :target: https://github.com/probberechts/soccerdata/actions?workflow=CI
   :alt: Tests
.. |Codecov| image:: https://codecov.io/gh/probberechts/soccerdata/branch/master/graph/badge.svg
   :target: https://app.codecov.io/gh/probberechts/soccerdata
   :alt: Codecov
.. |pre-commit| image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white
   :target: https://github.com/pre-commit/pre-commit
   :alt: pre-commit
.. |Black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
   :target: https://github.com/psf/black
   :alt: Black

.. badges-end

SoccerData is a collection of wrappers over soccer data from `Club Elo`_,
`ESPN`_, `FBref`_, `FiveThirtyEight`_, `Football-Data.co.uk`_, `SoFIFA`_ and
`WhoScored`_. You get Pandas DataFrames with sensible, matching column names
and identifiers across datasets. Data is downloaded when needed and cached
locally.

.. code:: python

   import soccerdata as sd

   # Create scraper class instance for the Premier League
   five38 = sd.FiveThirtyEight('ENG-Premier League', '1819')

   # Fetch dataframes
   games = five38.read_games()

To learn how to install, configure and use SoccerData, see the
`Quickstart guide <https://soccerdata.readthedocs.io/en/latest/usage.html>`__. For documentation on each of the
supported data sources, see the `example notebooks <https://soccerdata.readthedocs.io/en/latest/datasources/>`__ and `API reference <https://soccerdata.readthedocs.io/en/latest/reference/>`__.

.. _Club Elo: https://www.clubelo.com/
.. _ESPN: https://www.espn.com/soccer/
.. _FBref: https://www.fbref.com/en/
.. _FiveThirtyEight: https://fivethirtyeight.com/soccer-predictions/
.. _Football-Data.co.uk: https://www.football-data.co.uk/
.. _SoFIFA: https://sofifa.com/
.. _WhoScored: https://www.whoscored.com/

**Disclaimer:** As soccerdata relies on web scraping, any changes to the
scraped websites will break the package. Hence, do not expect that all code
will work all the time. If you spot any bugs, then please `fork it and start
a pull request <https://github.com/probberechts/soccerdata/blob/master/CONTRIBUTING.rst>`__.

