sdvplot 0.1.0__tar.gz → 0.1.1__tar.gz

sdvplot-0.1.1/.claude/settings.json

@@ -0,0 +1,31 @@
+{
+  "attribution": {
+    "commit": "",
+    "pr": "",
+    "sessionUrl": false
+  },
+  "extraKnownMarketplaces": {
+    "sportsdataverse": {
+      "source": {
+        "source": "github",
+        "repo": "sportsdataverse/sportsdataverse"
+      }
+    }
+  },
+  "enabledPlugins": {
+    "sdv-toolkit@sportsdataverse": true
+  },
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "Bash",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "i=$(cat); printf '%s' \"$i\" | grep -qE 'git commit|git notes|gh pr (create|edit|merge)|gh api' || exit 0; printf '%s' \"$i\" | grep -qiE 'co-?authored[-[:space:]]?(by|with)[[:space:]]*:[^\"]*(claude|copilot|cursor|gpt|openai|anthropic|gemini)|generated with[^\"]*claude|claude-session:' && { echo 'BLOCKED: AI attribution (Co-Authored-By / Generated with / Claude-Session) is not permitted. See .claude/CLAUDE.md.' >&2; exit 2; }; exit 0"
+          }
+        ]
+      }
+    ]
+  }
+}

{sdvplot-0.1.0 → sdvplot-0.1.1}/.gitignore

@@ -1,5 +1,5 @@
 __pycache__/
-.venv/
+.venv*/
 dist/
 *.egg-info/
 .pytest_cache/

{sdvplot-0.1.0 → sdvplot-0.1.1}/CHANGELOG.md

