docs(data): 补齐 io 两个函数的 Parameters 与 Raises
按 docs/02-architecture.md §4.7,每个公开函数都要写全 Parameters 与 Raises, 格式对齐参考实现 core/random.py 的 get_rng。 - docstring 由 Codex 代写(本轮用户明确授权);函数体逻辑由用户本人改 - load_table:返回注解 Any -> pd.DataFrame,与 docstring 的承诺对齐; 写明 FileNotFoundError / ValueError / ImportError 各自在什么情况下抛 - save_table:写明 TypeError / ValueError / ImportError; 并把 isinstance(df, pd.DataFrame) 校验挪到 mkdir 之前 - 两套环境 pytest 均 39 passed / 44 skipped,ruff All checks passed
This commit is contained in:
1 parent
49fd84a2df
commit
19f4a15107
3 files changed
+55
-11
No files matched your search
@@ -31,6 +31,9 @@
|
||||
`na_values` 默认吃下空串 / `NA` / `N/A` / `#N/A` / `null` / `-`。
|
||||
- `data.save_table`:实现(原属 L1,顺手落地)。按扩展名分派,父目录不存在时自动创建,
|
||||
返回实际写入的 `Path`。
|
||||
- `data.load_table` / `data.save_table`:docstring 补 `Parameters` / `Raises`
|
||||
(`docs/02-architecture.md` §4.7 对每个公开函数的硬要求)。
|
||||
- `data.load_table` 的返回注解 `Any` → `pd.DataFrame`,与 docstring 的承诺对齐。
|
||||
|
||||
### Added
|
||||
- `docs/02-architecture.md` §4.7「类型约定」:注解要写全、numpy 标量的判断写法、
|
||||
|
||||
Reference in new issue
Block a user