"""The tabs and the JSON API they call, against a temp database and FastAPI's TestClient. No network — nothing here touches an ATS host or the queue's own worker beyond starting and stopping it with the app.""" from __future__ import annotations from collections.abc import Iterator from datetime import UTC, datetime, timedelta from pathlib import Path import pytest from fastapi import FastAPI from fastapi.testclient import TestClient from app.config import Config, ServerConfig from app.main import create_app from app.storage import Store from app.web import MOVED, SETTINGS, TABS from auth import AuthConfig from desk.models import Item class Clock: """A controllable `Store.clock`, for tests that need upserts to land at distinct, known moments — see `test_storage.py`'s twin of this.""" def __init__(self) -> None: self.at = datetime(2026, 9, 23, 9, 0, tzinfo=UTC) def __call__(self) -> datetime: return self.at def tick(self, hours: float = 1) -> None: self.at += timedelta(hours=hours) def posting(source_id: str = "1", **raw: object) -> Item: item = Item(source_id=source_id, location=f"https://boards.example/acme/{source_id}", title="Senior Backend Engineer", body="Build things.", published_at=datetime(2026, 9, 20, tzinfo=UTC), raw=dict(raw)) item.source = "ats" return item @pytest.fixture def app(tmp_path: Path) -> FastAPI: """The database in `tmp_path` and the config passed in, so a test never touches `roledesk.db` and two tests never share a jobs table.""" return create_app(Config(server=ServerConfig(host="127.0.0.1", port=0), database=tmp_path / "roledesk.db")) @pytest.fixture def store(app: FastAPI) -> Store: return app.state.store @pytest.fixture def client(app: FastAPI) -> Iterator[TestClient]: with TestClient(app) as c: yield c # ------------------------------------------------------------------- roles def test_list_roles_filters_by_query_place_and_function( client: TestClient, store: Store) -> None: store.upsert_role(posting("1", company="Acme", place="Berlin", function="engineering")) store.upsert_role(posting("2", company="Acme", place="Munich", function="sales")) store.upsert_role(posting("3", company="Other", place="Berlin", function="engineering")) res = client.get("/api/roles", params={"q": "engineer", "place": "Berlin"}) assert res.status_code == 200 assert {r["source_id"] for r in res.json()["items"]} == {"1", "3"} res = client.get("/api/roles", params={"function": "sales"}) assert [r["source_id"] for r in res.json()["items"]] == ["2"] res = client.get("/api/roles", params={"company": "other"}) assert [r["source_id"] for r in res.json()["items"]] == ["3"] def test_list_roles_limit_is_bounded(client: TestClient, store: Store) -> None: for i in range(3): store.upsert_role(posting(str(i))) assert len(client.get("/api/roles", params={"limit": 1}).json()["items"]) == 1 assert client.get("/api/roles", params={"limit": 0}).status_code == 422 assert client.get("/api/roles", params={"limit": 1001}).status_code == 422 def test_muted_roles_are_hidden_unless_show_muted(client: TestClient, store: Store) -> None: store.add_company("Acme", key="acme") store.upsert_role(posting("1", company="Acme")) store.upsert_role(posting("2", company="Other")) assert {r["source_id"] for r in client.get("/api/roles").json()["items"]} == {"1", "2"} assert client.post("/api/companies/acme/affinity", json={"affinity": -1}).status_code == 200 assert {r["source_id"] for r in client.get("/api/roles").json()["items"]} == {"2"} assert {r["source_id"] for r in client.get("/api/roles", params={"show_muted": "true"}).json()["items"]} == {"1", "2"} def test_muted_is_excluded_before_the_limit_not_after( client: TestClient, store: Store) -> None: """A regression case: filtering a muted company out of an already `LIMIT`-ed page can leave nothing to show, if that company happens to be the newest thing in the database — exactly what a company with hundreds of roles, all freshly (re-)pulled at once, produces.""" clock = Clock() store.clock = clock store.add_company("Acme", key="acme", affinity=-1) store.upsert_role(posting("other", company="Other")) clock.tick() for i in range(3): store.upsert_role(posting(f"a{i}", company="Acme")) clock.tick() res = client.get("/api/roles", params={"limit": 1}) assert [r["source_id"] for r in res.json()["items"]] == ["other"] assert res.json()["total"] == 1 def test_list_roles_pages_by_offset_and_counts_the_total( client: TestClient, store: Store) -> None: clock = Clock() store.clock = clock for i in range(5): store.upsert_role(posting(str(i))) clock.tick() first = client.get("/api/roles", params={"limit": 2}).json() assert [r["source_id"] for r in first["items"]] == ["4", "3"] assert first["total"] == 5 rest = client.get("/api/roles", params={"limit": 2, "offset": 4}).json() assert [r["source_id"] for r in rest["items"]] == ["0"] and rest["total"] == 5 assert client.get("/api/roles", params={"offset": 9}).json() == {"items": [], "total": 5} assert client.get("/api/roles", params={"offset": -1}).status_code == 422 assert len(client.get("/api/roles").json()["items"]) == 5 # default 60 def test_a_vote_is_set_cleared_and_filtered_on(client: TestClient, store: Store) -> None: for sid in ("liked", "passed", "fine", "open"): store.upsert_role(posting(sid)) uid = {r.source_id: r.uid for r in store.roles()} res = client.post(f"/api/roles/{uid['liked']}/vote", json={"value": 1}) assert res.status_code == 200 assert res.json()["vote"] == 1 and res.json()["voted_at"] is not None client.post(f"/api/roles/{uid['passed']}/vote", json={"value": -1}) client.post(f"/api/roles/{uid['fine']}/vote", json={"value": 0}) def judged(value: str) -> set[str]: page = client.get("/api/roles", params={"judged": value}).json() return {r["source_id"] for r in page["items"]} assert judged("liked") == {"liked"} assert judged("passed") == {"passed"} assert judged("unjudged") == {"open"} assert judged("") == {"liked", "passed", "fine", "open"} # a pass is not hidden assert client.get("/api/roles", params={"judged": "maybe"}).status_code == 422 cleared = client.delete(f"/api/roles/{uid['liked']}/vote") assert cleared.status_code == 200 assert cleared.json()["vote"] is None and cleared.json()["voted_at"] is None assert judged("unjudged") == {"open", "liked"} assert client.post(f"/api/roles/{uid['open']}/vote", json={"value": 2}).status_code == 422 assert client.post("/api/roles/nope/vote", json={"value": 1}).status_code == 404 assert client.delete("/api/roles/nope/vote").status_code == 404 def test_a_vote_moves_a_role_in_the_ranking_at_once( client: TestClient, store: Store) -> None: for sid in ("a", "b", "c"): store.upsert_role(posting(sid)) uid = {r.source_id: r.uid for r in store.roles()} agent = store.save_agent("A") store.replace_scores(agent.id, [(uid["a"], 0.9, ""), (uid["b"], 0.6, ""), (uid["c"], 0.55, "")]) def ranked() -> list[tuple[str, float]]: page = client.get("/api/roles", params={"agent": agent.id}).json() return [(r["source_id"], round(r["score"], 3)) for r in page["items"]] assert ranked() == [("a", 0.9), ("b", 0.6), ("c", 0.55)] client.post(f"/api/roles/{uid['a']}/vote", json={"value": -1}) client.post(f"/api/roles/{uid['c']}/vote", json={"value": 1}) assert ranked() == [("c", 0.66), ("b", 0.6), ("a", 0.45)] client.post(f"/api/roles/{uid['b']}/vote", json={"value": 0}) client.post(f"/api/roles/{uid['a']}/vote", json={"value": 1}) assert ranked() == [("a", 1.0), ("c", 0.66), ("b", 0.6)] # capped at 1 def test_one_role_and_its_read_page(client: TestClient, store: Store) -> None: store.upsert_role(posting("1", company="Acme", place="Berlin")) uid = posting("1").uid res = client.get(f"/api/roles/{uid}") assert res.status_code == 200 body = res.json() assert (body["uid"], body["company"], body["description"]) == (uid, "Acme", "Build things.") assert body["vote"] is None and body["summary"] == "" and body["article_text"] == "" assert client.get("/api/roles/nope").status_code == 404 page = client.get(f"/roles/{uid}") assert page.status_code == 200 assert 'id="role"' in page.text and "/static/role.js" in page.text assert "/static/roles.js" not in page.text missing = client.get("/roles/nope") assert missing.status_code == 404 and "text/html" in missing.headers["content-type"] def test_the_roles_page_offers_the_judged_filter_and_hidden_companies( client: TestClient) -> None: page = client.get("/").text assert 'id="f-judged"' in page and "