softmax-cli 0.26.13__tar.gz → 0.26.14__tar.gz

softmax_cli-0.26.14/AGENTS.md

@@ -0,0 +1,49 @@
+# AGENTS.md — softmax-cli
+
+The `softmax` CLI: authentication and account tools for Softmax/Observatory. Other packages (e.g. `coworld`) depend on
+it for login/token handling and pin an exact version. Deps: `typer`, `rich`, `httpx`, plus `fastapi`/`uvicorn` for the
+local browser-login callback server. The `cogames` optional extra mounts the cogames CLI as a `softmax cogames`
+subcommand. Published to PyPI.
+
+## CLI
+
+Installs a `softmax` entrypoint (`softmax.cli:app`, Typer):
+
+```bash
+uv run softmax login          # browser-based login (spins up a local callback server)
+uv run softmax logout
+uv run softmax status
+uv run softmax get-login-url
+uv run softmax get-token / set-token
+uv run softmax cogames ...    # only when installed with the `cogames` extra
+```
+
+## Tests
+
+```bash
+uv run metta pytest packages/softmax-cli/tests -v
+uv run metta pytest --changed
+```
+
+Tests cover auth/login, the Python API, and CLI plugin wiring; a `BUILD.bazel` exists under `tests/`.
+
+## Lint
+
+```bash
+uv run metta lint --fix              # ruff (also runs via the Edit/Write hook)
+```
+
+## Source layout (`src/softmax/`)
+
+- `cli.py` — the Typer app; mounts the optional `cogames` subapp via `add_typer`.
+- `auth.py` — auth/session state and token validation.
+- `perform_login.py` — the local FastAPI/uvicorn callback server used during `softmax login`.
+- `token_storage.py` — on-disk token persistence.
+- `cogames.py` — the optional cogames subcommand wiring.
+- `_console.py` — shared rich console helpers.
+
+## Gotchas
+
+- Versioned via `setuptools_scm` off `softmax-v*` git tags (`fallback_version = 0.0.0`).
+- Downstream packages pin an exact `softmax-cli==X.Y.Z`; bumping the public auth API can break them — coordinate version
+  bumps with consumers like `coworld`.

{softmax_cli-0.26.13 → softmax_cli-0.26.14}/BUILD.bazel

@@ -9,11 +9,11 @@ py_library(
     visibility = ["//visibility:public"],
     deps = [
         # Mirrors packages/softmax-cli/pyproject.toml [project.dependencies].
-        "@pyenv//:typer",
-        "@pyenv//:rich",
-        "@pyenv//:fastapi",
-        "@pyenv//:uvicorn",
-        "@pyenv//:httpx",
-        "@pyenv//:pyyaml",
+        "@pypi//typer",
+        "@pypi//rich",
+        "@pypi//fastapi",
+        "@pypi//uvicorn",
+        "@pypi//httpx",
+        "@pypi//pyyaml",
     ],
 )

softmax_cli-0.26.14/CLAUDE.md

@@ -0,0 +1,49 @@
+# AGENTS.md — softmax-cli
+
+The `softmax` CLI: authentication and account tools for Softmax/Observatory. Other packages (e.g. `coworld`) depend on
+it for login/token handling and pin an exact version. Deps: `typer`, `rich`, `httpx`, plus `fastapi`/`uvicorn` for the
+local browser-login callback server. The `cogames` optional extra mounts the cogames CLI as a `softmax cogames`
+subcommand. Published to PyPI.
+
+## CLI
+
+Installs a `softmax` entrypoint (`softmax.cli:app`, Typer):
+
+```bash
+uv run softmax login          # browser-based login (spins up a local callback server)
+uv run softmax logout
+uv run softmax status
+uv run softmax get-login-url
+uv run softmax get-token / set-token
+uv run softmax cogames ...    # only when installed with the `cogames` extra
+```
+
+## Tests
+
+```bash
+uv run metta pytest packages/softmax-cli/tests -v
+uv run metta pytest --changed
+```
+
+Tests cover auth/login, the Python API, and CLI plugin wiring; a `BUILD.bazel` exists under `tests/`.
+
+## Lint
+
+```bash
+uv run metta lint --fix              # ruff (also runs via the Edit/Write hook)
+```
+
+## Source layout (`src/softmax/`)
+
+- `cli.py` — the Typer app; mounts the optional `cogames` subapp via `add_typer`.
+- `auth.py` — auth/session state and token validation.
+- `perform_login.py` — the local FastAPI/uvicorn callback server used during `softmax login`.
+- `token_storage.py` — on-disk token persistence.
+- `cogames.py` — the optional cogames subcommand wiring.
+- `_console.py` — shared rich console helpers.
+
+## Gotchas
+
+- Versioned via `setuptools_scm` off `softmax-v*` git tags (`fallback_version = 0.0.0`).
+- Downstream packages pin an exact `softmax-cli==X.Y.Z`; bumping the public auth API can break them — coordinate version
+  bumps with consumers like `coworld`.

