sweatstack 0.11.1__tar.gz → 0.13.0__tar.gz

sweatstack-0.13.0/.gitignore

@@ -0,0 +1,10 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv

sweatstack-0.13.0/.python-version

@@ -0,0 +1 @@
+3.12

sweatstack-0.13.0/DEVELOPMENT.md

@@ -0,0 +1,13 @@
+# Development
+
+
+
+## Running locally
+
+Point your terminal to some other directory (to not clutter this one with `Untitled` files) and then run:
+
+```bash
+uvx --with-editable "path/to/sweatstack-python[jupyterlab]" jupyter lab
+```
+
+This will start a JupyterLab instance.

sweatstack-0.13.0/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: sweatstack
+Version: 0.13.0
+Summary: The official Python client for SweatStack
+Author-email: Aart Goossens <aart@gssns.io>
+Requires-Python: >=3.12
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pandas>=2.2.3
+Requires-Dist: pyarrow>=19.0.0
+Requires-Dist: pydantic>=2.10.5
+Provides-Extra: jupyterlab
+Requires-Dist: ipython>=8.31.0; extra == 'jupyterlab'
+Requires-Dist: jupyterlab>=4.3.4; extra == 'jupyterlab'
+Requires-Dist: matplotlib; extra == 'jupyterlab'
+Provides-Extra: streamlit
+Requires-Dist: streamlit-cookies-controller>=0.0.4; extra == 'streamlit'
+Requires-Dist: streamlit>=1.42.0; extra == 'streamlit'
+Description-Content-Type: text/markdown
+
+# SweatStack Python client library
+
+
+# Quickstart
+
+```
+uv pip install sweatstack
+```
+
+```python
+import sweatstack as ss
+
+ss.login()
+
+ss.list_activities()
+```
+
+
+# Authentication
+
+SweatStack supports three authentication methods:
+
+### 1. Browser-Based OAuth2 Authentication
+```python
+ss.login()  # Opens your default browser for authentication
+```
+
+### 2. Direct API Key Authentication
+```python
+client = ss.Client(api_key="your-api-key")
+```
+
+### 3. Environment Variable
+Set the `SWEATSTACK_API_KEY` environment variable:
+```bash
+export SWEATSTACK_API_KEY="your-api-key"
+```
+
+SweatStack follows this priority order:
+
+1. Browser-based OAuth2 (`ss.login()`)
+2. Direct API key via `Client` constructor
+3. `SWEATSTACK_API_KEY` environment variable
+
+For example, calling `ss.login()` or `client.login()` will override any existing API key authentication, including those set through the constructor or environment variables.
+
+
+## Interfaces: Singleton vs Class-based
+
+This library provides both a singleton interface and a class-based interface.
+
+Singleton interface:
+```python
+import sweatstack as ss
+
+activities = ss.list_activities()
+```
+
+Class-based interface:
+```python
+from sweatstack import Client
+
+client = Client()
+activities = client.list_activities()
+```
+
+Although both interfaces are feature-equivalent, they serve different purposes:
+- The singleton interface is the default and recommended interface. It is intended for most use cases and is the easiest to use.
+- The class-based interface is intended for more advanced use cases, such as when you need to authenticate multiple users at the same time or in multi-threaded applications.
+
+
+## Streamlit integration
+
+The `sweatstack.streamlit` module provides a Streamlit integration for SweatStack. This requires the optional `streamlit` dependency that can be installed with:
+```
+uv pip install 'sweatstack[streamlit]'
+```
+
+The `StreamlitAuth` class is a Streamlit component that handles the OAuth2 authentication flow. It provides a `st.authenticate()` function that can be used to authenticate the user.
+
+Example usage:
+
+```python
+from sweatstack.streamlit import StreamlitAuth
+
+auth = StreamlitAuth()
+
+with st.sidebar:
+    st.authenticate()
+
+if not auth.is_authenticated():
+    st.write("User is not authenticated")
+    st.stop()
+
+st.write("User is authenticated")
+
+auth.client.get_latest_activity()
+```

sweatstack-0.13.0/README.md

