<!-- omit in toc -->
# 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/)
[![codecov](https://codecov.io/github/American-Soccer-Analysis/itscalledsoccer/graph/badge.svg?token=RUWMM7ZLQ2)](https://codecov.io/github/American-Soccer-Analysis/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)
---
<!-- omit in toc -->
## 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
```
## 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")
```
For more information, check out the [documentation site](https://american-soccer-analysis.github.io/itscalledsoccer/).
## Contributing
See [CONTRIBUTING.md](./CONTRIBUTING.md)
## License
MIT © itscalledsoccer authors
Raw data
{
"_id": null,
"home_page": null,
"name": "itscalledsoccer",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "stats, soccer, api, football, american, machine learning",
"author": null,
"author_email": "American Soccer Analysis <americansocceranalysis@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/68/fa/f144b9fc5c564be9e2365f6ca201636e61f18a1cec286f6563606c740dfb/itscalledsoccer-1.3.0.tar.gz",
"platform": null,
"description": "<!-- omit in toc -->\n# 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[![codecov](https://codecov.io/github/American-Soccer-Analysis/itscalledsoccer/graph/badge.svg?token=RUWMM7ZLQ2)](https://codecov.io/github/American-Soccer-Analysis/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<!-- omit in toc -->\n## Table of Contents\n\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\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\nFor more information, check out the [documentation site](https://american-soccer-analysis.github.io/itscalledsoccer/).\n\n## Contributing\n\nSee [CONTRIBUTING.md](./CONTRIBUTING.md)\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.3.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": "718560b792224506e196ceb9ab5d443b3df706288e740f93f08f5deac1357f39",
"md5": "7b7349b80adee8148245af54cec0dba8",
"sha256": "eb520b8439e0f6273756ddae5eee440ed89616e7e4eccb709b04d1b3cdba8001"
},
"downloads": -1,
"filename": "itscalledsoccer-1.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7b7349b80adee8148245af54cec0dba8",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 10482,
"upload_time": "2024-08-30T01:47:37",
"upload_time_iso_8601": "2024-08-30T01:47:37.974740Z",
"url": "https://files.pythonhosted.org/packages/71/85/60b792224506e196ceb9ab5d443b3df706288e740f93f08f5deac1357f39/itscalledsoccer-1.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "68faf144b9fc5c564be9e2365f6ca201636e61f18a1cec286f6563606c740dfb",
"md5": "051a7a1a1d8c244224a5aac29e8856e8",
"sha256": "002f468c7ceab6bbae41a658790f844cb5b38b7b39cf94e74ba8bc5487ca7405"
},
"downloads": -1,
"filename": "itscalledsoccer-1.3.0.tar.gz",
"has_sig": false,
"md5_digest": "051a7a1a1d8c244224a5aac29e8856e8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 12531,
"upload_time": "2024-08-30T01:47:39",
"upload_time_iso_8601": "2024-08-30T01:47:39.294297Z",
"url": "https://files.pythonhosted.org/packages/68/fa/f144b9fc5c564be9e2365f6ca201636e61f18a1cec286f6563606c740dfb/itscalledsoccer-1.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-30 01:47:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "American-Soccer-Analysis",
"github_project": "itscalledsoccer",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "itscalledsoccer"
}