sweatstack 0.73.0__tar.gz → 0.75.0__tar.gz

{sweatstack-0.73.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
@@ -286,7 +301,13 @@ user = client.get_user("abc123", search_mode="id")
 # Create a managed user (no login credentials)
 user = client.create_user(first_name="John", last_name="Doe")
 
-# Team management
+# List teams you're a member/owner of
+teams = client.get_teams()                # list[TeamResponse] with .role
+
+# List teams you've authorized to access your data
+authorized = client.get_authorized_teams()  # list[AuthorizedTeamResponse] with .scopes
+
+# Team user management
 team_users = client.get_team_users(team_id="team_abc")
 athlete = client.get_team_user(team_id="team_abc", user="john")  # by name or ID
 client.authorize_team(team_id="team_abc", scopes=[Scope.data_read])
@@ -367,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.73.0 → sweatstack-0.75.0}/CHANGELOG.md

@@ -6,6 +6,18 @@ 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
+- Team listing — `get_teams()` returns teams you own or belong to, `get_authorized_teams()` returns teams you've granted data access to.
+
+
 ## [0.73.0] - 2026-04-09
 
 ### Added

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sweatstack
-Version: 0.73.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.73.0 → sweatstack-0.75.0}/pyproject.toml

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

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

@@ -29,9 +29,10 @@ from platformdirs import user_cache_dir, user_data_dir
 
 from .constants import DEFAULT_URL
 from .schemas import (
-    ActivityDetails, ActivitySummary, BackfillStatus, DailyMeasure, DailyResponse,
+    ActivityDetails, ActivitySummary, ApplicationMemberRole, AuthorizedTeamResponse,
+    BackfillStatus, DailyMeasure, DailyResponse,
     Marker, Metric, Scope, Sport,
-    TestDetails, TestResults, TestSummary, TokenResponse, TraceDetails,
+    TeamResponse, TestDetails, TestResults, TestSummary, TokenResponse, TraceDetails,
     UserInfoResponse, UserResponse, UserSummary
 )
 from .utils import convert_to_standard_dtypes, decode_jwt_body, make_dataframe_streamlit_compatible
@@ -1758,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
     # -------------------------------------------------------------------------
@@ -2278,6 +2345,34 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
             self._raise_for_status(response)
             return UserResponse.model_validate(response.json())
 