softmax_cli-0.26.14/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: softmax-cli
+Version: 0.26.14
+Summary: Softmax CLI — authentication and account tools
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: <3.13,>=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.19.2
+Requires-Dist: rich>=13.7.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: uvicorn>=0.34.0
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pyyaml>=6.0.2
+Provides-Extra: cogames
+Requires-Dist: cogames; extra == "cogames"
+
+# softmax-cli
+
+The `softmax` command-line tool: authentication and account management for Softmax / Observatory. It provides
+browser-based login (with a local callback server), token storage, and account status. Other packages — notably
+`coworld` — depend on it for auth. Installing with the `cogames` extra mounts the cogames CLI as a `softmax cogames`
+subcommand.
+
+## Install
+
+```bash
+uv tool install softmax-cli            # standalone
+uv tool install "softmax-cli[cogames]" # with the cogames subcommand
+```
+
+Within the metta workspace it is available via `uv sync`.
+
+## Usage
+
+```bash
+uv run softmax login           # log in via the browser
+uv run softmax status          # show current auth status
+uv run softmax logout
+uv run softmax get-token       # print the stored token
+uv run softmax set-token       # store a token manually
+uv run softmax cogames ...     # only with the `cogames` extra
+```
+
+## Development
+
+```bash
+uv run metta pytest packages/softmax-cli/tests -v   # run tests
+uv run metta lint --fix                              # lint/format
+```
+
+See [AGENTS.md](AGENTS.md) for the source layout and versioning/compatibility notes.

softmax_cli-0.26.14/README.md

@@ -0,0 +1,35 @@
+# softmax-cli
+
+The `softmax` command-line tool: authentication and account management for Softmax / Observatory. It provides
+browser-based login (with a local callback server), token storage, and account status. Other packages — notably
+`coworld` — depend on it for auth. Installing with the `cogames` extra mounts the cogames CLI as a `softmax cogames`
+subcommand.
+
+## Install
+
+```bash
+uv tool install softmax-cli            # standalone
+uv tool install "softmax-cli[cogames]" # with the cogames subcommand
+```
+
+Within the metta workspace it is available via `uv sync`.
+
+## Usage
+
+```bash
+uv run softmax login           # log in via the browser
+uv run softmax status          # show current auth status
+uv run softmax logout
+uv run softmax get-token       # print the stored token
+uv run softmax set-token       # store a token manually
+uv run softmax cogames ...     # only with the `cogames` extra
+```
+
+## Development
+
+```bash
+uv run metta pytest packages/softmax-cli/tests -v   # run tests
+uv run metta lint --fix                              # lint/format
+```
+
+See [AGENTS.md](AGENTS.md) for the source layout and versioning/compatibility notes.

softmax_cli-0.26.14/src/softmax_cli.egg-info/PKG-INFO

