initial commit

This commit is contained in:
2026-04-12 23:24:13 +08:00
commit 7592af1c3a
55 changed files with 5051 additions and 0 deletions
+250
View File
@@ -0,0 +1,250 @@
"""命令集成测试: 使用 mock GiteaClient 测试 CLI 命令逻辑"""
from __future__ import annotations
import csv
from pathlib import Path
from unittest.mock import MagicMock, patch
import pytest
from pydantic import HttpUrl, SecretStr
from typer.testing import CliRunner
from tjhlp.cli import app
from tjhlp.config import GiteaConfig, LabelDef
from tjhlp.models import GiteaRepo, GiteaTeam, GiteaUser
runner = CliRunner()
@pytest.fixture()
def mock_config() -> GiteaConfig:
return GiteaConfig(
url=HttpUrl("http://gitea.test"),
token=SecretStr("test-token"),
labels=[
LabelDef(name="duplicate", color="#cfd3d7", description="重复"),
LabelDef(name="resolved", color="#0e8a16", description="已解决"),
],
)
# ---------------------------------------------------------------------------
# setup status
# ---------------------------------------------------------------------------
class TestSetupStatus:
@patch("tjhlp.commands.setup.GiteaClient")
@patch("tjhlp.commands.setup.get_gitea_config")
def test_status_ok(self, mock_get_cfg, mock_client_cls, mock_config):
mock_get_cfg.return_value = mock_config
client = MagicMock()
client.__enter__ = MagicMock(return_value=client)
client.__exit__ = MagicMock(return_value=False)
client.get_version.return_value = "1.25.5"
mock_client_cls.return_value = client
result = runner.invoke(app, ["setup", "status"])
assert result.exit_code == 0
assert "1.25.5" in result.output
# ---------------------------------------------------------------------------
# users list
# ---------------------------------------------------------------------------
class TestUsersList:
@patch("tjhlp.commands.users.GiteaClient")
@patch("tjhlp.commands.users.get_gitea_config")
def test_list_users(self, mock_get_cfg, mock_client_cls, mock_config):
mock_get_cfg.return_value = mock_config
client = MagicMock()
client.__enter__ = MagicMock(return_value=client)
client.__exit__ = MagicMock(return_value=False)
client.list_users.return_value = [
GiteaUser(id=1, login="admin", full_name="Admin", is_admin=True),
GiteaUser(id=2, login="2659999", full_name="赵一伤"),
]
mock_client_cls.return_value = client
result = runner.invoke(app, ["users", "list"])
assert result.exit_code == 0
assert "admin" in result.output
assert "2659999" in result.output
# ---------------------------------------------------------------------------
# users create (dry-run)
# ---------------------------------------------------------------------------
class TestUsersCreateDryRun:
def test_dry_run(self, tmp_path: Path, mock_config):
csv_file = tmp_path / "members.csv"
csv_file.write_text(
"id,name,role\n2659999,赵一伤,student\n10001,李四催,ta\n",
encoding="utf-8",
)
with patch("tjhlp.commands.users.get_gitea_config", return_value=mock_config):
result = runner.invoke(
app,
[
"users",
"create",
"--file",
str(csv_file),
"--dry-run",
],
)
assert result.exit_code == 0
assert "2659999" in result.output
assert "赵一伤" in result.output
# ---------------------------------------------------------------------------
# users create (actual)
# ---------------------------------------------------------------------------
class TestUsersCreate:
@patch("tjhlp.commands.users.GiteaClient")
@patch("tjhlp.commands.users.get_gitea_config")
def test_creates_users_and_outputs_credentials(
self, mock_get_cfg, mock_client_cls, mock_config, tmp_path: Path
):
mock_get_cfg.return_value = mock_config
client = MagicMock()
client.__enter__ = MagicMock(return_value=client)
client.__exit__ = MagicMock(return_value=False)
client.get_user.return_value = None # user doesn't exist
client.create_user.return_value = GiteaUser(id=1, login="2659999")
client.get_team_by_name.return_value = None # no org specified
mock_client_cls.return_value = client
csv_file = tmp_path / "members.csv"
csv_file.write_text("id,name,role\n2659999,赵一伤,student\n", encoding="utf-8")
out_file = tmp_path / "creds.csv"
result = runner.invoke(
app,
[
"users",
"create",
"--file",
str(csv_file),
"--output",
str(out_file),
],
)
assert result.exit_code == 0
assert "创建" in result.output
assert out_file.exists()
# Verify credentials CSV
with open(out_file, encoding="utf-8") as f:
rows = list(csv.DictReader(f))
assert len(rows) == 1
assert rows[0]["id"] == "2659999"
assert len(rows[0]["password"]) >= 8
@patch("tjhlp.commands.users.GiteaClient")
@patch("tjhlp.commands.users.get_gitea_config")
def test_skips_existing_user(self, mock_get_cfg, mock_client_cls, mock_config, tmp_path: Path):
mock_get_cfg.return_value = mock_config
client = MagicMock()
client.__enter__ = MagicMock(return_value=client)
client.__exit__ = MagicMock(return_value=False)
client.get_user.return_value = GiteaUser(id=1, login="2659999") # already exists
mock_client_cls.return_value = client
csv_file = tmp_path / "members.csv"
csv_file.write_text("id,name,role\n2659999,赵一伤,student\n", encoding="utf-8")
result = runner.invoke(app, ["users", "create", "--file", str(csv_file)])
assert result.exit_code == 0
assert "跳过" in result.output
client.create_user.assert_not_called()
# ---------------------------------------------------------------------------
# users delete
# ---------------------------------------------------------------------------
class TestUsersDelete:
@patch("tjhlp.commands.users.GiteaClient")
@patch("tjhlp.commands.users.get_gitea_config")
def test_skips_admin(self, mock_get_cfg, mock_client_cls, mock_config, tmp_path: Path):
mock_get_cfg.return_value = mock_config
client = MagicMock()
client.__enter__ = MagicMock(return_value=client)
client.__exit__ = MagicMock(return_value=False)
client.get_user.return_value = GiteaUser(id=1, login="admin", is_admin=True)
mock_client_cls.return_value = client
csv_file = tmp_path / "members.csv"
csv_file.write_text("id,name,role\nadmin,Admin,ta\n", encoding="utf-8")
result = runner.invoke(
app,
[
"users",
"delete",
"--file",
str(csv_file),
"--yes",
],
)
assert result.exit_code == 0
assert "管理员" in result.output
client.delete_user.assert_not_called()
# ---------------------------------------------------------------------------
# repos create-homework
# ---------------------------------------------------------------------------
class TestReposCreateHomework:
@patch("tjhlp.commands.repos.push_templates", return_value=2)
@patch("tjhlp.commands.repos.sync_labels", return_value=3)
@patch("tjhlp.commands.repos.GiteaClient")
@patch("tjhlp.commands.repos.get_gitea_config")
def test_creates_hw_repo(
self, mock_get_cfg, mock_client_cls, mock_sync, mock_push, mock_config
):
mock_get_cfg.return_value = mock_config
client = MagicMock()
client.__enter__ = MagicMock(return_value=client)
client.__exit__ = MagicMock(return_value=False)
client.get_repo.return_value = None # doesn't exist
client.create_org_repo.return_value = GiteaRepo(id=1, name="hw03")
client.get_team_by_name.return_value = GiteaTeam(id=1, name="ta", permission="write")
mock_client_cls.return_value = client
result = runner.invoke(
app,
[
"repos",
"create-homework",
"--org",
"tjhlp-2025f",
"--number",
"3",
],
)
assert result.exit_code == 0
assert "hw03" in result.output
client.create_org_repo.assert_called_once()
# Verify the repo name is hw03
call_args = client.create_org_repo.call_args
assert call_args[0][1] == "hw03"
# ---------------------------------------------------------------------------
# CLI help
# ---------------------------------------------------------------------------
class TestCLIHelp:
def test_root_help(self):
result = runner.invoke(app, ["--help"])
assert result.exit_code == 0
assert "同济大学" in result.output
def test_setup_help(self):
result = runner.invoke(app, ["setup", "--help"])
assert result.exit_code == 0
def test_users_help(self):
result = runner.invoke(app, ["users", "--help"])
assert result.exit_code == 0