+    def get_teams(self) -> list[TeamResponse]:
+        """Lists all teams the current user owns or is a member of.
+
+        Returns:
+            list[TeamResponse]: Teams with the user's role (owner or member).
+
+        Raises:
+            HTTPStatusError: If the API request fails.
+        """
+        with self._http_client() as client:
+            response = client.get(url="/api/v1/teams/")
+            self._raise_for_status(response)
+            return [TeamResponse.model_validate(team) for team in response.json()]
+
+    def get_authorized_teams(self) -> list[AuthorizedTeamResponse]:
+        """Lists all teams the current user has authorized to access their data.
+
+        Returns:
+            list[AuthorizedTeamResponse]: Teams with their granted scopes.
+
+        Raises:
+            HTTPStatusError: If the API request fails.
+        """
+        with self._http_client() as client:
+            response = client.get(url="/api/v1/teams/authorized")
+            self._raise_for_status(response)
+            return [AuthorizedTeamResponse.model_validate(team) for team in response.json()]
+
     def get_team_users(self, team_id: str) -> list[UserSummary]:
         """Lists all users who have authorized a team to access their data.
 
@@ -2553,6 +2648,8 @@ _generate_singleton_methods(
         "get_user",
         "get_users",
         "create_user",
+        "get_teams",
+        "get_authorized_teams",
         "get_team_users",
         "get_team_user",
         "authorize_team",

{sweatstack-0.73.0 → sweatstack-0.75.0}/src/sweatstack/openapi_schemas.py

@@ -1,6 +1,6 @@
 # generated by datamodel-codegen:
 #   filename:  openapi.json
-#   timestamp: 2026-04-09T11:13:41+00:00
+#   timestamp: 2026-04-22T12:23:13+00:00
 
 from __future__ import annotations
 
@@ -64,6 +64,11 @@ class ApplicationListItem(BaseModel):
     page_slug: Optional[str] = Field(None, title='Page Slug')
 
 
+class ApplicationMemberRole(Enum):
+    owner = 'owner'
+    member = 'member'
+
+
 class Prompt(Enum):
     none = 'none'
     login = 'login'
@@ -1043,6 +1048,16 @@ class TeamCreateOrUpdate(BaseModel):
     privacy_statement: AnyUrl = Field(..., title='Privacy Statement')
 
 
+class TeamResponse(BaseModel):
+    id: str = Field(..., title='Id')
+    name: str = Field(..., title='Name')
+    description: str = Field(..., title='Description')
+    url: AnyUrl = Field(..., title='Url')
+    image: AnyUrl = Field(..., title='Image')
+    privacy_statement: AnyUrl = Field(..., title='Privacy Statement')
+    role: Optional[ApplicationMemberRole] = None
+
+
 class TemperatureSummary(BaseModel):
     mean: Optional[float] = Field(None, title='Mean')
     min: Optional[float] = Field(None, title='Min')
@@ -1256,6 +1271,16 @@ class AuthorizeTeamRequest(BaseModel):
     scopes: List[Scope] = Field(..., title='Scopes')
 
 
+class AuthorizedTeamResponse(BaseModel):
+    id: str = Field(..., title='Id')
+    name: str = Field(..., title='Name')
+    description: str = Field(..., title='Description')
+    url: AnyUrl = Field(..., title='Url')
+    image: AnyUrl = Field(..., title='Image')
+    privacy_statement: AnyUrl = Field(..., title='Privacy Statement')
+    scopes: List[Scope] = Field(..., title='Scopes')
+
+
 class BodyAuthorizeOauthAuthorizePost(BaseModel):
     client_id: str = Field(..., title='Client Id')
     redirect_uri: Optional[str] = Field(None, title='Redirect Uri')

{sweatstack-0.73.0 → sweatstack-0.75.0}/src/sweatstack/schemas.py

@@ -14,9 +14,10 @@ from enum import Enum
 from typing import List, Union
 
 from .openapi_schemas import (
-    ActivityDetails, ActivitySummary, BackfillStatus, DailyMeasure, DailyResponse,
+    ActivityDetails, ActivitySummary, ApplicationMemberRole, AuthorizedTeamResponse,
+    BackfillStatus, DailyMeasure, DailyResponse,
     Marker, Metric, Scope, Sport,
-    TestDetails, TestResults, TestSummary, TokenResponse, TraceDetails,
+    TeamResponse, TestDetails, TestResults, TestSummary, TokenResponse, TraceDetails,
     UserInfoResponse, UserResponse, UserSummary
 )
 

sweatstack-0.75.0/tests/test_teams.py

@@ -0,0 +1,113 @@
+"""Tests for the Teams listing functionality.
+
+Tests schema round-trips and enum handling for TeamResponse and
+AuthorizedTeamResponse without hitting the API.
+"""
+
+import pytest
+
+from sweatstack import ApplicationMemberRole, AuthorizedTeamResponse, Scope, TeamResponse
+
+
+# ---------------------------------------------------------------------------
+# Fixtures
+# ---------------------------------------------------------------------------
+
+
+@pytest.fixture
+def sample_team() -> TeamResponse:
+    return TeamResponse(
+        id="team_001",
+        name="Cycling Club",
+        description="Local cycling team",
+        url="https://example.com",
+        image="https://example.com/logo.png",
+        privacy_statement="https://example.com/privacy",
+        role=ApplicationMemberRole.owner,
+    )
+
+
+@pytest.fixture
+def sample_authorized_team() -> AuthorizedTeamResponse:
+    return AuthorizedTeamResponse(
+        id="team_002",
+        name="Coach Platform",
+        description="Coaching service",
+        url="https://coach.example.com",
+        image="https://coach.example.com/logo.png",
+        privacy_statement="https://coach.example.com/privacy",
+        scopes=[Scope.data_read],
+    )
+
+
+# ---------------------------------------------------------------------------
+# Schema round-trip tests
+# ---------------------------------------------------------------------------
+
+
+class TestSchemaRoundTrip:
+    def test_team_response_round_trip(self, sample_team: TeamResponse):
+        """TeamResponse should survive serialize -> deserialize."""
+        dumped = sample_team.model_dump()
+        restored = TeamResponse.model_validate(dumped)
+
+        assert restored.id == "team_001"
+        assert restored.name == "Cycling Club"
+        assert restored.role == ApplicationMemberRole.owner
+
+    def test_team_response_null_role(self):
+        """TeamResponse with null role should round-trip cleanly."""
+        team = TeamResponse(
+            id="team_001",
+            name="Test",
+            description="Test",
+            url="https://example.com",
+            image="https://example.com/img.png",
+            privacy_statement="https://example.com/privacy",
+            role=None,
+        )
+        dumped = team.model_dump()
+        restored = TeamResponse.model_validate(dumped)
+
+        assert restored.role is None
+
+    def test_authorized_team_response_round_trip(
+        self, sample_authorized_team: AuthorizedTeamResponse
+    ):
+        """AuthorizedTeamResponse should survive serialize -> deserialize."""
+        dumped = sample_authorized_team.model_dump()
+        restored = AuthorizedTeamResponse.model_validate(dumped)
+
+        assert restored.id == "team_002"
+        assert restored.name == "Coach Platform"
+        assert restored.scopes == [Scope.data_read]
+
+    def test_authorized_team_multiple_scopes(self):
+        """AuthorizedTeamResponse with multiple scopes should round-trip."""
+        team = AuthorizedTeamResponse(
+            id="team_003",
+            name="Full Access",
+            description="Test",
+            url="https://example.com",
+            image="https://example.com/img.png",
+            privacy_statement="https://example.com/privacy",
+            scopes=[Scope.data_read, Scope.data_write],
+        )
+        dumped = team.model_dump()
+        restored = AuthorizedTeamResponse.model_validate(dumped)
+
+        assert len(restored.scopes) == 2
+        assert Scope.data_read in restored.scopes
+        assert Scope.data_write in restored.scopes
+
+
+# ---------------------------------------------------------------------------
+# Enum tests
+# ---------------------------------------------------------------------------
+
+
+class TestApplicationMemberRole:
+    def test_role_values(self):
+        """ApplicationMemberRole should have owner and member."""
+        assert ApplicationMemberRole.owner.value == "owner"
+        assert ApplicationMemberRole.member.value == "member"

{sweatstack-0.73.0 → sweatstack-0.75.0}/uv.lock

@@ -2456,7 +2456,7 @@ wheels = [
 
 [[package]]
 name = "sweatstack"
-version = "0.72.0"
+version = "0.73.0"
 source = { editable = "." }
 dependencies = [
     { name = "email-validator" },