Metadata-Version: 2.4
Name: nhl-hut-bigquery
Version: 0.1.1
Summary: EA NHL HUT player ratings → BigQuery snapshots + cross-source resolver to nhl-bigquery
Project-URL: Homepage, https://github.com/blahovec-labs/nhl-hut-bigquery
Project-URL: Issues, https://github.com/blahovec-labs/nhl-hut-bigquery/issues
Author: Jason Blahovec
License: MIT
License-File: LICENSE
Keywords: bigquery,ea-sports,hockey,hut,nhl
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Requires-Dist: beautifulsoup4<5.0,>=4.12
Requires-Dist: db-dtypes<2.0,>=1.0
Requires-Dist: google-cloud-bigquery<4.0,>=3.20
Requires-Dist: pandas<3.0,>=2.0
Requires-Dist: pyarrow<19.0,>=15.0
Requires-Dist: requests<3.0,>=2.31
Requires-Dist: unidecode<2.0,>=1.3
Provides-Extra: dev
Requires-Dist: build>=1.2.0; extra == 'dev'
Requires-Dist: pyright>=1.1.380; extra == 'dev'
Requires-Dist: pytest-cov>=5.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: responses>=0.25; extra == 'dev'
Requires-Dist: ruff>=0.6.0; extra == 'dev'
Description-Content-Type: text/markdown

# nhl-hut-bigquery

EA NHL Ultimate Team player ratings → BigQuery snapshots, with cross-source resolver and coverage metrics linking HUT cards to NHL stats.

## Install

    pip install nhl-hut-bigquery

This package is a sibling to [`nhl-bigquery`](https://pypi.org/project/nhl-bigquery/). Install both for the full experience:

    pip install nhl-bigquery nhl-hut-bigquery

## Quickstart

    gcloud auth application-default login

    # 1. Snapshot today's HUT ratings
    nhl-hut-bigquery sync \
        --table myproject.mydataset.hut_player_ratings

    # 2. Resolve HUT cards to NHL player_ids (requires nhl-bigquery's boxscore_stats)
    nhl-hut-bigquery resolve-ids \
        --xref-table myproject.mydataset.hut_player_xref \
        --hut-table myproject.mydataset.hut_player_ratings \
        --nhl-boxscore-table myproject.mydataset.boxscore_stats \
        --season 2024

    # 3. How much of NHL ice-time is covered by today's HUT snapshot?
    nhl-hut-bigquery verify \
        --aggregation hut-coverage \
        --xref-table myproject.mydataset.hut_player_xref \
        --nhl-boxscore-table myproject.mydataset.boxscore_stats \
        --season 2024 --snapshot-date 2026-05-22

## Documentation

    nhl-hut-bigquery docs --format llm > HUT_FOR_LLMS.md
    nhl-hut-bigquery docs --format markdown > schema.md

## Verification

    # Internal integrity checks on a snapshot (overall in range, no dupes, …)
    nhl-hut-bigquery verify --aggregation snapshot-integrity \
        --table myproject.mydataset.hut_player_ratings

    # Drift checks between consecutive snapshots
    nhl-hut-bigquery verify --aggregation cross-snapshot-drift \
        --table myproject.mydataset.hut_player_ratings

MIT licensed. This software does not include or distribute EA-owned data.
