spells-mtg 0.2.1__tar.gz → 0.2.3__tar.gz

spells_mtg-0.2.1/README.md → spells_mtg-0.2.3/PKG-INFO

@@ -1,3 +1,14 @@
+Metadata-Version: 2.1
+Name: spells-mtg
+Version: 0.2.3
+Summary: analaysis of 17Lands.com public datasets
+Author-Email: Joel Barnes <oelarnes@gmail.com>
+License: MIT
+Requires-Python: >=3.11
+Requires-Dist: polars>=1.14.0
+Requires-Dist: wget>=3.2
+Description-Content-Type: text/markdown
+
 # 🪄 spells ✨
 
 **spells** is a python package that tutors up blazing-fast and extensible analysis of the public data sets provided by [17Lands](https://www.17lands.com/) and exiles the annoying and slow parts of your workflow. Spells exposes one first-class function, `summon`, which summons a Polars DataFrame to the battlefield.
@@ -53,7 +64,7 @@ Wall time: 80.8 ms
 ```
 Coverting to pandas DataFrame is as simple as invoking the chained call `summon(...).to_pandas()`.
 
-Spells is not affiliated with 17Lands. Please review the Usage Guidelines for 17lands data before using Spells, and consider supporting their patreon. Spells is free and open-source; please consider contributing and feel free to make use of the source code under the terms of the MIT license.
+Spells is not affiliated with 17Lands. Please review the [Usage Guidelines](https://www.17lands.com/usage_guidelines) for 17lands data before using Spells, and consider supporting their patreon. Spells is free and open-source; please consider contributing and feel free to make use of the source code under the terms of the MIT license.
 
 ## spells
 
@@ -72,6 +83,7 @@ Spells is not affiliated with 17Lands. Please review the Usage Guidelines for 17
 - Provides optional enums for all base columns and built-in extensions, as well as for custom extension parameters
 - Uses Polars expressions to support second-stage aggregations and beyond like game-weighted z-scores with one call to summon
 - Works on MacOS, Linux, and Windows
+- Provides example notebooks to kickstart your exploration
 
 ## summon
 
@@ -182,6 +194,8 @@ Spells is still in development and could benefit from many new features and impr
 
 If you are new to Python, I recommend using a package manager like poetry, pdm or uv to create a virtual environment and manage your project.
 
+Once Spells is installed, check out the notebooks under [examples](https://github.com/oelarnes/spells/tree/main/examples) for ideas on getting started.
+
 ## Why did you make this? Who is it for?
 
 Earlier this year I developed a card quality metric called [DEq](https://docs.google.com/spreadsheets/d/1n1pfrb5q_2ICYk-vfF3Uwo8t61DJU-5T_DFe0dwk8DY/edit), short for "Estimated Draft Equity", which is designed to estimate the average value of selecting a card in draft relative to a comparable baseline, in order to improve on commonly-used metrics like GIH WR, which has a number of major and minor problems when interpreted as a card quality metric. DEq depends on the daily drops from 17Lands.com and won't be replaced by this static kind of analysis.
@@ -238,8 +252,8 @@ So that's it, that's what Spells does from a high level. `summon` will hand off
 ## CLI
 
 Spells includes a command-line interface `spells` to manage your external data files and local cache. Spells will download files to an appropriate file location on your system, 
-typically `~/.local/share/spells` on Unix-like platforms and `C:\Users\{Username}\AppData\Local\Spells` on Windows. 
-To use `spells`, make sure Spells in installed in your environment using pip or a package manager, and type `spells help` into your shell, or dive in with `spells add DSK` or your favorite set. If Spells is installed globally using pipx, any local version of Spells will be able to read the managed files.
+typically `~/.local/share/spells` on Unix-like platforms and `C:\Users\{Username}\AppData\Local\Spells` on Windows, or to a location specified by the environment variable `SPELLS_DATA_HOME`.
+To use `spells`, make sure Spells is installed in your environment using pip or a package manager, and type `spells help` into your shell, or dive in with `spells add DSK` or your favorite set. If Spells is installed globally using pipx, any local version of Spells will be able to read the managed files.
 
 ## API
 

spells_mtg-0.2.1/PKG-INFO → spells_mtg-0.2.3/README.md

@@ -1,14 +1,3 @@
-Metadata-Version: 2.1
-Name: spells-mtg
-Version: 0.2.1
-Summary: analaysis of 17Lands.com public datasets
-Author-Email: Joel Barnes <oelarnes@gmail.com>
-License: MIT
-Requires-Python: >=3.11
-Requires-Dist: polars>=1.14.0
-Requires-Dist: wget>=3.2
-Description-Content-Type: text/markdown
-
 # 🪄 spells ✨
 
 **spells** is a python package that tutors up blazing-fast and extensible analysis of the public data sets provided by [17Lands](https://www.17lands.com/) and exiles the annoying and slow parts of your workflow. Spells exposes one first-class function, `summon`, which summons a Polars DataFrame to the battlefield.
@@ -64,7 +53,7 @@ Wall time: 80.8 ms
 ```
 Coverting to pandas DataFrame is as simple as invoking the chained call `summon(...).to_pandas()`.
 
-Spells is not affiliated with 17Lands. Please review the Usage Guidelines for 17lands data before using Spells, and consider supporting their patreon. Spells is free and open-source; please consider contributing and feel free to make use of the source code under the terms of the MIT license.
+Spells is not affiliated with 17Lands. Please review the [Usage Guidelines](https://www.17lands.com/usage_guidelines) for 17lands data before using Spells, and consider supporting their patreon. Spells is free and open-source; please consider contributing and feel free to make use of the source code under the terms of the MIT license.
 
 ## spells
 
@@ -83,6 +72,7 @@ Spells is not affiliated with 17Lands. Please review the Usage Guidelines for 17
 - Provides optional enums for all base columns and built-in extensions, as well as for custom extension parameters
 - Uses Polars expressions to support second-stage aggregations and beyond like game-weighted z-scores with one call to summon
 - Works on MacOS, Linux, and Windows
+- Provides example notebooks to kickstart your exploration
 
 ## summon
 
@@ -193,6 +183,8 @@ Spells is still in development and could benefit from many new features and impr
 
 If you are new to Python, I recommend using a package manager like poetry, pdm or uv to create a virtual environment and manage your project.
 
+Once Spells is installed, check out the notebooks under [examples](https://github.com/oelarnes/spells/tree/main/examples) for ideas on getting started.
+
 ## Why did you make this? Who is it for?
 
 Earlier this year I developed a card quality metric called [DEq](https://docs.google.com/spreadsheets/d/1n1pfrb5q_2ICYk-vfF3Uwo8t61DJU-5T_DFe0dwk8DY/edit), short for "Estimated Draft Equity", which is designed to estimate the average value of selecting a card in draft relative to a comparable baseline, in order to improve on commonly-used metrics like GIH WR, which has a number of major and minor problems when interpreted as a card quality metric. DEq depends on the daily drops from 17Lands.com and won't be replaced by this static kind of analysis.
@@ -249,8 +241,8 @@ So that's it, that's what Spells does from a high level. `summon` will hand off
 ## CLI
 
 Spells includes a command-line interface `spells` to manage your external data files and local cache. Spells will download files to an appropriate file location on your system, 
-typically `~/.local/share/spells` on Unix-like platforms and `C:\Users\{Username}\AppData\Local\Spells` on Windows. 
-To use `spells`, make sure Spells in installed in your environment using pip or a package manager, and type `spells help` into your shell, or dive in with `spells add DSK` or your favorite set. If Spells is installed globally using pipx, any local version of Spells will be able to read the managed files.
+typically `~/.local/share/spells` on Unix-like platforms and `C:\Users\{Username}\AppData\Local\Spells` on Windows, or to a location specified by the environment variable `SPELLS_DATA_HOME`.
+To use `spells`, make sure Spells is installed in your environment using pip or a package manager, and type `spells help` into your shell, or dive in with `spells add DSK` or your favorite set. If Spells is installed globally using pipx, any local version of Spells will be able to read the managed files.
 
 ## API
 

{spells_mtg-0.2.1 → spells_mtg-0.2.3}/pyproject.toml

@@ -11,7 +11,7 @@ dependencies = [
 ]
 requires-python = ">=3.11"
 readme = "README.md"
-version = "0.2.1"
+version = "0.2.3"
 
 [project.license]
 text = "MIT"

{spells_mtg-0.2.1 → spells_mtg-0.2.3}/spells/columns.py

@@ -24,7 +24,7 @@ class ColumnDefinition:
     name: str
     col_type: ColType
     expr: pl.Expr | tuple[pl.Expr, ...]
-    views: tuple[View, ...]
+    views: set[View]
     dependencies: tuple[str, ...]
     signature: str
 

{spells_mtg-0.2.1 → spells_mtg-0.2.3}/spells/draft_data.py

@@ -53,22 +53,23 @@ def _get_names(set_code: str) -> tuple[str, ...]:
 
 
 def _hydrate_col_defs(set_code: str, col_spec_map: dict[str, ColumnSpec]):
-    def get_views(spec: ColumnSpec) -> list[View]:
+    def get_views(spec: ColumnSpec) -> set[View]:
         if spec.name == ColName.NAME or spec.col_type == ColType.AGG:
-            return []
+            return set()
         if spec.col_type == ColType.CARD_ATTR:
-            return [View.CARD]
+            return {View.CARD}
         if spec.views is not None:
-            return spec.views
+            return set(spec.views)
         assert (
             spec.dependencies is not None
         ), f"Col {spec.name} should have dependencies"
 
-        views = []
-        for dep in spec.dependencies:
-            views.extend(get_views(col_spec_map[dep]))
+        views = functools.reduce(
+            lambda prev, curr: prev.intersection(curr),
+            [get_views(col_spec_map[dep]) for dep in spec.dependencies],
+        )
 
-        return list(set(views))
+        return views
 
     names = _get_names(set_code)
     assert len(names) > 0, "there should be names"
@@ -118,7 +119,7 @@ def _hydrate_col_defs(set_code: str, col_spec_map: dict[str, ColumnSpec]):
         cdef = ColumnDefinition(
             name=spec.name,
             col_type=spec.col_type,
-            views=tuple(views),
+            views=views,
             expr=expr,
             dependencies=dependencies,
             signature=signature,

{spells_mtg-0.2.1 → spells_mtg-0.2.3}/spells/manifest.py

@@ -99,8 +99,6 @@ def _resolve_view_cols(
     For each view ('game', 'draft', and 'card'), return the columns
     that must be present at the aggregation step. 'name' need not be
     included, and 'pick' will be added if needed.
-
-    Dependencies within base views will be resolved by `col_df`.
     """
     unresolved_cols = col_set
     view_resolution = {}
@@ -169,7 +167,7 @@ def create(
     needed_views = frozenset()
     for view, cols_for_view in view_cols.items():
         for col in cols_for_view:
-            if col_def_map[col].views == (view,):  # only found in this view
+            if col_def_map[col].views == {view}:  # only found in this view
                 needed_views = needed_views.union({view})
 
     view_cols = {v: view_cols[v] for v in needed_views}