sdvplot 0.1.0__py3-none-any.whl

sdvplot-0.1.0.dist-info/METADATA

@@ -0,0 +1,188 @@
+Metadata-Version: 2.5
+Name: sdvplot
+Version: 0.1.0
+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: pillow>=12.3
+Requires-Dist: platformdirs>=4
+Requires-Dist: polars<2,>=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: matplotlib>=3.7; extra == 'all'
+Requires-Dist: mplsoccer>=1.2; extra == 'all'
+Requires-Dist: nokap>=0.1; 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: 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: mpl
+Requires-Dist: matplotlib>=3.7; extra == 'mpl'
+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: 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>
+
+[![Lifecycle: experimental](https://img.shields.io/badge/lifecycle-experimental-orange.svg)](https://lifecycle.r-lib.org/articles/stages.html#experimental)
+[![Docs](https://img.shields.io/badge/docs-sdvplot.sportsdataverse.org-blue)](https://sdvplot.sportsdataverse.org)
+
+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/). See
+[CHANGELOG](https://github.com/sportsdataverse/sdvplot/blob/main/CHANGELOG.md).
+
+## 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`).
+
+| 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 |
+| `[all]` | everything above |
+
+## Get started
+
+```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
+```
+
+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.
+
+## Environment variables
+
+- `SDVPLOT_CACHE_DIR`: cache root.
+- `SDVPLOT_CACHE_TTL`: cache lifetime in days (default 7).
+- `SDVPLOT_LIVE_TESTS=1`: enable the network tests.
+
+## Documentation
+
+- [Docs site](https://sdvplot.sportsdataverse.org) with concepts, tutorials and the API reference.
+- [Changelog](https://github.com/sportsdataverse/sdvplot/blob/main/CHANGELOG.md).
+- [Contributing](https://github.com/sportsdataverse/sdvplot/blob/main/CONTRIBUTING.md).
+
+## 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.
+
+## Companion packages
+
+- [sdvplotR](https://sdvplotR.sportsdataverse.org/): the R package this one mirrors.
+- [sdv-py](https://py.sportsdataverse.org/): SportsDataverse data for Python.
+- [sportypy](https://sportypy.sportsdataverse.org/): sports surfaces for Python plots.
+
+## 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}
+}
+```

sdvplot-0.1.0.dist-info/RECORD

@@ -0,0 +1,49 @@
+sdvplot/__init__.py,sha256=NOy3y_KocmQt5M0miSFUuURnWExwwt9SsgCOJBeGbm0,1800
+sdvplot/_cache.py,sha256=L1_B0fSi5sjxyQCGQkmi_C9UI909Eh1TK0XyknWl2fY,21745
+sdvplot/_colors.py,sha256=k98JUzSfuGBFB-tPvcb77Wp4sFrUxtzteYupmlxvCGU,8139
+sdvplot/_contrast.py,sha256=uYhxHqtZ5buAok5vmNEilA7QQT48p24XQy804caavfM,2887
+sdvplot/_court.py,sha256=V8cdSDxYtnBChi18r85Rmanh6EKd6c46kdZa_1dpHc0,5903
+sdvplot/_deprecate.py,sha256=IiZq9RequW0TOLqsdAxVgaO0iDOu-ELFQiWjRcszIM0,1747
+sdvplot/_dispatch.py,sha256=irWy-5fP-EQ1dFmQOfwG9J1v8pkFcEXzcT3coeI1O74,19575
+sdvplot/_errors.py,sha256=DNOuqZia4YEbFkxX2UrwuTSYsMuGv0gynlFDsWt__Wc,4006
+sdvplot/_headshots.py,sha256=DJ4v0Qhp3mUDDeglHxvSduUA3kTvHayF2QovsJSrRC4,5257
+sdvplot/_images.py,sha256=HiCTsp6q_lsEFI-FApk_fQKWvCEB2zwstWmXDUqz-cc,12659
+sdvplot/_index.py,sha256=z_c30n-C9Hp8TCEXeo7DzQdg5n0fByL7_h-eYarQ8dE,6411
+sdvplot/_lazy.py,sha256=I6Hbu10X1pvppe1KTP0vML21oHlQgfzWpsCxzn01lM0,316
+sdvplot/_manifest.py,sha256=5pdrCP71juna6SJsCDfvqFPeTbKyunJ_L8GbN--HVxY,2600
+sdvplot/_marks.py,sha256=V51fXEmfaMuMfypKssKTcUXsTDL-c21Qmb59lOsnBw8,13206
+sdvplot/_normalize.py,sha256=xYKEMiBcMuLB3UZx6lt3fcm-YpWQd6FIEDKED_iGAXY,3301
+sdvplot/_placement.py,sha256=G9Sow6OyqwN4JlPr7dfFd5MI_3R-RC5H_wumXy1_ZkU,7304
+sdvplot/_resolve.py,sha256=vP1Rmscibg3qwK_iTCeF0-wDYAJE_kiJTxzVni95uWA,15445
+sdvplot/_surface.py,sha256=pgFlwvlTsCnIk1_4zZaVu-6Zl4nbXr9xmrQrYOnI2K4,10252
+sdvplot/_tables.py,sha256=usu2-FWxj-RDmgQZcNEuXHCyK5AxHtdvuG5YUi0B28g,3717
+sdvplot/_tiers.py,sha256=QMI_6CgImuBtmPr_zW_D4atDq2xJwRHX-NrpKFD_KBU,6391
+sdvplot/_types.py,sha256=22xtZtooUbKiHT1q66HxcbIPARh0HeOoXvAt361xJHo,1235
+sdvplot/_versions.py,sha256=4L9o4C15EW9Z0RiGyurfXRoSYMQ5jeXLJkrJnUJ--JI,970
+sdvplot/_web.py,sha256=01sO_PX7LTLnR74UH-2PGTSr3g_BMGl6WoNg1usRnEY,2643
+sdvplot/altair.py,sha256=NOkXDAaG5j08FzG71fSgiuiYkCap_Ev7Qk8lckIHNPA,29717
+sdvplot/bokeh.py,sha256=APwaetY6WyaKnkWcDsBLRYzaXn_dogr8lWYKoJomgQ8,13319
+sdvplot/folium.py,sha256=IXlMfQt5gP0YNngJtuGjkegfptZiELvQz6QaHiKFsL0,12383
+sdvplot/holoviews.py,sha256=3XkzUOFfHh0fCWOASbg0z6b5fVdOBEmZqgDelVBlt-w,12421
+sdvplot/matplotlib.py,sha256=sQNiAsDPUyGlizcqhuI93F3PyCIEokD-gmVQO5UJobI,43821
+sdvplot/plotly.py,sha256=RYuPT-2dS8_h7rbcQwpZ3avjPU9iR8iJtHARXBGcBkU,27926
+sdvplot/plotnine.py,sha256=XJWb4A08zuCrAYEPf317TRAI1pS-1xvk_fNOG4eIVUU,51575
+sdvplot/plottable.py,sha256=l055fHY6uEk0Ineeg1NUVssLWHaFqtdePUTBOTfURiI,5702
+sdvplot/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sdvplot/pygal.py,sha256=MsZI3l6r6UFITDKwfwPhYRcJzosD6l-X68naaG1mufU,18037
+sdvplot/reactable.py,sha256=z7qi8PVM6Y6fmvvq8Ls0_7VmpmodG2nPyRRusKWL3H0,20478
+sdvplot/testing.py,sha256=iYMpWwaUzp8SEqbQGQ2ZBlY_DtnvoB6hnRfMuYF35RU,28656
+sdvplot/typing.py,sha256=D7hJkTn9rjJ2ZD9IDvlAE5qaZO13qpqVONTxBTWFXTI,779
+sdvplot/data/INDEX_VERSION,sha256=SDR0zYmUAjTwHsEfvXzMxchlyoSyQMcYTwiRLP0FRuA,13
+sdvplot/data/aliases.parquet,sha256=vCI-gOXLIMTDlof5TqZfifEFuGBf73Z0hYkGlDn1MC8,200988
+sdvplot/data/teams.parquet,sha256=0v1UR5XTLPLtcxbOLseDFQt8i8Cv3Rt1S--esMS66Ig,123744
+sdvplot/great_tables/__init__.py,sha256=uk08XJm6Bz5vdxP6igi-MMbQeBsKsmRutnqDWAd0czQ,7573
+sdvplot/great_tables/_cells.py,sha256=_zZRBXKaJPcl_ol96lf1hje4yEkiHJt-EAmOxCAeuHc,73600
+sdvplot/great_tables/_export.py,sha256=p-a8CcYcv6wRRoxKqmYqGel8Zz6yibZv2tTy9Mc0J8s,36523
+sdvplot/great_tables/_layout.py,sha256=O8d4k-iGGDtCL44nCWAbHwsr7wF2jgk0-lfNJrAXin8,77918
+sdvplot/great_tables/_marks.py,sha256=NVSiDZ9C1C38PUUHtcS2xkOutwu8977BgVjP0q8mJ8U,35865
+sdvplot/great_tables/_themes.py,sha256=gDDLFAvnajYH2IzXjoxKVpsDk_eqIAdMcQBYYX4OSEg,91569
+sdvplot-0.1.0.dist-info/METADATA,sha256=o7KJll0Dh5IGkmSnDRBUPBhgwZ4039N17yYOwJRSqBk,8647
+sdvplot-0.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+sdvplot-0.1.0.dist-info/licenses/LICENSE,sha256=llGQBA8uOMP-hqaJ2dFyl-WOkuovpKV1oyBGsi-WzWA,1069
+sdvplot-0.1.0.dist-info/RECORD,,

sdvplot-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.32.4
+Root-Is-Purelib: true
+Tag: py3-none-any

sdvplot-0.1.0.dist-info/licenses/LICENSE

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