PyPI - ghost-tdf-predictor - Versions diffs - 0.6.0__tar.gz - Mend

ghost-tdf-predictor 0.6.0__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (276) hide show

ghost_tdf_predictor-0.6.0/.cz.yaml ADDED Viewed

@@ -0,0 +1,64 @@
+commitizen:
+  name: cz_customize
+  version_provider: uv
+  version_scheme: semver
+  major_version_zero: true
+  update_changelog_on_bump: true
+  tag_format: v$version
+  bump_message: ":ghost: chore: release v$current_version -> v$new_version [skip ci]"
+  customize:
+    bump_map:
+      Break: MAJOR
+      break: MAJOR
+      Feature: MINOR
+      feature: MINOR
+      Fix: PATCH
+      fix: PATCH
+      Bug: PATCH
+      bug: PATCH
+    bump_pattern: '(feature|fix|bug|break|Feature|Fix|Bug|Break)/[A-Z]{3}-\d{5}'
+    commit_parser: '.*?(?P<change_type>feature|fix|bug|break|Feature|Fix|Bug|Break)/[A-Z]{3}-\d{5}: (?P<message>.*)'
+    change_type_map:
+      Break: "Breaking Changes"
+      break: "Breaking Changes"
+      Feature: "Features"
+      feature: "Features"
+      Fix: "Bug Fixes"
+      fix: "Bug Fixes"
+      Bug: "Bug Fixes"
+      bug: "Bug Fixes"
+    change_type_order:
+      - break
+      - Break
+      - feature
+      - Feature
+      - fix
+      - Fix
+      - bug
+      - Bug
+    changelog_pattern: '.*(feature|fix|bug|break|Feature|Fix|Bug|Break)/[A-Z]{3}-\d{5}'
+    example: '👻 feature/TJP-00001: implement sovereign automation'
+    message_template: '{{change_type}}: {{message}}'
+    questions:
+      - name: change_type
+        type: list
+        message: Select the type of change you are committing
+        choices:
+          - {name: "break:   A breaking change", value: break}
+          - {name: "feature: A new feature", value: feature}
+          - {name: "fix:     A standard fix", value: fix}
+          - {name: "bug:     A specific bug fix", value: bug}
+      - name: message
+        type: input
+        message: "Enter a brief description:"
+    schema: '<type>/<ticket>: <body>'
+    schema_pattern: '^.*(feature|fix|bug|break|Feature|Fix|Bug|Break)/[A-Z]{3}-\d{5}: (.*)'

ghost_tdf_predictor-0.6.0/.env.example ADDED Viewed

@@ -0,0 +1,10 @@
+# ghost-tdf-predictor
+# Copy to .env and fill in real values. Never commit .env.
+# Tissot fantasy scraper (src/tissot_riders.py)
+TISSOT_USER=
+TISSOT_PASS=
+# Data paths
+DATA_DIR=./data
+PREDICTIONS_OUTPUT=./predictions.json

ghost_tdf_predictor-0.6.0/.gitea/CODEOWNERS.md ADDED Viewed

	@@ -0,0 +1 @@
1	+ * @thomaspeoples

ghost_tdf_predictor-0.6.0/.gitea/PULL_REQUEST_TEMPLATE.md ADDED Viewed

@@ -0,0 +1,30 @@
+# 👻 Ghost Stack Pull Request
+## 🎯 Purpose
+_What are we haunting today? Briefly describe the change._
+**Fixes:** # (Link the Gitea Issue here)
+---
+## 🛠️ Proposed Changes
+- [ ] Logic updated in `src/`
+- [ ] Dependencies synced via `uv lock`
+---
+## 🚦 Quality Gate (The Ghost Protocol)
+- [ ] **uv Sync:** Environment is healthy and `uv.lock` is up to date.
+- [ ] **Tests:** `./bin/run_tests.sh` passes with >80% coverage.
+- [ ] **Linting:** `pre-commit run --all-files` passes.
+- [ ] **Commits:** Messages follow the `cz_customize` regex (Fix/Feature/Break).
+---
+## 🧪 Deployment & Verification
+- [ ] Branch is synced with the latest `main`.
+---
+## 👤 Author's Final Word
+_Any specific notes for the reviewer or warnings about breaking changes?_

