78 Commits

Author	SHA1	Message	Date
zhou	32ca8c1208	docs: 搭建 Sphinx 文档站并清理死代码 ... 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	2026-07-05 12:17:10 +08:00
zhou	de368ea810	refactor: 删除冗余 cli 入口脚本, gittool 用数组配置 clean excludes ... 1. 删除 13 个已有 YAML 配置的 cli .py 入口脚本, 统一通过 pf 调用 2. gittool.yaml 用 CLEAN_EXCLUDES 数组变量配置 git clean 的 -e 参数, 保留 .venv/.tox/node_modules/.idea 等目录避免误删 3. run_cli 执行前打印调用信息: [gittool] 执行: c 4. 更新 pyproject.toml 移除 13 个冗余 entry points, 仅保留 pf 5. 清理测试文件中的 TestMain 类 (测 _ops 模块的测试保留)	2026-07-05 08:39:20 +08:00
zhou	12d9f2f647	fix: 恢复 gittool 条件逻辑,修复 has_files 检查 git status ... 将 gitt a/i 命令改用 fn job 包装(git_add_commit/git_init_add_commit), 内部检查 has_files() 和 not_has_git_repo() 条件,避免无更改时 git commit 报错。修正 has_files() 实现为检查 git status --porcelain 而非目录文件。	2026-07-04 20:00:25 +08:00
zhou	52e20e3f93	style: 统一调整代码格式，将单行列表展开为多行缩进格式	2026-07-04 19:49:10 +08:00
zhou	3f966a230e	refactor: 简化 CLI 工具入口为 YAML 加载器 ... 将 13 个工具入口文件重构为通过 px.run_yaml 调用 YAML 配置, 辅助函数移至 _ops 模块。新增 run_yaml 便捷函数支持 job 选择 和传递依赖收集,修复 _build_cmd 列表变量展开,新增 bump_project_version 高层函数封装版本号更新+git 提交流程。	2026-07-04 19:35:08 +08:00
zhou	5d0b211a44	feat: 新增 13 个 CLI 工具的 YAML 配置并修复 _ops 函数注册 ... - 在 cli/configs/ 下创建 13 个 YAML 工作流配置, 覆盖 filedate/filelevel/folderback/ folderzip/autofmt/bumpversion/piptool/gittool/pdftool/screenshot/lscalc/ sshcopyid/packtool 工具, 共 51 个 job (cmd 与 fn 混合) - yaml_loader 模块级导入 _ops 子模块, 使 YAML fn 字段可引用注册函数, try/except 守卫避免最小安装场景下的 ImportError - 修复 test_registry 的 clear_registry fixture: 保存/恢复 _REGISTRY 原始状态, 避免 teardown 清空 _ops 自动注册的函数导致 TestOpsModules 失败	2026-07-04 18:35:20 +08:00
zhou	6931f36fd1	feat: 新增函数注册机制与 CLI 工具函数模块 ... - 新增 registry.py 提供 register_fn/get_fn/has_fn 函数注册机制, 支持 @register_fn 和 @register_fn("name") 两种用法 - 新增 cli/_ops 包 (files/dev/media/system 四个子模块), 聚合 59 个可复用函数供 YAML fn 字段引用 - 扩展 yaml_loader 支持 fn 字段、args/kwargs 传参、${VAR} 变量占位符 - 新增 test_registry.py (20 个测试) 和扩展 test_yaml_loader.py - 更新自驱动规则: 自动 commit+push, 删除需要用户明确指示的步骤	2026-07-04 18:24:52 +08:00
zhou	db02443463	feat: 新增 YAML 任务编排功能 ... 1. 新增 yaml_loader 模块，支持加载 GitHub Actions 风格的 YAML 任务图 2. 新增 Graph.from_yaml 静态方法，支持从 YAML 文件构建任务图 3. 新增 yamlrun CLI 工具，支持执行、预览 YAML 任务流水线 4. 添加 pyyaml 运行时依赖与 types-PyYAML 开发依赖 5. 更新 README 文档与对外暴露的 API 接口	2026-07-04 16:00:04 +08:00
zhou	f699bb9167	chore: 升级pyflowx版本到0.3.2	2026-07-04 10:50:50 +08:00
zhou	85793ff9d5	test(cli): 为文件写入错误测试添加root权限跳过逻辑	2026-07-04 10:22:35 +08:00
zhou	43e1aad1fe	chore: 发布版本0.2.13并完善任务执行环境配置 ... 本次提交更新了版本号至0.2.13，同时完成多项改进： 1. 在.gitignore中新增忽略性能分析文件*_profile.html 2. 修复测试用例中echo命令在Windows下无法被正确检测的问题，改用python命令 3. 优化测试用例确保性能统计数据有效，添加耗时模拟函数 4. 为所有CLI任务统一配置项目根目录作为工作目录，解决跨平台执行路径问题 5. 新增测试验证所有任务的cwd配置正确性	2026-06-28 21:38:18 +08:00
zhou	ce31f60441	feat(cli): add pxp performance profiler command ... 1. 新增pxp CLI工具用于分析PyFlowX脚本生成性能报告 2. 新增ProfileReport.to_html方法生成自包含HTML报告 3. 新增完整的profiler功能测试用例 4. 更新pyproject.toml添加pxp入口点 5. 版本升级至0.2.12	2026-06-28 20:30:17 +08:00
zhou	3d6d769685	feat(profiling): 添加工作流性能分析模块与测试用例 ... 新增了性能剖面分析能力，支持从运行报告生成任务级、图级性能指标，包括关键路径、并行度分析和瓶颈识别，同时补充了完整的单元测试覆盖。	2026-06-28 19:59:25 +08:00
zhou	abc1152538	refactor(cli): 统一使用@px.task装饰器定义任务，重构任务注册和别名管理 ... 1. 将folderzip/folderback/gittool中的旧TaskSpec定义替换为@px.task装饰器 2. 重构pymake模块，将maturin_build_cmd转为常量定义，合并别名配置 3. 精简测试文件中的冗余测试用例	2026-06-28 18:12:30 +08:00
zhou	5e561b4b3a	refactor: 重构CliRunner，新增cmd工厂函数优化任务定义 ... 1. 新增cmd工厂函数，简化TaskSpec创建并自动推导名称 2. 重构CliRunner，将graphs参数替换为tasks+aliases，支持扁平任务注册与别名映射 3. 替换所有cli工具中的旧版任务定义方式，使用新API简化代码 4. 补充对应测试用例，适配新的运行器API	2026-06-28 17:52:52 +08:00
zhou	40f641611b	feat: 新增多项核心功能并优化默认执行策略 ... 1. 将CliRunner默认执行策略从sequential改为dependency 2. 新增RunReport的任务状态查询和时长统计方法 3. 实现task装饰器并补充executor参数文档 4. 新增进程池执行器支持CPU密集型任务 5. 新增Graph.chain链式构建和add_subgraph子图合并功能 6. 新增流式任务传递、进程池执行、命名空间等多类测试用例 7. 补充tests目录路径导入配置	2026-06-28 15:10:15 +08:00
zhou	232e7293d9	refactor(system): 简化write_file实现，使用pathlib替代手动文件操作。	2026-06-28 11:20:58 +08:00
zhou	9999071119	refactor(executors): 重构执行器逻辑，移除重复mixin并优化分层排序 ... 主要变更： 1. 将任务跳过/重试逻辑从类mixin改为模块级函数，减少代码重复 2. 优化_graph.layers()的前置校验逻辑，统一在run入口执行 3. 重构存储过期检查API，移除废弃的_expired方法 4. 优化TaskSpec.cache_key异常处理，增加指定异常捕获并记录警告 5. 修复verbose模式下的事件回调逻辑，正确触发RUNNING事件 6. 调整测试用例以适配新的API和行为变更	2026-06-28 08:25:15 +08:00
zhou	bdd70e9c43	refactor: 重构项目代码结构，拆分职责模块 ... 1. 抽离图组合逻辑到pyflowx.compose，原graph.py仅保留单图DAG逻辑 2. 抽离命令执行逻辑到pyflowx.command，移除task.py内的_run_command 3. 重构上下文签名缓存，优化性能 4. 移除废弃的utils.perf_timer相关代码 5. 为JSONBackend添加batch批量落盘优化 6. 调整导入路径与公开API，更新测试用例 7. 简化条件判断逻辑，移除冗余代码	2026-06-28 02:28:38 +08:00
zhou	7d4e8a40ce	refactor(cli): 重构CLI模块结构，整理系统工具与开发工具 ... 1. 将原cli根目录下的clearscreen、taskkill、which工具迁移到cli/system子目录 2. 新增cli/dev子目录并添加envdev环境配置工具 3. 更新pyproject.toml中的脚本入口点映射 4. 调整tests/cli下的测试文件导入路径 5. 整理tasks/system.py的__all__导出顺序	2026-06-27 22:01:02 +08:00
zhou	df890f0f16	chore: 移除独立的envpy和envrs命令，合并功能到envdev ... 将原来envpy和envrs的环境配置功能整合到envdev命令中，删除了冗余的独立CLI模块和测试文件，统一管理Python、Conda和Rust的环境配置。	2026-06-27 21:22:36 +08:00
zhou	b62a544569	chore: 调整Python版本与依赖适配，新增性能报告测试与工具函数 ... 1. 将Python版本从3.13降级到3.11 2. 为typing-extensions添加版本适配标记 3. 简化dev依赖组，移除pysnooper 4. 重构perf_timer，提取_generate_report独立函数 5. 新增性能报告生成与测试用例	2026-06-27 20:47:29 +08:00
zhou	d58fc5536e	chore: 发布 pyflowx 0.2.10，新增性能计时器与多项重构 ... 1. 新增 perf_timer 工具与配套测试用例 2. 重构任务条件跳过逻辑，优化失败条件展示 3. 重构 Graph 子图生成逻辑，提取公共依赖修剪函数 4. 重构条件模块，统一条件名称与失败原因获取逻辑 5. 重构存储后端，提取 TTL 共享逻辑并优化实现 6. 重构执行器模块，使用 Mixin 复用代码，拆分任务与层执行逻辑 7. 删除冗余的 which 命令测试文件 8. 更新依赖锁文件	2026-06-27 20:15:35 +08:00
zhou	65dcbcbf62	bump version to 0.2.9	2026-06-27 16:42:10 +08:00
zhou	7fa97a01e3	test(executors): add future annotations import to edge case test file ... 为测试文件添加from __future__ import annotations以支持更规范的类型注解写法	2026-06-27 16:33:24 +08:00
zhou	83da5135d0	test: add tests for graph all_deps and defaults inheritance ... - add test_all_deps_combines_hard_and_soft to verify all_deps returns correct hard+soft deps in order - add multiple tests for GraphDefaults field inheritance, including normal inheritance and non-override of custom values	2026-06-27 16:32:34 +08:00
zhou	7463a60649	test: 修复代码检查警告并优化测试用例 ... 1. 为测试代码添加pyrefly忽略注释解决类型检查警告 2. 优化lambda参数命名为通配符符合PEP8规范 3. 增加断言检查任务函数非空并修正参数传递 4. 统一环境变量测试的命名和清理逻辑	2026-06-27 16:26:56 +08:00
zhou	87dd010342	test: add multiple new test cases and update python version ... 1. update .python-version from 3.11 to 3.13 2. add tests for IS_RUNNING and DIR_EXISTS conditions 3. add graph-related tests including string ref parsing, mermaid output, GraphComposer and compose function 4. add storage backend TTL tests for both MemoryBackend and JSONBackend 5. add new system task tests for clr, reset_icon_cache, setenv and which 6. add comprehensive task spec tests including soft dependencies, retry policy, context managers and task template 7. add executor edge case tests for various scenarios	2026-06-27 16:17:05 +08:00
zhou	a7b7a82dff	ci: 完善CI/CD流程，添加测试覆盖率与并行测试配置 ... 1. 为tox测试命令添加并行执行、覆盖率报告和JUnit结果输出 2. 拆分CI工作流为lint、格式检查、类型检查、安全审计、多矩阵测试和覆盖率汇总 3. 新增release前的预测试步骤，让build依赖测试通过 4. 移除低效的依赖策略测速测试用例 5. 配置多Python版本跨平台测试矩阵并上传测试 artifacts	2026-06-27 15:53:08 +08:00
zhou	2b3f4b82d3	bump version to 0.2.7	2026-06-27 15:23:48 +08:00
zhou	5c8ec281ff	refactor: 重构重试策略、条件函数与上下文注入逻辑 ... 主要变更： 1. 替换旧retries参数为RetryPolicy配置 2. 重构条件函数，支持上下文参数与动态依赖判断 3. 更新上下文注入逻辑，支持软依赖与更清晰的注入描述 4. 新增sglang CLI命令与相关配置 5. 格式化代码统一列表与参数写法 6. 更新文档与测试用例适配新API	2026-06-27 14:33:54 +08:00
zhou	bcd189ae60	refactor(graph,runner): 重构引用解析逻辑，拆分GraphComposer ... 1. 抽离CliRunner中的引用解析逻辑为GraphComposer类，分离图数据与组合职责 2. 取消Graph的frozen修饰，简化内部属性修改逻辑 3. 重构任务执行与跳过逻辑，合并重复代码并优化条件求值时机 4. 调整TaskSpec为普通dataclass，移除不必要的replace重建 5. 修复测试用例中skip_if_missing的断言值 6. 重构命令执行逻辑，抽离为模块级函数避免闭包捕获参数	2026-06-27 10:13:52 +08:00
zhou	20c4fb87c5	feat: 添加上游任务跳过豁免、进程检查条件及相关优化 ... 1. 新增allow_upstream_skip参数支持任务不跟随上游跳过 2. 新增IS_RUNNING内置条件检查进程运行状态 3. 调整skip_if_missing默认值为False 4. 补充跳过任务的事件上报和verbose打印 5. 优化reset_icon_cache示例任务使用新特性 6. 更新测试用例匹配默认参数变更	2026-06-27 09:24:22 +08:00
zhou	f15f235ecf	chore: 发布v0.2.6版本，新增重置图标缓存工具 ... 1. 新增reseticon命令行工具用于重置Windows图标缓存 2. 重构平台常量导出逻辑，移除顶层直接导出的IS_*变量 3. 为系统任务相关的TaskSpec添加verbose输出 4. 优化测试用例的列表格式和平台条件写法 5. 更新依赖锁定文件和项目配置	2026-06-27 08:45:48 +08:00
zhou	10bbc07118	refactor(cli): 重构清屏和which命令实现 ... 1. 提取清屏、设置环境变量、命令查找逻辑到system任务模块 2. 统一命令行工具的任务实现方式，减少重复代码 3. 修正pyproject.toml中的cli命令名拼写错误 4. 移除过时的测试用例代码	2026-06-26 23:27:45 +08:00
zhou	22ac9fc4dd	test: 完善多份测试用例的类型标注与校验逻辑 ... 1. 为多个测试函数补充pytest.CaptureFixture[str]类型注解 2. 为graphlib类型声明文件补全方法参数类型 3. 为pdftool测试的mock函数添加Any类型标注 4. 新增数据库连接非空校验断言 5. 优化emlmanager测试的字典展开格式与修复decode测试bug 6. 为gittool测试添加命令类型列表校验 7. 为envrs测试添加pyrefly忽略注释	2026-06-26 21:57:44 +08:00
zhou	fd282db28f	refactor: 整理代码格式与项目结构，修复命令检查bug ... 1. 重构多处列表展开写法，统一代码格式风格 2. 修复executors.py中命令不存在时的类型判断bug 3. 删除废弃的envlinux.py并替换为envdev.py，更新CLI入口配置 4. 为storage.py的后端方法添加override装饰器 5. 移除空的cli/__init__.py冗余导入 6. 更新pyproject.toml依赖与配置项 7. 精简测试用例代码	2026-06-26 21:45:06 +08:00
zhou	6f64d9d6dc	bump version to 0.2.3	2026-06-26 07:43:56 +08:00
zhou	1eb7942aa9	bump version to 0.2.2	2026-06-26 01:50:49 +08:00
zhou	9285ae3782	test(packtool): 优化打包工具测试用例，统一使用临时工作目录 ... 1. 新增自动切换临时工作目录的全局fixture，避免测试污染项目根目录 2. 移除测试中手动mock缓存目录的代码，复用全局fixture配置 3. 简化测试代码结构，提升测试可读性和维护性	2026-06-26 01:47:24 +08:00
zhou	a88797f410	chore(pyflowx): bump pyflowx version to 0.2.0 and add bumpversion cli tests ... - update pyflowx package version from 0.1.13 to 0.2.0 - add auto tmp path fixture for tests - add test cases for bumpversion cli minor version bump and no valid files scenario	2026-06-26 01:42:03 +08:00
zhou	b047b05aaf	bump version to 0.2.1	2026-06-26 01:40:11 +08:00
zhou	936a009212	feat(bumpversion): 重构版本号更新工具，支持多文件类型并新增minor版本命令 ... 1. 重构bumpversion模块，支持自动识别pyproject.toml和__init__.py文件的版本号格式 2. 提取版本计算、替换字符串构建逻辑，提升代码可维护性 3. 在pymake.py中新增bumpmi命令用于执行次版本号更新 4. 全面升级测试用例，适配新的版本匹配逻辑，修正测试文件类型 5. 保留原始引号和格式，不破坏文件原有排版	2026-06-25 23:44:39 +08:00
zhou	f10f8d09a6	~bumpversion	2026-06-25 23:36:05 +08:00
zhou	0afdb54e5c	~	2026-06-25 12:49:26 +08:00
zhou	9e99a1f1ba	~	2026-06-25 12:35:27 +08:00
zhou	50575c6e91	style: 格式化代码并补充开发工具依赖 ... 1. 统一格式化多个文件的字典/列表缩进样式 2. 为pymake的bump命令新增typecheck、ruff_lint、ruff_format检查步骤 3. 扩充test_packtool.py的嵌入式Python安装测试用例	2026-06-25 12:26:25 +08:00
zhou	f8436f6b8c	refactor(emlmanager): 重构EML解析逻辑，提取公共方法并优化字符编码处理 ... 1. 拆分邮件解析为多部分/单部分处理函数，抽离正文提取、日期解析逻辑 2. 完善字符编码检测与 fallback 处理，使用replace模式避免解码失败崩溃 3. 统一使用配置的最大正文长度限制，添加详细日志记录 4. 修复原代码中解码异常未妥善处理的问题 5. 优化测试用例，使用tmp_path替代固定临时目录提升测试稳定性	2026-06-25 12:21:23 +08:00
zhou	477d901281	~	2026-06-22 12:46:50 +08:00
zhou	0df795237d	~tests	2026-06-22 12:31:26 +08:00