sweatstack-cli 0.14.0__tar.gz → 0.16.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/CHANGELOG.md +48 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/DEVELOPMENT.md +1 -1
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/Makefile +13 -1
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/PKG-INFO +5 -2
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/README.md +1 -1
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/pyproject.toml +8 -2
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/auth/__init__.py +92 -15
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/commands/auth.py +7 -3
- sweatstack_cli-0.16.0/src/sweatstack_cli/commands/tool.py +153 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/config.py +3 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/main.py +3 -2
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/templates/page/index.html +166 -101
- sweatstack_cli-0.16.0/src/sweatstack_cli/tools/__init__.py +1 -0
- sweatstack_cli-0.16.0/src/sweatstack_cli/tools/check.py +184 -0
- sweatstack_cli-0.16.0/src/sweatstack_cli/tools/content_types.json +55 -0
- sweatstack_cli-0.16.0/src/sweatstack_cli/tools/policy.json +25 -0
- sweatstack_cli-0.16.0/src/sweatstack_cli/tools/policy.py +155 -0
- sweatstack_cli-0.16.0/src/sweatstack_cli/tools/rewrite.py +111 -0
- sweatstack_cli-0.16.0/src/sweatstack_cli/tools/server.py +148 -0
- sweatstack_cli-0.16.0/tests/e2e/test_page_template.py +483 -0
- sweatstack_cli-0.16.0/tests/e2e/test_tool_serve.py +104 -0
- sweatstack_cli-0.16.0/tests/test_auth/test_authenticator.py +281 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/tests/test_commands/test_auth.py +22 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/tests/test_commands/test_page_init.py +13 -0
- sweatstack_cli-0.16.0/tests/test_services/__init__.py +0 -0
- sweatstack_cli-0.16.0/tests/test_tools/__init__.py +0 -0
- sweatstack_cli-0.16.0/tests/test_tools/test_check.py +181 -0
- sweatstack_cli-0.16.0/tests/test_tools/test_policy.py +163 -0
- sweatstack_cli-0.16.0/tests/test_tools/test_rewrite.py +133 -0
- sweatstack_cli-0.16.0/tests/test_tools/test_server.py +195 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/uv.lock +196 -2
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/.claude/settings.local.json +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/.claude/skills/sweatstack/SKILL.md +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/.claude/skills/sweatstack/api.md +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/.claude/skills/sweatstack/auth.md +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/.claude/skills/sweatstack/cli.md +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/.claude/skills/sweatstack/pyscript.md +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/.claude/skills/sweatstack/webapp.md +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/.gitignore +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/.python-version +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/CREATE_PRIVATE_APP.md +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/PLAN.md +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/plans/001-page-init-command.md +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/__init__.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/api/__init__.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/api/client.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/auth/callback_server.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/auth/jwt.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/auth/pkce.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/auth/tokens.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/commands/__init__.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/commands/app.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/commands/page.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/console.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/exceptions.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/go_live.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/project.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/py.typed +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/services/__init__.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/services/applications.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/src/sweatstack_cli/version_check.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/sweatstack.toml +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/tests/__init__.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/tests/conftest.py +0 -0
- {sweatstack_cli-0.14.0/tests/test_services → sweatstack_cli-0.16.0/tests/e2e}/__init__.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/tests/test_api/__init__.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/tests/test_api/test_client.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/tests/test_auth/__init__.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/tests/test_auth/test_authorize_url.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/tests/test_auth/test_callback_server.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/tests/test_auth/test_jwt.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/tests/test_auth/test_pkce.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/tests/test_auth/test_tokens.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/tests/test_commands/__init__.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/tests/test_commands/test_app.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/tests/test_commands/test_cli.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/tests/test_commands/test_page_deploy.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/tests/test_project.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/tests/test_services/test_applications.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/tests/test_version.py +0 -0
- {sweatstack_cli-0.14.0 → sweatstack_cli-0.16.0}/tests/test_version_check.py +0 -0
|
@@ -4,6 +4,54 @@ All notable changes to this project are documented here. The format is based on
|
|
|
4
4
|
[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and this project
|
|
5
5
|
adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
|
6
6
|
|
|
7
|
+
## [0.16.0] - 2026-11-20
|
|
8
|
+
|
|
9
|
+
### Added
|
|
10
|
+
|
|
11
|
+
- `sweatstack tool serve [DIR]` serves a tool locally the way SweatStack Tools serves it:
|
|
12
|
+
every response carries the production network policy, without reporting and HSTS; HTML
|
|
13
|
+
gets the same WebRTC block and report link, and loses speculation rules and preconnect
|
|
14
|
+
or DNS prefetch hints, as in production; paths resolve in production's order, files get
|
|
15
|
+
the Tools contract's content types, and nothing outside the folder is served. A request
|
|
16
|
+
the policy blocks shows in the browser console with its file and line.
|
|
17
|
+
- `sweatstack tool check [DIR]` reports every reference in a tool's folder that loads from
|
|
18
|
+
another origin and would be blocked on SweatStack Tools, with file, line and kind, and
|
|
19
|
+
exits with 1 so an agent treats it as a failure to fix. It also lists what SweatStack
|
|
20
|
+
Tools removes. Links, licence comments and XML namespaces are never reported.
|
|
21
|
+
- Both read the policy from `https://sweatstack.tools/v1/policy`, with a one-second
|
|
22
|
+
timeout, and fall back to the copy cached from the last fetch, then to the copy in this
|
|
23
|
+
release (`make refresh-policy`). `SWEATSTACK_TOOLS_URL` points them elsewhere.
|
|
24
|
+
|
|
25
|
+
## [0.15.0] - 2026-11-19
|
|
26
|
+
|
|
27
|
+
### Fixed
|
|
28
|
+
|
|
29
|
+
- The page `page init` scaffolds can sign in to a new application. It requested
|
|
30
|
+
`data:read`, which SweatStack refuses with `invalid_scope` for an application
|
|
31
|
+
registered since 13 October 2026. It now requests
|
|
32
|
+
`openid profile activities:read offline_access`.
|
|
33
|
+
- With `SWEATSTACK_API_KEY` and `SWEATSTACK_REFRESH_TOKEN` set, a refresh no longer
|
|
34
|
+
writes the environment's tokens over the tokens file, which holds the sign-in of
|
|
35
|
+
`sweatstack login` and is shared with the Python SDK. A command now refreshes once
|
|
36
|
+
and keeps the result; every request used to refresh again with the variable's token.
|
|
37
|
+
|
|
38
|
+
### Changed
|
|
39
|
+
|
|
40
|
+
- From SweatStack 0.162.0, every refresh returns a new refresh token. With the tokens
|
|
41
|
+
from `SWEATSTACK_REFRESH_TOKEN`, the CLI uses the new one for the rest of the command
|
|
42
|
+
and warns on stderr that the variable still holds the old one, which SweatStack will
|
|
43
|
+
stop accepting. Tokens from `sweatstack login` are saved after every refresh, as before.
|
|
44
|
+
- `sweatstack logout` ends the sign-in on SweatStack, so its refresh token stops working
|
|
45
|
+
everywhere, and then removes the stored credentials. When SweatStack can't be reached,
|
|
46
|
+
the credentials are still removed and `logout` says that the sign-in was not ended.
|
|
47
|
+
- The scaffolded page's Sign out ends the sign-in on SweatStack too.
|
|
48
|
+
|
|
49
|
+
- The scaffolded page stays signed in. Access tokens last 15 minutes, and the page
|
|
50
|
+
now refreshes them instead of asking the user to connect again. It keeps the new
|
|
51
|
+
refresh token from every refresh, and only one tab refreshes at a time.
|
|
52
|
+
- A returning user goes straight back through sign-in, and a cancelled sign-in
|
|
53
|
+
shows why instead of starting again. The button reads "Sign in with SweatStack".
|
|
54
|
+
|
|
7
55
|
## [0.14.0] - 2026-10-29
|
|
8
56
|
|
|
9
57
|
### Added
|
|
@@ -299,7 +299,7 @@ pytest
|
|
|
299
299
|
| `SWEATSTACK_API_KEY` | Access token (CI/CD) | — |
|
|
300
300
|
| `SWEATSTACK_REFRESH_TOKEN` | Refresh token (CI/CD) | — |
|
|
301
301
|
|
|
302
|
-
For CI/CD pipelines, set `SWEATSTACK_API_KEY` and `SWEATSTACK_REFRESH_TOKEN` to bypass interactive login.
|
|
302
|
+
For CI/CD pipelines, set `SWEATSTACK_API_KEY` and `SWEATSTACK_REFRESH_TOKEN` to bypass interactive login. Both are needed: an API key alone cannot act for the CLI, so it is ignored. SweatStack rotates refresh tokens, so the CLI keeps a refreshed pair for the rest of the command only, never writes it to the tokens file, and warns that the variable still holds the old token, which SweatStack will stop accepting (plan 095 in the server repo).
|
|
303
303
|
|
|
304
304
|
## Error Handling
|
|
305
305
|
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
.PHONY: help install dev test lint format typecheck check clean build publish
|
|
1
|
+
.PHONY: help install dev test test-e2e lint format typecheck check clean build publish refresh-policy
|
|
2
2
|
|
|
3
3
|
help:
|
|
4
4
|
@echo "SweatStack CLI Development Commands"
|
|
@@ -6,10 +6,12 @@ help:
|
|
|
6
6
|
@echo " make install Install the package"
|
|
7
7
|
@echo " make dev Install with development dependencies"
|
|
8
8
|
@echo " make test Run tests"
|
|
9
|
+
@echo " make test-e2e Run the page template in a browser (downloads Chromium once)"
|
|
9
10
|
@echo " make lint Run linter"
|
|
10
11
|
@echo " make format Format code"
|
|
11
12
|
@echo " make typecheck Run type checker"
|
|
12
13
|
@echo " make check Run all checks (lint, format, typecheck, test)"
|
|
14
|
+
@echo " make refresh-policy Copy the live SweatStack Tools policy into the package"
|
|
13
15
|
@echo " make clean Remove build artifacts"
|
|
14
16
|
@echo " make build Build distribution packages"
|
|
15
17
|
@echo " make publish Publish to PyPI"
|
|
@@ -23,6 +25,10 @@ dev:
|
|
|
23
25
|
test:
|
|
24
26
|
uv run pytest
|
|
25
27
|
|
|
28
|
+
test-e2e:
|
|
29
|
+
uv run --extra dev --extra e2e playwright install chromium
|
|
30
|
+
uv run --extra dev --extra e2e pytest tests/e2e -m e2e -v
|
|
31
|
+
|
|
26
32
|
lint:
|
|
27
33
|
uv run ruff check .
|
|
28
34
|
|
|
@@ -42,6 +48,12 @@ clean:
|
|
|
42
48
|
find . -type d -name .mypy_cache -exec rm -rf {} + 2>/dev/null || true
|
|
43
49
|
find . -type d -name .ruff_cache -exec rm -rf {} + 2>/dev/null || true
|
|
44
50
|
|
|
51
|
+
# The copy of the SweatStack Tools policy this release falls back to when sweatstack.tools is
|
|
52
|
+
# unreachable and nothing is cached. Run before a release, and commit the result.
|
|
53
|
+
refresh-policy:
|
|
54
|
+
curl -fsS https://sweatstack.tools/v1/policy -o src/sweatstack_cli/tools/policy.json
|
|
55
|
+
uv run python -c "import json; from sweatstack_cli.tools.policy import parse_policy; parse_policy(json.load(open('src/sweatstack_cli/tools/policy.json')), 'built-in')"
|
|
56
|
+
|
|
45
57
|
build:
|
|
46
58
|
rm -rf dist
|
|
47
59
|
uv build
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.5
|
|
2
2
|
Name: sweatstack-cli
|
|
3
|
-
Version: 0.
|
|
3
|
+
Version: 0.16.0
|
|
4
4
|
Summary: Command-line interface for SweatStack — the sports data platform for developers
|
|
5
5
|
Project-URL: Homepage, https://sweatstack.no
|
|
6
6
|
Project-URL: Documentation, https://docs.sweatstack.no
|
|
@@ -26,6 +26,9 @@ Requires-Dist: mypy>=1.14; extra == 'dev'
|
|
|
26
26
|
Requires-Dist: pytest-httpx>=0.35; extra == 'dev'
|
|
27
27
|
Requires-Dist: pytest>=8.0; extra == 'dev'
|
|
28
28
|
Requires-Dist: ruff>=0.9; extra == 'dev'
|
|
29
|
+
Provides-Extra: e2e
|
|
30
|
+
Requires-Dist: playwright>=1.50; extra == 'e2e'
|
|
31
|
+
Requires-Dist: pyarrow>=18.0; extra == 'e2e'
|
|
29
32
|
Description-Content-Type: text/markdown
|
|
30
33
|
|
|
31
34
|
# SweatStack CLI
|
|
@@ -83,7 +86,7 @@ sweatstack page deploy
|
|
|
83
86
|
|---------|-------------|
|
|
84
87
|
| `sweatstack login` | Authenticate via browser (OAuth2 PKCE) |
|
|
85
88
|
| `sweatstack login --force` | Force re-authentication |
|
|
86
|
-
| `sweatstack logout` |
|
|
89
|
+
| `sweatstack logout` | End the sign-in on SweatStack and remove stored credentials |
|
|
87
90
|
| `sweatstack status` | Show auth status, user info, and version |
|
|
88
91
|
| `sweatstack --version` | Show version and check for updates |
|
|
89
92
|
|
|
@@ -53,7 +53,7 @@ sweatstack page deploy
|
|
|
53
53
|
|---------|-------------|
|
|
54
54
|
| `sweatstack login` | Authenticate via browser (OAuth2 PKCE) |
|
|
55
55
|
| `sweatstack login --force` | Force re-authentication |
|
|
56
|
-
| `sweatstack logout` |
|
|
56
|
+
| `sweatstack logout` | End the sign-in on SweatStack and remove stored credentials |
|
|
57
57
|
| `sweatstack status` | Show auth status, user info, and version |
|
|
58
58
|
| `sweatstack --version` | Show version and check for updates |
|
|
59
59
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
[project]
|
|
2
2
|
name = "sweatstack-cli"
|
|
3
|
-
version = "0.
|
|
3
|
+
version = "0.16.0"
|
|
4
4
|
description = "Command-line interface for SweatStack — the sports data platform for developers"
|
|
5
5
|
readme = "README.md"
|
|
6
6
|
authors = [{ name = "Aart Goossens", email = "aart@sweatstack.no" }]
|
|
@@ -39,6 +39,11 @@ dev = [
|
|
|
39
39
|
"mypy>=1.14",
|
|
40
40
|
"coverage>=7.0",
|
|
41
41
|
]
|
|
42
|
+
# The browser test of the `page init` template (`make test-e2e`).
|
|
43
|
+
e2e = [
|
|
44
|
+
"playwright>=1.50",
|
|
45
|
+
"pyarrow>=18.0",
|
|
46
|
+
]
|
|
42
47
|
|
|
43
48
|
[build-system]
|
|
44
49
|
requires = ["hatchling"]
|
|
@@ -80,7 +85,8 @@ warn_unreachable = true
|
|
|
80
85
|
|
|
81
86
|
[tool.pytest.ini_options]
|
|
82
87
|
testpaths = ["tests"]
|
|
83
|
-
addopts = "-ra -q"
|
|
88
|
+
addopts = "-ra -q -m 'not e2e'"
|
|
89
|
+
markers = ["e2e: drives the page template in a real browser (`make test-e2e`)"]
|
|
84
90
|
|
|
85
91
|
[tool.coverage.run]
|
|
86
92
|
source = ["src/sweatstack_cli"]
|
|
@@ -13,6 +13,7 @@ from sweatstack_cli.auth.callback_server import CallbackServer
|
|
|
13
13
|
from sweatstack_cli.auth.pkce import PKCEChallenge, generate_pkce
|
|
14
14
|
from sweatstack_cli.auth.tokens import FileTokenStorage, TokenPair
|
|
15
15
|
from sweatstack_cli.config import get_settings
|
|
16
|
+
from sweatstack_cli.console import stderr_console
|
|
16
17
|
from sweatstack_cli.exceptions import AuthenticationError
|
|
17
18
|
|
|
18
19
|
if TYPE_CHECKING:
|
|
@@ -24,6 +25,15 @@ CLIENT_ID = "5382f68b0d254378"
|
|
|
24
25
|
# Default OAuth2 scopes (offline_access required for refresh tokens)
|
|
25
26
|
SCOPES = "offline_access data:read data:write profile"
|
|
26
27
|
|
|
28
|
+
# Said once per command when the refresh token from the environment was replaced by a new one,
|
|
29
|
+
# which the CLI can keep only for that command.
|
|
30
|
+
ROTATION_LOST_WARNING = (
|
|
31
|
+
"[yellow]Warning:[/yellow] SweatStack replaced the refresh token from "
|
|
32
|
+
"SWEATSTACK_REFRESH_TOKEN. This command used the new one, but the variable still holds the "
|
|
33
|
+
"old one, which SweatStack will stop accepting. To stay signed in on this machine, unset "
|
|
34
|
+
"SWEATSTACK_API_KEY and SWEATSTACK_REFRESH_TOKEN and run 'sweatstack login'."
|
|
35
|
+
)
|
|
36
|
+
|
|
27
37
|
|
|
28
38
|
class Authenticator:
|
|
29
39
|
"""
|
|
@@ -57,6 +67,10 @@ class Authenticator:
|
|
|
57
67
|
self._client_id = client_id
|
|
58
68
|
self._scopes = scopes
|
|
59
69
|
self._settings = get_settings()
|
|
70
|
+
# The environment's tokens once this command refreshed them. Never written to the
|
|
71
|
+
# tokens file: that holds the sign-in of `sweatstack login`, shared with the Python SDK.
|
|
72
|
+
self._renewed_environment_tokens: TokenPair | None = None
|
|
73
|
+
self._warned_rotation_lost = False
|
|
60
74
|
|
|
61
75
|
def login(self, force: bool = False) -> TokenPair:
|
|
62
76
|
"""
|
|
@@ -110,39 +124,77 @@ class Authenticator:
|
|
|
110
124
|
Checks token expiry with a 30-second margin to avoid
|
|
111
125
|
edge cases where token expires during a request.
|
|
112
126
|
|
|
127
|
+
Every refresh returns a new refresh token, and the old one stops working. Tokens from
|
|
128
|
+
the tokens file are saved back to it. Tokens from the environment are kept for the
|
|
129
|
+
rest of this command only, with a warning, because the variables cannot be updated.
|
|
130
|
+
|
|
113
131
|
Returns:
|
|
114
132
|
Valid TokenPair, or None if not authenticated or refresh fails.
|
|
115
133
|
"""
|
|
116
|
-
tokens = self._load_tokens()
|
|
134
|
+
tokens, from_environment = self._load_tokens()
|
|
117
135
|
if tokens is None:
|
|
118
136
|
return None
|
|
119
137
|
|
|
120
138
|
if tokens.is_expired(margin_seconds=30):
|
|
121
139
|
try:
|
|
122
|
-
|
|
123
|
-
self._storage.save(tokens)
|
|
140
|
+
renewed = self._refresh_tokens(tokens.refresh_token)
|
|
124
141
|
except AuthenticationError:
|
|
125
142
|
return None
|
|
143
|
+
if from_environment:
|
|
144
|
+
self._renewed_environment_tokens = renewed
|
|
145
|
+
if renewed.refresh_token != tokens.refresh_token:
|
|
146
|
+
self._warn_rotation_lost()
|
|
147
|
+
else:
|
|
148
|
+
self._storage.save(renewed)
|
|
149
|
+
tokens = renewed
|
|
126
150
|
|
|
127
151
|
return tokens
|
|
128
152
|
|
|
129
|
-
def logout(self) -> None:
|
|
130
|
-
"""
|
|
131
|
-
|
|
153
|
+
def logout(self) -> str | None:
|
|
154
|
+
"""
|
|
155
|
+
End the sign-in of ``sweatstack login`` and remove the tokens file.
|
|
156
|
+
|
|
157
|
+
The refresh token is revoked on SweatStack first, so it stops working everywhere, also
|
|
158
|
+
for a copy of the file. The file is removed whether or not that succeeds.
|
|
159
|
+
|
|
160
|
+
Returns:
|
|
161
|
+
Why SweatStack did not end the sign-in, or None when it did or nothing was stored.
|
|
162
|
+
"""
|
|
163
|
+
tokens = self._storage.load()
|
|
164
|
+
try:
|
|
165
|
+
return None if tokens is None else self._revoke(tokens.refresh_token)
|
|
166
|
+
finally:
|
|
167
|
+
self._storage.delete()
|
|
132
168
|
|
|
133
|
-
def _load_tokens(self) -> TokenPair | None:
|
|
169
|
+
def _load_tokens(self) -> tuple[TokenPair | None, bool]:
|
|
134
170
|
"""
|
|
135
|
-
|
|
171
|
+
The tokens to use, and whether they come from the environment.
|
|
136
172
|
|
|
137
|
-
|
|
173
|
+
``SWEATSTACK_API_KEY`` and ``SWEATSTACK_REFRESH_TOKEN`` together take precedence over
|
|
174
|
+
the tokens file, for CI. Either one alone is ignored: an API key cannot act for the CLI.
|
|
138
175
|
"""
|
|
176
|
+
if self._renewed_environment_tokens is not None:
|
|
177
|
+
return self._renewed_environment_tokens, True
|
|
178
|
+
|
|
139
179
|
access = os.environ.get("SWEATSTACK_API_KEY")
|
|
140
180
|
refresh = os.environ.get("SWEATSTACK_REFRESH_TOKEN")
|
|
141
181
|
|
|
142
182
|
if access and refresh:
|
|
143
|
-
return TokenPair(access_token=access, refresh_token=refresh)
|
|
183
|
+
return TokenPair(access_token=access, refresh_token=refresh), True
|
|
184
|
+
|
|
185
|
+
return self._storage.load(), False
|
|
186
|
+
|
|
187
|
+
def _oauth_client(self, timeout: float) -> httpx.Client:
|
|
188
|
+
"""A client for the OAuth endpoints, named as the API client names itself."""
|
|
189
|
+
return httpx.Client(
|
|
190
|
+
timeout=timeout,
|
|
191
|
+
headers={"User-Agent": f"sweatstack-cli/{self._settings.version}"},
|
|
192
|
+
)
|
|
144
193
|
|
|
145
|
-
|
|
194
|
+
def _warn_rotation_lost(self) -> None:
|
|
195
|
+
if not self._warned_rotation_lost:
|
|
196
|
+
self._warned_rotation_lost = True
|
|
197
|
+
stderr_console.print(ROTATION_LOST_WARNING)
|
|
146
198
|
|
|
147
199
|
def _build_auth_url(self, redirect_uri: str, pkce: PKCEChallenge) -> str:
|
|
148
200
|
"""Construct OAuth2 authorization URL with PKCE challenge."""
|
|
@@ -167,7 +219,7 @@ class Authenticator:
|
|
|
167
219
|
code_verifier: str,
|
|
168
220
|
) -> TokenPair:
|
|
169
221
|
"""Exchange authorization code for tokens."""
|
|
170
|
-
with
|
|
222
|
+
with self._oauth_client(timeout=30.0) as client:
|
|
171
223
|
response = client.post(
|
|
172
224
|
f"{self._settings.api_url}/api/v1/oauth/token",
|
|
173
225
|
data={
|
|
@@ -194,7 +246,7 @@ class Authenticator:
|
|
|
194
246
|
|
|
195
247
|
def _refresh_tokens(self, refresh_token: str) -> TokenPair:
|
|
196
248
|
"""Refresh expired access token using refresh token."""
|
|
197
|
-
with
|
|
249
|
+
with self._oauth_client(timeout=30.0) as client:
|
|
198
250
|
response = client.post(
|
|
199
251
|
f"{self._settings.api_url}/api/v1/oauth/token",
|
|
200
252
|
data={
|
|
@@ -210,10 +262,35 @@ class Authenticator:
|
|
|
210
262
|
data = response.json()
|
|
211
263
|
return TokenPair(
|
|
212
264
|
access_token=data["access_token"],
|
|
213
|
-
#
|
|
214
|
-
|
|
265
|
+
# SweatStack returns a new refresh token with every refresh (it rotates them); an
|
|
266
|
+
# older server returned none, and the presented one stays good then.
|
|
267
|
+
refresh_token=data.get("refresh_token") or refresh_token,
|
|
215
268
|
)
|
|
216
269
|
|
|
270
|
+
def _revoke(self, refresh_token: str) -> str | None:
|
|
271
|
+
"""Revoke a refresh token (RFC 7009). Returns why it failed, or None."""
|
|
272
|
+
try:
|
|
273
|
+
with self._oauth_client(timeout=10.0) as client:
|
|
274
|
+
response = client.post(
|
|
275
|
+
f"{self._settings.api_url}/api/v1/oauth/revoke",
|
|
276
|
+
data={
|
|
277
|
+
"token": refresh_token,
|
|
278
|
+
"token_type_hint": "refresh_token",
|
|
279
|
+
"client_id": self._client_id,
|
|
280
|
+
},
|
|
281
|
+
)
|
|
282
|
+
except httpx.HTTPError:
|
|
283
|
+
return "SweatStack could not be reached"
|
|
284
|
+
|
|
285
|
+
if response.status_code == 200:
|
|
286
|
+
return None
|
|
287
|
+
try:
|
|
288
|
+
body = response.json()
|
|
289
|
+
reason = body.get("error_description") or body.get("error")
|
|
290
|
+
except Exception:
|
|
291
|
+
reason = None
|
|
292
|
+
return f"SweatStack answered {response.status_code}" + (f": {reason}" if reason else "")
|
|
293
|
+
|
|
217
294
|
|
|
218
295
|
# Re-export commonly used types
|
|
219
296
|
__all__ = ["AuthenticationError", "Authenticator", "FileTokenStorage", "TokenPair"]
|
|
@@ -74,10 +74,14 @@ def _confirmation(access_token: str) -> str:
|
|
|
74
74
|
|
|
75
75
|
|
|
76
76
|
def logout() -> None:
|
|
77
|
-
"""
|
|
78
|
-
|
|
79
|
-
auth.logout()
|
|
77
|
+
"""End the sign-in on SweatStack and remove the stored credentials."""
|
|
78
|
+
failure = Authenticator().logout()
|
|
80
79
|
console.print("[green]✓[/green] Logged out")
|
|
80
|
+
if failure:
|
|
81
|
+
console.print(
|
|
82
|
+
f"[yellow]![/yellow] The sign-in could not be ended on SweatStack ({failure}). "
|
|
83
|
+
"The removed refresh token keeps working until it goes a year unused."
|
|
84
|
+
)
|
|
81
85
|
|
|
82
86
|
|
|
83
87
|
def status() -> None:
|
|
@@ -0,0 +1,153 @@
|
|
|
1
|
+
"""Tool commands: serve a tool locally under the SweatStack Tools policy, and check it.
|
|
2
|
+
|
|
3
|
+
`tool create`, `deploy`, `publish` and `rollback` follow when the SweatStack app's tool API exists.
|
|
4
|
+
See plans/developer-kit/cli.md in sweatstack-tools.
|
|
5
|
+
"""
|
|
6
|
+
|
|
7
|
+
from __future__ import annotations
|
|
8
|
+
|
|
9
|
+
import socket
|
|
10
|
+
from pathlib import Path
|
|
11
|
+
|
|
12
|
+
import typer
|
|
13
|
+
|
|
14
|
+
from sweatstack_cli.console import console
|
|
15
|
+
from sweatstack_cli.tools.check import REMOVED_KINDS, Finding, check_folder
|
|
16
|
+
from sweatstack_cli.tools.policy import Policy, load_policy
|
|
17
|
+
from sweatstack_cli.tools.server import make_server
|
|
18
|
+
|
|
19
|
+
DOCS_DEPENDENCIES = "https://docs.sweatstack.no/learn/tools/dependencies/"
|
|
20
|
+
|
|
21
|
+
app = typer.Typer(
|
|
22
|
+
name="tool",
|
|
23
|
+
help="Build tools for SweatStack Tools: serve and check them locally.",
|
|
24
|
+
no_args_is_help=True,
|
|
25
|
+
)
|
|
26
|
+
|
|
27
|
+
|
|
28
|
+
def _directory(directory: Path) -> Path:
|
|
29
|
+
if not directory.is_dir():
|
|
30
|
+
console.print(f"[red]Error:[/red] '{directory}' is not a directory.")
|
|
31
|
+
raise typer.Exit(1)
|
|
32
|
+
return directory.resolve()
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
def _policy() -> Policy:
|
|
36
|
+
policy = load_policy()
|
|
37
|
+
if policy.source == "cached":
|
|
38
|
+
console.print(
|
|
39
|
+
"[yellow]sweatstack.tools is unreachable: using the policy from the last run.[/yellow]"
|
|
40
|
+
)
|
|
41
|
+
elif policy.source == "built-in":
|
|
42
|
+
console.print(
|
|
43
|
+
"[yellow]sweatstack.tools is unreachable: using the policy this CLI shipped with.[/yellow]"
|
|
44
|
+
)
|
|
45
|
+
return policy
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
def _free_port(start: int, attempts: int = 100) -> int:
|
|
49
|
+
for port in range(start, start + attempts):
|
|
50
|
+
with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as probe:
|
|
51
|
+
try:
|
|
52
|
+
probe.bind(("localhost", port))
|
|
53
|
+
return port
|
|
54
|
+
except OSError:
|
|
55
|
+
continue
|
|
56
|
+
console.print(f"[red]Error:[/red] No free port from {start} to {start + attempts - 1}.")
|
|
57
|
+
raise typer.Exit(1)
|
|
58
|
+
|
|
59
|
+
|
|
60
|
+
@app.command()
|
|
61
|
+
def serve(
|
|
62
|
+
directory: Path = typer.Argument(Path("."), help="The tool's folder."),
|
|
63
|
+
port: int | None = typer.Option(
|
|
64
|
+
None, "--port", "-p", help="Port to serve on. The first free one from 8000 by default."
|
|
65
|
+
),
|
|
66
|
+
slug: str = typer.Option("local", "--slug", help="The tool's slug, for its report link."),
|
|
67
|
+
) -> None:
|
|
68
|
+
"""Serve a tool locally, with the same network policy as SweatStack Tools."""
|
|
69
|
+
root = _directory(directory)
|
|
70
|
+
policy = _policy()
|
|
71
|
+
chosen = port if port is not None else _free_port(8000)
|
|
72
|
+
try:
|
|
73
|
+
server = make_server(root, policy, slug=slug, port=chosen)
|
|
74
|
+
except OSError as error:
|
|
75
|
+
console.print(f"[red]Error:[/red] Cannot serve on port {chosen}: {error.strerror}.")
|
|
76
|
+
raise typer.Exit(1)
|
|
77
|
+
console.print(
|
|
78
|
+
"Serving with the SweatStack Tools network policy: requests to other hosts are blocked, "
|
|
79
|
+
"as they will be when deployed. Blocked requests show in the browser console."
|
|
80
|
+
)
|
|
81
|
+
console.print(f" [cyan]http://localhost:{chosen}[/cyan] ({root})")
|
|
82
|
+
try:
|
|
83
|
+
server.serve_forever()
|
|
84
|
+
except KeyboardInterrupt:
|
|
85
|
+
pass
|
|
86
|
+
finally:
|
|
87
|
+
server.server_close()
|
|
88
|
+
|
|
89
|
+
|
|
90
|
+
def say(text: str = "", *, highlight: bool = True) -> None:
|
|
91
|
+
"""Print one line without wrapping."""
|
|
92
|
+
console.print(text, soft_wrap=True, highlight=highlight)
|
|
93
|
+
|
|
94
|
+
|
|
95
|
+
def print_findings(findings: list[Finding], directory: Path) -> None:
|
|
96
|
+
"""The check's report, written for a person and for an agent: what, where, and the fix.
|
|
97
|
+
|
|
98
|
+
Lines never wrap, so each finding stays on one line with its whole URL, at any terminal width.
|
|
99
|
+
"""
|
|
100
|
+
blocked = [f for f in findings if f.kind not in REMOVED_KINDS]
|
|
101
|
+
removed = [f for f in findings if f.kind in REMOVED_KINDS]
|
|
102
|
+
if blocked:
|
|
103
|
+
files = len({f.file for f in blocked})
|
|
104
|
+
say(
|
|
105
|
+
f"[red]✗[/red] {len(blocked)} load{'s' if len(blocked) != 1 else ''} in {files} "
|
|
106
|
+
f"file{'s' if files != 1 else ''} would be blocked on SweatStack Tools"
|
|
107
|
+
)
|
|
108
|
+
say()
|
|
109
|
+
width = max(len(f"{f.file}:{f.line}") for f in blocked)
|
|
110
|
+
kind_width = max(len(f.kind) for f in blocked)
|
|
111
|
+
for f in blocked:
|
|
112
|
+
say(
|
|
113
|
+
f" {f'{f.file}:{f.line}':<{width}} {f.kind:<{kind_width}} {f.url}",
|
|
114
|
+
highlight=False,
|
|
115
|
+
)
|
|
116
|
+
say()
|
|
117
|
+
say(" Tools can load only their own files and the SweatStack API.")
|
|
118
|
+
say(
|
|
119
|
+
" Download these files into your tool (for example into vendor/) and use relative paths."
|
|
120
|
+
)
|
|
121
|
+
say(f" How, including DuckDB and Pyodide: {DOCS_DEPENDENCIES}")
|
|
122
|
+
if removed:
|
|
123
|
+
if blocked:
|
|
124
|
+
say()
|
|
125
|
+
say(
|
|
126
|
+
f"[yellow]![/yellow] {len(removed)} element{'s' if len(removed) != 1 else ''} SweatStack Tools removes, so they do nothing there:"
|
|
127
|
+
)
|
|
128
|
+
say()
|
|
129
|
+
width = max(len(f"{f.file}:{f.line}") for f in removed)
|
|
130
|
+
for f in removed:
|
|
131
|
+
say(f" {f'{f.file}:{f.line}':<{width}} {f.kind} {f.url}", highlight=False)
|
|
132
|
+
say()
|
|
133
|
+
say(
|
|
134
|
+
" Speculation rules, preconnect and DNS prefetch are not available in SweatStack Tools."
|
|
135
|
+
)
|
|
136
|
+
if not findings:
|
|
137
|
+
say(f"[green]✓[/green] Nothing in {directory} loads from another site.")
|
|
138
|
+
|
|
139
|
+
|
|
140
|
+
@app.command()
|
|
141
|
+
def check(
|
|
142
|
+
directory: Path = typer.Argument(Path("."), help="The tool's folder."),
|
|
143
|
+
) -> None:
|
|
144
|
+
"""Check a tool for files it would load from other sites, which SweatStack Tools blocks.
|
|
145
|
+
|
|
146
|
+
Exits with 1 when anything would be blocked, so an agent's loop treats it as a failure to fix.
|
|
147
|
+
"""
|
|
148
|
+
root = _directory(directory)
|
|
149
|
+
policy = _policy()
|
|
150
|
+
findings = check_folder(root, policy.load_origins())
|
|
151
|
+
print_findings(findings, directory)
|
|
152
|
+
if any(f.kind not in REMOVED_KINDS for f in findings):
|
|
153
|
+
raise typer.Exit(1)
|
|
@@ -7,6 +7,7 @@ from dataclasses import dataclass
|
|
|
7
7
|
from functools import cache
|
|
8
8
|
|
|
9
9
|
DEFAULT_API_URL = "https://app.sweatstack.no"
|
|
10
|
+
DEFAULT_TOOLS_URL = "https://sweatstack.tools"
|
|
10
11
|
|
|
11
12
|
|
|
12
13
|
@dataclass(frozen=True, slots=True)
|
|
@@ -14,6 +15,7 @@ class Settings:
|
|
|
14
15
|
"""Immutable application settings."""
|
|
15
16
|
|
|
16
17
|
api_url: str
|
|
18
|
+
tools_url: str
|
|
17
19
|
version: str
|
|
18
20
|
|
|
19
21
|
|
|
@@ -28,5 +30,6 @@ def get_settings() -> Settings:
|
|
|
28
30
|
|
|
29
31
|
return Settings(
|
|
30
32
|
api_url=os.environ.get("SWEATSTACK_URL", DEFAULT_API_URL).rstrip("/"),
|
|
33
|
+
tools_url=os.environ.get("SWEATSTACK_TOOLS_URL", DEFAULT_TOOLS_URL).rstrip("/"),
|
|
31
34
|
version=__version__,
|
|
32
35
|
)
|
|
@@ -6,7 +6,7 @@ import typer
|
|
|
6
6
|
|
|
7
7
|
from sweatstack_cli import __version__
|
|
8
8
|
from sweatstack_cli.commands import app as app_commands
|
|
9
|
-
from sweatstack_cli.commands import auth, page
|
|
9
|
+
from sweatstack_cli.commands import auth, page, tool
|
|
10
10
|
from sweatstack_cli.console import console
|
|
11
11
|
from sweatstack_cli.exceptions import CLIError
|
|
12
12
|
from sweatstack_cli.version_check import get_update_message
|
|
@@ -23,11 +23,12 @@ app = typer.Typer(
|
|
|
23
23
|
# Register command groups
|
|
24
24
|
app.add_typer(page.app, name="page")
|
|
25
25
|
app.add_typer(app_commands.app, name="app")
|
|
26
|
+
app.add_typer(tool.app, name="tool")
|
|
26
27
|
|
|
27
28
|
# Register top-level auth commands for convenience
|
|
28
29
|
# These are the most common operations, so we promote them to top level
|
|
29
30
|
app.command(name="login", help="Authenticate with SweatStack via browser.")(auth.login)
|
|
30
|
-
app.command(name="logout", help="
|
|
31
|
+
app.command(name="logout", help="End the sign-in and remove stored credentials.")(auth.logout)
|
|
31
32
|
app.command(name="status", help="Show authentication and version status.")(auth.status)
|
|
32
33
|
|
|
33
34
|
|