@@ -3,9 +3,13 @@
 
 - [Changelog](#changelog)
   - [[Unreleased]](#unreleased)
+  - [[0.1.1] - 2026-10-26](#011---2026-10-26)
+    - [Added](#added)
+    - [Changed](#changed)
+    - [Fixed](#fixed)
   - [[0.1.0] - 2026-10-05](#010---2026-10-05)
     - [Migrating from the git pre-release](#migrating-from-the-git-pre-release)
-    - [Added](#added)
+    - [Added](#added-1)
       - [Core (team identity, colors, logos, cache, adapter contract)](#core-team-identity-colors-logos-cache-adapter-contract)
       - [Repository standards](#repository-standards)
       - [Matplotlib family](#matplotlib-family)
@@ -19,11 +23,11 @@
       - [Parity extras (court coordinates, images by path, reference lines)](#parity-extras-court-coordinates-images-by-path-reference-lines)
       - [Parity extras (title images, team tiers)](#parity-extras-title-images-team-tiers)
       - [Release hardening](#release-hardening)
-    - [Changed](#changed)
+    - [Changed](#changed-1)
       - [Documentation](#documentation)
       - [Documentation — example notebooks by section, interactive outputs and the gallery](#documentation--example-notebooks-by-section-interactive-outputs-and-the-gallery)
       - [Release hardening](#release-hardening-1)
-    - [Fixed](#fixed)
+    - [Fixed](#fixed-1)
       - [Adapter contract follow-ups](#adapter-contract-follow-ups)
       - [Tables follow-ups](#tables-follow-ups)
       - [Content findings (team index, team tiers, surface)](#content-findings-team-index-team-tiers-surface)
@@ -38,6 +42,140 @@ All notable changes to sdvplot are documented here. The format follows [Keep a C
 
 ## [Unreleased]
 
+## [0.1.1] - 2026-10-26
+
+### Added
+
+- `sdvplot.pydeck` (new `[pydeck]` extra): deck.gl layer props for pydeck, the same as sdvplot-js's `./deckgl` builds
+  (held to one shared fixture). `logo_icon_layer` draws team logos at points (an `IconLayer` of auto-packed logo
+  icons), `pass_arc_layer` draws arcs in team colors (primary at the source, secondary at the target; with
+  `background`, 3:1 contrast and ΔE 20 apart through sdvplot-js's team palette, ported), and `surface_layer` draws a
+  sportypy rink, pitch, court or field as a `PolygonLayer` in the surface's own coordinates. The props are plain dicts
+  (`pydeck.Layer(**props)`); `deck()` builds a `pydeck.Deck` fitted to a surface or a map.
+- `sdvplot.perspective` (new `[perspective]` extra, Python 3.11+): `perspective_sdv_config(frame, team_col=, league=,
+  plugin=, theme=, mode=)` returns a Perspective viewer config (`PerspectiveWidget(data, **config)` or the JavaScript
+  `restore()`) that colors each team with the shared team palette: the Datagrid fills the team column's cells, and a
+  chart splits by team and colors each team's series. A registry table theme sets the grid's fonts and sign colors.
+  Number columns get formats (3 decimals, 1 for a percentage, integers plain; `formats=` overrides).
+  `perspective_logo_column(frame, team_col, league=)` adds each team's logo URL, shown as a link.
+- `sdvplot.itables.itables_sdv_theme(name, mode=, table_id=)` returns `classes`, `style` and a scoped `css` string
+  (with a Google Fonts import) that styles an `itables.show` table like any of the 122 surveyed themes.
+- `sdvplot.plottable.plottable_sdv_theme(name, mode=)` returns the `plottable.Table` keywords (text, dividers, stripes) for
+  any of the 122 surveyed themes, plus a `facecolor` to pop and apply to the figure; a font matplotlib cannot find falls
+  back to its generic family with one warning per family.
+- `table_theme_spec()` and `sdv_table_themes()`: resolve and list the 122 surveyed table themes (light and dark).
+- `sdvplot.great_tables.gt_theme_source(gt, name, mode=, density=)` styles a table like any of the 122 surveyed
+  themes, plus 20 named shortcuts (`gt_theme_datagolf`, `gt_theme_economist`, `gt_theme_basketball_reference`, ...)
+  generated by `tools/gen_gt_shortcuts.py`.
+- `reactable_sdv_theme(name, mode=)` accepts every registry theme, and the new `reactable_sdv_args(name, mode=)` returns
+  the `Reactable` keywords (`theme`, `striped`, `highlight`, `bordered`, `compact`) that match it. reactablefmtr names
+  are unchanged; `mode="dark"` on a reactablefmtr theme raises unless the theme is dark already.
+- `teams(league, include_conferences=True)` lists sdvplotR's conference and league rows (its `include_conferences`):
+  the 89 college conferences of cfb, mbb and wbb and the AFC, NFC and NFL, with `program` `"conference"` or `"league"`,
+  the conference's short name as `team_id` and `abbr`, cbbplotR's colors (`color_source` `"cbbplotR"`) and the
+  `conference_id` the league's teams carry. The default lists teams only, and `resolve()` and `palette()` never
+  answer a conference key, so no existing call changes.
+- Conference and league logos from the archive (sdvplotR's `logo_marks` for those rows): `logo_url("SEC", "cfb")`,
+  `logo_url("AFC", "nfl")`, `logo_url("NFL", "nfl")` and every mark helper (`marks`, `logo_image`, `add_logos`,
+  `axis_logos`, `geom_sdv_logos`, the table marks, the web adapters) take a conference or league row's key, with
+  `variant="dark"` where the archive has one (16 CFB conferences, the AFC, NFC and NFL) and the usual fallbacks. The
+  key is read after every team alias, so CFB's `MAC` is still Macalester, and `resolve()` still answers no conference:
+  the rows' only aliases are "mark" aliases, which name the manifest's own conference rows
+  (`level:league:source:entity_id`; `tools/build_index.py` `conference_mark_aliases`, from the new
+  `data-raw/manifest_conferences.csv` snapshot). All 92 rows have a primary mark, as sdvplotR's 92 do.
+- Headshots by the league's own player id: `id_system="league"` (sdvplotR's `id_type = "league"`) on `headshot_url`
+  and every headshot helper (`add_headshots` on every adapter, `geom_sdv_headshots`, `gt_sdv_headshots`,
+  `gt_sdv_cols_label(mark_type="headshot")`, `reactable_sdv_headshots`, `plottable.headshot_column`) draws an NBA or
+  WNBA Stats `PERSON_ID` (what nba_api, hoopR and wehoop return), an MLBAM id or an NHL API id from the league's CDN,
+  with sdvplotR's URL templates; for the NFL it is the gsis id. `"espn"` stays the default. A league without them is
+  an `InputError` naming the ones that have them, and a `DownloadError` from cdn.nba.com or cdn.wnba.com with a 403
+  says that those CDNs block datacenter and cloud IPs.
+- `surface("fiba")` draws a FIBA court (no team yet).
+- `sdvplot.plotnine.scale_color_sdv` and `scale_fill_sdv` take `alpha=`, an opacity applied to the team colors
+  (sdvplotR's `alpha`); `na_value` is drawn as given. `scale_colour_sdv` is the British alias sdvplotR and plotnine
+  both ship.
+- `gt_merge_stack_team_color` takes `background=`, the cell background the bottom line's color is checked against;
+  the default reads the table's background, so a theme applied first is taken into account.
+- `gt_tiers` takes `alt=`, a function from the image paths or URLs to their alt text. By default a logo the archive
+  knows (any `logo_url`) is named by its team and any other image by its file name; the images had no alt text at
+  all. The alt comes from the cell's value, so a local file (embedded as a data URI) gets a real name.
+- `pitch_coords()` converts soccer event coordinates from Opta / Stats Perform, Wyscout, StatsBomb, UEFA, Impect,
+  ESPN and the tracking providers (Tracab, SkillCorner, Second Spectrum, Metrica) to one regulation 105 x 68 m
+  frame, piecewise-linearly between pitch landmarks, with `flip` for teams attacking opposite ends. The port of
+  sdvplotR's `sdv_pitch_coords()`, matched to 1e-12 on every provider.
+- `court_coords(provider="euroleague")` converts the Euroleague shot frame of sportsdataverse-py's
+  `euroleague_game_points()` (`coord_x`/`coord_y`: integer centimeters, hoop at the origin, both teams on one basket,
+  free throws as `-1,-1`) onto the FIBA court `surface("fiba")` draws, in meters, with the `-1,-1` free throws as
+  null. The default `"nba"` is unchanged, byte for byte. Matched to sdvplotR's `sdv_court_coords(provider =
+  "euroleague")` bit for bit on a real Euroleague game (`tests/fixtures/euroleague_points_E2025_1.csv`).
+- `tools/espn_soccer_y_gate.py`, the measurement behind the ESPN frame's y direction.
+- `axis_logos(..., mark_type="headshot")` draws player headshots as axis labels on matplotlib, plotnine, Plotly and
+  Altair (the port of sdvplotR's `scale_x_sdv_headshots()` / `scale_y_sdv_headshots()` and `element_sdv_headshot()`):
+  the tick labels are read as player ids (`id_system` `"espn"`, which `"auto"` means, `"gsis"` or `"league"`), each headshot
+  keeps its own aspect, an unknown id stays as text with one warning, and the adapters without axis logos raise
+  `UnsupportedTargetError` as before. `sdvplot.typing.AxisMarkType` is the `Literal` of the three mark types. The
+  matplotlib y-axis label pad now grows by the widest image's width, so wordmarks and headshots no longer overlap
+  their tick labels' room. The adapter contract (`check_adapter_contract`, rule 7) checks the headshot axis too.
+
+### Changed
+
+- The README links the JavaScript / TypeScript port, sdvplot-js, now on npm: an npm badge and an Installation note
+  for `@sportsdataverse/sdvplot`, `@sportsdataverse/sporty` and `@sportsdataverse/sdvtables`, with their docs at
+  plot.sportsdataverse.org.
+- The docs site's SDV menu adds cfbseedR and sdvplot-js, and the README's SportsDataverse table adds sdvplot-js, so
+  the package lists match the other SportsDataverse sites.
+- polars 2.x is supported: the dependency is `polars>=1.24` (was `<2`). With every optional extra installed,
+  the full suite (2,343 tests) passes on polars 2.0.0, the same as on 1.44.
+- numpy is now a core dependency (it was optional, needed only by `pitch_coords()`).
+- `surface("soccer")` draws a regulation 105 x 68 m pitch by default (it drew sportypy's 120 x 90 m maximum), the
+  frame `pitch_coords()` returns; `pitch_updates` still overrides it key by key.
+- `gt_merge_stack_team_color` keeps the bottom line readable (sdvplotR #55): the team's primary color when it clears
+  4.5:1 contrast (WCAG AA) on the cell background, else the secondary, else the primary darkened (or lightened, on a
+  dark table) until it does, so Missouri's gold (1.8:1 on white) reads on a white table and stays gold on a dark one.
+  An unknown team's grey goes through the same rule.
+- `gt_spotlight(dim_color=)` defaults to `"auto"` (sdvplotR #61): the other rows are dimmed to the table's text
+  blended toward its background until it clears 4.5:1 (`#737373` on white), instead of the fixed `#BBBBBB`, which is
+  1.9:1 on white and barely dimmer than the text on a dark theme. Pass a color to choose it, or `None` not to dim.
+- `team_tiers` (matplotlib and plotnine) takes `variant=`, default `"auto"`: the dark theme now draws the archive's
+  dark-background logos (the `"dark"` variant), so dark marks such as the Capitals', the Giants', Penn State's or
+  Iowa's no longer fade into the near-black background. A team with no dark mark draws its default one, with no
+  warning; the light theme still draws the default logos. Pass `variant="default"` for the old look (sdvplotR's), or
+  any variant `add_logos` takes.
+- great_tables 1.1 is supported. Its `data_color` now interpolates in CIELAB, as R gt and `scales::col_numeric` do,
+  so `gt_color_ranks` fills match sdvplotR's exactly under it; `gt_color_pills`, `gt_percentile_bar` and the
+  `gt_legend_continuous` steps now draw great_tables' own gradient, so they stay equal to `data_color` cells on every
+  version (CIELAB from 1.1, sRGB before) and match sdvplotR's colors from 1.1 (they were sRGB approximations).
+
+### Fixed
+
+- The surfaces cookbook's soccer shot map (§9) placed ESPN shots at twice their distance from goal (ESPN's
+  `field_position_x` is a fraction of half the pitch, not of the whole), mirrored the home team's wings, and kept
+  ESPN's `(0, 0)` "no location" events. It now scales by 52.5 m, turns the away team half a turn, and drops them.
+- Coordinates, teams and seasons accept a `range`: `add_logos(ax, range(1, 8), ...)` raised a `TypeError` that named
+  `resolve()` though the bad value was `x`. A container sdvplot cannot read now raises a `TypeError` that names no one
+  function: `expected a scalar, list, tuple, range, numpy array or a pandas/polars Series, got dict`.
+- NHL `WIN` is season-aware: `resolve("WIN", "nhl", season=1990)` (and NHL team id 33, and the archive's logos of
+  those seasons) gives the original Jets' line, today's Utah Mammoth, for the seasons ending 1980-1996, as sdvplotR's
+  `resolve_historical_abbr()` does; any other season, or none, gives today's Winnipeg Jets, the relocated Thrashers.
+  Every season used to give today's Jets, because the NHL stats API files the 1979-96 team under their franchise.
+- `UTRGV`, `TEXAS-RIO GRANDE VALLEY` and `RGV` resolve in college football (ESPN's teams list omits UT Rio Grande
+  Valley, 292; its per-team endpoint's `RGV` is now in `data-raw/espn_abbrs.csv`).
+- Six college basketball teams ESPN's teams lists omit resolve by their ESPN abbreviation: `LIN` (Lindenwood, 2815),
+  `QUC` (Queens, 2511), `SFPA` (Saint Francis, 2598) and `USI` (Southern Indiana, 88) in mbb, `MERC` (Mercyhurst,
+  2385) and `SFPA` in wbb, and with them sdvplotR's keys for those teams. `tools/fetch_sources.py` reads them from
+  ESPN's Core API per season (`ESPN_CORE_TEAMS`) into `data-raw/espn_abbrs.csv`.
+  `teams()` shows that code as `abbr` where ESPN's teams lists give none, as for UTRGV (`RGV`) and college
+  baseball's Loras (`LOR`): eight teams had a null `abbr`.
+- sdvplotR's conference names draw the conference's logo again: `logo_url("Southeastern Conference", "cfb")` is
+  `logo_url("SEC", "cfb")`, `logo_url("B10", "mbb")` is `logo_url("Big Ten", "mbb")`, and so for the other keys
+  sdvplotR's `clean_team_abbrs()` maps to a conference or league row ("B1G", "Pac-10", "American Football
+  Conference"): 275 keys in cfb, mbb, wbb and the NFL, a new internal id system `"conference"` that only the mark
+  functions read, after every team alias. `resolve()` still answers no conference, and CFB's `MAC` is still
+  Macalester; `resolve("Mid-American Conference", "cfb")` no longer gives Macalester (it went through sdvplotR's
+  `MAC` canon): it is `None`, and its logo is the conference's.
+- `gt_tiers` no longer writes two `alt` attributes on an image under great_tables 1.1, whose `fmt_image` adds an
+  empty `alt=""`: the image's alt text replaces it.
+
 ## [0.1.0] - 2026-10-05
 
 First release.
@@ -557,5 +695,6 @@ fails loudly, with the message shown:
   had a 60 s timeout of its own, so a server sending a header byte every 59 s held the call open almost indefinitely.
   Through a proxy, the watchdog covers the body only.
 
-[Unreleased]: https://github.com/sportsdataverse/sdvplot/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/sportsdataverse/sdvplot/compare/v0.1.1...HEAD
+[0.1.1]: https://github.com/sportsdataverse/sdvplot/compare/v0.1.0...v0.1.1
 [0.1.0]: https://github.com/sportsdataverse/sdvplot/releases/tag/v0.1.0

{sdvplot-0.1.0 → sdvplot-0.1.1}/CITATION.cff

@@ -6,8 +6,8 @@ authors:
   - family-names: Gilani
     given-names: Saiem
     orcid: "https://orcid.org/0000-0002-7194-9067"
-version: 0.1.0
-date-released: "2026-10-05"
+version: 0.1.1
+date-released: "2026-10-26"
 url: "https://sdvplot.sportsdataverse.org"
 repository-code: "https://github.com/sportsdataverse/sdvplot"
 license: MIT

{sdvplot-0.1.0 → sdvplot-0.1.1}/CONTRIBUTING.md

@@ -218,16 +218,27 @@ npx yarn@1.22.22 build    # what CI runs: it must finish with no new broken link
 
 1. Re-check the watch list in `docs/COMPATIBILITY.md`: if a newer reflex-xy release documents an image mark or a
    custom glyph, open an issue for a Reflex XY adapter; either way, update the version and date checked there.
-2. Bump `version` in `pyproject.toml`, run `uv lock`, and commit `uv.lock` with it (the `drift` workflow fails on a
-   stale lock).
+2. Install the hooks first (`uv run pre-commit install`; a fresh clone or worktree has none, and then nothing checks
+   your commits). Bump `version` in `pyproject.toml`, run `uv lock` with the uv that `release.yml` pins
+   (`uvx --from uv==<pin> uv lock`: an older uv rewrites environment markers all over the lock), and commit `uv.lock`
+   with it (the `drift` workflow fails on a stale lock); the lock diff should be the one `version` line.
+   Update every other place the version is written: `CITATION.cff` (`version` and a quoted `date-released`;
+   `tests/test_repo_files.py` checks the version), the `versions()` docstring example in `src/sdvplot/_versions.py`,
+   and the hand-written example in `docs/docs/concepts/cache.md`. `docs/docs/reference/**` is generated: change the
+   docstring, then run `uv run python tools/gen_docs.py`, never edit the page.
 3. In `CHANGELOG.md`, move the `## [Unreleased]` entries under a new `## [X.Y.Z] - <date>` heading (and add its link reference) directly below
    an emptied `## [Unreleased]`, which always stays at the top (a test asserts it).
-4. Run `cd docs && npx yarn@1.22.22 version:docs X.Y.Z`.
-5. First release only: merge the install-line PR (#50: README, intro and quickstart switch to `pip install sdvplot`)
+4. Run `cd docs && npx yarn@1.22.22 version:docs X.Y.Z` after the docs are final: the snapshot copies
+   `docs/docs` as it stands, and later edits do not reach it. `docs/versioned_docs` is in ruff's `extend-exclude`, so
+   the snapshot of the generated pages is never reformatted.
+5. Before pushing, run `uv run pre-commit run --all-files`, the drift checks (`uv run python tools/build_index.py
+   --check`, `uv run python tools/gen_docs.py --check`) and `SDVPLOT_RELEASE_VERSION=vX.Y.Z uv run pytest -q
+   tests/test_repo_files.py`, the gate `release.yml` runs on the tag.
+6. First release only: merge the install-line PR (#50: README, intro and quickstart switch to `pip install sdvplot`)
    just before tagging. The README is the PyPI page and cannot be changed for a version once it is uploaded. For 0.1.0,
    step 3 means folding the `[Unreleased]` entries into the existing `## [0.1.0]` section and replacing its
    `Unreleased` with the date; #50 carries that cut too.
-6. Publish a GitHub Release `vX.Y.Z`. `release.yml` checks that the tag equals the project version, runs the tests
+7. Publish a GitHub Release `vX.Y.Z`. `release.yml` checks that the tag equals the project version, runs the tests
    with `SDVPLOT_RELEASE_VERSION` set from the tag (so `tests/test_repo_files.py::test_the_tagged_release_is_ready`
    refuses a README that still installs from GitHub, a CHANGELOG without a dated `## [X.Y.Z] - YYYY-MM-DD` heading, or
    entries left under `[Unreleased]`) and the index drift check, builds the sdist and wheel from a fresh checkout, and

sdvplot-0.1.1/PKG-INFO

@@ -0,0 +1,319 @@
+Metadata-Version: 2.5
+Name: sdvplot
+Version: 0.1.1
+Summary: Team logos, wordmarks, headshots and colors for Python plots and tables (SportsDataverse)
+Project-URL: Homepage, https://sdvplot.sportsdataverse.org/
+Project-URL: Documentation, https://sdvplot.sportsdataverse.org/
+Project-URL: Repository, https://github.com/sportsdataverse/sdvplot
+Project-URL: Bug Tracker, https://github.com/sportsdataverse/sdvplot/issues
+Project-URL: Changelog, https://sdvplot.sportsdataverse.org/CHANGELOG
+Author: Saiem Gilani
+Maintainer: Saiem Gilani, SportsDataverse
+License-Expression: MIT
+License-File: LICENSE
+Keywords: altair,logos,matplotlib,plotly,sports,sportsdataverse,team colors
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Science/Research
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: narwhals>=2.0
+Requires-Dist: numpy>=1.26
+Requires-Dist: pillow>=12.3
+Requires-Dist: platformdirs>=4
+Requires-Dist: polars>=1.24
+Requires-Dist: requests>=2.33
+Requires-Dist: urllib3>=2.6
+Provides-Extra: all
+Requires-Dist: altair>=5.1; extra == 'all'
+Requires-Dist: bokeh>=3.8.2; extra == 'all'
+Requires-Dist: folium>=0.19; extra == 'all'
+Requires-Dist: great-tables>=1.0; extra == 'all'
+Requires-Dist: holoviews>=1.18; extra == 'all'
+Requires-Dist: htmltools>=0.4.1; extra == 'all'
+Requires-Dist: itables>=2.4; extra == 'all'
+Requires-Dist: matplotlib>=3.7; extra == 'all'
+Requires-Dist: mplsoccer>=1.2; extra == 'all'
+Requires-Dist: nokap>=0.1; extra == 'all'
+Requires-Dist: perspective-python[jupyter]>=5.5.1; (python_version >= '3.11') and extra == 'all'
+Requires-Dist: plotly>=5.14; extra == 'all'
+Requires-Dist: plotnine>=0.15; extra == 'all'
+Requires-Dist: plottable>=0.1.5; extra == 'all'
+Requires-Dist: pydeck>=0.9.3; extra == 'all'
+Requires-Dist: pygal>=3.0.1; extra == 'all'
+Requires-Dist: reactable>=0.1.6; extra == 'all'
+Requires-Dist: resvg-py>=0.2.5; extra == 'all'
+Requires-Dist: sportypy>=1.0; extra == 'all'
+Provides-Extra: altair
+Requires-Dist: altair>=5.1; extra == 'altair'
+Provides-Extra: bokeh
+Requires-Dist: bokeh>=3.8.2; extra == 'bokeh'
+Provides-Extra: folium
+Requires-Dist: folium>=0.19; extra == 'folium'
+Provides-Extra: holoviews
+Requires-Dist: bokeh>=3.8.2; extra == 'holoviews'
+Requires-Dist: holoviews>=1.18; extra == 'holoviews'
+Provides-Extra: itables
+Requires-Dist: itables>=2.4; extra == 'itables'
+Provides-Extra: mpl
+Requires-Dist: matplotlib>=3.7; extra == 'mpl'
+Provides-Extra: perspective
+Requires-Dist: perspective-python[jupyter]>=5.5.1; (python_version >= '3.11') and extra == 'perspective'
+Provides-Extra: plotly
+Requires-Dist: plotly>=5.14; extra == 'plotly'
+Provides-Extra: plotnine
+Requires-Dist: plotnine>=0.15; extra == 'plotnine'
+Provides-Extra: plottable
+Requires-Dist: plottable>=0.1.5; extra == 'plottable'
+Provides-Extra: pydeck
+Requires-Dist: pydeck>=0.9.3; extra == 'pydeck'
+Provides-Extra: pygal
+Requires-Dist: pygal>=3.0.1; extra == 'pygal'
+Provides-Extra: reactable
+Requires-Dist: reactable>=0.1.6; extra == 'reactable'
+Provides-Extra: surfaces
+Requires-Dist: mplsoccer>=1.2; extra == 'surfaces'
+Requires-Dist: sportypy>=1.0; extra == 'surfaces'
+Provides-Extra: svg
+Requires-Dist: resvg-py>=0.2.5; extra == 'svg'
+Provides-Extra: tables
+Requires-Dist: great-tables>=1.0; extra == 'tables'
+Requires-Dist: htmltools>=0.4.1; extra == 'tables'
+Requires-Dist: nokap>=0.1; extra == 'tables'
+Description-Content-Type: text/markdown
+
+# **sdvplot** <a href='https://sdvplot.sportsdataverse.org/'><img src='https://raw.githubusercontent.com/sportsdataverse/sdvplot/main/docs/static/img/sdvplot-logo.png' align="right" width="25%" min-width="120px" alt="sdvplot hex logo" /></a>
+
+[![PyPI](https://img.shields.io/pypi/v/sdvplot?label=sdvplot&logo=python&style=for-the-badge)](https://pypi.org/project/sdvplot/)
+[![Python](https://img.shields.io/pypi/pyversions/sdvplot?logo=python&logoColor=white&style=for-the-badge)](https://pypi.org/project/sdvplot/)
+[![npm](https://img.shields.io/npm/v/@sportsdataverse/sdvplot?label=sdvplot-js&logo=npm&style=for-the-badge)](https://www.npmjs.com/package/@sportsdataverse/sdvplot)
+[![Downloads](https://img.shields.io/pypi/dm/sdvplot?style=for-the-badge)](https://pypistats.org/packages/sdvplot)
+[![Total downloads](https://img.shields.io/pepy/dt/sdvplot?style=for-the-badge)](https://pepy.tech/projects/sdvplot)
+[![tests](https://img.shields.io/github/actions/workflow/status/sportsdataverse/sdvplot/tests.yml?branch=main&label=tests&logo=github&style=for-the-badge)](https://github.com/sportsdataverse/sdvplot/actions/workflows/tests.yml)
+[![quality](https://img.shields.io/github/actions/workflow/status/sportsdataverse/sdvplot/quality.yml?branch=main&label=quality&logo=github&style=for-the-badge)](https://github.com/sportsdataverse/sdvplot/actions/workflows/quality.yml)
+[![docs](https://img.shields.io/github/actions/workflow/status/sportsdataverse/sdvplot/docs-deploy.yml?branch=main&label=docs&logo=github&style=for-the-badge)](https://sdvplot.sportsdataverse.org)
+[![Lifecycle: experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg?style=for-the-badge&logo=github)](https://lifecycle.r-lib.org/articles/stages.html#experimental)
+[![License](https://img.shields.io/pypi/l/sdvplot?style=for-the-badge)](https://github.com/sportsdataverse/sdvplot/blob/main/LICENSE)
+[![Contributors](https://img.shields.io/github/contributors/sportsdataverse/sdvplot?style=for-the-badge)](https://github.com/sportsdataverse/sdvplot/graphs/contributors)
+[![Twitter Follow](https://img.shields.io/twitter/follow/SportsDataverse?color=blue&label=%40SportsDataverse&logo=x&style=for-the-badge)](https://x.com/SportsDataverse)
+
+Team logos, wordmarks, headshots and colors for Python plots and tables, from the SportsDataverse logo archive. It
+resolves team abbreviations, names and provider ids across 28 leagues and picks the right era's mark for a season. Colors
+and logos work with any library through `palette()`, `team_colors()`, `logo_url()` and `logo_image()`, and the
+`add_logos()`, `add_wordmarks()` and `add_headshots()` adapters draw them on matplotlib (and seaborn), plotnine, plotly,
+altair, bokeh, holoviews, great_tables, folium and pygal plots, tables and maps. `sdvplot.great_tables` also ports
+sdvplotR's table themes, cell styling, legends and image export, and `surface()` draws a league's field, court or rink
+in a team's colors. The Python counterpart to [sdvplotR](https://sdvplotR.sportsdataverse.org/).
+
+## **Installation**
+
+```bash
+pip install sdvplot
+# or
+uv add sdvplot
+```
+
+Plotting libraries are optional extras, for example
+`pip install "sdvplot[mpl]"`. Each extra adds the libraries for one feature: `[svg]` lets `logo_image()`
+rasterize SVG marks. With `[mpl]`, `[plotnine]`, `[plotly]`, `[altair]`, `[bokeh]`, `[holoviews]`, `[tables]`,
+`[folium]` or `[pygal]`, `add_logos()`, `add_wordmarks()` and `add_headshots()` draw on that library's plots, tables and
+maps; `axis_logos()` works on matplotlib, seaborn, plotnine, Plotly and Altair. `[surfaces]` is for `surface()`, and
+`[reactable]` and `[plottable]` add column helpers (`sdvplot.reactable`, `sdvplot.plottable`). `sdvplot.pydeck`
+builds deck.gl layers (team logos, team-colored arcs, sportypy surfaces) for pydeck, and `sdvplot.perspective`
+Perspective viewer configs in team colors and a logo column (Python 3.11+).
+
+| Extra | Adds |
+| --- | --- |
+| `[mpl]` | matplotlib |
+| `[plotnine]` | plotnine |
+| `[plotly]` | plotly |
+| `[altair]` | altair |
+| `[bokeh]` | bokeh |
+| `[holoviews]` | holoviews |
+| `[tables]` | great_tables |
+| `[reactable]` | reactable (reactable-py) |
+| `[folium]` | folium |
+| `[svg]` | resvg-py, for SVG marks |
+| `[surfaces]` | sportypy and mplsoccer |
+| `[plottable]` | plottable |
+| `[pygal]` | pygal |
+| `[pydeck]` | pydeck, for `sdvplot.pydeck`'s layers and `deck()` |
+| `[perspective]` | perspective-python (with its Jupyter widget), for `sdvplot.perspective`; Python 3.11+ |
+| `[all]` | everything above |
+
+### JavaScript / TypeScript
+
+The same colors, logos, wordmarks and headshots are on npm as
+[`@sportsdataverse/sdvplot`](https://www.npmjs.com/package/@sportsdataverse/sdvplot), with integrations for Observable
+Plot, D3, React, Chart.js, Plotly, Vega-Lite and ECharts, plus shot charts and linked interactivity. Its siblings
+[`@sportsdataverse/sporty`](https://www.npmjs.com/package/@sportsdataverse/sporty) (playing surfaces) and
+[`@sportsdataverse/sdvtables`](https://www.npmjs.com/package/@sportsdataverse/sdvtables) (tables) ship from the same
+[sdvplot-js repo](https://github.com/sportsdataverse/sdvplot-js). Docs for all three:
+[plot.sportsdataverse.org](https://plot.sportsdataverse.org/).
+
+```bash
+npm install @sportsdataverse/sdvplot
+```
+
+## **Usage**
+
+Team identity, colors and marks:
+
+```python
+import sdvplot
+
+sdvplot.resolve(["LV", "OAK", "Las Vegas Raiders"], "nfl")  # ['13', '13', '13']
+sdvplot.palette("nfl", teams=["LV", "KC"])  # {'LV': '#000000', 'KC': '#e31837'}
+sdvplot.logo_url("OAK", "nfl", season=2010)  # the Oakland-era mark
+img = sdvplot.logo_image("LV", "nfl", size=128)  # a PIL image
+```
+
+Logos on a plot, here the 2024 AFC playoff field in seed order:
+
+```python
+import matplotlib.pyplot as plt
+import sdvplot
+
+seeds = ["KC", "BUF", "BAL", "HOU", "LAC", "PIT", "DEN"]
+x = list(range(1, 8))
+fig, ax = plt.subplots(figsize=(8, 1.6))
+sdvplot.add_logos(ax, x, [0] * 7, seeds, league="nfl", height=0.7)
+ax.set(xlim=(0.5, 7.5), ylim=(-1, 1), xticks=x, yticks=[], title="2024 AFC playoff seeds")
+```
+
+Colors work in any library that takes a `{value: color}` mapping, for example seaborn:
+`sns.barplot(data=df, x="team", y="epa", hue="team", palette=sdvplot.palette("nfl", teams=df["team"]))`.
+
+`teams()` records where each team's colors come from in `color_source`: `nflverse` or `espn` when that source
+publishes them, `logo` when they are derived from the team's archived logo because no source does, and `fallback` for
+a placeholder that is not the team's colors (`cbbplotR` on the conference rows `teams(league, include_conferences=True)`
+adds).
+
+From the [gallery](https://sdvplot.sportsdataverse.org/docs/gallery), each drawn by sdvplot from the logo archive:
+
+| | |
+| --- | --- |
+| ![NHL teams stacked by the decade their archived logos begin](https://raw.githubusercontent.com/sportsdataverse/sdvplot/main/docs/static/img/home/nhl-decades-light.png) | ![Each AFC team's two colors, their contrast ratio as the bar height, with logos on the axis](https://raw.githubusercontent.com/sportsdataverse/sdvplot/main/docs/static/img/home/afc-colors-light.png) |
+| `add_logos()` as scatter points: NHL teams by the decade their archived logos begin | Each AFC team's two colors from `palette()`, their contrast as the height, `axis_logos()` on the axis |
+| ![The Montreal Canadiens mark used in each season, from the logo archive](https://raw.githubusercontent.com/sportsdataverse/sdvplot/main/docs/static/img/home/montreal-eras-light.png) | ![Player headshots from five leagues drawn with add_headshots](https://raw.githubusercontent.com/sportsdataverse/sdvplot/main/docs/static/img/home/headshots-light.png) |
+| One `add_logos()` call with `season=`: the mark Montreal used each season | `add_headshots()` with ESPN athlete ids, one player from each of five leagues |
+
+## **Documentation**
+
+The [**`sdvplot`** documentation website](https://sdvplot.sportsdataverse.org) has the
+[getting started guide](https://sdvplot.sportsdataverse.org/docs/intro), the
+[API reference](https://sdvplot.sportsdataverse.org/docs/reference) and the
+[gallery](https://sdvplot.sportsdataverse.org/docs/gallery), plus:
+
+**League tutorials:**
+[NFL](https://sdvplot.sportsdataverse.org/docs/tutorials/leagues/nfl) ·
+[CFB](https://sdvplot.sportsdataverse.org/docs/tutorials/leagues/cfb) ·
+[NBA](https://sdvplot.sportsdataverse.org/docs/tutorials/leagues/nba) ·
+[WNBA](https://sdvplot.sportsdataverse.org/docs/tutorials/leagues/wnba) ·
+[MBB](https://sdvplot.sportsdataverse.org/docs/tutorials/leagues/mbb) ·
+[WBB](https://sdvplot.sportsdataverse.org/docs/tutorials/leagues/wbb) ·
+[MLB](https://sdvplot.sportsdataverse.org/docs/tutorials/leagues/mlb) ·
+[NHL](https://sdvplot.sportsdataverse.org/docs/tutorials/leagues/nhl) ·
+[PWHL](https://sdvplot.sportsdataverse.org/docs/tutorials/leagues/pwhl) ·
+[Soccer](https://sdvplot.sportsdataverse.org/docs/tutorials/leagues/soccer) ·
+[Cricket](https://sdvplot.sportsdataverse.org/docs/tutorials/leagues/cricket)
+
+**Cookbooks:**
+[Matplotlib logos](https://sdvplot.sportsdataverse.org/docs/cookbooks/matplotlib-logos) ·
+[Colors and themes](https://sdvplot.sportsdataverse.org/docs/cookbooks/colors-and-themes) ·
+[Tables](https://sdvplot.sportsdataverse.org/docs/cookbooks/tables) ·
+[Interactive web](https://sdvplot.sportsdataverse.org/docs/cookbooks/interactive-web) ·
+[plotnine](https://sdvplot.sportsdataverse.org/docs/cookbooks/plotnine) ·
+[Surfaces and shot charts](https://sdvplot.sportsdataverse.org/docs/cookbooks/surfaces-and-shot-charts)
+
+**Recipes, leaderboards and automation:**
+[Head-to-head card](https://sdvplot.sportsdataverse.org/docs/recipes/head-to-head-card) ·
+[CFB conference table](https://sdvplot.sportsdataverse.org/docs/recipes/cfb-conference-table) ·
+[NFL weekly leaderboard](https://sdvplot.sportsdataverse.org/docs/leaderboards/nfl-weekly) ·
+[Social game-day graphics](https://sdvplot.sportsdataverse.org/docs/automation)
+
+The [changelog](https://github.com/sportsdataverse/sdvplot/blob/main/CHANGELOG.md) lists every release, and
+[contributing](https://github.com/sportsdataverse/sdvplot/blob/main/CONTRIBUTING.md) covers development.
+
+### Environment variables
+
+- `SDVPLOT_CACHE_DIR`: cache root.
+- `SDVPLOT_CACHE_TTL`: cache lifetime in days (default 7).
+- `SDVPLOT_LIVE_TESTS=1`: enable the network tests.
+
+<!-- cheatsheet-section -->
+## **Cheat sheet**
+
+A printable four-page reference for **sdvplot**: team identity and colours, the nine plotting adapters, the
+great_tables toolkit, surfaces and coordinates, in four colour themes, light and dark.
+
+📄 **[Download the sdvplot cheat sheet (PDF)](https://sportsdataverse.org/cheatsheets/sdvplot.pdf)**
+
+Browse the other SportsDataverse cheat sheets at
+**[sportsdataverse.org/cheatsheets](https://sportsdataverse.org/cheatsheets)**.
+
+## **Logos, trademarks and data**
+
+Team names, logos, wordmarks and player headshots are trademarks or copyrighted works of their respective leagues,
+teams, schools and other rights holders. sdvplot is not affiliated with, sponsored by or endorsed by any of them, and
+using sdvplot to draw a mark grants no right to use it. The package ships no logo files: the wheel carries only an
+index of team names, ids and colors, and marks are fetched at runtime from the
+[SportsDataverse logo archive](https://github.com/sportsdataverse/sdv-assets), headshots from ESPN (or, for NFL gsis
+ids, the URLs in nflverse's player table). Use of any mark in your own work is
+governed by that owner's terms, and following them is your responsibility. The [MIT license](https://github.com/sportsdataverse/sdvplot/blob/main/LICENSE)
+covers the sdvplot code only; team data belongs to its respective owners and sources.
+
+## **The SportsDataverse**
+
+`sdvplot` draws the pictures; the companion packages fetch the data.
+
+| Package | Sport / Scope |
+| --- | --- |
+| [**sportsdataverse-py**](https://py.sportsdataverse.org/) | SportsDataverse data for Python: NFL, CFB, NBA, WNBA, MBB, WBB, MLB, NHL, PWHL, soccer and more |
+| [**sdvplotR**](https://sdvplotR.sportsdataverse.org/) | The R package this one mirrors |
+| [**sdvplot-js**](https://plot.sportsdataverse.org/) | The JavaScript port: `@sportsdataverse/sdvplot`, `@sportsdataverse/sporty` and `@sportsdataverse/sdvtables` on npm |
+| [**sportypy**](https://sportypy.sportsdataverse.org/) | Playing-surface plots for Python |
+| [**nflreadpy**](https://github.com/nflverse/nflreadpy) | nflverse data loaders for Python |
+| [**sportsdataverse-R**](https://r.sportsdataverse.org/) · [**sportsdataverse.js**](https://js.sportsdataverse.org/) | R and Node.js |
+
+See the full ecosystem at [sportsdataverse.org](https://sportsdataverse.org/).
+
+## **Follow the [SportsDataverse](https://x.com/SportsDataverse) on X and star this repo**
+
+[![Twitter Follow](https://img.shields.io/twitter/follow/SportsDataverse?color=blue&label=%40SportsDataverse&logo=x&style=for-the-badge)](https://x.com/SportsDataverse)
+[![GitHub stars](https://img.shields.io/github/stars/sportsdataverse/sdvplot.svg?color=eee&logo=github&style=for-the-badge&label=Star%20sdvplot&maxAge=2592000)](https://github.com/sportsdataverse/sdvplot/stargazers/)
+
+<a href="https://github.com/sportsdataverse/sdvplot/stargazers">
+  <picture>
+    <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/sportsdataverse/sdvplot/star-history/star-history-dark.svg">
+    <img alt="Star history of sportsdataverse/sdvplot" src="https://raw.githubusercontent.com/sportsdataverse/sdvplot/star-history/star-history.png" width="600">
+  </picture>
+</a>
+
+## **Our Authors**
+
+- [Saiem Gilani](https://x.com/saiemgilani)
+  <a href="https://x.com/saiemgilani" target="blank"><img src="https://img.shields.io/twitter/follow/saiemgilani?color=blue&label=%40saiemgilani&logo=x&style=for-the-badge" alt="@saiemgilani" /></a>
+  <a href="https://github.com/saiemgilani" target="blank"><img src="https://img.shields.io/github/followers/saiemgilani?color=eee&logo=Github&style=for-the-badge" alt="@saiemgilani" /></a>
+
+## **Citations**
+
+To cite [**`sdvplot`**](https://sdvplot.sportsdataverse.org) in publications, use:
+
+BibTeX Citation
+
+```bibtex
+@misc{gilani_2026_sdvplot,
+  author = {Gilani, Saiem},
+  title = {sdvplot: Team logos, wordmarks, headshots and colors for Python plots and tables},
+  url = {https://sdvplot.sportsdataverse.org},
+  year = {2026}
+}
+```