fcmd 0.2.2__tar.gz → 0.2.4__tar.gz

{fcmd-0.2.2 → fcmd-0.2.4}/.bumpversion.toml

@@ -1,5 +1,5 @@
 [tool.bumpversion]
-current_version = "0.2.2"
+current_version = "0.2.4"
 commit = true
 exclude = ["template/*"]
 message = "chore: 更新版本 {current_version} → {new_version}"

{fcmd-0.2.2 → fcmd-0.2.4}/Makefile

@@ -4,7 +4,7 @@
 PACKAGE := fcmd
 COV_THRESHOLD := 95
 
-.PHONY: help sync build b clean c test cov lint typecheck check doc tox bump patch minor major push
+.PHONY: help sync build b clean c test cov lint typecheck typecheck-ci check doc tox bump patch minor major push
 
 help: ## 显示帮助信息
 	@awk 'BEGIN {FS = ":.*##"} /^[a-zA-Z].*:.*##/ {printf "  \033[36m%-14s\033[0m %s\n", $$1, $$2}' $(MAKEFILE_LIST)
@@ -31,10 +31,13 @@ lint: ## 代码风格检查 (ruff)
 	uv run ruff check .
 	uv run ruff format --check .
 
-typecheck: ## 类型检查 (pyrefly)
+typecheck: ## 类型检查 (pyrefly, 本地平台)
 	uv run pyrefly check
 
-check: lint typecheck cov ## 运行全套门禁 (lint + typecheck + cov)
+typecheck-ci: ## 类型检查 (pyrefly, CI 平台 linux — 捕获跨平台问题)
+	uv run pyrefly check --python-platform linux
+
+check: lint typecheck typecheck-ci cov ## 运行全套门禁 (lint + typecheck + typecheck-ci + cov)
 
 doc: ## 构建 Sphinx 文档
 	uv run sphinx-build -b html docs docs/_build/html

