| Name | bball JSON |
| Version |
0.1.2
JSON |
| download |
| home_page | None |
| Summary | NBA analytics platform with core models and utilities |
| upload_time | 2025-10-22 00:57:13 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.13 |
| license | None |
| keywords |
analytics
basketball
data
nba
sports
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# bball
Comprehensive NBA analytics platform for Python.
## Features
- **Core Models** - Pydantic models for Players, Teams, Games, and Stats
- **Advanced Analytics** - Calculate true shooting %, PER, win shares, and more
- **Data Fetching** - Integration with NBA stats API
- **CLI Tools** - Command-line interface for quick analysis
- **API Server** - REST and GraphQL endpoints for your applications
- **Reporting** - Generate visualizations and reports
- **Type Safe** - Full type hints and runtime validation
## Installation
```bash
# Install everything
pip install bball[all]
# Or install specific components
pip install bball # Just core models and utilities
pip install bball[cli] # Core + CLI
pip install bball[analytics] # Core + data, strategies, reports
pip install bball[api] # Core + API server
```
## Quick Start
```python
from bball import Player, Team, Game, Stats
# Create a player
player = Player(
id="203999",
name="Nikola Jokic",
team_id="DEN",
position="C",
height=83,
weight=284,
jersey_number=15
)
# Work with stats
from bball import calculate_advanced_stats
stats = Stats(
points=25.0,
rebounds=12.0,
assists=9.0,
field_goals_made=10,
field_goals_attempted=18,
# ... more stats
)
advanced = calculate_advanced_stats(stats)
print(f"True Shooting %: {advanced['true_shooting_pct']:.3f}")
```
## Package Ecosystem
The bball ecosystem consists of a core package and optional extensions:
| Package | Description | Install |
| -------------------- | ----------------------------------- | ------------------------------- |
| **bball** | Core models and utilities | `pip install bball` |
| **bball-cli** | Command-line interface | `pip install bball[cli]` |
| **bball-api** | REST/GraphQL API server | `pip install bball[api]` |
| **bball-data** | Data fetching and processing | `pip install bball[data]` |
| **bball-strategies** | Analysis strategies and ML models | `pip install bball[strategies]` |
| **bball-reports** | Report generation and visualization | `pip install bball[reports]` |
## CLI Usage
```bash
# After installing bball[cli]
bball info # Show installed components
bball version # Show version information
```
## Development
This project uses modern Python tooling and requires Python 3.13+.
```bash
# Clone the repository
git clone https://github.com/bball-dev/bball.git
cd bball
# Install uv package manager
curl -LsSf https://astral.sh/uv/install.sh | sh
# Install all packages in development mode
# This automatically installs Python 3.13 and all dependencies
uv sync --all-packages
# Run tests
uv run pytest
# Run code quality checks
uv run ruff check src/ packages/
uv run ruff format src/ packages/
uv run pyright src/ packages/
```
For detailed development documentation, see [docs/development.md](docs/development.md).
## Documentation
- [Development Guide](docs/development.md) - Complete guide for contributors
- [API Documentation](https://docs.bball.dev) - Full API reference
- [Examples](https://docs.bball.dev/examples) - Usage examples and tutorials
## Contributing
Contributions are welcome! Please see our [development guide](docs/development.md) for:
- Architecture overview
- Development workflow
- Testing strategy
- Publishing process
### Quick Contribution Guide
1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-feature`)
3. Make your changes
4. Run tests and quality checks (`uv run pytest && uv run ruff check`)
5. Commit your changes (`git commit -m 'Add amazing feature'`)
6. Push to your branch (`git push origin feature/amazing-feature`)
7. Open a Pull Request
## Requirements
- Python 3.13+
- See `pyproject.toml` for package-specific dependencies
## Links
- **Homepage:** https://bball.dev
- **Documentation:** https://docs.bball.dev
- **Repository:** https://github.com/bball-dev/bball
- **Issue Tracker:** https://github.com/bball-dev/bball/issues
- **PyPI:** https://pypi.org/project/bball/
## Credits
Built with:
- [uv](https://docs.astral.sh/uv/) - Fast Python package manager
- [Pydantic](https://docs.pydantic.dev/) - Data validation
- [FastAPI](https://fastapi.tiangolo.com/) - API framework
- [Typer](https://typer.tiangolo.com/) - CLI framework
Raw data
{
"_id": null,
"home_page": null,
"name": "bball",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.13",
"maintainer_email": null,
"keywords": "analytics, basketball, data, nba, sports",
"author": null,
"author_email": "Nicholas Cooper <nicholascullencooper@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/b1/dd/15594c260cbf212d38c8b91cc9fe6d2ca85b58ede29be2df14355cb22f76/bball-0.1.2.tar.gz",
"platform": null,
"description": "# bball\n\nComprehensive NBA analytics platform for Python.\n\n## Features\n\n- **Core Models** - Pydantic models for Players, Teams, Games, and Stats\n- **Advanced Analytics** - Calculate true shooting %, PER, win shares, and more\n- **Data Fetching** - Integration with NBA stats API\n- **CLI Tools** - Command-line interface for quick analysis\n- **API Server** - REST and GraphQL endpoints for your applications\n- **Reporting** - Generate visualizations and reports\n- **Type Safe** - Full type hints and runtime validation\n\n## Installation\n\n```bash\n# Install everything\npip install bball[all]\n\n# Or install specific components\npip install bball # Just core models and utilities\npip install bball[cli] # Core + CLI\npip install bball[analytics] # Core + data, strategies, reports\npip install bball[api] # Core + API server\n```\n\n## Quick Start\n\n```python\nfrom bball import Player, Team, Game, Stats\n\n# Create a player\nplayer = Player(\n id=\"203999\",\n name=\"Nikola Jokic\",\n team_id=\"DEN\",\n position=\"C\",\n height=83,\n weight=284,\n jersey_number=15\n)\n\n# Work with stats\nfrom bball import calculate_advanced_stats\n\nstats = Stats(\n points=25.0,\n rebounds=12.0,\n assists=9.0,\n field_goals_made=10,\n field_goals_attempted=18,\n # ... more stats\n)\n\nadvanced = calculate_advanced_stats(stats)\nprint(f\"True Shooting %: {advanced['true_shooting_pct']:.3f}\")\n```\n\n## Package Ecosystem\n\nThe bball ecosystem consists of a core package and optional extensions:\n\n| Package | Description | Install |\n| -------------------- | ----------------------------------- | ------------------------------- |\n| **bball** | Core models and utilities | `pip install bball` |\n| **bball-cli** | Command-line interface | `pip install bball[cli]` |\n| **bball-api** | REST/GraphQL API server | `pip install bball[api]` |\n| **bball-data** | Data fetching and processing | `pip install bball[data]` |\n| **bball-strategies** | Analysis strategies and ML models | `pip install bball[strategies]` |\n| **bball-reports** | Report generation and visualization | `pip install bball[reports]` |\n\n## CLI Usage\n\n```bash\n# After installing bball[cli]\nbball info # Show installed components\nbball version # Show version information\n```\n\n## Development\n\nThis project uses modern Python tooling and requires Python 3.13+.\n\n```bash\n# Clone the repository\ngit clone https://github.com/bball-dev/bball.git\ncd bball\n\n# Install uv package manager\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Install all packages in development mode\n# This automatically installs Python 3.13 and all dependencies\nuv sync --all-packages\n\n# Run tests\nuv run pytest\n\n# Run code quality checks\nuv run ruff check src/ packages/\nuv run ruff format src/ packages/\nuv run pyright src/ packages/\n```\n\nFor detailed development documentation, see [docs/development.md](docs/development.md).\n\n## Documentation\n\n- [Development Guide](docs/development.md) - Complete guide for contributors\n- [API Documentation](https://docs.bball.dev) - Full API reference\n- [Examples](https://docs.bball.dev/examples) - Usage examples and tutorials\n\n## Contributing\n\nContributions are welcome! Please see our [development guide](docs/development.md) for:\n- Architecture overview\n- Development workflow\n- Testing strategy\n- Publishing process\n\n### Quick Contribution Guide\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Make your changes\n4. Run tests and quality checks (`uv run pytest && uv run ruff check`)\n5. Commit your changes (`git commit -m 'Add amazing feature'`)\n6. Push to your branch (`git push origin feature/amazing-feature`)\n7. Open a Pull Request\n\n## Requirements\n\n- Python 3.13+\n- See `pyproject.toml` for package-specific dependencies\n\n## Links\n\n- **Homepage:** https://bball.dev\n- **Documentation:** https://docs.bball.dev\n- **Repository:** https://github.com/bball-dev/bball\n- **Issue Tracker:** https://github.com/bball-dev/bball/issues\n- **PyPI:** https://pypi.org/project/bball/\n\n## Credits\n\nBuilt with:\n- [uv](https://docs.astral.sh/uv/) - Fast Python package manager\n- [Pydantic](https://docs.pydantic.dev/) - Data validation\n- [FastAPI](https://fastapi.tiangolo.com/) - API framework\n- [Typer](https://typer.tiangolo.com/) - CLI framework\n",
"bugtrack_url": null,
"license": null,
"summary": "NBA analytics platform with core models and utilities",
"version": "0.1.2",
"project_urls": {
"Documentation": "https://docs.bball.dev",
"Homepage": "https://bball.dev",
"Issues": "https://github.com/bball-dev/bball/issues",
"Repository": "https://github.com/bball-dev/bball"
},
"split_keywords": [
"analytics",
" basketball",
" data",
" nba",
" sports"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "8541d3d6659e9aa3a9149eafaa1ef01fae62685355f064559a5e25a1d6dd5f3e",
"md5": "0ffe9a9e256bffdc7e976e3c24787275",
"sha256": "f9de6841dfeed97a753a7a851ad826129126669ca7f61abdd35fec9969556c11"
},
"downloads": -1,
"filename": "bball-0.1.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0ffe9a9e256bffdc7e976e3c24787275",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.13",
"size": 5532,
"upload_time": "2025-10-22T00:57:12",
"upload_time_iso_8601": "2025-10-22T00:57:12.877100Z",
"url": "https://files.pythonhosted.org/packages/85/41/d3d6659e9aa3a9149eafaa1ef01fae62685355f064559a5e25a1d6dd5f3e/bball-0.1.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "b1dd15594c260cbf212d38c8b91cc9fe6d2ca85b58ede29be2df14355cb22f76",
"md5": "6612369206412ea0c777e0cba0df7ef5",
"sha256": "e5c05a122197bbc6fd55669daa34716de5f7648b59fa1d5e5a489675d84b5e36"
},
"downloads": -1,
"filename": "bball-0.1.2.tar.gz",
"has_sig": false,
"md5_digest": "6612369206412ea0c777e0cba0df7ef5",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.13",
"size": 8020,
"upload_time": "2025-10-22T00:57:13",
"upload_time_iso_8601": "2025-10-22T00:57:13.629745Z",
"url": "https://files.pythonhosted.org/packages/b1/dd/15594c260cbf212d38c8b91cc9fe6d2ca85b58ede29be2df14355cb22f76/bball-0.1.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-22 00:57:13",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "bball-dev",
"github_project": "bball",
"github_not_found": true,
"lcname": "bball"
}
