sweatstack 0.79.0__tar.gz → 0.81.0__tar.gz

{sweatstack-0.79.0 → sweatstack-0.81.0}/.claude/settings.local.json

@@ -23,7 +23,15 @@
       "mcp__sentry__get_sentry_resource",
       "Bash(awk *)",
       "Bash(git show *)",
-      "Read(//tmp/**)"
+      "Read(//tmp/**)",
+      "WebFetch(domain:pypi.org)",
+      "WebFetch(domain:github.com)",
+      "WebFetch(domain:raw.githubusercontent.com)",
+      "Bash(uv add *)",
+      "Bash(sed -n '42,50p' src/sweatstack/client.py)",
+      "Bash(sed -n '1017,1022p' src/sweatstack/client.py)",
+      "Bash(sed -i '' 's/sport=cycling\\\\.road&sport=cycling\\\\.tt/sport=cycling.road\\\\&sport=cycling.time_trial/' docs-dev/changelog.md)",
+      "Bash(sed -n '25p' docs-dev/changelog.md)"
     ],
     "deny": []
   }

{sweatstack-0.79.0 → sweatstack-0.81.0}/AGENTS.md

@@ -16,7 +16,7 @@ you add or change a surface, the default is to mirror the server:
 | `POST /api/v1/traces/`                  | `client.create_trace(...)`              |
 | `PUT /api/v1/traces/{id}` (full-replace)| `client.update_trace(trace_id, ...)`    |
 | `DELETE /api/v1/dailies/{id}`           | `client.delete_daily(daily_id)`         |
-| query param `?sport=cycling&sport=running` | `sports=[Sport.cycling, Sport.running]` |
+| query param `?sport=cycling&sport=running` | `sports=[Sport("cycling"), Sport("running")]` |
 | JSON body field `test_id`               | kwarg `test_id`                         |
 | OpenAPI enum value `"auto"`             | `TraceResolution.auto`                  |
 
