sweatstack-cli 0.7.0

Command-line interface for SweatStack — the sports data platform for developers

SweatStack CLI

Command-line interface for SweatStack — the sports data platform for developers.

Installation

pip install sweatstack-cli

Requires Python 3.11+.

Quick Start

# Authenticate with SweatStack
sweatstack login

# Check authentication and version status
sweatstack status

# Deploy a static site
sweatstack page deploy my-page ./dist

# Create an OAuth2 application
sweatstack app create "My App" --page my-page --env

# Logout
sweatstack logout

Commands

Authentication

Command	Description
sweatstack login	Authenticate via browser (OAuth2 PKCE)
sweatstack login --force	Force re-authentication
sweatstack logout	Remove stored credentials
sweatstack status	Show auth status, user info, and version
sweatstack --version	Show version and check for updates

Page Deployment

Deploy static sites to SweatStack Pages.

Command	Description
sweatstack page deploy [SLUG] [DIRECTORY]	Deploy a static site

• SLUG — Page identifier. Falls back to sweatstack.toml if omitted.
• DIRECTORY — Directory to deploy. Falls back to sweatstack.toml, then current directory.

# Deploy using CLI arguments
sweatstack page deploy my-page ./dist

# Deploy using sweatstack.toml defaults
sweatstack page deploy

Application Management

Manage OAuth2 applications.

Command	Description
sweatstack app create NAME	Create a new private OAuth2 application
sweatstack app link	Link current directory to an existing application

app create options

Option	Description
--description, -d TEXT	Application description (max 500 chars)
--page, -p SLUG	Associate with a SweatStack Page
--secret, -s	Generate a client secret
--env	Write credentials to .env
--env-file PATH	Write credentials to a specific file
--json	Output as JSON

app link options

Option	Description
--force, -f	Overwrite existing sweatstack.toml

Project Configuration

Commands read defaults from a sweatstack.toml in the current directory. This file is created automatically by app create and app link.

[app]
name = "My App"
client_id = "abc123"

[page]
slug = "my-page"
directory = "dist"

CI/CD Usage

For automated environments, set environment variables instead of interactive login:

export SWEATSTACK_API_KEY="your-access-token"
export SWEATSTACK_REFRESH_TOKEN="your-refresh-token"

sweatstack page deploy my-page ./dist

Environment Variables

Variable	Description	Default
SWEATSTACK_URL	API base URL	https://app.sweatstack.no
SWEATSTACK_API_KEY	Access token (for CI/CD)	—
SWEATSTACK_REFRESH_TOKEN	Refresh token (for CI/CD)	—

Token Storage

Credentials are stored in your OS user data directory:

• macOS: ~/Library/Application Support/SweatStack/SweatStack/tokens.json
• Linux: ~/.local/share/SweatStack/SweatStack/tokens.json
• Windows: %APPDATA%\SweatStack\SweatStack\tokens.json

Token files are created with 0600 permissions (owner read/write only). This location is shared with the sweatstack Python library, so authenticating with either tool works for both.

Development

See DEVELOPMENT.md for development setup and contribution guidelines.

# Install with dev dependencies
uv pip install -e ".[dev]"

# Run tests
pytest

# Lint and format
ruff check . && ruff format .

# Type check
mypy src/sweatstack_cli

License

MIT