sweatstack 0.86.0__tar.gz → 0.87.0__tar.gz

{sweatstack-0.86.0 → sweatstack-0.87.0}/.claude/settings.local.json

@@ -31,7 +31,8 @@
       "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)"
+      "Bash(sed -n '25p' docs-dev/changelog.md)",
+      "Bash(uv build *)"
     ],
     "deny": []
   }

{sweatstack-0.86.0 → sweatstack-0.87.0}/CHANGELOG.md

@@ -6,6 +6,13 @@ 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.87.0] - 2026-06-30
+
+### Changed
+
+- **Breaking:** the codec previously named NLEC is now AISC (Adaptive Intensity Segmentation Codec), and its parameters are renamed: `nlec_on` is now `segmentation_on` (on `get_activity_data`, `get_latest_activity_data`, `get_longitudinal_data`) and `nlec` is now `segmentation` (on `get_activity_mean_max`, `get_latest_activity_mean_max`). No backwards-compatible aliases.
+
+
 ## [0.86.0] - 2026-06-18
 
 ### Changed

{sweatstack-0.86.0 → sweatstack-0.87.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sweatstack
-Version: 0.86.0
+Version: 0.87.0
 Summary: The official Python client for SweatStack
 Project-URL: Homepage, https://sweatstack.no
 Project-URL: Documentation, https://docs.sweatstack.no/getting-started/

{sweatstack-0.86.0 → sweatstack-0.87.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sweatstack"
-version = "0.86.0"
+version = "0.87.0"
 description = "The official Python client for SweatStack"
 readme = "README.md"
 license = "MIT"

{sweatstack-0.86.0 → sweatstack-0.87.0}/src/sweatstack/client.py

@@ -1219,18 +1219,18 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
     def get_activity_data(
         self,
         activity_id: str,
-        nlec_on: Literal["power", "speed"] | None = None,
+        segmentation_on: Literal["power", "speed"] | None = None,
         metrics: list[Metric | str] | None = None,
     ) -> pd.DataFrame:
         """Gets the raw data for a specific activity.
 
-        This method retrieves the time-series data for a given activity, with optional NLEC
-        (near-lossless effort codec) downsampling to reduce data points for visualization.
+        This method retrieves the time-series data for a given activity, with optional AISC
+        (Adaptive Intensity Segmentation Codec) downsampling to reduce data points for visualization.
 
         Args:
             activity_id: The unique identifier of the activity.
-            nlec_on: Downsample with NLEC (near-lossless effort codec), keyed on 
-                either "power" or "speed" data. If None, no NLEC is applied.
+            segmentation_on: Downsample with AISC (Adaptive Intensity Segmentation Codec), keyed on
+                either "power" or "speed" data. If None, no AISC is applied.
             metrics: Optional list of metrics to include in the results. Can be a list of Metric enums or strings.
 
         Returns:
@@ -1241,8 +1241,8 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
             SweatStackAPIError: If the API request fails for any other reason.
         """
         params = {}
-        if nlec_on is not None:
-            params["nlec_on"] = nlec_on
+        if segmentation_on is not None:
+            params["segmentation_on"] = segmentation_on
         if metrics is not None:
             params["metrics"] = self._enums_to_strings(metrics)
 
@@ -1260,7 +1260,7 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
         self,
         activity_id: str,
         metric: Literal[Metric.power, Metric.speed] | Literal["power", "speed"],
-        nlec: bool = False,
+        segmentation: bool = False,
     ) -> pd.DataFrame:
         """Gets the mean-max data for a specific activity.
 
@@ -1270,7 +1270,7 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
         Args:
             activity_id: The unique identifier of the activity.
             metric: The metric to calculate mean-max values for, either "power" or "speed".
-            nlec: Downsample with NLEC (near-lossless effort codec) to reduce data points
+            segmentation: Downsample with AISC (Adaptive Intensity Segmentation Codec) to reduce data points
                 for visualization. Defaults to False.
 
         Returns:
@@ -1286,7 +1286,7 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
                 url=f"/api/v1/activities/{activity_id}/mean-max",
                 params={
                     "metric": metric,
-                    "nlec": nlec,
+                    "segmentation": segmentation,
                 },
             )
             self._raise_for_status(response)
@@ -1332,7 +1332,7 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
     def get_latest_activity_data(
         self,
         sport: Sport | str | None = None,
-        nlec_on: Literal["power", "speed"] | None = None,
+        segmentation_on: Literal["power", "speed"] | None = None,
         metrics: list[Metric | str] | None = None,
     ) -> pd.DataFrame:
         """Gets the data for the latest activity of a specific sport.
@@ -1342,7 +1342,7 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
 
         Args:
             sport: Optional sport to filter by. Can be a Sport enum or string.
-            nlec_on: Metric to downsample on with NLEC (near-lossless effort codec); omit to disable.
+            segmentation_on: Metric to downsample on with AISC (Adaptive Intensity Segmentation Codec); omit to disable.
                 Can be either "power" or "speed". Defaults to None.
             metrics: Optional list of metrics to include in the results. Can be a list of Metric enums or strings.
 
@@ -1353,13 +1353,13 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
             SweatStackAPIError: If the API request fails.
         """
         activity = self.get_latest_activity(sport=sport)
-        return self.get_activity_data(activity.id, nlec_on, metrics=metrics)
+        return self.get_activity_data(activity.id, segmentation_on, metrics=metrics)
 
     def get_latest_activity_mean_max(
         self,
         metric: Literal[Metric.power, Metric.speed] | Literal["power", "speed"],
         sport: Sport | str | None = None,
-        nlec: bool = False,
+        segmentation: bool = False,
     ) -> pd.DataFrame:
         """Gets the mean-max curve for the latest activity of a specific sport.
 
@@ -1369,7 +1369,7 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
         Args:
             metric: The metric to calculate the mean-max curve for. Can be either "power" or "speed".
             sport: Optional sport to filter by. Can be a Sport enum or string.
-            nlec: Downsample the mean-max curve with NLEC (near-lossless effort codec).
+            segmentation: Downsample the mean-max curve with AISC (Adaptive Intensity Segmentation Codec).
                 Defaults to False.
 
         Returns:
@@ -1379,7 +1379,7 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
             SweatStackAPIError: If the API request fails.
         """
         activity = self.get_latest_activity(sport=sport)
-        return self.get_activity_mean_max(activity.id, metric, nlec)
+        return self.get_activity_mean_max(activity.id, metric, segmentation)
 
     def get_longitudinal_data(
         self,
@@ -1389,7 +1389,7 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
         start: date | str,
         end: date | str | None = None,
         metrics: list[Metric | str] | None = None,
-        nlec_on: Literal[Metric.power, Metric.speed] | Literal["power", "speed"] | None = None,
+        segmentation_on: Literal[Metric.power, Metric.speed] | Literal["power", "speed"] | None = None,
     ) -> pd.DataFrame:
         """Gets longitudinal data for activities within a specified date range.
 
@@ -1402,7 +1402,7 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
             start: The start date for the data range. Can be a date object or string in ISO format.
             end: Optional end date for the data range. Can be a date object or string in ISO format.
             metrics: Optional list of metrics to include in the results. Can be a list of Metric enums or strings.
-            nlec_on: Metric to downsample on with NLEC (near-lossless effort codec); omit to disable.
+            segmentation_on: Metric to downsample on with AISC (Adaptive Intensity Segmentation Codec); omit to disable.
                 Can be either "power" or "speed". Defaults to None.
 
         Returns:
@@ -1431,8 +1431,8 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
             params["end"] = end
         if metrics is not None:
             params["metrics"] = self._enums_to_strings(metrics)
-        if nlec_on is not None:
-            params["nlec_on"] = self._enums_to_strings([nlec_on])[0]
+        if segmentation_on is not None:
+            params["segmentation_on"] = self._enums_to_strings([segmentation_on])[0]
 
         if self._cache_enabled():
             cache_key = self._generate_cache_key("longitudinal_data", **params)

sweatstack-0.87.0/tests/test_segmentation.py

@@ -0,0 +1,70 @@
+"""AISC (Adaptive Intensity Segmentation Codec) parameters are sent on the wire.
+
+Guards the `segmentation_on` / `segmentation` query-param contract (renamed from `nlec_on` / `nlec`
+in 0.87.0) and the clean break — the old names must no longer be accepted.
+"""
+
+from unittest.mock import MagicMock, patch
+
+import pandas as pd
+import pytest
+
+from sweatstack.client import Client
+
+
+@pytest.fixture
+def client():
+    c = Client.__new__(Client)
+    c.url = "https://test.sweatstack.no"
+    c._access_token = None
+    c.streamlit_compatible = False
+    c.skip_token_expiry_check = True
+    return c
+
+
+def _params_sent(client, call):
+    """Run `call`, mocking out HTTP + parquet, and return the query params sent to the server."""
+    response = MagicMock(status_code=200, content=b"")
+    http = MagicMock()
+    http.__enter__ = MagicMock(return_value=http)
+    http.__exit__ = MagicMock(return_value=False)
+    http.get.return_value = response
+
+    with patch.object(client, "_http_client", return_value=http), \
+         patch.object(client, "_raise_for_status"), \
+         patch.object(client, "_postprocess_dataframe", side_effect=lambda df: df), \
+         patch.object(client, "_cache_enabled", return_value=False), \
+         patch("sweatstack.client.pd.read_parquet", return_value=pd.DataFrame()):
+        call()
+    return http.get.call_args.kwargs["params"]
+
+
+def test_get_activity_data_sends_segmentation_on(client):
+    params = _params_sent(client, lambda: client.get_activity_data("a", segmentation_on="power"))
+    assert params["segmentation_on"] == "power"
+
+
+def test_get_activity_data_omits_segmentation_when_unset(client):
+    params = _params_sent(client, lambda: client.get_activity_data("a"))
+    assert "segmentation_on" not in params
+
+
+def test_get_longitudinal_data_sends_segmentation_on(client):
+    params = _params_sent(
+        client,
+        lambda: client.get_longitudinal_data(sports=["running"], start="2024-01-01", segmentation_on="power"),
+    )
+    assert params["segmentation_on"] == "power"
+
+
+def test_get_activity_mean_max_sends_segmentation(client):
+    params = _params_sent(client, lambda: client.get_activity_mean_max("a", "power", segmentation=True))
+    assert params["segmentation"] is True
+
+
+def test_old_nlec_kwargs_are_rejected(client):
+    # Clean break: the pre-0.87.0 names must raise, not silently no-op.
+    with pytest.raises(TypeError):
+        client.get_activity_data("a", nlec_on="power")
+    with pytest.raises(TypeError):
+        client.get_activity_mean_max("a", "power", nlec=True)

{sweatstack-0.86.0 → sweatstack-0.87.0}/uv.lock

@@ -2600,7 +2600,7 @@ wheels = [
 
 [[package]]
 name = "sweatstack"
-version = "0.86.0"
+version = "0.87.0"
 source = { editable = "." }
 dependencies = [
     { name = "email-validator" },