@@ -44,7 +44,7 @@ and pagination shape. Don't redesign the API in Python.
 ```
 src/sweatstack/
 ├── openapi_schemas.py   # AUTO-GENERATED. Never hand-edit.
-├── schemas.py           # Re-exports + Enum._missing_ / display_name helpers.
+├── schemas.py           # Re-exports (incl. OST Sport/Modifier) + Metric/Scope/DailyMeasure helpers.
 ├── exceptions.py        # Public error contract. No httpx types leak.
 ├── client.py            # Single Client class + module-level singletons.
 ├── utils.py             # Dataframe / JWT helpers.
@@ -72,6 +72,10 @@ Skipping step 3 silently breaks the public surface. Same for new enums.
   bottom of `client.py`. Forgetting is silent.
 - **Enum-typed params accept `Enum | str`** and route through
   `_enums_to_strings`. Don't introduce strict-enum-only parameters.
+- **`Sport` is the OpenSportTaxonomy type** (`open_sport_taxonomy.Sport`), not a generated enum.
+  Construct with `Sport("cycling.road")` or `Sport.parse(value)`; serialise with `str(sport)`. Codegen
+  binds the `sport` field to OST's permissive `SportField` (cli.py `_bind_sport_to_ost`), so regen is
+  safe and `sport`-typed fields keep decoding to `Sport`.
 - **Tests are offline.** No network calls. Use `Client.__new__(Client)` to
   bypass init when you need an instance for a helper method.
 - **`update_*` methods are full-replace.** Document the silent-clear

{sweatstack-0.79.0 → sweatstack-0.81.0}/CHANGELOG.md

@@ -5,6 +5,71 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.81.0] - 2026-06-16
+
+The SweatStack API has fully adopted [OpenSportTaxonomy](https://github.com/SweatStack/open-sport-taxonomy)
+(OST), and so has this client. `sweatstack.Sport` is now the OST `Sport` type instead of a bespoke enum.
+This is a **breaking change** for code that uses `Sport`.
+
+### Changed (breaking)
+- `sweatstack.Sport` is now `open_sport_taxonomy.Sport` — a rich type (`.code`, `.label`, `.modifiers`,
+  `.parent`, `.is_subsport_of()`, `.resolve()`, `Sport.parse()`, `Sport.all()`) rather than a string
+  enum. There are no `Sport.cycling_road`-style members; construct a known sport with
+  `Sport("cycling.road")` or parse external input with `Sport.parse(value)`. The bespoke helpers
+  (`root_sport()`, `parent_sport()`, `is_sub_sport_of()`, `is_root_sport()`, `display_name()`) are
+  removed in favour of OST's native API.
+- Sport values are now OST values, e.g. `cycling.trainer` → `cycling+stationary`, `cycling.tt` →
+  `cycling.time_trial`, `cross_country_skiing` → `xc_skiing`, `unknown` → `generic`. Response data,
+  longitudinal DataFrames and `get_sports()` all return OST values; requests send OST values.
+
+### Added
+- `sweatstack.Modifier` (re-exported from OpenSportTaxonomy) for inspecting sport modifiers. (For typed
+  sport annotations, `StandardSport` is available from `open_sport_taxonomy` directly.)
+- `open-sport-taxonomy[pydantic]` is now a runtime dependency. Response models consume `sport` via OST's
+  permissive `SportField`, so sports newer than the bundled taxonomy are preserved rather than rejected.
+
+### Migration
+Hand the following prompt to a coding agent, or apply it by hand:
+
+```text
+Migrate this codebase to sweatstack 0.81.0, which replaces its custom `Sport` enum with the
+OpenSportTaxonomy type (`open_sport_taxonomy.Sport`). `from sweatstack import Sport` is now that type.
+
+1. Construction (there are no enum members like `Sport.cycling_road`):
+   - Known sport in app code -> `Sport("cycling.road")` (raises on an unknown code/modifier).
+   - From an API/string value -> `Sport.parse(value)` (permissive; never raises; preserves unknown).
+   - For typed annotations/autocomplete of the standard catalogue ->
+     `from open_sport_taxonomy import StandardSport` (a Literal).
+
+2. These sport VALUES changed; update hardcoded strings or members:
+   cycling.trainer->cycling+stationary, running.treadmill->running+stationary,
+   rowing.ergometer->rowing+stationary, cycling.tt->cycling.time_trial,
+   cycling.mountainbike->cycling.mountain, cross_country_skiing[.classic|.skate]->xc_skiing[...],
+   unknown->generic. ("stationary" etc. are now modifiers, appended with `+`; see sport.modifiers.)
+
+3. Methods / attributes:
+   Sport.cycling_road          -> Sport("cycling.road")
+   sport.value                 -> str(sport)  (canonical, incl. modifiers) or sport.code
+   sport.display_name()        -> sport.label
+   sport.parent_sport()        -> sport.parent
+   sport.is_sub_sport_of(x)    -> sport.is_subsport_of(x)   (x is a single Sport; for a list use
+                                  any(sport.is_subsport_of(s) for s in xs))
+   sport.root_sport()          -> Sport(sport.code.split(".")[0])
+   sport.is_root_sport()       -> ("." not in sport.code and not sport.modifiers)
+   for s in Sport: ...         -> for s in Sport.all(): ...
+
+4. Equality works: `activity.sport == Sport("cycling+stationary")`. Compare against the NEW value.
+
+After editing, run the test suite and fix any remaining references. Do not add a compatibility shim;
+migrate call sites to the OST API directly.
+```
+
+
+## [0.80.0] - 2026-06-12
+
+### Changed
+- Makes the Sport enum forward compatible with OpenSportTaxonomy sports.
+
 
 ## [0.79.0] - 2026-05-28
 

{sweatstack-0.79.0 → sweatstack-0.81.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sweatstack
-Version: 0.79.0
+Version: 0.81.0
 Summary: The official Python client for SweatStack
 Project-URL: Homepage, https://sweatstack.no
 Project-URL: Documentation, https://docs.sweatstack.no/getting-started/
@@ -23,6 +23,7 @@ Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
 Requires-Dist: email-validator>=2.2.0
 Requires-Dist: httpx>=0.28.1
+Requires-Dist: open-sport-taxonomy[pydantic]>=0.10.0
 Requires-Dist: pandas>=2.2.3
 Requires-Dist: platformdirs>=4.0.0
 Requires-Dist: pyarrow>=18.0.0
@@ -43,3 +44,7 @@ Description-Content-Type: text/markdown
 This is the official Python client library for SweatStack.
 
 Documentation can be found [here](https://docs.sweatstack.no/getting-started/).
+
+Sports follow [OpenSportTaxonomy](https://open-sport-taxonomy.sweatstack.no): `sweatstack.Sport` is the
+OST `Sport` type. See the [OpenSportTaxonomy Python guide](https://github.com/SweatStack/open-sport-taxonomy/blob/main/python/README.md)
+for the full `Sport` API.

sweatstack-0.81.0/README.md

@@ -0,0 +1,9 @@
+# SweatStack Python client library
+
+This is the official Python client library for SweatStack.
+
+Documentation can be found [here](https://docs.sweatstack.no/getting-started/).
+
+Sports follow [OpenSportTaxonomy](https://open-sport-taxonomy.sweatstack.no): `sweatstack.Sport` is the
+OST `Sport` type. See the [OpenSportTaxonomy Python guide](https://github.com/SweatStack/open-sport-taxonomy/blob/main/python/README.md)
+for the full `Sport` API.

{sweatstack-0.79.0 → sweatstack-0.81.0}/docs/everything.rst

@@ -151,8 +151,13 @@ sweatstack.schemas
 Sport
 ~~~~~
 
-.. autoclass:: sweatstack.schemas.Sport
-    :members: root_sport, parent_sport, is_sub_sport_of, is_root_sport, display_name
+``sweatstack.Sport`` is the `OpenSportTaxonomy <https://github.com/SweatStack/open-sport-taxonomy>`_
+``Sport`` type. Construct a known sport with ``Sport("cycling.road")`` and parse external/API input
+with ``Sport.parse(value)``. See the OpenSportTaxonomy documentation for the full API (``code``,
+``label``, ``modifiers``, ``parent``, ``disciplines``, ``is_subsport_of``, ``resolve``, ``all``).
+
+.. autoclass:: sweatstack.Sport
+    :members: parse, resolve, is_subsport_of, all
     :undoc-members:
 
 Metric