DeepTutor: Lifelong Personalized Tutoring. https://deeptutor.info/.
Python ai-agentsai-tutorclawbotcli-tooldeepresearchinteractive-learninglearningmulti-agent-systemsrag
from __future__ import annotations
from pathlib import Path
import pytest
fastapi = pytest.importorskip("fastapi")
TestClient = pytest.importorskip("fastapi.testclient").TestClient
from deeptutor.knowledge.manager import KnowledgeBaseManager
import deeptutor.services.config as config_package
from deeptutor.services.config import loader as config_loader
from deeptutor.services.web_source import scheduler as scheduler_module
from deeptutor.services.web_source.repository import (
SQLiteWebSourceSyncRepository,
)
@pytest.fixture()
def client(tmp_path: Path, monkeypatch: pytest.MonkeyPatch):
from fastapi import FastAPI
runtime_home = tmp_path / "runtime"
settings_dir = runtime_home / "data" / "user" / "settings"
settings_dir.mkdir(parents=True)
(settings_dir / "main.yaml").write_text("system:\n language: en\n", encoding="utf-8")
monkeypatch.setenv("DEEPTUTOR_HOME", str(runtime_home))
monkeypatch.setattr(config_package, "PROJECT_ROOT", runtime_home)
monkeypatch.setattr(config_loader, "PROJECT_ROOT", runtime_home)
from deeptutor.api.routers import knowledge as knowledge_router
manager = KnowledgeBaseManager(base_dir=str(tmp_path / "kbs"))
(manager.base_dir / "kb").mkdir(parents=True)
(manager.base_dir / "kb" / "metadata.json").write_text("{}", encoding="utf-8")
manager.register_knowledge_base("kb")
def writable(kb_name: str):
assert kb_name == "kb"
return manager, "kb", manager.base_dir
monkeypatch.setattr(knowledge_router, "_writable_kb", writable)
scheduler = scheduler_module.WebSourceSyncScheduler(
repository=SQLiteWebSourceSyncRepository(tmp_path / "web-source-sync.sqlite")
)
monkeypatch.setattr(scheduler_module, "_scheduler", scheduler)
app = FastAPI()
app.include_router(knowledge_router.router, prefix="/api")
return TestClient(app), manager
def test_schedule_defaults_update_and_delete_cleanup(client) -> None:
test_client, manager = client
source = manager.add_web_source("kb", "https://example.com/docs/")
scheduler_module._scheduler.repo.ensure_source(("local-admin", "kb", source["id"]))
created = test_client.post(
"/api/knowledge-bases/kb/web-source",
json={"url": "https://another.example.com/docs/"},
)
assert created.status_code == 200
assert created.json()["auto_sync_enabled"] is True
assert created.json()["sync_interval_hours"] == 24
jobs = test_client.get("/api/knowledge-bases/kb/web-source-sync")
assert jobs.status_code == 200
assert {item["source_id"] for item in jobs.json()} == {
source["id"],
created.json()["id"],
}
updated = test_client.put(
f"/api/knowledge-bases/kb/web-source/{source['id']}/schedule",
json={"auto_sync_enabled": False, "sync_interval_hours": 6},
)
assert updated.status_code == 200
assert updated.json()["auto_sync_enabled"] is False
assert updated.json()["sync_interval_hours"] == 6
scheduled_ids = {
item["source_id"]
for item in test_client.get("/api/knowledge-bases/kb/web-source-sync").json()
}
assert scheduled_ids == {created.json()["id"]}
removed = test_client.delete(f"/api/knowledge-bases/kb/web-source/{source['id']}")
assert removed.status_code == 200
job_ids = {
item["source_id"]
for item in test_client.get("/api/knowledge-bases/kb/web-source-sync").json()
}
assert source["id"] not in job_ids
def test_schedule_rejects_out_of_range_interval(client) -> None:
test_client, manager = client
source = manager.add_web_source("kb", "https://example.com/docs/")
response = test_client.put(
f"/api/knowledge-bases/kb/web-source/{source['id']}/schedule",
json={"auto_sync_enabled": True, "sync_interval_hours": 0},
)
assert response.status_code == 422
def test_web_source_pairings_api(client) -> None:
test_client, manager = client
source = manager.add_web_source("kb", "https://example.com/docs/")
source_id = source["id"]
# Initial web-sources listing has empty pairings
list_res = test_client.get("/api/knowledge-bases/kb/web-sources")
assert list_res.status_code == 200
sources = list_res.json()
assert len(sources) == 1
assert "bilingual_pairings" in sources[0]
assert sources[0]["bilingual_pairings"] == []
# Initial pairings endpoint returns empty
pair_res = test_client.get(f"/api/knowledge-bases/kb/web-source/{source_id}/pairings")
assert pair_res.status_code == 200
assert pair_res.json() == []
# Record pairings into repo
scheduler_module._scheduler.repo.record_pairings(
"local-admin",
"kb",
source_id,
[
{
"pairing_id": "pair-1",
"source_url": "https://example.com/docs/intro",
"target_url": "https://example.com/zh/docs/intro",
"source_file": "_web/s/docs/intro.md",
"target_file": "_web/s/zh/docs/intro.md",
"source_lang": "en",
"target_lang": "zh",
"pairing_method": "hreflang",
}
],
)
pair_res = test_client.get(f"/api/knowledge-bases/kb/web-source/{source_id}/pairings")
assert pair_res.status_code == 200
pairings = pair_res.json()
assert len(pairings) == 1
assert pairings[0]["pairing_id"] == "pair-1"
assert pairings[0]["source_lang"] == "en"
assert pairings[0]["target_lang"] == "zh"
# Non-existent source returns 404
missing_res = test_client.get("/api/knowledge-bases/kb/web-source/nonexistent/pairings")
assert missing_res.status_code == 404
# Deleting source removes pairings
del_res = test_client.delete(f"/api/knowledge-bases/kb/web-source/{source_id}")
assert del_res.status_code == 200
assert scheduler_module._scheduler.repo.list_pairings("local-admin", "kb", source_id) == []