refactor(config): 重构配置类以支持动态元数据字段

配置类 ThesisConfig 现在使用 metadata 字典直接透传 TOML 配置,
无需为每个变量单独声明字段。新增模板变量只需修改 TOML 文件,
无需修改 Python 代码。

BREAKING CHANGE: 配置文件结构发生改变,从单独字段改为统一的
metadata 节点。
This commit is contained in:
zzy
2026-05-08 23:07:23 +08:00
parent 74d28ea2d8
commit fc6afdea9d
3 changed files with 24 additions and 43 deletions

View File

@@ -6,17 +6,15 @@ import tomllib
@dataclass
class ThesisConfig:
"""论文配置数据(学生信息、元数据等,不包含正文内容)。"""
"""论文配置数据
student_name: str = "<None>"
student_id: str = "<None>"
college: str = "<None>"
major: str = "<None>"
class_: str = "<None>"
advisor: str = "<None>"
advisor_title: str = "<None>"
title: str = "<None>"
``metadata`` 直接透传 TOML 的 ``[metadata]`` 节,不再为每个变量声明字段。
新增模板变量只需改 TOML无需修改 Python。
"""
metadata: dict = field(default_factory=dict)
# 以下字段仍有业务逻辑,保留为显式属性
title_from_md: bool = True
body_start_keywords: list[str] = field(default_factory=lambda: ["绪论", "引言"])
body_end_keywords: list[str] = field(
@@ -27,17 +25,8 @@ class ThesisConfig:
reference_style: str = "列出段落1"
def to_dict(self) -> dict:
"""转成模板渲染用的扁平字典,排除 options 命名空间"""
return {
"student_name": self.student_name,
"student_id": self.student_id,
"college": self.college,
"major": self.major,
"class": self.class_,
"advisor": self.advisor,
"advisor_title": self.advisor_title,
"title": self.title,
}
"""透传 metadata模板变量来源"""
return self.metadata
def load_config(path: str | Path) -> ThesisConfig:
@@ -50,14 +39,7 @@ def load_config(path: str | Path) -> ThesisConfig:
opts = raw.get("options", {})
return ThesisConfig(
student_name=meta.get("student_name", "<None>"),
student_id=meta.get("student_id", "<None>"),
college=meta.get("college", "<None>"),
major=meta.get("major", "<None>"),
class_=meta.get("class", "<None>"),
advisor=meta.get("advisor", "<None>"),
advisor_title=meta.get("advisor_title", "<None>"),
title=meta.get("title", "<None>"),
metadata=meta,
title_from_md=opts.get("title_from_md", True),
body_start_keywords=opts.get("body_start_keywords", ["绪论", "引言"]),
body_end_keywords=opts.get(