zhou
32ca8c1208
CI / Lint, Typecheck & Test (push) Successful in 1m57s
1. 新建 docs/ Sphinx 文档结构 (conf.py + 8 个 rst 章节), napoleon 支持 Google/NumPy docstring, rtd 主题, 自动生成 API 参考与错误家族文档 2. 新建 .readthedocs.yaml 配置, pyproject.toml 加 docs 依赖 3. 删除 runner.py 的 _apply_verbose_to_graph 死代码及对应测试 (功能已移入 executors.run 统一处理) 4. 更新 README: CLI 示例改为 pf 统一入口, 模块结构表补全 cli/pf.py/cli/configs/cli/_ops 等模块 5. 修复版本不一致 (pyproject.toml 0.3.5 → 0.4.5) 6. 加文档徽章链接到 ReadTheDocs
46 lines
1.8 KiB
ReStructuredText
46 lines
1.8 KiB
ReStructuredText
变更日志
|
||
========
|
||
|
||
0.4.5
|
||
-----
|
||
|
||
CLI 重构
|
||
~~~~~~~~
|
||
|
||
- 新增 ``pf`` 统一入口：通过 ``pf <tool> [command] [options]`` 调用所有工具
|
||
- 13 个工具迁移到 YAML 配置（filedate/filelevel/folderback/folderzip/screenshot/sshcopyid/lscalc/bumpversion/autofmt/piptool/packtool/pdftool/gittool）
|
||
- YAML 配置支持 ``cli:`` 段声明命令行参数 schema，由 ``build_cli_parser`` 自动生成 argparse
|
||
- 删除 13 个冗余 ``.py`` 入口脚本，统一通过 ``pf`` 调用
|
||
- ``run()`` 在 ``verbose=True`` 时自动把 verbose 标记应用到所有 spec
|
||
- 全局选项 ``--verbose`` 改为 ``--quiet``（默认显示执行过程）
|
||
- ``cmd`` 任务成功时打印 stdout（此前被静默丢弃）
|
||
- ``gittool`` 用 ``CLEAN_EXCLUDES`` 数组变量配置 ``git clean -e`` 参数
|
||
|
||
YAML 任务编排
|
||
~~~~~~~~~~~~~
|
||
|
||
- 支持 ``variables`` 变量定义，``${VAR}`` 在 cmd/env/cwd 中替换
|
||
- 列表变量展开为 cmd 数组多个元素
|
||
- ``cli:`` 段支持 subcommands/positional/options 三级 schema
|
||
- 支持 ``type: path`` 自动转为 ``pathlib.Path``
|
||
|
||
文档
|
||
~~~~
|
||
|
||
- 搭建 Sphinx 文档，发布到 ReadTheDocs
|
||
- 更新 README：CLI 示例改为 ``pf`` 统一入口，模块结构表补全
|
||
|
||
0.3.x
|
||
-----
|
||
|
||
- 新增 YAML 任务编排（GitHub Actions 风格 schema）
|
||
- 新增 ``fn:`` 函数引用与 ``register_fn`` / ``get_fn`` 注册中心
|
||
- 新增 ``compose`` / ``GraphComposer`` 多图组合
|
||
- 新增 ``task_template`` 任务模板工厂
|
||
- 新增 ``concurrency_key`` + ``concurrency_limits`` 并发限制
|
||
- 新增 ``JSONBackend`` 断点续跑与 ``batch()`` 批量落盘
|
||
- 新增 ``cache_key`` 缓存键函数
|
||
- 新增条件执行（``IS_WINDOWS`` / ``HAS_INSTALLED`` / ``ENV_VAR_EQUALS`` 等）
|
||
- 四种执行策略：``sequential`` / ``thread`` / ``async`` / ``dependency``
|
||
- 参数名即依赖的上下文注入机制
|