@@ -0,0 +1,98 @@
+# SweatStack Python client library
+
+
+# Quickstart
+
+```
+uv pip install sweatstack
+```
+
+```python
+import sweatstack as ss
+
+ss.login()
+
+ss.list_activities()
+```
+
+
+# Authentication
+
+SweatStack supports three authentication methods:
+
+### 1. Browser-Based OAuth2 Authentication
+```python
+ss.login()  # Opens your default browser for authentication
+```
+
+### 2. Direct API Key Authentication
+```python
+client = ss.Client(api_key="your-api-key")
+```
+
+### 3. Environment Variable
+Set the `SWEATSTACK_API_KEY` environment variable:
+```bash
+export SWEATSTACK_API_KEY="your-api-key"
+```
+
+SweatStack follows this priority order:
+
+1. Browser-based OAuth2 (`ss.login()`)
+2. Direct API key via `Client` constructor
+3. `SWEATSTACK_API_KEY` environment variable
+
+For example, calling `ss.login()` or `client.login()` will override any existing API key authentication, including those set through the constructor or environment variables.
+
+
+## Interfaces: Singleton vs Class-based
+
+This library provides both a singleton interface and a class-based interface.
+
+Singleton interface:
+```python
+import sweatstack as ss
+
+activities = ss.list_activities()
+```
+
+Class-based interface:
+```python
+from sweatstack import Client
+
+client = Client()
+activities = client.list_activities()
+```
+
+Although both interfaces are feature-equivalent, they serve different purposes:
+- The singleton interface is the default and recommended interface. It is intended for most use cases and is the easiest to use.
+- The class-based interface is intended for more advanced use cases, such as when you need to authenticate multiple users at the same time or in multi-threaded applications.
+
+
+## Streamlit integration
+
+The `sweatstack.streamlit` module provides a Streamlit integration for SweatStack. This requires the optional `streamlit` dependency that can be installed with:
+```
+uv pip install 'sweatstack[streamlit]'
+```
+
+The `StreamlitAuth` class is a Streamlit component that handles the OAuth2 authentication flow. It provides a `st.authenticate()` function that can be used to authenticate the user.
+
+Example usage:
+
+```python
+from sweatstack.streamlit import StreamlitAuth
+
+auth = StreamlitAuth()
+
+with st.sidebar:
+    st.authenticate()
+
+if not auth.is_authenticated():
+    st.write("User is not authenticated")
+    st.stop()
+
+st.write("User is authenticated")
+
+auth.client.get_latest_activity()
+```

sweatstack-0.13.0/pyproject.toml

@@ -0,0 +1,40 @@
+[project]
+name = "sweatstack"
+version = "0.13.0"
+description = "The official Python client for SweatStack"
+readme = "README.md"
+authors = [
+    { name = "Aart Goossens", email = "aart@gssns.io" }
+]
+requires-python = ">=3.12"
+dependencies = [
+    "httpx>=0.28.1",
+    "pandas>=2.2.3",
+    "pyarrow>=19.0.0",
+    "pydantic>=2.10.5",
+]
+
+[project.optional-dependencies]
+jupyterlab = [
+    "ipython>=8.31.0",
+    "jupyterlab>=4.3.4",
+    "matplotlib",
+]
+streamlit = [
+    "streamlit>=1.42.0",
+    "streamlit-cookies-controller>=0.0.4",
+]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[dependency-groups]
+dev = [
+    "datamodel-code-generator>=0.26.5",
+]
+
+[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.11.1 → sweatstack-0.13.0/src}/sweatstack/cli.py

@@ -6,10 +6,10 @@ from datamodel_code_generator import DataModelType
 
 
 def generate_response_models():
-    response = httpx.get("http://localhost:2400/openapi.json")
+    response = httpx.get("http://localhost:8080/openapi.json")
     response.raise_for_status()
     output_directory = Path(__file__).parent
-    output = Path(output_directory / "schemas.py")
+    output = Path(output_directory / "openapi_schemas.py")
     output.unlink(missing_ok=True)
     generate(
         response.text,