{fcmd-0.2.2 → fcmd-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: fcmd
-Version: 0.2.2
+Version: 0.2.4
 Summary: 极速 Python 工具集应用：DAG 任务调度 + 组合 CLI
 Author: fcmd
 License: MIT
@@ -70,7 +70,7 @@ Description-Content-Type: text/markdown
 - **极速冷启动**（< 100ms）：三层懒加载，核心模块零外部依赖
 - **DAG 任务调度**：四种执行策略（sequential/thread/async/dependency）
 - **组合 API 简洁**：`@fx.task` 装饰器 + 自动依赖推断 + `@fx.tool` CLI 工具
-- **纯 CLI（rich 增强）**：彩色输出、表格、进度条
+- **纯 CLI（自实现 Console）**：ASCII 表格、彩色输出、Win7/8 兼容
 - **便捷脚本模式**：`fcmd pymake b` 一键调用
 - **YAML 编排**：GitHub Actions 风格的 `jobs`/`needs`/`matrix`/`if` 任务图
 - **零配置工具发现**：`fcmd/cli/` 下的模块自动注册为 CLI 子命令
@@ -127,7 +127,7 @@ fcmd doctor            # 诊断环境问题
 
 ## 内建命令
 
-`fcmd` 自带 6 个内建命令（不通过 `@fx.tool` 注册）：
+`fcmd` 自带 7 个内建命令（不通过 `@fx.tool` 注册）：
 
 | 命令 | 说明 |
 |------|------|
@@ -137,6 +137,7 @@ fcmd doctor            # 诊断环境问题
 | `fcmd yaml <file> [job]` | 从 YAML 加载任务图并执行（支持 `--dry-run`/`--strategy`） |
 | `fcmd env [--json]` | 展示运行环境（fcmd 版本、Python、平台、工具数、可选依赖） |
 | `fcmd doctor` | 诊断环境问题（Python 版本、核心模块、工具模块、可选依赖、PATH 命令） |
+| `fcmd profiler <script.py> [args] [-E html\|text] [-o FILE] [--no-browser]` | 分析含 `fx.run()` 的脚本，生成性能剖面报告（HTML/文本） |
 
 shell 补全安装：
 
@@ -148,7 +149,7 @@ fcmd completion --shell fish | source         # fish
 
 ## 工具列表
 
-54 个工具模块，按用途分组：
+57 个工具模块，按用途分组：
 
 ### 项目构建与发布
 
@@ -197,7 +198,9 @@ fcmd completion --shell fish | source         # fish
 | `stattool` | - | 统计工具（mean/median/variance/quantile） |
 | `textdiff` | - | 文本比较（行级 diff，统一格式输出） |
 | `timetool` | - | 时间工具（convert/format/timezone） |
+| `calcdate` | - | 日期计算（add/workdays/diff/compare） |
 | `urltool` | - | URL 解析（编码/解码/拆分/拼接） |
+| `cryptool` | - | 文本对称加密（genkey/encrypt/decrypt，PBKDF2 + HMAC-SHA256 CTR + Encrypt-then-MAC） |
 
 ### 数据格式
 
@@ -205,6 +208,8 @@ fcmd completion --shell fish | source         # fish
 |------|------|------|
 | `xmltool` | - | XML 处理（pretty/get/keys/validate） |
 | `yamtool` | - | YAML 处理（pretty/get/keys/validate） |
+| `inifile` | - | INI 处理（get/set/list/keys，基于 configparser） |
+| `tomltool` | - | TOML 处理（get/keys/format/validate，3.11+ 用 tomllib，3.8-3.10 回退 tomli） |
 
 ### 多媒体（可选依赖）
 

{fcmd-0.2.2 → fcmd-0.2.4}/README.md

@@ -7,7 +7,7 @@
 - **极速冷启动**（< 100ms）：三层懒加载，核心模块零外部依赖
 - **DAG 任务调度**：四种执行策略（sequential/thread/async/dependency）
 - **组合 API 简洁**：`@fx.task` 装饰器 + 自动依赖推断 + `@fx.tool` CLI 工具
-- **纯 CLI（rich 增强）**：彩色输出、表格、进度条
+- **纯 CLI（自实现 Console）**：ASCII 表格、彩色输出、Win7/8 兼容
 - **便捷脚本模式**：`fcmd pymake b` 一键调用
 - **YAML 编排**：GitHub Actions 风格的 `jobs`/`needs`/`matrix`/`if` 任务图
 - **零配置工具发现**：`fcmd/cli/` 下的模块自动注册为 CLI 子命令
@@ -64,7 +64,7 @@ fcmd doctor            # 诊断环境问题
 
 ## 内建命令
 
-`fcmd` 自带 6 个内建命令（不通过 `@fx.tool` 注册）：
+`fcmd` 自带 7 个内建命令（不通过 `@fx.tool` 注册）：
 
 | 命令 | 说明 |
 |------|------|
@@ -74,6 +74,7 @@ fcmd doctor            # 诊断环境问题
 | `fcmd yaml <file> [job]` | 从 YAML 加载任务图并执行（支持 `--dry-run`/`--strategy`） |
 | `fcmd env [--json]` | 展示运行环境（fcmd 版本、Python、平台、工具数、可选依赖） |
 | `fcmd doctor` | 诊断环境问题（Python 版本、核心模块、工具模块、可选依赖、PATH 命令） |
+| `fcmd profiler <script.py> [args] [-E html\|text] [-o FILE] [--no-browser]` | 分析含 `fx.run()` 的脚本，生成性能剖面报告（HTML/文本） |
 
 shell 补全安装：
 
@@ -85,7 +86,7 @@ fcmd completion --shell fish | source         # fish
 
 ## 工具列表
 
-54 个工具模块，按用途分组：
+57 个工具模块，按用途分组：
 
 ### 项目构建与发布
 
@@ -134,7 +135,9 @@ fcmd completion --shell fish | source         # fish
 | `stattool` | - | 统计工具（mean/median/variance/quantile） |
 | `textdiff` | - | 文本比较（行级 diff，统一格式输出） |
 | `timetool` | - | 时间工具（convert/format/timezone） |
+| `calcdate` | - | 日期计算（add/workdays/diff/compare） |
 | `urltool` | - | URL 解析（编码/解码/拆分/拼接） |
+| `cryptool` | - | 文本对称加密（genkey/encrypt/decrypt，PBKDF2 + HMAC-SHA256 CTR + Encrypt-then-MAC） |
 
 ### 数据格式
 
@@ -142,6 +145,8 @@ fcmd completion --shell fish | source         # fish
 |------|------|------|
 | `xmltool` | - | XML 处理（pretty/get/keys/validate） |
 | `yamtool` | - | YAML 处理（pretty/get/keys/validate） |
+| `inifile` | - | INI 处理（get/set/list/keys，基于 configparser） |
+| `tomltool` | - | TOML 处理（get/keys/format/validate，3.11+ 用 tomllib，3.8-3.10 回退 tomli） |
 
 ### 多媒体（可选依赖）
 

fcmd-0.2.4/docs/api.rst

@@ -0,0 +1,120 @@
+API 参考
+========
+
+本节按模块组织 fcmd 的公共 API。顶层包 ``fcmd`` 通过 ``__getattr__`` 懒加载聚合
+各子模块符号，确保 ``import fcmd`` 冷启动 < 100ms；首次访问 ``fx.task`` /
+``fx.run`` 等才触发对应模块导入。
+
+顶层 API
+--------
+
+.. automodule:: fcmd
+   :members:
+   :undoc-members:
+   :show-inheritance:
+   :exclude-members: __version__
+
+任务与图
+--------
+
+任务定义、依赖推断与 DAG 构建。
+
+.. automodule:: fcmd.apis.dag
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: fcmd.apis.task
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+执行器
+------
+
+四种执行策略（``sequential`` / ``thread`` / ``async`` / ``dependency``）
+与对应的 Runner 实现。
+
+.. automodule:: fcmd.executors
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+工具箱
+------
+
+``@tool`` 装饰器、``run_tool`` / ``build_tool_graph`` 等 CLI 工具注册与执行 API。
+
+.. automodule:: fcmd.apis.toolkit
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+报告与上下文
+------------
+
+.. automodule:: fcmd.apis.report
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: fcmd.apis.context
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+性能分析
+--------
+
+``fcmd profiler`` 内建命令背后的剖面数据结构。
+
+.. automodule:: fcmd.apis.profiling
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+异常
+----
+
+fcmd 异常层次，均继承自 :class:`fcmd.FcmdError`。
+
+.. automodule:: fcmd.apis.errors
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+命令执行
+--------
+
+.. automodule:: fcmd.command
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+YAML 加载
+---------
+
+GitHub Actions 风格的 ``jobs`` / ``needs`` / ``matrix`` / ``if`` 任务图加载。
+
+.. automodule:: fcmd.yaml_loader
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+模型
+----
+
+.. automodule:: fcmd.models.command
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: fcmd.models.filefilter
+   :members:
+   :undoc-members:
+   :show-inheritance:
+
+.. automodule:: fcmd.models.version
+   :members:
+   :undoc-members:
+   :show-inheritance:

fcmd-0.2.4/docs/changelog.rst

@@ -0,0 +1,117 @@
+更新日志
+=========
+
+遵循 `Keep a Changelog <https://keepachangelog.com/>`_ 风格，版本倒序排列。
+
+v0.2.3 (2026-08-12)
+-------------------
+
+- ``feat``: 新增 3 个 CLI 工具：``inifile``（INI 读写，configparser）、``tomltool``（TOML 解析，3.11+ tomllib / 3.8-3.10 回退 tomli）、``calcdate``（日期计算 add/workdays/diff/compare）
+- ``refactor``: 拆分 ``executors.py``，抽取 Runner 抽象与 LayerRunner 系列，简化 ``_dispatch_strategy``
+- ``refactor``: 拆分 ``toolkit.py``，参数解析移至 ``apis/_tool_args.py``，执行逻辑移至 ``apis/_tool_exec.py``
+- ``refactor``: 拆分 ``main.py`` 内建命令纯函数辅助到 ``cli/_env_helpers.py`` 与 ``cli/_doctor_helpers.py``
+- ``refactor``: 审计异常处理模式，统一 CLI 错误打印格式
+- ``perf``: 建立性能基线（cold start / tool discovery / DAG / tool exec），工具发现耗时从 126ms 降至 63ms
+- ``chore``: 死代码扫描清理，复测性能基线对比
+
+v0.2.2 (2026-08-12)
+-------------------
+
+- ``feat(envdev)``: 新增 Bun 环境配置功能，完善 Rust 子命令实现
+- ``feat(portcheck)``: 端口占用时显示进程详情（PID/名称/状态/用户）
+- ``fix``: envdev 镜像源环境变量实质持久化到用户层面（Windows 注册表 + Linux/macOS profile）
+- ``refactor``: 清理死代码与重复工具，删除 basetool 合并到 codetool
+- ``refactor``: 提升代码质量，覆盖率 98.04% → 98.16%，补全异常处理注释
+- ``chore``: 清理项目内废弃的 .trae 文档与配置文件，envdev 默认镜像源改为 aliyun
+
+v0.2.1 (2026-08-08)
+-------------------
+
+- ``refactor(envdev)``: 重构 envdev 子命令，发布版本 0.2.1
+- ``perf``: 修复打包后管道输出无内容的问题
+- ``fix``: 为所有 CLI 工具模块添加 ``if __name__ == "__main__"`` 块，修复 fspack 打包后单独运行无输出
+
+v0.2.0 (2026-07-31)
+-------------------
+
+- ``refactor``: 重构项目结构，将核心 API 抽取到 ``apis`` 子模块（dag/task/toolkit/report/context/profiling/errors）
+- ``refactor``: 重构项目 API 结构，将核心模块迁移至 apis 目录
+
+v0.1.10 (2026-07-31)
+--------------------
+
+- ``chore``: 移除 pymake 任务中多余的 c 依赖并更新相关测试
+
+v0.1.9 (2026-07-31)
+-------------------
+
+- ``chore``: 移除 pymake 任务中多余的 c 依赖并更新相关测试
+
+v0.1.8 (2026-07-30)
+-------------------
+
+- ``refactor``: 拆分 ``run_tool`` / ``run_command`` 高复杂度函数并修复 RET 风格
+- ``refactor``: 提取 main.py 补全生成器与 profiler 辅助函数到独立模块（``_completion_scripts`` / ``_profiler_helpers``）
+- ``fix(console)``: 兼容 Win7/8 终端宽度，修复表格超出窗口问题
+- ``fix(console)``: Win7/8 下强制 ascii_only 修复 box 字符乱码
+- ``fix(console)``: 改用 AsciiBoxStream 包装 stdout 兜底 Win7 乱码
+- ``fix(console)``: ``_display_width`` 补全 Fullwidth 字符宽度计算
+
+v0.1.7 (2026-07-30)
+-------------------
+
+- ``perf``: pdftool 惰性导入 fitz/pypdf，工具发现耗时从 163ms 降至 126ms
+- ``fix``: 缩窄 basetool.py 的异常捕获范围，符合 python-standards 硬约束
+- ``refactor``: 删除 randtool 两处不可达 raise 并补测 timetool 无效 from_tz 分支
+
+v0.1.6 (2026-07-29)
+-------------------
+
+- ``build``: 适配 Python 3.12+ 版本的依赖包
+- ``fix(taskkill)``: 修复跨平台路径拼接导致的进程爆炸问题
+
+v0.1.5 (2026-07-29)
+-------------------
+
+- ``fix(pdf)``: 降级 Win7 环境的 PyMuPDF 版本至 1.22 系列（mupdfcpp64.dll 链接了 Win7 UCRT 不支持的函数）
+
+v0.1.4 (2026-07-29)
+-------------------
+
+- ``fix(cli)``: 修复 taskkill 递归调用自身的进程爆炸问题
+- ``build``: 修复命令行别名拼写错误并适配 Win7 Python 环境
+
+v0.1.3 (2026-07-29)
+-------------------
+
+- ``feat``: 新增 7 个 CLI 工具及其测试用例
+- ``refactor``: 统一变量命名并简化代码格式
+
+v0.1.2 (2026-07-18 ~ 2026-07-29)
+--------------------------------
+
+- ``feat``: 迁移 dockercmd 和 lscalc 两个 CLI 工具到 fcmd
+- ``feat``: 为所有 CLI 工具模块添加独立入口脚本，支持打包后直接命令调用
+- ``build``: 添加 fspack 打包入口声明，解决 src layout 无法识别入口的问题
+- ``refactor``: 重组 CLI 测试文件结构，按工具拆分为单工具测试文件
+
+v0.1.1 (2026-07-16 ~ 2026-07-18)
+--------------------------------
+
+- ``feat``: 移植 imagetool/pdftool 工具并修复 verbose 回调 Unicode 编码
+- ``feat``: 框架支持 Optional 解包与 bool=True 取反，还原 imagetool 反转语义
+- ``feat``: 新增 ``fcmd env`` 与 ``fcmd doctor`` 内置命令
+- ``feat``: 移植 profiler 性能分析工具，支持离线 HTML/text 报告
+- ``fix``: 修复 ``_unwrap_optional`` 跨 Python 版本兼容性问题
+- ``fix``: 修复测试状态泄漏并补全 command.py 覆盖率至 100%
+
+v0.1.0 (2026-07-13 ~ 2026-07-16)
+--------------------------------
+
+- 项目初始化，完成基础框架搭建
+- ``feat``: 实现 P0 DAG 调度核心，支持编程式 API ``fx.graph`` / ``fx.run``
+- ``feat``: 实现 P1 ``@fx.tool`` 装饰器框架与 FcmdApp CLI 路由
+- ``feat``: 扩展 pymake 子命令集为完整构建/测试/发布工具集
+- ``feat``: 实现工具自动发现机制替代硬编码注册表
+- ``feat``: 新增 ``fcmd graph`` 内建命令与 ``build_tool_graph`` 公共 API
+- ``feat``: 新增 ``fcmd info`` 内建命令展示工具与子命令元信息

{fcmd-0.2.2 → fcmd-0.2.4}/docs/conf.py

@@ -63,6 +63,10 @@ intersphinx_mapping = {
 language = "zh_CN"
 master_doc = "index"
 exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
+# fcmd 顶层包通过 __getattr__ 聚合子模块符号，autodoc 会同时索引 fcmd.X 与
+# fcmd.apis.Y.X，导致交叉引用多目标与重复对象描述警告。这些警告不影响文档
+# 功能（Sphinx 自动选首个目标），且 RTD 配置 fail_on_warning: false，此处抑制。
+suppress_warnings = ["ref.python", "duplicate_object"]
 source_suffix = {
     ".rst": "restructuredtext",
     ".md": "markdown",

fcmd-0.2.4/docs/index.rst

@@ -0,0 +1,120 @@
+fcmd
+====
+
+极速 Python 工具集应用：DAG 任务调度 + 组合 CLI。
+
+.. toctree::
+   :maxdepth: 2
+   :caption: 目录
+
+   api
+   changelog
+
+特性
+====
+
+- **极速冷启动** (小于 100ms)：三层懒加载，核心模块零外部依赖
+- **DAG 任务调度**：四种执行策略（sequential/thread/async/dependency）
+- **组合 API 简洁**：``@fx.task`` 装饰器 + 自动依赖推断 + ``@fx.tool`` CLI 工具
+- **纯 CLI（自实现 Console）**：ASCII 表格、彩色输出、Win7/8 兼容
+- **YAML 编排**：GitHub Actions 风格的 ``jobs``/``needs``/``matrix``/``if`` 任务图
+- **零配置工具发现**：``fcmd/cli/`` 下的模块自动注册为 CLI 子命令
+
+安装
+====
+
+.. code-block:: bash
+
+   pip install fcmd          # 或 uv add fcmd
+
+可选依赖按需安装：``fcmd[img]`` (Pillow)、``fcmd[pdf]`` (PyMuPDF + pypdf)、
+``fcmd[ocr]`` (pytesseract)、``fcmd[office]`` (img + pdf + ocr)。
+要求 Python ≥ 3.8。
+
+快速上手
+========
+
+Python API
+----------
+
+.. code-block:: python
+
+   import fcmd as fx
+
+   @fx.task
+   def extract() -> list[int]: return [1, 2, 3]
+
+   @fx.task
+   def double(extract: list[int]) -> list[int]: return [x * 2 for x in extract]
+
+   graph = fx.graph(extract, double)  # double 自动依赖 extract
+   report = fx.run(graph)
+   print(report["double"])  # [2, 4, 6]
+
+CLI
+---
+
+.. code-block:: bash
+
+   fcmd                   # 列出所有工具
+   fcmd pymake b          # 构建
+   fcmd pymake tc         # 类型检查
+   fcmd info pymake       # 查看 pymake 子命令
+   fcmd graph pymake tc   # 输出 DAG（Mermaid）
+   fcmd env               # 查看运行环境
+   fcmd doctor            # 诊断环境问题
+   fcmd profiler workflow.py   # 性能剖面分析
+
+更多用法（任务定义 API、YAML 编排、执行策略）详见 ``README.md``。
+
+项目结构
+========
+
+采用 ``src`` layout，核心分为三层：
+
+.. code-block:: text
+
+   src/fcmd/
+   ├── __init__.py          # 顶层导出：task/tool/graph/run 等
+   ├── _compat.py           # 跨版本兼容补丁
+   ├── command.py           # 命令执行辅助
+   ├── conditions.py        # YAML ``if`` 条件函数（success()/failure() 等）
+   ├── console.py           # 自实现 Console + Table（替代 rich）
+   ├── executors.py         # 四种执行策略的 Runner
+   ├── yaml_loader.py       # YAML 任务图加载
+   ├── apis/                # 核心 API：DAG/任务/工具箱/报告/上下文/性能
+   │   ├── dag.py           # 图构建与拓扑排序
+   │   ├── task.py          # TaskSpec/TaskResult 数据结构
+   │   ├── toolkit.py       # @tool 装饰器与 run_tool/build_tool_graph
+   │   ├── report.py        # RunReport 执行报告
+   │   ├── context.py       # 执行上下文
+   │   ├── profiling.py     # 性能剖面
+   │   └── errors.py        # 异常层次
+   ├── models/              # 命令/文件过滤/版本等模型
+   └── cli/                 # CLI 入口与 57 个工具模块
+       ├── main.py          # FcmdApp 主入口与 7 个内建命令
+       ├── _common.py       # 共享常量（_BUILTIN_COMMANDS 等）
+       ├── _completion_scripts.py  # shell 补全生成
+       ├── _profiler_helpers.py    # profiler 内建命令辅助
+       ├── _env_persist.py         # 环境变量持久化
+       └── <tool>.py        # 工具模块（@fcmd.tool 自动注册）
+
+开发
+====
+
+.. code-block:: bash
+
+   # 安装开发依赖（lint + test + office + prek + tox）
+   uv sync --extra dev
+
+   fcmd pymake tc           # 类型检查（pyrefly + ruff）
+   fcmd pymake t            # 运行测试
+   fcmd pymake cov          # 测试 + 覆盖率
+   make check               # 全套门禁（lint + typecheck + cov ≥ 95%）
+
+工具链独立配置文件：``ruff.toml`` / ``pyrefly.toml`` / ``pytest.ini`` / ``.coveragerc``
+/ ``.bumpversion.toml`` / ``uv.toml`` / ``.pre-commit-config.yaml``。
+``pyproject.toml`` 仅含项目元数据。
+
+新增工具：在 ``src/fcmd/cli/`` 下新建模块（非 ``_`` 前缀、非 ``main``），
+用 ``@fcmd.tool`` 装饰器注册即可，无需修改 ``main.py``。

{fcmd-0.2.2 → fcmd-0.2.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "fcmd"
-version = "0.2.2"
+version = "0.2.4"
 description = "极速 Python 工具集应用：DAG 任务调度 + 组合 CLI"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -28,6 +28,7 @@ archivex = "fcmd.cli.archivex:main"
 asciitool = "fcmd.cli.asciitool:main"
 autofmt = "fcmd.cli.autofmt:main"
 bumpversion = "fcmd.cli.bumpversion:main"
+calcdate = "fcmd.cli.calcdate:main"
 casetool = "fcmd.cli.casetool:main"
 clr = "fcmd.cli.clr:main"
 codetool = "fcmd.cli.codetool:main"
@@ -47,6 +48,7 @@ gitt = "fcmd.cli.gittool:main"
 hashfile = "fcmd.cli.hashfile:main"
 hashtool = "fcmd.cli.hashtool:main"
 idtool = "fcmd.cli.idtool:main"
+inifile = "fcmd.cli.inifile:main"
 imaget = "fcmd.cli.imagetool:main"
 iptool = "fcmd.cli.iptool:main"
 jsont = "fcmd.cli.jsontool:main"
@@ -71,6 +73,7 @@ sysinfo = "fcmd.cli.sysinfo:main"
 taskk = "fcmd.cli.taskkill:main"
 textdiff = "fcmd.cli.textdiff:main"
 timetool = "fcmd.cli.timetool:main"
+tomltool = "fcmd.cli.tomltool:main"
 txttool = "fcmd.cli.txttool:main"
 urltool = "fcmd.cli.urltool:main"
 wch = "fcmd.cli.which:main"

{fcmd-0.2.2 → fcmd-0.2.4}/pyrefly.toml

@@ -3,3 +3,5 @@ project-excludes = [".venv/**", "template/**"]
 project-includes = ["**/*.ipynb", "**/*.py*"]
 python-version   = "3.8"
 search-path      = ["."]
+# winreg 仅 Windows 可用；替换为 Any 使 Linux CI 也能通过类型检查（运行时仍导入真实模块）
+replace-imports-with-any = ["winreg"]

{fcmd-0.2.2 → fcmd-0.2.4}/src/fcmd/__init__.py

@@ -22,7 +22,7 @@ from __future__ import annotations
 
 from typing import Any
 
-__version__ = "0.2.2"
+__version__ = "0.2.4"
 
 __all__ = [
     "Context",