sweatstack 0.70.0__tar.gz → 0.72.0__tar.gz

{sweatstack-0.70.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.70.0 → sweatstack-0.72.0}/.claude/skills/sweatstack-python/client.md

@@ -102,33 +102,43 @@ Aggregated time-series across multiple activities. One request instead of loopin
 
 ```python
 df = client.get_longitudinal_data(
-    sport=Sport.cycling,                # single sport
+    sports=[Sport.cycling_road],        # list of Sport enum or strings
     start=date(2025, 1, 1),             # required
     end=date(2025, 12, 31),             # optional (defaults to today)
     metrics=[Metric.power, Metric.heart_rate],  # optional
 )
 
-# Or filter by multiple sports
+# Multiple sports
 df = client.get_longitudinal_data(
     sports=[Sport.cycling_road, Sport.cycling_gravel],
     start=date(2025, 1, 1),
 )
 
 # Longitudinal mean-max (best efforts across time range)
-df = client.get_longitudinal_mean_max(sport=Sport.cycling, start=date(2025, 1, 1))
+df = client.get_longitudinal_mean_max(
+    sports=[Sport.cycling_road],
+    metric="power",
+    start=date(2025, 1, 1),
+)
 
 # Longitudinal AWD
-df = client.get_longitudinal_awd(sport=Sport.cycling, start=date(2025, 1, 1))
+df = client.get_longitudinal_awd(
+    sports=[Sport.cycling_road],
+    metric="power",
+    start=date(2025, 1, 1),
+)
 ```
 
 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(sport=Sport.cycling, start=date(2025, 1, 1), end=date(2025, 3, 31))
+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
@@ -252,7 +262,7 @@ df = sweatstack.get_latest_activity_data()
 
 - **Sport enum uses underscores:** `Sport.cycling_road`, not `Sport("road")` or `Sport.cycling.road`. String values use dots: `"cycling.road"`.
 - **`start` is required for longitudinal endpoints.** Unlike `get_activities()` where all filters are optional.
-- **`sport` (singular) vs `sports` (list):** `get_latest_activity(sport=...)` takes one. `get_activities(sports=[...])` and `get_longitudinal_data(sports=[...])` take a list.
+- **`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()` and `get_traces()`. Time-series methods (`get_activity_data`, `get_longitudinal_data`, etc.) always return DataFrames.
 - **`summary` fields are optional.** Always null-check: `activity.summary.power.mean if activity.summary and activity.summary.power else None`.

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.70.0 → sweatstack-0.72.0}/CHANGELOG.md

@@ -6,6 +6,36 @@ 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
+- `sports` (list) parameter on `get_longitudinal_mean_max()` and `get_longitudinal_awd()` for multi-sport support. The existing `sport` (single) parameter remains for backwards compatibility.
+- `start` and `end` date-range parameters on `get_longitudinal_mean_max()` and `get_longitudinal_awd()`.
+
+### Changed
+- `get_activities()`, `get_traces()`, and `get_longitudinal_data()` now send the `sport` query key to the API instead of `sports`.
+
+### Deprecated
+- `sport` (singular) parameter on `get_longitudinal_mean_max()`, `get_longitudinal_awd()`, and `get_longitudinal_data()`. Use `sports` (list) instead.
+- `date` and `window_days` parameters on `get_longitudinal_mean_max()` and `get_longitudinal_awd()`. Use `start`/`end` instead.
+
+
 ## [0.70.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.70.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.70.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.70.0 → sweatstack-0.72.0}/pyproject.toml

@@ -1,12 +1,26 @@
 [project]
 name = "sweatstack"
-version = "0.70.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"