<p align="center">
<img src="https://user-images.githubusercontent.com/57769272/224566374-c8c748c7-c663-489f-8b98-d7041ab4092a.png" width="150">
</p>
<p align="center">
<a href="https://pypi.org/project/nbb-api/">
<img src="https://img.shields.io/pypi/v/nbb-api" alt="pypi" />
</a>
<a href="https://pypi.org/project/nbb-api/">
<img src="https://img.shields.io/pypi/pyversions/nbb-api" alt="python version" />
</a>
<a href="https://pypi.org/project/nbb-api/">
<img src="https://img.shields.io/pypi/l/nbb-api" alt="license" />
</a>
</p>
# nbb_api
Python package for easy access to Brazilian basketball data through scraping of [LNB](https://lnb.com.br/) website.
This allows users to obtain statistics, standings, and scores for various seasons and phases of the following tournaments:
- **NBB** (Novo Basquete Brasil)
- **LDB** (Liga de Desenvolvimento de Basquete)
- **Liga Ouro**
## Installing
### Via `pip`
This library was written as an exercise for creating my first PyPi package. Hopefully you will find it valuable!
Install with the following command:
```
pip install nbb-api
```
## Documentation
For documentation about the API methods refer to [the documentation](https://github.com/GabrielPastorello/nbb_api/blob/main/API.md).
## Example of use
```
from nbb_api import nbb
```
```
nbb.get_stats('2022-23','regular','cestinhas').head()
```
Output:
| | Jogador | Equipe | JO | Min | Pts | 3P | 2P | LL | Camisa | Temporada |
| --- | ------------- | --------------- | -- | ----- | ----- | ------- | ----- | ---- | ------ | --------- |
| 0 | McClanahan | Fortaleza B. C. | 27 | 34.11 | 20.89 | 6.11 | 10.89 | 3.89 | 22 | 2022-23 |
| 1 | Antonio | UNIFACISA | 26 | 31.74 | 17.96 | 6.00 | 8.85 | 3.12 | 11 | 2022-23 |
| 2 | Thomas | Corinthians | 27 | 32.13 | 17.67 | 5.44 | 8.15 | 4.07 | 0 | 2022-23 |
| 3 | Lucas Mariano | Sesi Franca | 22 | 27.41 | 17.59 | 7.23 | 7.64 | 2.73 | 28 | 2022-23 |
| 4 | Lucas Dias | Sesi Franca | 20 | 30.65 | 17.50 | 5.85 | 8.60 | 3.05 | 9 | 2022-23 |
Use it wisely!
Raw data
{
"_id": null,
"home_page": "https://github.com/GabrielPastorello/nbb_api",
"name": "nbb-api",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6",
"maintainer_email": "",
"keywords": "nbb,novo basquete brasil,scraper,basketball,international basketball,brazil,ldb,liga-ouro",
"author": "Gabriel Speranza Pastorello",
"author_email": "gabriel.pastorello01@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/87/c1/b17e1a2069d9059834332927361862c2ef2c982333595eba75003912031c/nbb_api-0.1.5.tar.gz",
"platform": null,
"description": "<p align=\"center\">\r\n<img src=\"https://user-images.githubusercontent.com/57769272/224566374-c8c748c7-c663-489f-8b98-d7041ab4092a.png\" width=\"150\">\r\n</p>\r\n<p align=\"center\">\r\n <a href=\"https://pypi.org/project/nbb-api/\">\r\n <img src=\"https://img.shields.io/pypi/v/nbb-api\" alt=\"pypi\" />\r\n </a>\r\n <a href=\"https://pypi.org/project/nbb-api/\">\r\n <img src=\"https://img.shields.io/pypi/pyversions/nbb-api\" alt=\"python version\" />\r\n </a>\r\n <a href=\"https://pypi.org/project/nbb-api/\">\r\n <img src=\"https://img.shields.io/pypi/l/nbb-api\" alt=\"license\" />\r\n </a>\r\n</p>\r\n\r\n# nbb_api\r\n\r\nPython package for easy access to Brazilian basketball data through scraping of [LNB](https://lnb.com.br/) website.\r\n\r\nThis allows users to obtain statistics, standings, and scores for various seasons and phases of the following tournaments:\r\n- **NBB** (Novo Basquete Brasil)\r\n- **LDB** (Liga de Desenvolvimento de Basquete)\r\n- **Liga Ouro**\r\n\r\n## Installing\r\n### Via `pip`\r\nThis library was written as an exercise for creating my first PyPi package. Hopefully you will find it valuable!\r\nInstall with the following command:\r\n\r\n```\r\npip install nbb-api\r\n```\r\n\r\n## Documentation\r\nFor documentation about the API methods refer to [the documentation](https://github.com/GabrielPastorello/nbb_api/blob/main/API.md).\r\n\r\n## Example of use\r\n```\r\nfrom nbb_api import nbb\r\n```\r\n\r\n```\r\nnbb.get_stats('2022-23','regular','cestinhas').head()\r\n```\r\nOutput:\r\n| | Jogador | Equipe | JO | Min | Pts | 3P | 2P | LL | Camisa | Temporada |\r\n| --- | ------------- | --------------- | -- | ----- | ----- | ------- | ----- | ---- | ------ | --------- |\r\n| 0 | McClanahan | Fortaleza B. C. | 27 | 34.11 | 20.89 | 6.11 | 10.89 | 3.89 | 22 | 2022-23 |\r\n| 1 | Antonio | UNIFACISA | 26 | 31.74 | 17.96 | 6.00 | 8.85 | 3.12 | 11 | 2022-23 |\r\n| 2 | Thomas | Corinthians | 27 | 32.13 | 17.67 | 5.44 | 8.15 | 4.07 | 0 | 2022-23 |\r\n| 3 | Lucas Mariano | Sesi Franca | 22 | 27.41 | 17.59 | 7.23 | 7.64 | 2.73 | 28 | 2022-23 |\r\n| 4 | Lucas Dias | Sesi Franca | 20 | 30.65 | 17.50 | 5.85 | 8.60 | 3.05 | 9 | 2022-23 |\r\n\r\nUse it wisely!\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Python package for easy access to Brazilian basketball data: NBB (Novo Basquete Brasil), Liga Ouro and LDB",
"version": "0.1.5",
"project_urls": {
"Homepage": "https://github.com/GabrielPastorello/nbb_api"
},
"split_keywords": [
"nbb",
"novo basquete brasil",
"scraper",
"basketball",
"international basketball",
"brazil",
"ldb",
"liga-ouro"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c456327825fcbaec88fc2d447bc1da56e347d22c42c141cf45e544acf52faf4e",
"md5": "06912dd3e2541bb18463a2119786fabd",
"sha256": "6f7e75e0af49aa668d0174f074de76d0296114d9df1a3116b2882d7651f4b2be"
},
"downloads": -1,
"filename": "nbb_api-0.1.5-py3-none-any.whl",
"has_sig": false,
"md5_digest": "06912dd3e2541bb18463a2119786fabd",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6",
"size": 7265,
"upload_time": "2023-08-27T20:19:46",
"upload_time_iso_8601": "2023-08-27T20:19:46.703312Z",
"url": "https://files.pythonhosted.org/packages/c4/56/327825fcbaec88fc2d447bc1da56e347d22c42c141cf45e544acf52faf4e/nbb_api-0.1.5-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "87c1b17e1a2069d9059834332927361862c2ef2c982333595eba75003912031c",
"md5": "2e8cde4842d4bc8df908d7de83a65b63",
"sha256": "c0b46d0248c7e356fbd01fe2110e8f3d776861e8d91b3baa84edafa1fedfa071"
},
"downloads": -1,
"filename": "nbb_api-0.1.5.tar.gz",
"has_sig": false,
"md5_digest": "2e8cde4842d4bc8df908d7de83a65b63",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6",
"size": 5325,
"upload_time": "2023-08-27T20:19:49",
"upload_time_iso_8601": "2023-08-27T20:19:49.062053Z",
"url": "https://files.pythonhosted.org/packages/87/c1/b17e1a2069d9059834332927361862c2ef2c982333595eba75003912031c/nbb_api-0.1.5.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-27 20:19:49",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "GabrielPastorello",
"github_project": "nbb_api",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"lcname": "nbb-api"
}
JSON