@@ -0,0 +1,53 @@
+Metadata-Version: 2.4
+Name: softmax-cli
+Version: 0.26.14
+Summary: Softmax CLI — authentication and account tools
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: <3.13,>=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: typer>=0.19.2
+Requires-Dist: rich>=13.7.0
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: uvicorn>=0.34.0
+Requires-Dist: httpx>=0.28.1
+Requires-Dist: pyyaml>=6.0.2
+Provides-Extra: cogames
+Requires-Dist: cogames; extra == "cogames"
+
+# softmax-cli
+
+The `softmax` command-line tool: authentication and account management for Softmax / Observatory. It provides
+browser-based login (with a local callback server), token storage, and account status. Other packages — notably
+`coworld` — depend on it for auth. Installing with the `cogames` extra mounts the cogames CLI as a `softmax cogames`
+subcommand.
+
+## Install
+
+```bash
+uv tool install softmax-cli            # standalone
+uv tool install "softmax-cli[cogames]" # with the cogames subcommand
+```
+
+Within the metta workspace it is available via `uv sync`.
+
+## Usage
+
+```bash
+uv run softmax login           # log in via the browser
+uv run softmax status          # show current auth status
+uv run softmax logout
+uv run softmax get-token       # print the stored token
+uv run softmax set-token       # store a token manually
+uv run softmax cogames ...     # only with the `cogames` extra
+```
+
+## Development
+
+```bash
+uv run metta pytest packages/softmax-cli/tests -v   # run tests
+uv run metta lint --fix                              # lint/format
+```
+
+See [AGENTS.md](AGENTS.md) for the source layout and versioning/compatibility notes.

{softmax_cli-0.26.13 → softmax_cli-0.26.14}/src/softmax_cli.egg-info/SOURCES.txt

@@ -1,4 +1,7 @@
+AGENTS.md
 BUILD.bazel
+CLAUDE.md
+README.md
 pyproject.toml
 src/softmax/__init__.py
 src/softmax/_console.py

{softmax_cli-0.26.13 → softmax_cli-0.26.14}/tests/BUILD.bazel

@@ -26,12 +26,13 @@ _TEST_FILES = glob(
         deps = [
             "//packages/softmax-cli:softmax",
             # test_cli_plugins exercises Typer entry-point discovery — it
-            # asserts `cogames` registers as a softmax subcommand. With
-            # per-package @pyenv targets only deps you name reach the
-            # runfiles tree, so the cogames dist-info has to be pulled in
-            # explicitly for the entry-point loader to find it.
-            "@pyenv//:cogames",
-            "@pyenv//:pytest",
+            # asserts `cogames` registers as a softmax subcommand. The
+            # cogames bazel target carries its src/ tree but not the
+            # installed entry-point metadata; if test_cli_plugins fails
+            # after this migration the fix is to add a runtime data dep
+            # on the cogames wheel's dist-info instead.
+            "//packages/cogames:cogames",
+            "@pypi//pytest",
         ],
     )
     for test_file in _TEST_FILES

{softmax_cli-0.26.13 → softmax_cli-0.26.14}/tests/test_cli_plugins.py

@@ -20,5 +20,4 @@ def test_softmax_cogames_help_lists_local_commands() -> None:
     assert "train" in result.stdout
     assert "eval" in result.stdout
     assert "bundle" in result.stdout
-    assert "player" in result.stdout
     assert "tutorial" in result.stdout

softmax_cli-0.26.13/PKG-INFO

@@ -1,17 +0,0 @@
-Metadata-Version: 2.4
-Name: softmax-cli
-Version: 0.26.13
-Summary: Softmax CLI — authentication and account tools
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Python: <3.13,>=3.11
-Description-Content-Type: text/markdown
-Requires-Dist: typer>=0.19.2
-Requires-Dist: rich>=13.7.0
-Requires-Dist: fastapi>=0.115.0
-Requires-Dist: uvicorn>=0.34.0
-Requires-Dist: httpx>=0.28.1
-Requires-Dist: pyyaml>=6.0.2
-Provides-Extra: cogames
-Requires-Dist: cogames; extra == "cogames"

softmax_cli-0.26.13/src/softmax_cli.egg-info/PKG-INFO

@@ -1,17 +0,0 @@
-Metadata-Version: 2.4
-Name: softmax-cli
-Version: 0.26.13
-Summary: Softmax CLI — authentication and account tools
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Requires-Python: <3.13,>=3.11
-Description-Content-Type: text/markdown
-Requires-Dist: typer>=0.19.2
-Requires-Dist: rich>=13.7.0
-Requires-Dist: fastapi>=0.115.0
-Requires-Dist: uvicorn>=0.34.0
-Requires-Dist: httpx>=0.28.1
-Requires-Dist: pyyaml>=6.0.2
-Provides-Extra: cogames
-Requires-Dist: cogames; extra == "cogames"