# itscalledsoccer
<img src="https://raw.githubusercontent.com/American-Soccer-Analysis/itscalledsoccer-r/main/man/figures/logo.png" align="right" height="175"/>
<!-- badges: start -->
[![standard-readme compliant](https://img.shields.io/badge/readme%20style-standard-brightgreen.svg?style=flat-square)](https://github.com/RichardLitt/standard-readme)
![PyPi Version](https://img.shields.io/pypi/v/itscalledsoccer.svg)
![Python tests](https://github.com/American-Soccer-Analysis/itscalledsoccer/actions/workflows/python-tests.yml/badge.svg)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![PyPI download month](https://img.shields.io/pypi/dm/itscalledsoccer.svg)](https://pypi.python.org/pypi/itscalledsoccer/)
<!-- badges: end -->
---
:warning: **`itscalledsoccer` has been split up into multiple repositories. If you're looking for the R or JavaScript version, check out the links below** :warning::
- [itscalledsoccer-r](https://github.com/American-Soccer-Analysis/itscalledsoccer-r)
- [itscalledsoccer-js](https://github.com/American-Soccer-Analysis/itscalledsoccer-js)
---
## Table of Contents
- [itscalledsoccer](#itscalledsoccer)
- [Table of Contents](#table-of-contents)
- [Background](#background)
- [Install](#install)
- [Usage](#usage)
- [Contributing](#contributing)
- [License](#license)
## Background
`itscalledsoccer` is a wrapper around the same API that powers the [American Soccer Analysis app](https://app.americansocceranalysis.com/). It enables Python users to programmatically retrieve advanced analytics for their favorite [MLS](https://en.wikipedia.org/wiki/Major_League_Soccer), [NWSL](https://en.wikipedia.org/wiki/National_Women%27s_Soccer_League), and [USL](https://en.wikipedia.org/wiki/United_Soccer_League) players and teams.
## Install
```sh
pip install itscalledsoccer
```
To install a development version, clone this repo and run the following command.
```sh
pip install --editable itscalledsoccer/python-package
```
## Usage
```python
from itscalledsoccer.client import AmericanSoccerAnalysis
asa_client = AmericanSoccerAnalysis()
```
Any of the `get_*` methods can be used to retrieve the same data made available in the [American Soccer Analysis app](https://app.americansocceranalysis.com/). Partial matches or abbreviations are accepted for any player or team names. For most methods, arguments _must be named_. A few examples are below.
```python
# Get all players named "Andre"
asa_players = asa_client.get_players(names="Andre")
```
## Contributing
Feel free to open an issue or submit a pull request.
## License
MIT © itscalledsoccer authors
Raw data
{
"_id": null,
"home_page": "",
"name": "itscalledsoccer",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "stats,soccer,api,football,american,machine learning",
"author": "",
"author_email": "American Soccer Analysis <americansocceranalysis@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/50/84/16ab611b3699f4af50b2920e9de0e2fb121ef9a18098c056b08620443253/itscalledsoccer-1.1.0.tar.gz",
"platform": null,
"description": "# itscalledsoccer\n\n<img src=\"https://raw.githubusercontent.com/American-Soccer-Analysis/itscalledsoccer-r/main/man/figures/logo.png\" align=\"right\" height=\"175\"/>\n\n<!-- badges: start -->\n[![standard-readme compliant](https://img.shields.io/badge/readme%20style-standard-brightgreen.svg?style=flat-square)](https://github.com/RichardLitt/standard-readme)\n![PyPi Version](https://img.shields.io/pypi/v/itscalledsoccer.svg)\n![Python tests](https://github.com/American-Soccer-Analysis/itscalledsoccer/actions/workflows/python-tests.yml/badge.svg)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![PyPI download month](https://img.shields.io/pypi/dm/itscalledsoccer.svg)](https://pypi.python.org/pypi/itscalledsoccer/)\n<!-- badges: end -->\n\n---\n\n:warning: **`itscalledsoccer` has been split up into multiple repositories. If you're looking for the R or JavaScript version, check out the links below** :warning::\n\n- [itscalledsoccer-r](https://github.com/American-Soccer-Analysis/itscalledsoccer-r)\n- [itscalledsoccer-js](https://github.com/American-Soccer-Analysis/itscalledsoccer-js)\n\n---\n\n## Table of Contents\n\n- [itscalledsoccer](#itscalledsoccer)\n - [Table of Contents](#table-of-contents)\n - [Background](#background)\n - [Install](#install)\n - [Usage](#usage)\n - [Contributing](#contributing)\n - [License](#license)\n\n## Background\n\n`itscalledsoccer` is a wrapper around the same API that powers the [American Soccer Analysis app](https://app.americansocceranalysis.com/). It enables Python users to programmatically retrieve advanced analytics for their favorite [MLS](https://en.wikipedia.org/wiki/Major_League_Soccer), [NWSL](https://en.wikipedia.org/wiki/National_Women%27s_Soccer_League), and [USL](https://en.wikipedia.org/wiki/United_Soccer_League) players and teams.\n\n## Install\n\n```sh\npip install itscalledsoccer\n```\n\nTo install a development version, clone this repo and run the following command.\n\n```sh\npip install --editable itscalledsoccer/python-package\n```\n\n## Usage\n\n```python\nfrom itscalledsoccer.client import AmericanSoccerAnalysis\n\nasa_client = AmericanSoccerAnalysis()\n```\n\nAny of the `get_*` methods can be used to retrieve the same data made available in the [American Soccer Analysis app](https://app.americansocceranalysis.com/). Partial matches or abbreviations are accepted for any player or team names. For most methods, arguments _must be named_. A few examples are below.\n\n```python\n# Get all players named \"Andre\"\nasa_players = asa_client.get_players(names=\"Andre\")\n```\n\n## Contributing\n\nFeel free to open an issue or submit a pull request.\n\n## License\n\nMIT \u00a9 itscalledsoccer authors\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Programmatically interact with the American Soccer Analysis API",
"version": "1.1.0",
"project_urls": {
"Repository": "https://github.com/American-Soccer-Analysis/itscalledsoccer"
},
"split_keywords": [
"stats",
"soccer",
"api",
"football",
"american",
"machine learning"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7661b556fb1b8131d962c715ca0d7082ab5a98fe751d6eec4ad8134ea99881fd",
"md5": "661936936f39b53d529122f8a5bd74a9",
"sha256": "42046968ec2f51e5b15d92069348f6e01973e58b31bd515100b0572f3a9fc8cc"
},
"downloads": -1,
"filename": "itscalledsoccer-1.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "661936936f39b53d529122f8a5bd74a9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 10120,
"upload_time": "2023-08-22T02:41:07",
"upload_time_iso_8601": "2023-08-22T02:41:07.565167Z",
"url": "https://files.pythonhosted.org/packages/76/61/b556fb1b8131d962c715ca0d7082ab5a98fe751d6eec4ad8134ea99881fd/itscalledsoccer-1.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "508416ab611b3699f4af50b2920e9de0e2fb121ef9a18098c056b08620443253",
"md5": "61be0c648590477f4fd6bfb281b12d96",
"sha256": "6d6a0b9e05573732c3fa9b3ad6128533177ffbac1406088953068e96e347d26d"
},
"downloads": -1,
"filename": "itscalledsoccer-1.1.0.tar.gz",
"has_sig": false,
"md5_digest": "61be0c648590477f4fd6bfb281b12d96",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 11049,
"upload_time": "2023-08-22T02:41:09",
"upload_time_iso_8601": "2023-08-22T02:41:09.297723Z",
"url": "https://files.pythonhosted.org/packages/50/84/16ab611b3699f4af50b2920e9de0e2fb121ef9a18098c056b08620443253/itscalledsoccer-1.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-22 02:41:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "American-Soccer-Analysis",
"github_project": "itscalledsoccer",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [
{
"name": "requests",
"specs": [
[
"==",
"2.31.0"
]
]
},
{
"name": "CacheControl",
"specs": [
[
"==",
"0.13.1"
]
]
},
{
"name": "rapidfuzz",
"specs": [
[
"==",
"3.1.2"
]
]
},
{
"name": "pandas",
"specs": [
[
"==",
"2.0.3"
]
]
}
],
"lcname": "itscalledsoccer"
}