fantasyfb 0.3.0__tar.gz

fantasyfb-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Taylor Firman
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fantasyfb-0.3.0/PKG-INFO

@@ -0,0 +1,150 @@
+Metadata-Version: 2.4
+Name: fantasyfb
+Version: 0.3.0
+Summary: Fantasy football league simulation and optimization tool.
+Author-email: Taylor Firman <tefirman@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/tefirman/fantasyfb
+Project-URL: Repository, https://github.com/tefirman/fantasyfb
+Project-URL: Issues, https://github.com/tefirman/fantasyfb/issues
+Keywords: fantasy-football,nfl,simulation,yahoo-fantasy
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: End Users/Desktop
+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.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Games/Entertainment
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas>=2.0
+Requires-Dist: numpy>=1.24
+Requires-Dist: nflreadpy>=0.1.5
+Requires-Dist: pyarrow>=14.0
+Requires-Dist: yahoo-fantasy-api>=2.6
+Requires-Dist: yahoo-oauth>=2.0
+Requires-Dist: openpyxl>=3.1
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: pytz>=2023.3
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Dynamic: license-file
+
+# fantasyfb
+
+Fantasy football league simulation and optimization toolkit. Pulls
+projections from [nflverse](https://github.com/nflverse) data, syncs
+roster state from a Yahoo Fantasy league, and runs Monte Carlo season
+simulations to value pickups, trades, and draft picks.
+
+## Install
+
+```bash
+pip install fantasyfb
+```
+
+For local development:
+
+```bash
+git clone https://github.com/tefirman/fantasyfb.git
+cd fantasyfb
+pip install -e ".[dev]"
+```
+
+Python 3.10+ is required.
+
+## Quickstart
+
+```python
+import fantasyfb as fb
+
+league = fb.League(name="My Team")
+schedule_sim, standings_sim = league.season_sims(postseason=True)
+print(standings_sim[["team", "wins_avg", "playoffs", "winner"]])
+```
+
+`fb.League(name=...)` reads from the Yahoo Fantasy API, so you'll need
+`oauth2.json` (and `.env` with `CONSUMER_KEY` / `CONSUMER_SECRET`) set
+up alongside the script. See the
+[yahoo_oauth docs](https://github.com/josuebrunel/yahoo-oauth) for a
+walkthrough.
+
+## Command-line tools
+
+After install, four entry points are on your PATH:
+
+| Command            | Source                              | Use                                  |
+| ------------------ | ----------------------------------- | ------------------------------------ |
+| `fantasyfb`        | `fantasyfb.league:main`             | Weekly projections + lineup analysis |
+| `snake-draft`      | `fantasyfb.drafts.snake:main`       | Live snake-draft cockpit             |
+| `salary-cap-draft` | `fantasyfb.drafts.salary_cap:main`  | Live salary-cap (auction) draft tool |
+| `draft-prep`       | `fantasyfb.drafts.prep:main`        | Pre-draft tiers / VORP / mocks       |
+
+```bash
+# Weekly run for a team
+fantasyfb --team "My Team" --sims 1000 --adds --drops
+
+# Pre-draft analytics
+draft-prep tiers --team "My Team"
+draft-prep mock --team "My Team" --adp ADP.csv --my-pick 7 --sims 50
+
+# Draft-day cockpit
+snake-draft --team "My Team" --adp ADP.csv
+salary-cap-draft --team "My Team"
+```
+
+Run any command with `--help` for the full option list.
+
+## Public API
+
+```python
+from fantasyfb import (
+    League,                            # main entry point
+    FantasyScorer,                     # scoring rules -> points
+    MatchupModel, ProjectionEngineV2,  # projection internals
+    LineupOptimizer,
+    SeasonSimulator, ScheduleManager,
+    NflreadpyProvider,                 # default data backend
+)
+```
+
+Lower-level utilities live in submodules and can be imported directly:
+
+```python
+from fantasyfb.drafts.tools import compute_vorp, assign_tiers, MockDraft
+from fantasyfb.drafts.snake_cockpit import build_board, view_best
+from fantasyfb.sim.backtest import run_backtest, evaluate
+from fantasyfb.io.excel_exporter import FantasyExcelExporter
+```
+
+| Subpackage              | Purpose                                    |
+| ----------------------- | ------------------------------------------ |
+| `fantasyfb.league`      | Top-level `League` class                   |
+| `fantasyfb.configs`     | League / scoring presets                   |
+| `fantasyfb.drafts`      | Snake, salary-cap, prep, shared draft math |
+| `fantasyfb.data`        | Yahoo client + nflverse providers          |
+| `fantasyfb.scoring`     | Scoring, lineup optimization, matchups     |
+| `fantasyfb.projections` | V1 / V2 projection engines, fitter         |
+| `fantasyfb.sim`         | Season simulation, backtests, schedule     |
+| `fantasyfb.analysis`    | WAR, move analysis                         |
+| `fantasyfb.io`          | Excel export                               |
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest                       # full test suite
+python -m build              # produce sdist + wheel under dist/
+```
+
+The `tests/` directory pulls a small slice of nflverse parquet data on
+first run; subsequent runs are cached locally.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

fantasyfb-0.3.0/README.md

@@ -0,0 +1,113 @@
+# fantasyfb
+
+Fantasy football league simulation and optimization toolkit. Pulls
+projections from [nflverse](https://github.com/nflverse) data, syncs
+roster state from a Yahoo Fantasy league, and runs Monte Carlo season
+simulations to value pickups, trades, and draft picks.
+
+## Install
+
+```bash
+pip install fantasyfb
+```
+
+For local development:
+
+```bash
+git clone https://github.com/tefirman/fantasyfb.git
+cd fantasyfb
+pip install -e ".[dev]"
+```
+
+Python 3.10+ is required.
+
+## Quickstart
+
+```python
+import fantasyfb as fb
+
+league = fb.League(name="My Team")
+schedule_sim, standings_sim = league.season_sims(postseason=True)
+print(standings_sim[["team", "wins_avg", "playoffs", "winner"]])
+```
+
+`fb.League(name=...)` reads from the Yahoo Fantasy API, so you'll need
+`oauth2.json` (and `.env` with `CONSUMER_KEY` / `CONSUMER_SECRET`) set
+up alongside the script. See the
+[yahoo_oauth docs](https://github.com/josuebrunel/yahoo-oauth) for a
+walkthrough.
+
+## Command-line tools
+
+After install, four entry points are on your PATH:
+
+| Command            | Source                              | Use                                  |
+| ------------------ | ----------------------------------- | ------------------------------------ |
+| `fantasyfb`        | `fantasyfb.league:main`             | Weekly projections + lineup analysis |
+| `snake-draft`      | `fantasyfb.drafts.snake:main`       | Live snake-draft cockpit             |
+| `salary-cap-draft` | `fantasyfb.drafts.salary_cap:main`  | Live salary-cap (auction) draft tool |
+| `draft-prep`       | `fantasyfb.drafts.prep:main`        | Pre-draft tiers / VORP / mocks       |
+
+```bash
+# Weekly run for a team
+fantasyfb --team "My Team" --sims 1000 --adds --drops
+
+# Pre-draft analytics
+draft-prep tiers --team "My Team"
+draft-prep mock --team "My Team" --adp ADP.csv --my-pick 7 --sims 50
+
+# Draft-day cockpit
+snake-draft --team "My Team" --adp ADP.csv
+salary-cap-draft --team "My Team"
+```
+
+Run any command with `--help` for the full option list.
+
+## Public API
+
+```python
+from fantasyfb import (
+    League,                            # main entry point
+    FantasyScorer,                     # scoring rules -> points
+    MatchupModel, ProjectionEngineV2,  # projection internals
+    LineupOptimizer,
+    SeasonSimulator, ScheduleManager,
+    NflreadpyProvider,                 # default data backend
+)
+```
+
+Lower-level utilities live in submodules and can be imported directly:
+
+```python
+from fantasyfb.drafts.tools import compute_vorp, assign_tiers, MockDraft
+from fantasyfb.drafts.snake_cockpit import build_board, view_best
+from fantasyfb.sim.backtest import run_backtest, evaluate
+from fantasyfb.io.excel_exporter import FantasyExcelExporter
+```
+
+| Subpackage              | Purpose                                    |
+| ----------------------- | ------------------------------------------ |
+| `fantasyfb.league`      | Top-level `League` class                   |
+| `fantasyfb.configs`     | League / scoring presets                   |
+| `fantasyfb.drafts`      | Snake, salary-cap, prep, shared draft math |
+| `fantasyfb.data`        | Yahoo client + nflverse providers          |
+| `fantasyfb.scoring`     | Scoring, lineup optimization, matchups     |
+| `fantasyfb.projections` | V1 / V2 projection engines, fitter         |
+| `fantasyfb.sim`         | Season simulation, backtests, schedule     |
+| `fantasyfb.analysis`    | WAR, move analysis                         |
+| `fantasyfb.io`          | Excel export                               |
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest                       # full test suite
+python -m build              # produce sdist + wheel under dist/
+```
+
+The `tests/` directory pulls a small slice of nflverse parquet data on
+first run; subsequent runs are cached locally.
+
+## License
+
+MIT. See [LICENSE](LICENSE).

fantasyfb-0.3.0/pyproject.toml

@@ -0,0 +1,60 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "fantasyfb"
+version = "0.3.0"
+description = "Fantasy football league simulation and optimization tool."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [{ name = "Taylor Firman", email = "tefirman@gmail.com" }]
+keywords = ["fantasy-football", "nfl", "simulation", "yahoo-fantasy"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Games/Entertainment",
+]
+dependencies = [
+    "pandas>=2.0",
+    "numpy>=1.24",
+    "nflreadpy>=0.1.5",
+    "pyarrow>=14.0",
+    "yahoo-fantasy-api>=2.6",
+    "yahoo-oauth>=2.0",
+    "openpyxl>=3.1",
+    "python-dotenv>=1.0",
+    "pytz>=2023.3",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.4",
+    "ruff>=0.5",
+    "build>=1.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/tefirman/fantasyfb"
+Repository = "https://github.com/tefirman/fantasyfb"
+Issues = "https://github.com/tefirman/fantasyfb/issues"
+
+[project.scripts]
+fantasyfb = "fantasyfb.league:main"
+snake-draft = "fantasyfb.drafts.snake:main"
+salary-cap-draft = "fantasyfb.drafts.salary_cap:main"
+draft-prep = "fantasyfb.drafts.prep:main"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["fantasyfb*"]

fantasyfb-0.3.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

fantasyfb-0.3.0/src/fantasyfb/__init__.py

@@ -0,0 +1,41 @@
+"""fantasyfb: fantasy football league simulation and optimization toolkit.
+
+Public API
+----------
+The most commonly used entry points are re-exported here so that
+``import fantasyfb as fb`` continues to work after the package
+restructuring (League, FantasyScorer, projection / matchup models, etc.).
+For lower-level helpers, import directly from the relevant submodule:
+
+    from fantasyfb.drafts.tools import compute_vorp, assign_tiers
+    from fantasyfb.sim.backtest import run_backtest
+    from fantasyfb.io.excel_exporter import FantasyExcelExporter
+"""
+
+from .league import League
+from .scoring.fantasy_scoring import FantasyScorer
+from .scoring.matchup_model import MatchupModel
+from .scoring.lineup_optimizer import LineupOptimizer
+from .projections.engine_v2 import ProjectionEngineV2
+from .sim.season_simulator import SeasonSimulator
+from .sim.schedule_manager import ScheduleManager
+from .data.nfl_provider import NFLDataProvider
+from .data.nflreadpy_provider import NflreadpyProvider
+from .configs import get_league_config, apply_default_scoring_categories
+
+__version__ = "0.3.0"
+
+__all__ = [
+    "League",
+    "FantasyScorer",
+    "MatchupModel",
+    "LineupOptimizer",
+    "ProjectionEngineV2",
+    "SeasonSimulator",
+    "ScheduleManager",
+    "NFLDataProvider",
+    "NflreadpyProvider",
+    "get_league_config",
+    "apply_default_scoring_categories",
+    "__version__",
+]

fantasyfb-0.3.0/src/fantasyfb/analysis/__init__.py

@@ -0,0 +1 @@
+"""WAR calculation, move analysis, and post-hoc evaluators."""