paskia/tests/test_cli.py

"""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)) and bare ``paskia`` (serve the stored realms,
adopting a lone legacy ``<rp-id>.paskiadb`` database if present).
"""

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 <rp-id>.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_adopts_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()

    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 adopted
    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_serve_multiple_legacy_databases_abort(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="Multiple legacy"):
        run_cli()


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