refactor: 移除 SMTP 相关代码,简化用户创建流程,更新文档

This commit is contained in:
2026-04-13 12:27:14 +08:00
parent 919c561629
commit 66c254e0ff
13 changed files with 41 additions and 466 deletions
-7
View File
@@ -4,10 +4,3 @@
[default.gitea] [default.gitea]
token = "your-gitea-api-token" token = "your-gitea-api-token"
[default.smtp]
host = "smtp.example.com"
port = 465
user = "[email protected]"
password = "your-smtp-password"
from_addr = "同济大学高级语言程序设计课程 <[email protected]>"
+25 -25
View File
@@ -33,13 +33,6 @@ cp .secrets.toml.example .secrets.toml
```toml ```toml
[default.gitea] [default.gitea]
token = "your-gitea-api-token" # 必填 token = "your-gitea-api-token" # 必填
[default.smtp]
host = "smtp.example.com" # 发送邮件时必填
port = 465
user = "[email protected]"
password = "your-smtp-password"
from_addr = "同济大学高级语言程序设计课程 <[email protected]>"
``` ```
API Token 获取方式: 登录 Gitea -> 设置 -> 应用 -> 生成令牌(勾选所有权限)。 API Token 获取方式: 登录 Gitea -> 设置 -> 应用 -> 生成令牌(勾选所有权限)。
@@ -87,10 +80,30 @@ tjhlp
├── stats ├── stats
│ ├── summary Issue 统计摘要 │ ├── summary Issue 统计摘要
│ └── export 导出 Issue 数据到 CSV │ └── export 导出 Issue 数据到 CSV
└── notify └── labels
└── send-credentials 通过 SMTP 发送账号密码邮件 ├── sync 同步预定义 Label 到仓库
└── list 列出仓库 Label
``` ```
## 典型工作流
### 学期初始化
```bash
# 1. 检查连接
uv run tjhlp setup status
# 2. 一键初始化(创建组织 + 团队 + general 仓库 + Labels + Webhook)
uv run tjhlp setup init \
--org tjhlp-2025f \
--webhook-url http://notify-server:8080/webhook \
--webhook-secret mysecret
# 3. 批量创建用户并分配到团队
uv run tjhlp users create --file members.csv --org tjhlp-2025f
```
## 典型工作流 ## 典型工作流
### 学期初始化 ### 学期初始化
@@ -164,20 +177,10 @@ id,name,role
- `name` - 姓名, 作为 Gitea 的 full_name - `name` - 姓名, 作为 Gitea 的 full_name
- `role` - `student` 或 `ta`, 决定分配到哪个团队 - `role` - `student` 或 `ta`, 决定分配到哪个团队
- 邮箱自动生成为 `{id}@tongji.edu.cn` - 邮箱自动生成为 `{id}@tongji.edu.cn`
- **初始密码与用户名(学号/工号)相同**。
示例文件见 `example/members.csv`。 示例文件见 `example/members.csv`。
### 输出: `credentials_*.csv`
`users create` 执行后自动生成:
```csv
id,name,role,username,password,email
2659999,赵一伤,student,2659999,xK9#mP2$vL4w,[email protected]
```
此文件包含随机生成的初始密码, 用于 `notify send-credentials` 发送邮件。**请妥善保管并在使用后删除。**
## 预定义 Label ## 预定义 Label
通过 `settings.toml` 配置, `setup init` 和 `labels sync` 时自动创建: 通过 `settings.toml` 配置, `setup init` 和 `labels sync` 时自动创建:
@@ -230,9 +233,8 @@ uv run ruff format --check src/
tests/ tests/
├── conftest.py 公共 fixtures(mock config、client、样本数据) ├── conftest.py 公共 fixtures(mock config、client、样本数据)
├── test_models.py 数据模型(MemberRecord、Gitea API 模型、枚举) ├── test_models.py 数据模型(MemberRecord、Gitea API 模型、枚举)
├── test_config.py 配置校验(LabelDef 颜色、GiteaConfig/SmtpConfig 必填字段) ├── test_config.py 配置校验(LabelDef 颜色、GiteaConfig 必填字段)
├── test_utils.py 工具函数(parse_repo、compute_issue_stats) ├── test_utils.py 工具函数(parse_repo、compute_issue_stats)
├── test_pure_functions.py 纯函数(密码生成、CSV 解析、邮件模板)
├── test_client.py API 客户端(respx mock HTTP, 分页、错误处理、CRUD) ├── test_client.py API 客户端(respx mock HTTP, 分页、错误处理、CRUD)
└── test_commands.py 命令集成(CliRunner + mock, setup/users/repos 流程) └── test_commands.py 命令集成(CliRunner + mock, setup/users/repos 流程)
``` ```
@@ -254,7 +256,6 @@ tests/
| `config.py` | 87% | Pydantic 校验逻辑(未覆盖 Dynaconf 加载函数) | | `config.py` | 87% | Pydantic 校验逻辑(未覆盖 Dynaconf 加载函数) |
| `users.py` | 79% | 创建/跳过/删除流程 | | `users.py` | 79% | 创建/跳过/删除流程 |
| `client.py` | 67% | 核心 HTTP 方法和分页(未覆盖所有 API endpoint) | | `client.py` | 67% | 核心 HTTP 方法和分页(未覆盖所有 API endpoint) |
| `notify.py` | 38% | 邮件文本构建(未覆盖 SMTP 发送) |
## 项目结构 ## 项目结构
@@ -286,8 +287,7 @@ scripts/
├── repos.py 仓库管理 ├── repos.py 仓库管理
├── webhooks.py Webhook 管理 ├── webhooks.py Webhook 管理
├── labels.py Label 管理 ├── labels.py Label 管理
├── stats.py Issue 统计 └── stats.py Issue 统计
└── notify.py 邮件通知
``` ```
## 技术选型 ## 技术选型
-1
View File
@@ -2,7 +2,6 @@
url = "https://cpp.tongji.sh:3000" url = "https://cpp.tongji.sh:3000"
email_domain = "tongji.edu.cn" email_domain = "tongji.edu.cn"
default_org = "" default_org = ""
password_length = 12
# 预定义 Label 集合 # 预定义 Label 集合
[[default.gitea.labels]] [[default.gitea.labels]]
+1 -2
View File
@@ -2,7 +2,7 @@
import typer import typer
from tjhlp.commands import labels, notify, orgs, repos, setup, stats, users, webhooks from tjhlp.commands import labels, orgs, repos, setup, stats, users, webhooks
app = typer.Typer( app = typer.Typer(
name="tjhlp", name="tjhlp",
@@ -17,7 +17,6 @@ app.add_typer(repos.app, name="repos", help="仓库管理")
app.add_typer(webhooks.app, name="webhooks", help="Webhook 管理") app.add_typer(webhooks.app, name="webhooks", help="Webhook 管理")
app.add_typer(labels.app, name="labels", help="Label 管理") app.add_typer(labels.app, name="labels", help="Label 管理")
app.add_typer(stats.app, name="stats", help="Issue 统计") app.add_typer(stats.app, name="stats", help="Issue 统计")
app.add_typer(notify.app, name="notify", help="邮件通知")
if __name__ == "__main__": if __name__ == "__main__":
-117
View File
@@ -1,117 +0,0 @@
"""notify 命令: 通过 SMTP 发送账号凭据邮件"""
from __future__ import annotations
import csv
import smtplib
import ssl
import time
from email.mime.text import MIMEText
from pathlib import Path
import typer
from rich.console import Console
from rich.panel import Panel
from tjhlp.config import get_gitea_config, get_smtp_config
from tjhlp.models import CredentialRecord
app = typer.Typer(no_args_is_help=True)
console = Console()
def _build_email_text(cred: CredentialRecord, gitea_url: str) -> str:
"""构建纯文本邮件正文"""
return f"""\
同济大学高级语言程序设计 - 答疑平台账号
{"=" * 40}
{cred.name}同学/老师, 你好!
你的课程答疑平台账号已创建, 请使用以下信息登录:
平台地址: {gitea_url}
用户名: {cred.username}
初始密码: {cred.password}
首次登录后请立即修改密码。
如有问题, 请联系助教。
"""
def _read_credentials_csv(filepath: Path) -> list[CredentialRecord]:
"""读取凭据 CSV 文件"""
records: list[CredentialRecord] = []
with open(filepath, encoding="utf-8-sig") as f:
reader = csv.DictReader(f)
for row in reader:
records.append(CredentialRecord.model_validate(row))
return records
@app.command("send-credentials")
def send_credentials(
file: Path = typer.Option(..., "--file", "-f", help="凭据 CSV 文件路径(由 users create 生成)"),
dry_run: bool = typer.Option(False, "--dry-run", help="仅预览邮件内容, 不实际发送"),
batch_size: int = typer.Option(
10, "--batch-size", help="每批发送数量, 批次间暂停 2 秒(避免触发 SMTP 限制)"
),
) -> None:
"""通过 SMTP 向同济邮箱发送账号密码邮件"""
if not file.exists():
console.print(f"[red]文件不存在: {file}[/red]")
raise typer.Exit(code=1)
gitea_cfg = get_gitea_config()
credentials = _read_credentials_csv(file)
console.print(f"读取到 {len(credentials)} 条凭据记录")
if dry_run:
# 预览第一封邮件
if credentials:
cred = credentials[0]
text = _build_email_text(cred, str(gitea_cfg.url))
console.print(Panel(text, title=f"邮件预览 -> {cred.email}", border_style="blue"))
console.print(f"\n[yellow]dry-run 模式, 共 {len(credentials)} 封邮件待发送[/yellow]")
return
smtp_cfg = get_smtp_config()
from_addr = smtp_cfg.from_addr or smtp_cfg.user
stats = {"sent": 0, "failed": 0}
context = ssl.create_default_context()
try:
with smtplib.SMTP_SSL(smtp_cfg.host, smtp_cfg.port, context=context) as server:
server.login(smtp_cfg.user, smtp_cfg.password.get_secret_value())
console.print(f"[green]已连接 SMTP 服务器 {smtp_cfg.host}[/green]")
for i, cred in enumerate(credentials, 1):
msg = MIMEText(_build_email_text(cred, str(gitea_cfg.url)), "plain", "utf-8")
msg["Subject"] = "同济大学高级语言程序设计 - 答疑平台账号信息"
msg["From"] = from_addr
msg["To"] = cred.email
try:
server.send_message(msg)
console.print(
f" [{i}/{len(credentials)}] [green]已发送[/green] -> {cred.email}"
)
stats["sent"] += 1
except Exception as e:
console.print(
f" [{i}/{len(credentials)}] [red]失败[/red] -> {cred.email}: {e}"
)
stats["failed"] += 1
# 按 batch_size 暂停, 避免触发 SMTP 速率限制
if i % batch_size == 0 and i < len(credentials):
console.print(f" [dim]已发送 {i} 封, 暂停 2 秒...[/dim]")
time.sleep(2)
except Exception as e:
console.print(f"[red]SMTP 连接失败: {e}[/red]")
raise typer.Exit(code=1) from e
console.print(f"\n完成: 发送 {stats['sent']}, 失败 {stats['failed']}")
+3 -49
View File
@@ -12,28 +12,12 @@ from rich.table import Table
from tjhlp.client import GiteaClient, GiteaClientError from tjhlp.client import GiteaClient, GiteaClientError
from tjhlp.config import get_gitea_config from tjhlp.config import get_gitea_config
from tjhlp.models import CredentialRecord, MemberRecord, MemberRole from tjhlp.models import MemberRecord, MemberRole
app = typer.Typer(no_args_is_help=True) app = typer.Typer(no_args_is_help=True)
console = Console() console = Console()
def _generate_password(length: int = 12) -> str:
"""生成随机密码: 至少包含大小写字母、数字和特殊字符"""
if length < 8:
length = 8
alphabet = string.ascii_letters + string.digits + "!@#$%&*"
while True:
password = "".join(secrets.choice(alphabet) for _ in range(length))
if (
any(c.islower() for c in password)
and any(c.isupper() for c in password)
and any(c.isdigit() for c in password)
and any(c in "!@#$%&*" for c in password)
):
return password
def _read_members_csv(filepath: Path) -> list[MemberRecord]: def _read_members_csv(filepath: Path) -> list[MemberRecord]:
"""读取 members CSV 文件""" """读取 members CSV 文件"""
records: list[MemberRecord] = [] records: list[MemberRecord] = []
@@ -48,10 +32,9 @@ def _read_members_csv(filepath: Path) -> list[MemberRecord]:
def create_users( def create_users(
file: Path = typer.Option(..., "--file", "-f", help="成员名单 CSV 文件路径"), file: Path = typer.Option(..., "--file", "-f", help="成员名单 CSV 文件路径"),
org: str = typer.Option("", "--org", help="自动添加到指定组织的对应团队"), org: str = typer.Option("", "--org", help="自动添加到指定组织的对应团队"),
output: Path = typer.Option(None, "--output", "-o", help="凭据输出文件路径(默认自动生成)"),
dry_run: bool = typer.Option(False, "--dry-run", help="仅预览, 不实际创建"), dry_run: bool = typer.Option(False, "--dry-run", help="仅预览, 不实际创建"),
) -> None: ) -> None:
"""从 CSV 批量创建用户账号, 生成随机密码并输出到凭据文件""" """从 CSV 批量创建用户账号(初始密码与用户名相同)"""
if not file.exists(): if not file.exists():
console.print(f"[red]文件不存在: {file}[/red]") console.print(f"[red]文件不存在: {file}[/red]")
raise typer.Exit(code=1) raise typer.Exit(code=1)
@@ -75,7 +58,6 @@ def create_users(
console.print(table) console.print(table)
return return
credentials: list[CredentialRecord] = []
stats = {"created": 0, "skipped": 0, "failed": 0} stats = {"created": 0, "skipped": 0, "failed": 0}
with GiteaClient(cfg) as client: with GiteaClient(cfg) as client:
@@ -94,12 +76,10 @@ def create_users(
stats["skipped"] += 1 stats["skipped"] += 1
continue continue
password = _generate_password(cfg.password_length)
try: try:
client.create_user( client.create_user(
username=member.username, username=member.username,
password=password, password=member.username,
email=member.email, email=member.email,
full_name=member.name, full_name=member.name,
must_change_password=True, must_change_password=True,
@@ -107,17 +87,6 @@ def create_users(
console.print(f" [green]创建[/green] {member.username}({member.name})") console.print(f" [green]创建[/green] {member.username}({member.name})")
stats["created"] += 1 stats["created"] += 1
credentials.append(
CredentialRecord(
id=member.id,
name=member.name,
role=member.role.value,
username=member.username,
password=password,
email=member.email,
)
)
# 添加到团队 # 添加到团队
if org: if org:
team = ta_team if member.role == MemberRole.TA else students_team team = ta_team if member.role == MemberRole.TA else students_team
@@ -131,21 +100,6 @@ def create_users(
console.print(f" [red]失败[/red] {member.username}({member.name}): {e.message}") console.print(f" [red]失败[/red] {member.username}({member.name}): {e.message}")
stats["failed"] += 1 stats["failed"] += 1
# 写出凭据文件
if credentials:
if output is None:
ts = datetime.now(tz=UTC).strftime("%Y%m%d_%H%M%S")
output = Path(f"credentials_{ts}.csv")
with open(output, "w", newline="", encoding="utf-8") as f:
writer = csv.DictWriter(
f,
fieldnames=["id", "name", "role", "username", "password", "email"],
)
writer.writeheader()
for cred in credentials:
writer.writerow(cred.model_dump())
console.print(f"\n凭据已保存到 [bold]{output}[/bold]")
console.print( console.print(
f"\n完成: 创建 {stats['created']}, 跳过 {stats['skipped']}, 失败 {stats['failed']}" f"\n完成: 创建 {stats['created']}, 跳过 {stats['skipped']}, 失败 {stats['failed']}"
) )
+1 -26
View File
@@ -20,7 +20,7 @@ settings = Dynaconf(
], ],
environments=True, environments=True,
load_dotenv=True, load_dotenv=True,
merge_enabled=True merge_enabled=True,
) )
@@ -55,25 +55,9 @@ class GiteaConfig(BaseModel):
token: SecretStr token: SecretStr
email_domain: str = "tongji.edu.cn" email_domain: str = "tongji.edu.cn"
default_org: str = "" default_org: str = ""
password_length: int = 16
labels: list[LabelDef] = [] labels: list[LabelDef] = []
class SmtpConfig(BaseModel):
"""SMTP 邮件配置"""
model_config = ConfigDict(
alias_generator=AliasGenerator(validation_alias=str.upper),
populate_by_name=True,
)
host: str
port: int = 465
user: str
password: SecretStr
from_addr: str = ""
class Config(BaseModel): class Config(BaseModel):
"""总配置模型""" """总配置模型"""
@@ -85,7 +69,6 @@ class Config(BaseModel):
) )
gitea: GiteaConfig gitea: GiteaConfig
smtp: SmtpConfig | None = None
def get_config() -> Config: def get_config() -> Config:
@@ -96,11 +79,3 @@ def get_config() -> Config:
def get_gitea_config() -> GiteaConfig: def get_gitea_config() -> GiteaConfig:
"""从 Dynaconf 加载并校验 Gitea 配置""" """从 Dynaconf 加载并校验 Gitea 配置"""
return get_config().gitea return get_config().gitea
def get_smtp_config() -> SmtpConfig:
"""从 Dynaconf 加载并校验 SMTP 配置"""
cfg = get_config()
if cfg.smtp is None:
raise ValueError("SMTP 配置缺失, 请在 .secrets.toml 中配置")
return cfg.smtp
-11
View File
@@ -34,17 +34,6 @@ class MemberRecord(BaseModel):
return self.id return self.id
class CredentialRecord(BaseModel):
"""生成的凭据记录(输出到 credentials CSV)"""
id: str
name: str
role: str
username: str
password: str
email: str
# --------------------------------------------------------------------------- # ---------------------------------------------------------------------------
# Gitea API 响应模型(部分字段) # Gitea API 响应模型(部分字段)
# --------------------------------------------------------------------------- # ---------------------------------------------------------------------------
+2 -36
View File
@@ -5,8 +5,8 @@ from unittest.mock import MagicMock
import pytest import pytest
from pydantic import HttpUrl, SecretStr from pydantic import HttpUrl, SecretStr
from tjhlp.config import GiteaConfig, LabelDef, SmtpConfig from tjhlp.config import GiteaConfig, LabelDef
from tjhlp.models import CredentialRecord, MemberRecord, MemberRole from tjhlp.models import MemberRecord, MemberRole
@pytest.fixture() @pytest.fixture()
@@ -24,22 +24,10 @@ def gitea_config(sample_labels: list[LabelDef]) -> GiteaConfig:
token=SecretStr("test-token-12345"), token=SecretStr("test-token-12345"),
email_domain="tongji.edu.cn", email_domain="tongji.edu.cn",
default_org="tjhlp-test", default_org="tjhlp-test",
password_length=12,
labels=sample_labels, labels=sample_labels,
) )
@pytest.fixture()
def smtp_config() -> SmtpConfig:
return SmtpConfig(
host="smtp.test.com",
port=465,
user="[email protected]",
password=SecretStr("smtp-pass"),
from_addr="Test <[email protected]>",
)
@pytest.fixture() @pytest.fixture()
def sample_members() -> list[MemberRecord]: def sample_members() -> list[MemberRecord]:
return [ return [
@@ -49,28 +37,6 @@ def sample_members() -> list[MemberRecord]:
] ]
@pytest.fixture()
def sample_credentials() -> list[CredentialRecord]:
return [
CredentialRecord(
id="2659999",
name="赵一伤",
role=MemberRole.STUDENT,
username="2659999",
password="xK9#mP2$vL4w",
email="[email protected]",
),
CredentialRecord(
id="10001",
name="李四催",
role=MemberRole.TA,
username="10001",
password="aB3$cD5&eF7h",
email="[email protected]",
),
]
@pytest.fixture() @pytest.fixture()
def mock_gitea_client() -> MagicMock: def mock_gitea_client() -> MagicMock:
"""创建一个 mock GiteaClient, 可在各命令测试中复用""" """创建一个 mock GiteaClient, 可在各命令测试中复用"""
+8 -14
View File
@@ -104,9 +104,7 @@ class TestUsersCreateDryRun:
class TestUsersCreate: class TestUsersCreate:
@patch("tjhlp.commands.users.GiteaClient") @patch("tjhlp.commands.users.GiteaClient")
@patch("tjhlp.commands.users.get_gitea_config") @patch("tjhlp.commands.users.get_gitea_config")
def test_creates_users_and_outputs_credentials( def test_creates_users(self, mock_get_cfg, mock_client_cls, mock_config, tmp_path: Path):
self, mock_get_cfg, mock_client_cls, mock_config, tmp_path: Path
):
mock_get_cfg.return_value = mock_config mock_get_cfg.return_value = mock_config
client = MagicMock() client = MagicMock()
client.__enter__ = MagicMock(return_value=client) client.__enter__ = MagicMock(return_value=client)
@@ -118,7 +116,6 @@ class TestUsersCreate:
csv_file = tmp_path / "members.csv" csv_file = tmp_path / "members.csv"
csv_file.write_text("id,name,role\n2659999,赵一伤,student\n", encoding="utf-8") csv_file.write_text("id,name,role\n2659999,赵一伤,student\n", encoding="utf-8")
out_file = tmp_path / "creds.csv"
result = runner.invoke( result = runner.invoke(
app, app,
@@ -127,20 +124,17 @@ class TestUsersCreate:
"create", "create",
"--file", "--file",
str(csv_file), str(csv_file),
"--output",
str(out_file),
], ],
) )
assert result.exit_code == 0 assert result.exit_code == 0
assert "创建" in result.output assert "创建" in result.output
assert out_file.exists() client.create_user.assert_called_once_with(
username="2659999",
# Verify credentials CSV password="2659999",
with open(out_file, encoding="utf-8") as f: email="[email protected]",
rows = list(csv.DictReader(f)) full_name="赵一伤",
assert len(rows) == 1 must_change_password=True,
assert rows[0]["id"] == "2659999" )
assert len(rows[0]["password"]) >= 8
@patch("tjhlp.commands.users.GiteaClient") @patch("tjhlp.commands.users.GiteaClient")
@patch("tjhlp.commands.users.get_gitea_config") @patch("tjhlp.commands.users.get_gitea_config")
+1 -26
View File
@@ -7,7 +7,7 @@ from typing import Any
import pytest import pytest
from pydantic import HttpUrl, SecretStr, ValidationError from pydantic import HttpUrl, SecretStr, ValidationError
from tjhlp.config import GiteaConfig, LabelDef, SmtpConfig from tjhlp.config import GiteaConfig, LabelDef
class TestLabelDef: class TestLabelDef:
@@ -63,7 +63,6 @@ class TestGiteaConfig:
token=SecretStr("token123"), token=SecretStr("token123"),
) )
assert cfg.email_domain == "tongji.edu.cn" assert cfg.email_domain == "tongji.edu.cn"
assert cfg.password_length == 16
assert cfg.labels == [] assert cfg.labels == []
def test_missing_url_raises(self): def test_missing_url_raises(self):
@@ -92,27 +91,3 @@ class TestGiteaConfig:
labels=[LabelDef(name="bug", color="#ff0000")], labels=[LabelDef(name="bug", color="#ff0000")],
) )
assert len(cfg.labels) == 1 assert len(cfg.labels) == 1
class TestSmtpConfig:
def test_valid(self):
cfg = SmtpConfig(
host="smtp.test.com",
user="[email protected]",
password=SecretStr("pass123"),
)
assert cfg.port == 465
assert cfg.from_addr == ""
def test_missing_host_raises(self):
with pytest.raises(ValidationError):
kwargs: dict[str, Any] = {"user": "user", "password": SecretStr("pass")}
SmtpConfig(**kwargs)
def test_password_is_secret(self):
cfg = SmtpConfig(
host="smtp.test.com",
user="[email protected]",
password=SecretStr("my-secret"),
)
assert cfg.password.get_secret_value() == "my-secret"
-29
View File
@@ -6,7 +6,6 @@ import pytest
from pydantic import ValidationError from pydantic import ValidationError
from tjhlp.models import ( from tjhlp.models import (
CredentialRecord,
GiteaIssue, GiteaIssue,
GiteaLabel, GiteaLabel,
GiteaRepo, GiteaRepo,
@@ -60,34 +59,6 @@ class TestMemberRecord:
MemberRecord(id="123", name="测试") # type: ignore MemberRecord(id="123", name="测试") # type: ignore
class TestCredentialRecord:
def test_basic(self):
c = CredentialRecord(
id="2659999",
name="赵一伤",
role=MemberRole.STUDENT,
username="2659999",
password="abc123",
email="[email protected]",
)
assert c.username == "2659999"
assert c.password == "abc123"
def test_model_dump(self):
c = CredentialRecord(
id="2659999",
name="赵一伤",
role=MemberRole.STUDENT,
username="2659999",
password="abc123",
email="[email protected]",
)
d = c.model_dump()
assert d["id"] == "2659999"
assert d["password"] == "abc123"
assert len(d) == 6
class TestGiteaModels: class TestGiteaModels:
def test_gitea_user(self): def test_gitea_user(self):
u = GiteaUser(id=1, login="admin", full_name="Admin", is_admin=True) u = GiteaUser(id=1, login="admin", full_name="Admin", is_admin=True)
-123
View File
@@ -1,123 +0,0 @@
"""纯函数单元测试: 密码生成、邮件模板构建"""
from __future__ import annotations
from pathlib import Path
from tjhlp.commands.notify import _build_email_text, _read_credentials_csv
from tjhlp.commands.users import _generate_password, _read_members_csv
from tjhlp.models import CredentialRecord, MemberRole
class TestGeneratePassword:
def test_default_length(self):
pw = _generate_password()
assert len(pw) == 12
def test_custom_length(self):
pw = _generate_password(16)
assert len(pw) == 16
def test_min_length_enforced(self):
"""length < 8 should be corrected to 8"""
pw = _generate_password(4)
assert len(pw) == 8
def test_contains_lowercase(self):
for _ in range(20):
pw = _generate_password()
assert any(c.islower() for c in pw), f"No lowercase in: {pw}"
def test_contains_uppercase(self):
for _ in range(20):
pw = _generate_password()
assert any(c.isupper() for c in pw), f"No uppercase in: {pw}"
def test_contains_digit(self):
for _ in range(20):
pw = _generate_password()
assert any(c.isdigit() for c in pw), f"No digit in: {pw}"
def test_contains_special(self):
special = set("!@#$%&*")
for _ in range(20):
pw = _generate_password()
assert any(c in special for c in pw), f"No special char in: {pw}"
def test_randomness(self):
"""多次生成不应产生相同的密码"""
passwords = {_generate_password() for _ in range(50)}
assert len(passwords) > 45 # 极低概率碰撞
class TestReadMembersCsv:
def test_basic(self, tmp_path: Path):
csv_file = tmp_path / "members.csv"
csv_file.write_text(
"id,name,role\n2659999,赵一伤,student\n10001,李四催,ta\n", encoding="utf-8"
)
records = _read_members_csv(csv_file)
assert len(records) == 2
assert records[0].id == "2659999"
assert records[0].role == "student"
assert records[1].role == "ta"
def test_bom_encoding(self, tmp_path: Path):
csv_file = tmp_path / "members.csv"
csv_file.write_bytes(
b"\xef\xbb\xbfid,name,role\n2659999,\xe5\xbc\xa0\xe4\xb8\x89,student\n"
)
records = _read_members_csv(csv_file)
assert len(records) == 1
assert records[0].id == "2659999"
def test_empty_file(self, tmp_path: Path):
csv_file = tmp_path / "members.csv"
csv_file.write_text("id,name,role\n", encoding="utf-8")
records = _read_members_csv(csv_file)
assert len(records) == 0
class TestBuildEmailText:
def test_contains_fields(self):
cred = CredentialRecord(
id="2659999",
name="赵一伤",
role=MemberRole.STUDENT,
username="2659999",
password="testpass",
email="[email protected]",
)
text = _build_email_text(cred, "http://gitea.test")
assert "赵一伤" in text
assert "2659999" in text
assert "testpass" in text
assert "http://gitea.test" in text
def test_is_plain_text(self):
cred = CredentialRecord(
id="1",
name="test",
role=MemberRole.STUDENT,
username="1",
password="pw",
email="[email protected]",
)
text = _build_email_text(cred, "http://x")
assert "<html>" not in text
class TestReadCredentialsCsv:
def test_basic(self, tmp_path: Path):
csv_file = tmp_path / "creds.csv"
csv_file.write_text(
"id,name,role,username,password,email\n"
"2659999,赵一伤,student,2659999,abc123,[email protected]\n",
encoding="utf-8",
)
records = _read_credentials_csv(csv_file)
assert len(records) == 1
assert records[0].password == "abc123"