sweatstack 0.74.0__tar.gz → 0.75.0__tar.gz

{sweatstack-0.74.0 → sweatstack-0.75.0}/.claude/skills/sweatstack-python/client.md

@@ -163,6 +163,21 @@ trace = client.create_trace(
     tags=["test"],
     notes="Lactate threshold test",
 )
+
+# Update a trace (full replace — fields not provided are set to null)
+client.update_trace(
+    trace.id,
+    timestamp=trace.timestamp,
+    lactate=2.8,               # corrected value
+    rpe=trace.rpe,             # must re-pass to keep existing values
+    heart_rate=trace.heart_rate,
+    sport=trace.sport,
+    tags=trace.tags,
+    notes=trace.notes,
+)
+
+# Delete a trace
+client.delete_trace("trace_id")
 ```
 
 ## Tests
@@ -373,6 +388,6 @@ df = sweatstack.get_latest_activity_data()
 - **`sport` (singular) vs `sports` (list):** `get_latest_activity(sport=...)` and `create_trace(sport=...)` take a single sport. All other methods that filter by sport use `sports=[...]` (list). The singular `sport` parameter on longitudinal methods is deprecated.
 - **DataFrames have standard dtypes.** The library converts API-optimized types (Int16, float16) to float64/datetime64[ns] automatically.
 - **`as_dataframe=True`** is available on `get_activities()`, `get_traces()`, `get_tests()`, and `get_dailies()`. Time-series methods (`get_activity_data`, `get_longitudinal_data`, etc.) always return DataFrames.
-- **`update_test()` is a full replace.** Omitted optional fields are set to null. Always re-pass all fields you want to keep (e.g. `results=test.results`).
+- **`update_test()` and `update_trace()` are full replaces.** Omitted optional fields are set to null. Always re-pass all fields you want to keep.
 - **`summary` fields are optional.** Always null-check: `activity.summary.power.mean if activity.summary and activity.summary.power else None`.
 - **`metrics` on ActivitySummary** lists available data streams, not the data itself. Use to check availability before calling `get_activity_data()`.

{sweatstack-0.74.0 → sweatstack-0.75.0}/CHANGELOG.md

@@ -6,6 +6,12 @@ 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.75.0] - 2026-04-23
+
+### Added
+- Update and delete traces: `update_trace()` and `delete_trace()` methods for full trace lifecycle management.
+
+
 ## [0.74.0] - 2026-04-22
 
 ### Added

{sweatstack-0.74.0 → sweatstack-0.75.0}/PKG-INFO

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

{sweatstack-0.74.0 → sweatstack-0.75.0}/pyproject.toml

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

{sweatstack-0.74.0 → sweatstack-0.75.0}/src/sweatstack/client.py

@@ -1759,6 +1759,72 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
             self._raise_for_status(response)
             return TraceDetails.model_validate(response.json())
 
+    def update_trace(
+        self,
+        trace_id: str,
+        *,
+        timestamp: datetime,
+        lactate: float | None = None,
+        rpe: int | None = None,
+        notes: str | None = None,
+        power: int | None = None,
+        speed: float | None = None,
+        heart_rate: int | None = None,
+        tags: list[str] | None = None,
+        sport: Sport | str | None = None,
+    ) -> None:
+        """Updates a trace by replacing all fields.
+
+        This is a full replace operation. Fields not provided will be set to null
+        server-side. To modify a single field, first fetch the trace with
+        ``get_traces()``, then pass all fields back.
+
+        Args:
+            trace_id: The unique identifier of the trace to update.
+            timestamp: The date and time when the trace was recorded.
+            lactate: Optional blood lactate concentration in mmol/L.
+            rpe: Optional rating of perceived exertion (typically on a scale of 1-10).
+            notes: Optional text notes associated with this trace.
+            power: Optional power measurement in watts.
+            speed: Optional speed measurement in meters per second.
+            heart_rate: Optional heart rate measurement in beats per minute.
+            tags: Optional list of tags to associate with this trace.
+            sport: Optional sport to associate with this trace.
+
+        Raises:
+            HTTPStatusError: If the API request fails.
+        """
+        sport = self._enums_to_strings([sport])[0] if sport else None
+        with self._http_client() as client:
+            response = client.put(
+                url=f"/api/v1/traces/{trace_id}",
+                json={
+                    "timestamp": timestamp.isoformat(),
+                    "lactate": lactate,
+                    "rpe": rpe,
+                    "notes": notes,
+                    "power": power,
+                    "speed": speed,
+                    "heart_rate": heart_rate,
+                    "tags": tags,
+                    "sport": sport,
+                },
+            )
+            self._raise_for_status(response)
+
+    def delete_trace(self, trace_id: str) -> None:
+        """Deletes a trace.
+
+        Args:
+            trace_id: The unique identifier of the trace to delete.
+
+        Raises:
+            HTTPStatusError: If the API request fails.
+        """
+        with self._http_client() as client:
+            response = client.delete(url=f"/api/v1/traces/{trace_id}")
+            self._raise_for_status(response)
+
     # -------------------------------------------------------------------------
     # Tests
     # -------------------------------------------------------------------------