"""Tests for the CLI entry point in paskia/__main__.py. The CLI is split into ``paskia init`` (create the combined paskia.kantadb with the initial realm(s)), ``paskia migrate`` (convert a legacy ``.paskiadb`` database), and bare ``paskia`` (serve the stored realms; never migrates). """ from __future__ import annotations import asyncio import os import subprocess import sys from pathlib import Path import msgspec import pytest from kanta import Kanta from paskia.__main__ import _load_stored_config, main from paskia.db import legacy from paskia.db.structs import Config from paskia.util.runtime import ServeConfig, clear_cache @pytest.fixture def run_cli(monkeypatch, tmp_path): """Run the CLI main() in a temporary working directory. Returns a callable; server.run and the startup box are stubbed out. The returned dict records the server.run invocation (if any). """ monkeypatch.chdir(tmp_path) calls: dict = {} monkeypatch.setattr( "fastapi_vue.server.run", lambda app, **kw: calls.update({"app": app, **kw}), ) monkeypatch.setattr( "paskia.util.startupbox.print_startup_config", lambda *a, **kw: None ) monkeypatch.setattr("logging.basicConfig", lambda **kw: None) # Isolate environment mutations (PASKIA_CONFIG) from other tests env = os.environ.copy() env.pop("PASKIA_CONFIG", None) env.pop("PASKIA_VITE_URL", None) monkeypatch.setattr(os, "environ", env) def _run(*args: str) -> dict: monkeypatch.setattr(sys, "argv", ["paskia", *args]) clear_cache() try: main() finally: clear_cache() return calls return _run def stored_config(tmp_path: Path) -> Config: """Read back the stored combined configuration.""" return _load_stored_config(tmp_path / "paskia.kantadb") def write_legacy_db(root: Path, config: legacy.LegacyConfig) -> Path: """Create a legacy-format database directory .paskiadb/main.db.""" src_dir = root / f"{config.rp_id}.paskiadb" src_dir.mkdir() db_file = src_dir / "main.db" async def _write() -> None: kanta = Kanta(str(db_file), legacy.LegacyDB()) await kanta.open() with kanta.transaction("test:seed"): kanta.data.config = config await kanta.close() asyncio.run(_write()) return src_dir def test_init_defaults(run_cli, tmp_path): run_cli("init") config = stored_config(tmp_path) assert [r.rp_id for r in config.realms] == ["localhost"] assert config.realms[0].rp_name is None assert config.realms[0].auth_host is None assert config.listen is None def test_init_full_options(run_cli, tmp_path): run_cli( "init", "--rp-id", "example.com", "--rp-name", "Example Corp", "--auth-host", "auth.example.com", "--origin", "https://app.example.com", "--listen", "4402", ) config = stored_config(tmp_path) realm = config.realms[0] assert realm.rp_id == "example.com" assert realm.rp_name == "Example Corp" assert realm.auth_host == "https://auth.example.com" assert realm.origins == ["https://auth.example.com", "https://app.example.com"] assert config.listen == ["4402"] def test_init_multiple_rp_ids(run_cli, tmp_path): run_cli("init", "--rp-id", "company.com,app.com", "--rp-id", "pro.com") config = stored_config(tmp_path) assert [r.rp_id for r in config.realms] == ["company.com", "app.com", "pro.com"] assert config.default_realm.rp_id == "company.com" def test_init_refuses_existing_database(run_cli): run_cli("init") with pytest.raises(SystemExit): run_cli("init") def test_init_refuses_legacy_database(run_cli, tmp_path): write_legacy_db(tmp_path, legacy.LegacyConfig(rp_id="example.com")) with pytest.raises(SystemExit): run_cli("init") def test_init_invalid_auth_host(run_cli): with pytest.raises(SystemExit): run_cli("init", "--rp-id", "example.com", "--auth-host", "notsub.example.org") def test_serve_requires_database(run_cli): with pytest.raises(SystemExit, match="paskia init"): run_cli() def test_serve_uses_stored_config(run_cli, tmp_path): run_cli("init", "--rp-id", "example.com", "--rp-name", "Stored Name") calls = run_cli() assert calls["app"] == "paskia.fastapi.mainapp:app" assert calls["listen"] is None # stored listen (None) used serve = msgspec.json.decode(os.environ["PASKIA_CONFIG"].encode(), type=ServeConfig) assert serve.listen is None def test_serve_listen_override_not_persisted(run_cli, tmp_path): run_cli("init", "--listen", "4402") calls = run_cli("--listen", "4403") assert calls["listen"] == ["4403"] serve = msgspec.json.decode(os.environ["PASKIA_CONFIG"].encode(), type=ServeConfig) assert serve.listen == ["4403"] # Stored config keeps the original listen value assert stored_config(tmp_path).listen == ["4402"] def test_serve_suggests_migrate_when_legacy_present(run_cli, tmp_path): write_legacy_db(tmp_path, legacy.LegacyConfig(rp_id="example.com")) with pytest.raises(SystemExit, match="paskia migrate"): run_cli() def test_migrate_converts_legacy_database(run_cli, tmp_path): src_dir = write_legacy_db( tmp_path, legacy.LegacyConfig(rp_id="example.com", rp_name="Legacy Name") ) # Persisted user files move to the new data root avatar = src_dir / "users" / "019c6831-84cf-7b88-b66c-c8165890b7c5" avatar.mkdir(parents=True) (avatar / "profile.webp").write_bytes(b"RIFF1234WEBP") run_cli("migrate") config = stored_config(tmp_path) assert [r.rp_id for r in config.realms] == ["example.com"] assert config.realms[0].rp_name == "Legacy Name" # Legacy directory renamed aside, user files moved over assert not src_dir.exists() assert (tmp_path / "example.com.paskiadb.converted-bak").is_dir() assert ( tmp_path / "paskia.data" / "users" / "019c6831-84cf-7b88-b66c-c8165890b7c5" / "profile.webp" ).read_bytes() == b"RIFF1234WEBP" def test_migrate_multiple_legacy_databases_require_rp_id(run_cli, tmp_path): write_legacy_db(tmp_path, legacy.LegacyConfig(rp_id="one.com")) write_legacy_db(tmp_path, legacy.LegacyConfig(rp_id="two.com")) with pytest.raises(SystemExit, match="--rp-id"): run_cli("migrate") def test_migrate_explicit_rp_id_selects_candidate(run_cli, tmp_path): write_legacy_db(tmp_path, legacy.LegacyConfig(rp_id="one.com")) write_legacy_db(tmp_path, legacy.LegacyConfig(rp_id="two.com")) run_cli("migrate", "--rp-id", "two.com") config = stored_config(tmp_path) assert [r.rp_id for r in config.realms] == ["two.com"] # The other candidate is left in place assert (tmp_path / "one.com.paskiadb").is_dir() assert (tmp_path / "two.com.paskiadb.converted-bak").is_dir() def test_migrate_unknown_rp_id(run_cli, tmp_path): write_legacy_db(tmp_path, legacy.LegacyConfig(rp_id="one.com")) with pytest.raises(SystemExit, match="nope.com.paskiadb"): run_cli("migrate", "--rp-id", "nope.com") def test_migrate_refuses_existing_database(run_cli): run_cli("init") with pytest.raises(SystemExit, match="already exists"): run_cli("migrate") def test_migrate_without_legacy_database(run_cli): with pytest.raises(SystemExit, match="No legacy"): run_cli("migrate") def test_cli_help(): result = subprocess.run( [sys.executable, "-m", "paskia", "--help"], capture_output=True, text=True, check=False, ) assert result.returncode == 0 assert "Paskia authentication server" in result.stdout def test_cli_init_help(): result = subprocess.run( [sys.executable, "-m", "paskia", "init", "--help"], capture_output=True, text=True, check=False, ) assert result.returncode == 0 assert "Bootstrap" in result.stdout def test_cli_migrate_help(): result = subprocess.run( [sys.executable, "-m", "paskia", "migrate", "--help"], capture_output=True, text=True, check=False, ) assert result.returncode == 0 assert "Convert" in result.stdout