ghost_tdf_predictor-0.6.0/.gitea/workflows/pages.yml ADDED Viewed

@@ -0,0 +1,59 @@
+name: Deploy Gitea Pages
+on:
+  workflow_dispatch:
+  push:
+    branches:
+      - main
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          version: "latest"
+      - name: Install dependencies
+        run: uv sync --extra dev
+      - name: Run Tests & Coverage
+        run: uv run pytest --cov=src --cov-report=xml
+      - name: Generate Coverage Badge
+        run: uv run genbadge coverage -i coverage.xml -o docs/coverage.svg
+      - name: Build Documentation
+        run: uv run mkdocs build
+      - name: Sync to Main Website Repo
+        env:
+          MY_TOKEN: ${{ secrets.GITEATOKEN }}
+          MY_URL: ${{ secrets.GITEAURL }}
+        run: |
+          # 1. Clone your main website repo
+          CLEAN_URL=${MY_URL#*//}
+          git clone https://${MY_TOKEN}@${CLEAN_URL}/thomaspeoples/ghost-site.git main_site
+          # 2. Create the target directory if it doesn't exist
+          TARGET_DIR="main_site/www/gitea-repos/ghost-tdf-predictor"
+          mkdir -p $TARGET_DIR
+          # 3. Clean and Copy
+          rm -rf $TARGET_DIR/*
+          cp -r site/* $TARGET_DIR/
+          # 4. Commit and Push to the OTHER repo
+          cd main_site
+          git config user.name "Ghost Runner"
+          git config user.email "runner@ghost-stack.local"
+          git add .
+          if git diff --staged --quiet; then
+            echo "No changes to documentation. Skipping commit."
+          else
+            git commit -m ":books: main: Update docs for ghost-tdf-predictor: ${{ gitea.sha }}"
+            git push origin main
+          fi

ghost_tdf_predictor-0.6.0/.gitea/workflows/release.yml ADDED Viewed

@@ -0,0 +1,23 @@
+name: 'Sovereign Release'
+on:
+  push:
+    branches:
+      - main
+jobs:
+  release:
+    if: "!contains(github.event.head_commit.message, '[skip ci]')"
+    runs-on: ghost-runner
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.GITEA_TOKEN }}
+      - name: Run Ghost Bump
+        uses: https://git.thomaspeoples.com/thomaspeoples/ci-actions/version-bump@main
+        with:
+          gitea_token: ${{ secrets.giteatoken }}
+          api_url: "${{ secrets.giteaurl }}/api/v1"

ghost_tdf_predictor-0.6.0/.gitea/workflows/test.yml ADDED Viewed

@@ -0,0 +1,35 @@
+name: TDF Predictor CI
+on:
+  push:
+    branches-ignore:
+      - 'main'
+jobs:
+  test-and-verify:
+    runs-on: ghost-runner
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      - name: Install dependencies
+        run: uv sync --extra dev
+      - name: Run Tests
+        run: |
+          chmod +x bin/run_tests.sh
+          ./bin/run_tests.sh
+        env:
+          PYTHONPATH: .
+  auto-merge:
+    needs: test-and-verify
+    if: github.ref != 'refs/heads/main'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Call Central Merge Action
+        uses: https://git.thomaspeoples.com/thomaspeoples/ci-actions/auto-merge@main
+        with:
+          gitea_token: ${{ secrets.giteatoken }}
+          api_url: "${{ secrets.giteaurl }}/api/v1"

ghost_tdf_predictor-0.6.0/.gitignore ADDED Viewed

@@ -0,0 +1,30 @@
+.uv/
+__pycache__/
+*.py[cod]
+*.so
+build/
+dist/
+*.egg-info/
+.eggs/
+htmlcov/
+.coverage
+.coverage.*
+.cache
+.pytest_cache/
+.tox/
+.venv
+venv/
+env/
+ENV/
+.env
+.env.private
+/site
+.mypy_cache/
+.ruff_cache/
+*.db
+*.sqlite3
+src/debug/
+# Claude Code
+CLAUDE.md
+.claude/

ghost_tdf_predictor-0.6.0/.pre-commit-config.yaml ADDED Viewed

@@ -0,0 +1,58 @@
+repos:
+-   repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+    -   id: trailing-whitespace
+    -   id: end-of-file-fixer
+    -   id: check-yaml
+        exclude: mkdocs.yml
+    -   id: check-toml
+    -   id: check-json
+    -   id: check-added-large-files
+    -   id: check-merge-conflict
+    -   id: check-case-conflict
+    -   id: debug-statements
+    -   id: check-executables-have-shebangs
+    -   id: check-shebang-scripts-are-executable
+-   repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.15.20
+    hooks:
+    -   id: ruff-check
+        args: [--fix]
+    -   id: ruff-format
+-   repo: https://github.com/codespell-project/codespell
+    rev: v2.4.1
+    hooks:
+    -   id: codespell
+        exclude: uv.lock|\.secrets\.baseline
+        # rider surnames are not typos (Paret-Peintre)
+        args: [-L, "paret"]
+-   repo: https://github.com/astral-sh/uv-pre-commit
+    rev: 0.11.26
+    hooks:
+    -   id: uv-lock
+-   repo: https://github.com/Yelp/detect-secrets
+    rev: v1.5.0
+    hooks:
+    -   id: detect-secrets
+        args: ['--baseline', '.secrets.baseline']
+        exclude: uv.lock
+-   repo: local
+    hooks:
+    -   id: pytest-coverage
+        name: pytest-coverage
+        entry: ./bin/run_tests.sh
+        language: system
+        pass_filenames: false
+        always_run: true
+    -   id: commitizen
+        name: commitizen check
+        entry: uv run cz check --commit-msg-file
+        language: system
+        stages: [commit-msg]

ghost_tdf_predictor-0.6.0/.secrets.baseline ADDED Viewed

@@ -0,0 +1,127 @@
+{
+  "version": "1.5.0",
+  "plugins_used": [
+    {
+      "name": "ArtifactoryDetector"
+    },
+    {
+      "name": "AWSKeyDetector"
+    },
+    {
+      "name": "AzureStorageKeyDetector"
+    },
+    {
+      "name": "Base64HighEntropyString",
+      "limit": 4.5
+    },
+    {
+      "name": "BasicAuthDetector"
+    },
+    {
+      "name": "CloudantDetector"
+    },
+    {
+      "name": "DiscordBotTokenDetector"
+    },
+    {
+      "name": "GitHubTokenDetector"
+    },
+    {
+      "name": "GitLabTokenDetector"
+    },
+    {
+      "name": "HexHighEntropyString",
+      "limit": 3.0
+    },
+    {
+      "name": "IbmCloudIamDetector"
+    },
+    {
+      "name": "IbmCosHmacDetector"
+    },
+    {
+      "name": "IPPublicDetector"
+    },
+    {
+      "name": "JwtTokenDetector"
+    },
+    {
+      "name": "KeywordDetector",
+      "keyword_exclude": ""
+    },
+    {
+      "name": "MailchimpDetector"
+    },
+    {
+      "name": "NpmDetector"
+    },
+    {
+      "name": "OpenAIDetector"
+    },
+    {
+      "name": "PrivateKeyDetector"
+    },
+    {
+      "name": "PypiTokenDetector"
+    },
+    {
+      "name": "SendGridDetector"
+    },
+    {
+      "name": "SlackDetector"
+    },
+    {
+      "name": "SoftlayerDetector"
+    },
+    {
+      "name": "SquareOAuthDetector"
+    },
+    {
+      "name": "StripeDetector"
+    },
+    {
+      "name": "TelegramBotTokenDetector"
+    },
+    {
+      "name": "TwilioKeyDetector"
+    }
+  ],
+  "filters_used": [
+    {
+      "path": "detect_secrets.filters.allowlist.is_line_allowlisted"
+    },
+    {
+      "path": "detect_secrets.filters.common.is_ignored_due_to_verification_policies",
+      "min_level": 2
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_indirect_reference"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_likely_id_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_lock_file"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_not_alphanumeric_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_potential_uuid"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_prefixed_with_dollar_sign"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_sequential_string"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_swagger_file"
+    },
+    {
+      "path": "detect_secrets.filters.heuristic.is_templated_secret"
+    }
+  ],
+  "results": {},
+  "generated_at": "2026-07-02T12:34:25Z"
+}

ghost_tdf_predictor-0.6.0/CHANGELOG.md ADDED Viewed

@@ -0,0 +1,50 @@
+# Changelog
+All notable changes to this project are documented here. Generated by
+commitizen on version bump.
+## v0.6.0 (2026-07-05)
+### Bug Fixes
+- Stage teams stay ex-ante on raced stages for pred-vs-actual grading' (#5) from feature/TJP-05071 into main
+- Stage teams stay ex-ante on raced stages for pred-vs-actual grading
+- Restore cloudscraper, procyclingstats needs it behind Cloudflare
+- Empty hand picks, stage-2 riders stay model-driven
+- Delete dead forest code, cloudscraper and sklearn extras per ponytail audit
+### Features
+- Breakaway hand picks, stage-2 actuals, same-day raced fix
+- Blend prior-TDF into predictions, in-tour form updating with DNF zeroing, hand-pick overlay and display names
+- Three weight schemes with overlay, per-stage knapsack teams, jersey predictions and client-side transfer planner
+## v0.5.0 (2026-07-05)
+### Features
+- Updated model for actual fantasy scoring over ProCyclingStats points' (#4) from feature/TJP-04075 into main
+- Updated model for actual fantasy scoring over ProCyclingStats points
+## v0.4.0 (2026-07-04)
+### Features
+- Added random forest for some reason' (#3) from feature/TJP-04074 into main
+- Added random forest for some reason
+## v0.3.0 (2026-07-04)
+### Features
+- Full rider data.json output' (#2) from feature/TJP-04073 into main
+- Full rider data.json output
+## v0.2.0 (2026-07-04)
+### Features
+- Removed playwright from dev deps' (#1) from feature/TJP-04071 into main
+- Removed playwright from dev deps
+- Removed playwright from dev deps
+- Initial commit

ghost_tdf_predictor-0.6.0/CODEOWNERS.md ADDED Viewed

	@@ -0,0 +1 @@
1	+ * @thomaspeoples

ghost_tdf_predictor-0.6.0/CONTRIBUTING.md ADDED Viewed

@@ -0,0 +1,60 @@
+# Contributing to ghost-tdf-predictor
+## Prerequisites
+- Python 3.12+
+- [`uv`](https://docs.astral.sh/uv/) for dependency management
+## Setup
+```bash
+git clone https://git.thomaspeoples.com/thomaspeoples/ghost-tdf-predictor.git
+cd ghost-tdf-predictor
+uv run poe setup
+```
+This syncs all dependencies and installs pre-commit hooks.
+## Running tests
+```bash
+uv run poe test
+```
+Coverage must stay above 80%. The suite runs without any external services.
+## Code style
+Ruff handles formatting and linting:
+```bash
+uv run poe lint
+uv run poe format
+```
+Line length is 79 characters.
+## Commits
+Commits follow the Ghost Stack convention via commitizen:
+```
+👻 <type>/<ticket>: <message>
+```
+```bash
+uv run cz commit
+```
+Do not bypass pre-commit hooks with `--no-verify`.
+## Pull requests
+- One concern per PR.
+- Include or update tests for any behaviour change.
+- Run the full pre-commit suite before opening: `uv run pre-commit run --all-files`.
+## Reporting issues
+Open a Gitea issue with the input data (anonymised if needed) and the exact
+command you ran.

ghost_tdf_predictor-0.6.0/LICENSE ADDED Viewed

@@ -0,0 +1,21 @@
+MIT License
+Copyright (c) 2026 Thomas Peoples
+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.

ghost_tdf_predictor-0.6.0/PKG-INFO ADDED Viewed

@@ -0,0 +1,112 @@
+Metadata-Version: 2.4
+Name: ghost-tdf-predictor
+Version: 0.6.0
+Summary: Tour de France race outcome prediction for the Ghost Stack.
+Project-URL: Homepage, https://git.thomaspeoples.com/thomaspeoples/ghost-tdf-predictor
+Project-URL: Repository, https://git.thomaspeoples.com/thomaspeoples/ghost-tdf-predictor.git
+Project-URL: Documentation, https://www.thomaspeoples.com/gitea-repos/ghost-tdf-predictor/
+Project-URL: Issues, https://git.thomaspeoples.com/thomaspeoples/ghost-tdf-predictor/issues
+Project-URL: Changelog, https://git.thomaspeoples.com/thomaspeoples/ghost-tdf-predictor/src/branch/main/CHANGELOG.md
+Author-email: Thomas Peoples <hello@thomaspeoples.com>
+License: MIT License
+        Copyright (c) 2026 Thomas Peoples
+        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.
+License-File: LICENSE
+Keywords: cycling,ghost-stack,prediction,tour-de-france
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.12
+Requires-Dist: cloudscraper>=1.2.71
+Requires-Dist: procyclingstats>=0.2.8
+Provides-Extra: dev
+Requires-Dist: commitizen; extra == 'dev'
+Requires-Dist: detect-secrets; extra == 'dev'
+Requires-Dist: genbadge[coverage]>=1.1.1; extra == 'dev'
+Requires-Dist: mkdocs; extra == 'dev'
+Requires-Dist: mkdocs-material; extra == 'dev'
+Requires-Dist: mkdocstrings[python]; extra == 'dev'
+Requires-Dist: poethepoet; extra == 'dev'
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: pydoc-markdown; extra == 'dev'
+Requires-Dist: pymdown-extensions; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Requires-Dist: ty; extra == 'dev'
+Requires-Dist: typer; extra == 'dev'
+Provides-Extra: scrape
+Requires-Dist: playwright>=1.40; extra == 'scrape'
+Description-Content-Type: text/markdown
+# ghost-tdf-predictor 🚴💨
+Who cracks the top 10 in July? Six seasons of ProCyclingStats results,
+a from-scratch model, and a Tissot fantasy team picked by exact
+knapsack — all in pure Python. No torch, no sklearn, no 200 MB wheel
+for a model with nine weights.
+The 2026 hot take so far: Pogačar. Groundbreaking stuff.
+## What it does
+- **Scrapes** grand tours, one-week stage races, monuments and top
+  classics (men's elite, 2021–2026) into SQLite
+- **Clusters** riders into archetypes with hand-rolled k-means
+- **Predicts** top-10 finishes with class-weighted logistic regression
+  (test AUC ~0.89 — form really is everything in cycling)
+- **Picks** a 10-rider, 120-star Tissot fantasy team via 0/1 knapsack
+  with cardinality, backtested leave-one-year-out against the
+  hindsight-optimal team
+## Run it
+```bash
+uv run poe setup                        # once
+uv run python -m tdf_predictor.ingest   # scrape PCS -> data/raw/*.json
+uv run python -m tdf_predictor.db       # load -> data/races.db (SQLite)
+uv run python -m tdf_predictor.model    # archetypes + top-10 model
+uv run python -m tdf_predictor.fantasy  # backtest + 2026 team pick
+docker compose up -d                    # browse the DB at :8080
+```
+Outputs land in `data/`: `archetypes.json`, `model.json`, and a
+printed team that will absolutely not win your league.
+Where the data comes from (and how politely it's scraped):
+[docs/SOURCES.md](docs/SOURCES.md).
+## Hacking on it
+```bash
+uv run poe test         # pytest, coverage >80% enforced
+uv run poe tidy         # ruff lint + format
+uv run poe docs-serve   # MkDocs on :8000
+uv run cz commit        # commits go through commitizen, no exceptions
+```
+Full workflow in [CONTRIBUTING.md](CONTRIBUTING.md).
+## License
+MIT — see [LICENSE](LICENSE).