sweatstack 0.71.0__tar.gz → 0.72.0__tar.gz

{sweatstack-0.71.0 → sweatstack-0.72.0}/.claude/settings.local.json

@@ -14,7 +14,11 @@
       "Bash(uv run ruff:*)",
       "Bash(chmod:*)",
       "mcp__acp__Bash",
-      "Bash(wc:*)"
+      "Bash(wc:*)",
+      "Bash(ls:*)",
+      "Bash(git:*)",
+      "Bash(python3:*)",
+      "Bash(test:*)"
     ],
     "deny": []
   }

{sweatstack-0.71.0 → sweatstack-0.72.0}/.claude/skills/sweatstack-python/client.md

@@ -131,12 +131,14 @@ df = client.get_longitudinal_awd(
 
 The DataFrame has a timezone-aware datetime index and includes an `activity_id` column — group by it for per-activity aggregation.
 
-**Local caching** for reproducible analysis (avoids re-fetching on reruns):
+**Local caching** for reproducible analysis (avoids re-fetching on reruns). Caches `get_longitudinal_data()` and `get_longitudinal_mean_max()`:
 ```python
-import os
-os.environ["SWEATSTACK_LOCAL_CACHE"] = "true"
+import sweatstack
+sweatstack.enable_cache()                    # platform cache dir
+sweatstack.enable_cache(path="./my_cache")   # custom dir
 # Use fixed end dates (not "today") to get stable cache hits
 df = client.get_longitudinal_data(sports=[Sport.cycling], start=date(2025, 1, 1), end=date(2025, 3, 31))
+df = client.get_longitudinal_mean_max(sports=[Sport.cycling], metric="power", start=date(2025, 1, 1))
 ```
 
 ## Traces

sweatstack-0.72.0/.gitignore

@@ -0,0 +1,45 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# Environment variables and secrets
+.env
+.env.*
+
+# Databases and local storage
+*.db
+*.sqlite
+*.sqlite3
+
+# IDE and editor configuration
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# OS files
+.DS_Store
+
+# Test artifacts
+.pytest_cache/
+
+# Documentation
+docs/_build/
+
+# Internal docs dump
+dump/
+
+# Playground
+playground/
+
+# Claude skills (except our own)
+.claude/skills/*
+!.claude/skills/sweatstack-python/

{sweatstack-0.71.0 → sweatstack-0.72.0}/CHANGELOG.md

@@ -6,6 +6,22 @@ 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.72.0] - 2026-03-13
+
+### Added
+- `sweatstack.enable_cache()` function to enable local caching via a simple API call instead of environment variables.
+- Local caching for `get_longitudinal_mean_max()` responses (previously only `get_longitudinal_data()` was cached).
+
+### Changed
+- Cache directory now defaults to the platform cache dir (`platformdirs.user_cache_dir`) instead of the system temp directory.
+
+### Fixed
+- `AttributeError` on Python <3.11 when the API returns an error response (`add_note` is a Python 3.11+ feature).
+
+### Removed
+- `SWEATSTACK_LOCAL_CACHE` and `SWEATSTACK_CACHE_DIR` environment variables. Use `sweatstack.enable_cache()` instead.
+
+
 ## [0.71.0] - 2026-03-13
 
 ### Added

sweatstack-0.72.0/CONTRIBUTING.md

@@ -0,0 +1,9 @@
+# Contributing
+
+Thank you for your interest in the SweatStack Python client library!
+
+This repository is open-sourced primarily to make it easier for developers and AI coding agents to understand and work with the library. At this time, we are **not accepting external contributions** such as pull requests or feature requests.
+
+If you've found a bug or have a question about using the library, feel free to [open an issue](https://github.com/SweatStack/sweatstack-python/issues).
+
+For general questions about SweatStack, please refer to the [developer documentation](https://developer.sweatstack.no/getting-started/).

sweatstack-0.72.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-present Aart Goossens
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

sweatstack-0.72.0/PKG-INFO

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: sweatstack
+Version: 0.72.0
+Summary: The official Python client for SweatStack
+Project-URL: Homepage, https://sweatstack.no
+Project-URL: Documentation, https://developer.sweatstack.no/getting-started/
+Project-URL: Repository, https://github.com/SweatStack/sweatstack-python
+Project-URL: Issues, https://github.com/SweatStack/sweatstack-python/issues
+Project-URL: Changelog, https://github.com/SweatStack/sweatstack-python/blob/main/CHANGELOG.md
+Author-email: Aart Goossens <aart@sweatstack.no>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: api,client,fitness,sports,sweatstack
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.9
+Requires-Dist: email-validator>=2.2.0
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pandas>=2.2.3
+Requires-Dist: platformdirs>=4.0.0
+Requires-Dist: pyarrow>=18.0.0
+Requires-Dist: pydantic>=2.10.5
+Provides-Extra: fastapi
+Requires-Dist: cryptography>=41.0.0; extra == 'fastapi'
+Requires-Dist: fastapi[standard]>=0.100.0; extra == 'fastapi'
+Provides-Extra: jupyter
+Requires-Dist: ipython>=8.31.0; extra == 'jupyter'
+Requires-Dist: jupyterlab>=4.3.4; extra == 'jupyter'
+Requires-Dist: matplotlib>=3.10.0; extra == 'jupyter'
+Provides-Extra: streamlit
+Requires-Dist: streamlit>=1.42.0; extra == 'streamlit'
+Description-Content-Type: text/markdown
+
+# SweatStack Python client library
+
+This is the official Python client library for SweatStack.
+
+Documentation can be found [here](https://developer.sweatstack.no/getting-started/).

{sweatstack-0.71.0 → sweatstack-0.72.0}/README.md

@@ -1,6 +1,5 @@
 # SweatStack Python client library
 
-
 This is the official Python client library for SweatStack.
 
-Documentation can be found [here](https://developer.sweatstack.no/getting-started/).
+Documentation can be found [here](https://developer.sweatstack.no/getting-started/).

{sweatstack-0.71.0 → sweatstack-0.72.0}/examples/fastapi_webhooks_example.py

@@ -9,6 +9,14 @@ import logging
 import os
 from pathlib import Path
 
+# Required environment variables:
+#   SWEATSTACK_CLIENT_ID
+#   SWEATSTACK_CLIENT_SECRET
+#   SWEATSTACK_SESSION_SECRET
+#   SWEATSTACK_WEBHOOK_SECRET
+#   SWEATSTACK_ENCRYPTION_KEY  (for EncryptedSQLiteTokenStore)
+#   APP_URL (e.g. http://localhost:8001)
+
 from fastapi import FastAPI, Request
 from fastapi.responses import HTMLResponse, JSONResponse
 
@@ -28,18 +36,13 @@ logger = logging.getLogger(__name__)
 
 db_path = Path(__file__).parent / "tokens.db"
 token_store = EncryptedSQLiteTokenStore(
-    encryption_key="8BIvhwKdURGpXCAGcfWm3Aw1gXNmqc3zWJGfnDCXVs4=",
+    encryption_key=os.environ["SWEATSTACK_ENCRYPTION_KEY"],
     db_path=db_path,
 )
 
 configure(
-    client_id="1da141eeffa54c4d",
-    client_secret="vgwMFP6uTQa3K5bBc1mDqU33xnHVwhyqVq-NLacopD0",
-    session_secret="5YviwYhzDdmzsqbcEIP0QXzoiehIy8lqBWLtzaeBU8Q=",
-    app_url="http://localhost:8001",
-    webhook_secret="whsec_development_secret_key",
     token_store=token_store,
-)
+)  # Uses SWEATSTACK_* environment variables (CLIENT_ID, CLIENT_SECRET, SESSION_SECRET, WEBHOOK_SECRET, APP_URL)
 
 app = FastAPI(title="SweatStack Webhooks Example")
 instrument(app)

{sweatstack-0.71.0 → sweatstack-0.72.0}/pyproject.toml

@@ -1,12 +1,26 @@
 [project]
 name = "sweatstack"
-version = "0.71.0"
+version = "0.72.0"
 description = "The official Python client for SweatStack"
 readme = "README.md"
+license = "MIT"
 authors = [
-    { name = "Aart Goossens", email = "aart@gssns.io" }
+    { name = "Aart Goossens", email = "aart@sweatstack.no" }
 ]
 requires-python = ">=3.9"
+keywords = ["sweatstack", "sports", "fitness", "api", "client"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
 dependencies = [
     "email-validator>=2.2.0",
     "httpx>=0.28.1",
@@ -16,6 +30,13 @@ dependencies = [
     "pydantic>=2.10.5",
 ]
 
+[project.urls]
+Homepage = "https://sweatstack.no"
+Documentation = "https://developer.sweatstack.no/getting-started/"
+Repository = "https://github.com/SweatStack/sweatstack-python"
+Issues = "https://github.com/SweatStack/sweatstack-python/issues"
+Changelog = "https://github.com/SweatStack/sweatstack-python/blob/main/CHANGELOG.md"
+
 [project.optional-dependencies]
 streamlit = [
     "streamlit>=1.42.0",
@@ -30,6 +51,11 @@ fastapi = [
     "cryptography>=41.0.0",
 ]
 
+[project.scripts]
+generate-response-models = "sweatstack.cli:generate_response_models"
+sweatshell = "sweatstack.sweatshell:run_ipython"
+sweatlab = "sweatstack.jupyterlab_oauth2_startup:start_jupyterlab_with_oauth"
+
 [build-system]
 requires = ["hatchling"]
 build-backend = "hatchling.build"
@@ -45,8 +71,3 @@ dev = [
 
 [tool.uv.workspace]
 members = ["playground"]
-
-[project.scripts]
-generate-response-models = "sweatstack.cli:generate_response_models"
-sweatshell = "sweatstack.sweatshell:run_ipython"
-sweatlab = "sweatstack.jupyterlab_oauth2_startup:start_jupyterlab_with_oauth"

{sweatstack-0.71.0 → sweatstack-0.72.0}/src/sweatstack/client.py

@@ -7,7 +7,6 @@ import logging
 import os
 import secrets
 import shutil
-import tempfile
 import time
 import urllib
 import warnings
@@ -26,7 +25,7 @@ from urllib.parse import parse_qs, urlparse
 
 import httpx
 import pandas as pd
-from platformdirs import user_data_dir
+from platformdirs import user_cache_dir, user_data_dir
 
 from .constants import DEFAULT_URL
 from .schemas import (
@@ -40,6 +39,19 @@ logger = logging.getLogger(__name__)
 # Refresh tokens this many seconds before they expire to avoid race conditions
 TOKEN_EXPIRY_MARGIN_SECONDS = 5
 
+# Module-level cache configuration. None = caching disabled.
+_cache_config: dict | None = None
+
+
+def enable_cache(path: str | None = None) -> None:
+    """Enable local caching of API responses.
+
+    Args:
+        path: Optional custom cache directory. Defaults to the platform cache dir.
+    """
+    global _cache_config
+    _cache_config = {"path": path}
+
 
 class TokenRefreshError(Exception):
     """Raised when automatic token refresh fails.
@@ -74,29 +86,24 @@ OAUTH2_CLIENT_ID = "5382f68b0d254378"
 class _LocalCacheMixin:
     """Mixin for handling local filesystem caching of API responses.
 
-    Caching is controlled via environment variables:
-
-    - :envvar:`SWEATSTACK_LOCAL_CACHE` - Enable/disable caching
-    - :envvar:`SWEATSTACK_CACHE_DIR` - Custom cache directory location
-
+    Caching is enabled by calling :func:`sweatstack.enable_cache`.
     Use :meth:`clear_cache` to remove all cached data for the current user.
     """
 
     def _cache_enabled(self) -> bool:
         """Check if local caching is enabled."""
-        return bool(os.getenv("SWEATSTACK_LOCAL_CACHE"))
+        return _cache_config is not None
 
     def _log_cache_error(self, operation: str, error: Exception) -> None:
         """Log cache operation errors with context."""
-        cache_location = os.getenv("SWEATSTACK_CACHE_DIR") or tempfile.gettempdir()
         try:
-            user_id = self._get_user_id_from_token()
+            cache_dir = str(self._get_cache_dir())
         except Exception:
-            user_id = "unknown"
+            cache_dir = "unknown"
 
         logging.warning(
-            f"Failed to {operation} cache despite SWEATSTACK_LOCAL_CACHE being enabled. "
-            f"Cache directory: {cache_location}/sweatstack/{user_id}. "
+            f"Failed to {operation} cache. "
+            f"Cache directory: {cache_dir}. "
             f"Error: {error}"
         )
 
@@ -118,16 +125,16 @@ class _LocalCacheMixin:
         """Get cache directory for current user."""
         user_id = self._get_user_id_from_token()
 
-        if cache_location := os.getenv("SWEATSTACK_CACHE_DIR"):
-            cache_dir = Path(cache_location) / user_id
+        if _cache_config and _cache_config.get("path"):
+            cache_dir = Path(_cache_config["path"]) / user_id
         else:
-            cache_dir = Path(tempfile.gettempdir()) / "sweatstack" / user_id
+            cache_dir = Path(user_cache_dir("SweatStack", "SweatStack")) / user_id
 
         cache_dir.mkdir(parents=True, exist_ok=True, mode=0o700)
         return cache_dir
 
-    def _generate_longitudinal_cache_key(self, **params) -> str:
-        """Generate cache key for longitudinal data requests."""
+    def _generate_cache_key(self, namespace: str, **params) -> str:
+        """Generate a cache key for the given namespace and parameters."""
         normalized_params = {}
 
         for key, value in params.items():
@@ -144,37 +151,33 @@ class _LocalCacheMixin:
             else:
                 normalized_params[key] = str(value)
 
-        cache_data = f"longitudinal_data:{json.dumps(normalized_params, sort_keys=True)}"
+        cache_data = f"{namespace}:{json.dumps(normalized_params, sort_keys=True)}"
         return hashlib.sha256(cache_data.encode()).hexdigest()[:16]
 
-    def _read_longitudinal_cache(self, cache_key: str) -> pd.DataFrame | None:
-        """Try to read cached longitudinal data."""
+    def _read_cache(self, namespace: str, cache_key: str) -> bytes | None:
+        """Try to read cached data. Returns raw bytes or None."""
         try:
             cache_dir = self._get_cache_dir()
-            cache_file = cache_dir / f"longitudinal-{cache_key}.parquet"
+            cache_file = cache_dir / f"{namespace}-{cache_key}.parquet"
 
             if cache_file.exists():
-                return pd.read_parquet(cache_file)
+                return cache_file.read_bytes()
         except Exception as e:
             self._log_cache_error("read", e)
 
         return None
 
-    def _write_longitudinal_cache(self, cache_key: str, content: bytes) -> None:
-        """Write longitudinal data to cache."""
+    def _write_cache(self, namespace: str, cache_key: str, content: bytes) -> None:
+        """Write raw bytes to cache."""
         try:
             cache_dir = self._get_cache_dir()
-            cache_file = cache_dir / f"longitudinal-{cache_key}.parquet"
+            cache_file = cache_dir / f"{namespace}-{cache_key}.parquet"
             cache_file.write_bytes(content)
         except Exception as e:
             self._log_cache_error("write", e)
 
     def clear_cache(self) -> None:
-        """Clear all cached data for the current user.
-
-        This removes all cached data (longitudinal data, etc.) from the temporary
-        directory for the currently authenticated user.
-        """
+        """Clear all cached data for the current user."""
         try:
             cache_dir = self._get_cache_dir()
             if cache_dir.exists():
@@ -948,12 +951,23 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
         with httpx.Client(base_url=self.url, headers=headers, timeout=60) as client:
             yield client
 
+    @staticmethod
+    def _add_note(exception: Exception, note: str):
+        """Add a note to an exception, compatible with Python <3.11."""
+        if hasattr(exception, "add_note"):
+            exception.add_note(note)
+        else:
+            if not exception.args:
+                exception.args = (note,)
+            else:
+                exception.args = (f"{exception.args[0]}\n{note}",) + exception.args[1:]
+
     def _print_response_and_raise(self, response: httpx.Response):
         try:
             response.raise_for_status()
         except httpx.HTTPStatusError as exception:
             additional_info = response.text
-            exception.add_note(additional_info)
+            self._add_note(exception, additional_info)
             raise exception
 
     def _raise_for_status(self, response: httpx.Response):
@@ -973,7 +987,7 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
                             "\nStreamlit environment detected. Use StreamlitAuth.client instance.\n"
                             "Docs: https://developer.sweatstack.no/learn/integrations/streamlit/"
                         )
-                        exception.add_note(streamlit_error_message)
+                        self._add_note(exception, streamlit_error_message)
                     raise
 
         else:
@@ -1388,10 +1402,10 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
             params["adaptive_sampling_on"] = self._enums_to_strings([adaptive_sampling_on])[0]
 
         if self._cache_enabled():
-            cache_key = self._generate_longitudinal_cache_key(**params)
-            cached_df = self._read_longitudinal_cache(cache_key)
-            if cached_df is not None:
-                return self._postprocess_dataframe(cached_df)
+            cache_key = self._generate_cache_key("longitudinal_data", **params)
+            cached = self._read_cache("longitudinal_data", cache_key)
+            if cached is not None:
+                return self._postprocess_dataframe(pd.read_parquet(BytesIO(cached)))
 
         with self._http_client() as client:
             response = client.get(
@@ -1401,7 +1415,7 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
             self._raise_for_status(response)
 
             if self._cache_enabled():
-                self._write_longitudinal_cache(cache_key, response.content)
+                self._write_cache("longitudinal_data", cache_key, response.content)
 
             df = pd.read_parquet(BytesIO(response.content))
 
@@ -1469,6 +1483,12 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
             if window_days is not None:
                 params["window_days"] = window_days
 
+        if self._cache_enabled():
+            cache_key = self._generate_cache_key("mean_max", **params)
+            cached = self._read_cache("mean_max", cache_key)
+            if cached is not None:
+                return self._postprocess_dataframe(pd.read_parquet(BytesIO(cached)))
+
         with self._http_client() as client:
             response = client.get(
                 url="/api/v1/activities/longitudinal-mean-max",
@@ -1476,6 +1496,9 @@ class Client(_OAuth2Mixin, _DelegationMixin, _TokenStorageMixin, _LocalCacheMixi
             )
             self._raise_for_status(response)
 
+            if self._cache_enabled():
+                self._write_cache("mean_max", cache_key, response.content)
+
             df = pd.read_parquet(BytesIO(response.content))
             return self._postprocess_dataframe(df)
 

{sweatstack-0.71.0 → sweatstack-0.72.0}/tests/test_webhooks.py

@@ -52,7 +52,7 @@ def configured_app(webhook_secret: str) -> FastAPI:
         client_id="test_client_id",
         client_secret="test_client_secret",
         app_url="http://localhost:8000",
-        session_secret="5YviwYhzDdmzsqbcEIP0QXzoiehIy8lqBWLtzaeBU8Q=",
+        session_secret="dGVzdC1vbmx5LWtleS1mb3ItdW5pdC10ZXN0cy0zMmI=",
         webhook_secret=webhook_secret,
     )
     app = FastAPI()
@@ -460,7 +460,7 @@ class TestWebhookConfiguration:
         monkeypatch.setenv("SWEATSTACK_CLIENT_ID", "test_id")
         monkeypatch.setenv("SWEATSTACK_CLIENT_SECRET", "test_secret")
         monkeypatch.setenv("APP_URL", "http://localhost:8000")
-        monkeypatch.setenv("SWEATSTACK_SESSION_SECRET", "5YviwYhzDdmzsqbcEIP0QXzoiehIy8lqBWLtzaeBU8Q=")
+        monkeypatch.setenv("SWEATSTACK_SESSION_SECRET", "dGVzdC1vbmx5LWtleS1mb3ItdW5pdC10ZXN0cy0zMmI=")
         monkeypatch.setenv("SWEATSTACK_WEBHOOK_SECRET", "whsec_from_env")
 
         configure()
@@ -479,7 +479,7 @@ class TestWebhookConfiguration:
             client_id="test_id",
             client_secret="test_secret",
             app_url="http://localhost:8000",
-            session_secret="5YviwYhzDdmzsqbcEIP0QXzoiehIy8lqBWLtzaeBU8Q=",
+            session_secret="dGVzdC1vbmx5LWtleS1mb3ItdW5pdC10ZXN0cy0zMmI=",
             token_store=store,
         )
 

{sweatstack-0.71.0 → sweatstack-0.72.0}/uv.lock

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

sweatstack-0.71.0/.gitignore

@@ -1,17 +0,0 @@
-# Python-generated files
-__pycache__/
-*.py[oc]
-build/
-dist/
-wheels/
-*.egg-info
-
-# Virtual environments
-.venv
-
-# Documentation
-docs/_build/
-
-# Claude skills (except our own)
-.claude/skills/*
-!.claude/skills/sweatstack-python/