fcmd 0.1.0__tar.gz

fcmd-0.1.0/.copier-answers.yml

@@ -0,0 +1,21 @@
+# Changes here will be overwritten by Copier
+_commit: v0.7.0
+_src_path: https://gitee.com/gooker_young/coopie.git
+author_email: gooker_young@qq.com
+author_name: gooker_young
+coverage_fail_under: 95
+description: 极速 python 工具集。
+initial_version: 0.1.0
+license: MIT
+max_python_version: '3.14'
+min_python_version: '3.8'
+package_name: fcmd
+project_name: fcmd
+project_type: cli
+use_cicd: true
+use_cli: true
+use_docker: false
+use_docs: true
+use_domestic_mirrors: true
+use_tox: true
+

fcmd-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,63 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint & Typecheck
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.3.2
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Sync dependencies
+        run: uv sync --frozen --extra lint
+
+      - name: Ruff check
+        run: uv run ruff check src tests
+
+      - name: Ruff format check
+        run: uv run ruff format --check src tests
+
+      - name: Pyrefly check
+        run: uv run pyrefly check
+
+  test:
+    name: Test (Python 3.8 & 3.14)
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.8", "3.14"]
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.3.2
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Sync dependencies
+        run: uv sync --frozen --extra test --python ${{ matrix.python-version }}
+
+      - name: Run tests
+        run: uv run pytest -m "not slow" --cov=fcmd --cov-fail-under=95 --cov-report=term-missing

fcmd-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,44 @@
+name: Release
+
+on:
+  push:
+    tags: ['v*.*.*']
+
+permissions:
+  contents: write
+  id-token: write
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  release:
+    name: Build & Publish
+    runs-on: ubuntu-latest
+    environment: pypi
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v5
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v8.3.2
+        with:
+          enable-cache: true
+          cache-dependency-glob: "uv.lock"
+
+      - name: Build distributions
+        run: uv build
+
+      - name: Publish to PyPI (OIDC)
+        run: uv publish
+
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG_NAME: ${{ github.ref_name }}
+        run: |
+          gh release create "$TAG_NAME" \
+            --title "Release $TAG_NAME" \
+            --generate-notes \
+            dist/*

fcmd-0.1.0/.gitignore

@@ -0,0 +1,35 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+
+# 测试与覆盖率
+.coverage
+.coverage.*
+htmlcov/
+coverage.xml
+.tox/
+
+# 工具缓存
+.ruff_cache/
+.pyrefly_cache/
+.mypy_cache/
+.uv-cache/
+
+# IDE
+.idea/
+*_profile.html
+
+# 环境变量与凭证（勿提交）
+.env
+.env.*
+
+# Sphinx 文档构建输出
+docs/_build/
+.trae/refs

fcmd-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,21 @@
+# prek / pre-commit 配置
+# See https://pre-commit.com for more information
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    # Ruff 版本 - 与 pyproject.toml 保持同步
+    rev: v0.15.8
+    hooks:
+      # 运行 linter
+      - id: ruff
+        args: [--fix, --exit-non-zero-on-fix]
+      # 运行格式化
+      - id: ruff-format
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: check-merge-conflict
+      - id: debug-statements
+      - id: fix-byte-order-marker
+      - id: trailing-whitespace
+        args: [--markdown-linebreak-ext=md]
+      - id: end-of-file-fixer

fcmd-0.1.0/.python-version

@@ -0,0 +1 @@
+3.8

fcmd-0.1.0/.readthedocs.yaml

@@ -0,0 +1,23 @@
+# ReadTheDocs 配置
+# https://docs.readthedocs.io/en/stable/config-file/v2.html
+version: 2
+
+# 构建配置
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.8"
+
+# Python 依赖与构建命令
+python:
+  install:
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs
+
+# Sphinx 构建
+sphinx:
+  configuration: docs/conf.py
+  builder: html
+  fail_on_warning: false

fcmd-0.1.0/.trae/.ignore

@@ -0,0 +1,15 @@
+# PYTHON
+.coverage
+.pytest_cache/
+.ruff_cache/
+.tox/
+.venv/
+__pycache__/
+
+# NODEJS
+node_modules/
+
+# IDE
+.idea
+.trae
+.vscode

fcmd-0.1.0/.trae/rules/rule-01-/345/274/200/345/217/221/346/265/201/347/250/213.md

@@ -0,0 +1,19 @@
+# 开发流程约束
+
+## 执行过程记录
+
+- 每次迭代必须走完"计划 → 实现 → 测试 → 文档 → 验证"闭环，并记录到 `.trae/docs/iter-NN-<主题>.md`（`NN` 为零填充序号）。
+- 记录内容至少包括：迭代目标、改动文件清单、关键决策与依据、验证结果、遗留事项。
+- 每 5 次迭代后清理 `.trae/docs/` 和 `.trae/req/` 目录：长期保留内容归档到 `.trae/skills/skill-NN-<主题>.md`，仅保留最近未归档的记录。
+
+## 需求分析
+
+- 每次迭代前，必须与用户确认需求，确保理解无误。
+- 需求必须记录到 `.trae/req/req-NN-<主题>.md`（`NN` 为零填充序号）。
+- 需求记录按照`[] 需求描述`格式，其中`[]`为未完成标志，`[x]`为已完成标志。
+- 开发前扫描 `.trae/req/` 目录，整理所有需求，与用户确认后制定开发计划。
+
+## 规则变更约束
+
+- 修改 `.trae/rules/` 下文件**必须先询问用户**，获授权后方可变动。
+- 变动记录为 `rule-NN-<主题>.md`，并同步更新 `project_memory.md` 对应章节。

fcmd-0.1.0/.trae/rules/rule-02-/350/207/252/351/251/261/345/274/200/345/217/221/345/216/237/345/210/231.md

@@ -0,0 +1,57 @@
+---
+alwaysApply: true
+---
+
+# 自驱动开发规则
+
+初始确认后，Agent 自主完成"计划 → 实现 → 测试 → 文档 → 验证"迭代循环，直到整个项目目标达成。
+
+## 核心原则
+
+- **目标导向**：所有产出服务于用户最终目标。
+- **闭环执行**：每个子任务走完五步，禁止跳步留半成品。
+- **自主决策**：可逆操作（编辑文件、运行测试、修复 lint、调整实现）直接执行不询问；不可逆/高风险操作才暂停。
+- **透明沟通**：阶段开始一句话说明意图；关键节点简短更新；不复述内部思考；收尾时直接输出总结，**不询问**"是否继续"或"是否提交"。
+
+## 初始确认（一次性）
+
+用 `AskUserQuestion` 确认：1. 目标与范围（含不在范围内的内容）2. 验收标准 3. 特殊约束 4. 测试要求（覆盖率门槛、slow 标记）。确认后固化进 `TaskCreate`，不再反复询问。
+
+git commit/push 自动执行（分支已跟踪远程时 push；新分支跳过并在总结说明），仅破坏性操作（force-push/reset --hard/clean -f/改 git config）需暂停确认。
+
+## 迭代循环
+
+1. **计划**：用 Explore/Glob/Grep 研究既有模式；`TaskCreate` 拆分子任务，完成即 `TaskUpdate`；优先复用现有抽象；三处相似才考虑提取，不过早抽象。
+2. **实现**：遵守 `rule-11-python-standards.md` 与既有风格；优先 Edit 现有文件；公共 API 须有完整类型注解与中文 docstring；不写未被要求的功能、不为未来预留扩展点。
+3. **测试**：公共 API 配套测试，优先通过公共接口测试（故障注入可临时访问私有属性，docstring 注明）；Mock 优先级：`monkeypatch` > 内联 stub > `unittest.mock` > `pytest-mock`，禁用 `@patch` 装饰器；必跑：`ruff check` + `pytest --cov`；失败时定位根因，不放宽断言或 `# pragma: no cover` 绕过；覆盖率不得低于上一次的值。
+4. **文档**：同步更新 docstring/README；有价值决策追加到 memory（`project_memory.md` 或 `topics.md`）；不主动新建 `*.md` 文档。
+5. **验证**：逐条对照验收标准；全套门禁通过（ruff/pyrefly/pytest/coverage）；给出变更清单。
+
+未达标准回「计划」继续；达标准进入下一轮或收尾。
+
+## 多阶段项目
+
+初始确认目标是**整个项目**。阶段是里程碑不是边界——阶段完成后自动进入下一阶段「计划」，仅一句话说明"进入 Pn，重点：…"。仅所有阶段交付完毕才执行收尾。跨阶段需外部资源（新依赖审批、环境配置）时暂停；阶段范围需显著扩大或改变方向时暂停确认。
+
+## 暂停条件（仅以下情况中断找用户）
+
+1. **歧义无法自决**：多种合理解读且无既有约定可循。
+2. **高风险/不可逆**：删除非临时文件、重命名公共模块/包、`force-push`、`reset --hard`、`clean -f`、修改 CI/git config、引入新依赖、修改 pre-commit/pyproject.toml 工具链配置、卸载或降级既有依赖。**普通 commit/push 不属于此类**（自动执行）。
+3. **不可恢复的失败**：根因不在本仓库、需外部环境/权限配合、或两轮尝试仍无法定位。
+4. **超出初始确认范围**：需显著扩大范围或改变方向。
+5. **用户主动询问**。
+
+**可直接自决**：测试/lint/类型错误修复、代码风格选择、文件编辑、运行校验命令、收尾总结输出、重命名局部变量以避免遮蔽。
+
+"整个项目目标达成"不是暂停条件——单阶段完成应自动进入下一阶段。
+
+## 沟通与工具
+
+- 阶段切换一句话说明；完成子任务后一两句总结；阻塞时说明卡点与需求。
+- 独立操作并行调用（多个 Read/Grep/Glob 一批发出）；`TaskCreate`/`TaskUpdate` 维护进度；长命令后台运行。
+- 文件操作用专用工具（Read/Edit/Write/Glob/Grep），不用 `cat`/`sed`/`grep`/`find`。
+- 不用 emoji。
+
+## 收尾
+
+仅所有阶段交付后执行：输出总结（交付物、关键决策、遗留事项）→ 自动 `git add`（按文件名）+ `git commit`（遵循 `rule-09-git提交规则.md` 风格）+ `git push`（分支已跟踪远程时）→ 更新 memory。验收未满足则回「计划」继续，不停下询问。

fcmd-0.1.0/.trae/rules/rule-09-git/346/217/220/344/272/244/350/247/204/345/210/231.md

@@ -0,0 +1,7 @@
+---
+alwaysApply: true
+scene: git_message
+---
+
+## 提交信息格式
+- 使用中文，包含变更类型（fix/feat/refactor 等），简洁明了不超过一段落。

fcmd-0.1.0/.trae/rules/rule-11-python-standards.md

@@ -0,0 +1,108 @@
+# Python 开发规范
+
+## 工具链（以 pyproject.toml 为准）
+
+| 工具 | 配置要点 |
+|------|---------|
+| ruff | `line-length=120`，`target-version="py38"` |
+| pyrefly | `preset="strict"`，`python-version="3.8"` |
+| pytest | `asyncio_default_fixture_loop_scope="function"`，marker `slow` |
+| coverage | `branch=true`，`fail_under=95`，`concurrency=["thread"]` |
+| pre-commit | ruff `--fix` + trailing-whitespace + end-of-file-fixer |
+
+验证（每次修改后）：
+
+```bash
+uv run ruff check src tests
+uv run ruff format --check src tests
+uv run pyrefly check
+uv run pytest -m "not slow" --cov=fcmd --cov-fail-under=95
+```
+
+## 兼容性
+
+- 最低 Python 3.8：用 `from __future__ import annotations` 延迟注解求值；按版本 `typing.List` → 内置泛型(3.9) → `X | Y`(3.10) → `typing.override`(3.12)。
+- 版本守卫：`if sys.version_info >= (3, X):` 引入高版本 API；低版本回退加 `# pragma: no cover`。
+- 优先标准库；`typing-extensions` 用于 `override`/`TypeVar` 前向兼容（`python_version < '3.13'` 时引入）。新增依赖须审慎。
+
+## 类型注解
+
+- 公共 API 必须有完整类型注解（含返回类型）；私有函数也应有注解。
+- `Mapping`/`Sequence` 用于只读参数，`dict`/`list` 用于可变返回。`Any` 仅用于真正动态场景。
+- 禁用裸 `# type: ignore`，确需时加规则码（如 `# type: ignore[union-attr]`）。
+- 仅类型检查的导入放 `if TYPE_CHECKING:` 块内。
+- 类型收窄用 `assert isinstance(x, Y)`；`cast()` 仅用于类型系统无法表达的场景。
+
+## 数据结构
+
+- 配置/描述类用 `@dataclass(frozen=True)`；可变类属性标注 `RUF012` 豁免。
+- 缓存：实例级 `functools.cached_property`，参数键控 `lru_cache`；不可哈希参数 try/except 回退；修改缓存源后手动清空。
+- 接口用 `abc.ABC` + `@abstractmethod`；状态/标志值用 `enum.Enum`（`UPPER_SNAKE`），禁止裸字符串/魔术数字。
+- 可变类实现 `__repr__`（含关键字段）。
+
+## 模块与导入
+
+- 单一职责；导入顺序（ruff isort）：`__future__` → 标准库 → 第三方 → 本地，各组间空行。
+- 惰性导入仅用于打破循环依赖（函数体内导入并注释）。
+- 定义 `__all__` 显式声明导出符号（位置仅次于 `__future__`）。禁用 `from x import *`；避免 `utils.py`/`helpers.py`。
+
+## 函数设计
+
+- 模块级函数优于 Mixin；纯函数直接放模块级（慎用静态方法）。参数 ≤ 5 个，超出用 dataclass 封装。
+- 异常范围要窄：只捕获预期异常（如 `(TypeError, ValueError, KeyError, AttributeError)`），**禁止** `except Exception`；捕获后至少 `logger.warning`。
+- 可变默认参数用 `None` 哨兵或 `field(default_factory=list)`。
+
+## 异常处理
+
+- 自定义异常继承公共基类，按场景分类；`raise NewError(...) from exc` 保留因果链。
+- 不吞异常：捕获后必须处理（记录/包装/重抛），禁止空 `except: pass`。第三方回调异常仅记录，不影响主流程。
+
+## 并发
+
+- `os.environ`/`os.chdir` 等进程全局状态用 `threading.RLock` 序列化。循环内多次 I/O 改为批量一次；按组限流用 `Semaphore`。
+
+## 测试
+
+- 覆盖率 ≥ 95%（branch），不得下降。
+- 公共 API 优先通过公共接口测试；故障注入可临时访问私有属性（docstring 注明）。
+- 命名 `test_<对象>_<场景>`；原生 `assert`，禁用 `self.assertEqual`；`pytest.raises` 必填 `match=`。
+- Mock 优先级：`monkeypatch` > 内联 stub > `unittest.mock` > `pytest-mock`。禁用 `@patch` 装饰器、`mock.patch.object` 上下文、`pytest-mock` 的 `mocker` fixture。
+- fixture 优先 `tmp_path`/`monkeypatch`/`capsys`；autouse 仅全局必需时用。耗时测试加 `@pytest.mark.slow`；`tests/**` 忽略 `ARG001`/`ARG002`。
+
+## 代码风格
+
+- 行宽 120；ruff 默认双引号；末尾单 `\n`、无尾随空格。
+- 公共 API 必须有中文 docstring；使用中文打印和日志。
+- 命名：`snake_case` 函数/变量，`PascalCase` 类，`UPPER_SNAKE` 常量，`_` 前缀私有。不用 emoji。
+
+## Pythonic 风格
+
+- 单例用 `is`，值用 `==`；EAFP 优于 LBYL；`if items:` 优于 `if len(items) > 0:`。
+- 字符串首选 f-string（`%` 仅用于 logging 延迟格式化）；推导式优于 `map`+`filter`（> 2 层拆显式循环）。
+- `enumerate` 替代 `range(len())`；`zip` 并行迭代（3.10+ `strict=True`）；解包优于索引；海象运算符不滥用。
+
+## 日志
+
+- 每模块 `logging.getLogger(__name__)`，禁用 `print` 调试残留。
+- `extra={...}` 传字段；延迟格式化用 `%`；级别：DEBUG 诊断 / INFO 关键流程 / WARNING 可恢复 / ERROR 需介入。禁止日志密码/密钥，脱敏后记录。
+
+## 路径与资源
+
+- 优先 `pathlib.Path`（ruff `PTH` 强制），禁止字符串拼接路径；边界 `str` 立即包装。
+- 文件/锁/连接用 `with` 或 `contextlib.contextmanager`；多资源用 `ExitStack`。循环内多次 acquire/release 改为批量一次。
+
+## 安全
+
+- 禁用 `eval`/`exec`（用 `ast.literal_eval`）；`subprocess` 禁用 `shell=True`（优先 `list[str]`）。
+- 凭证放 `.env`/环境变量，`.gitignore` 须含 `.env`；日志脱敏。`uv lock` 后审阅新增依赖避免已知 CVE。
+
+## 性能
+
+- 循环内查询缓存或预构建映射；`has(k)` + `get(k)` 改为单次 `get(k)` + `KeyError` 回退。
+- 入口校验一次，下游不重复。生命周期事件 emit 完整，不留死分支（`# pragma: no cover` 应激活或删除）。
+
+## Git 与提交
+
+- 任务完成后自动 `git add`（按文件名）+ `git commit`（遵循 `rule-09-git提交规则.md` 风格）+ `git push`（分支已跟踪远程时；新分支跳过并在总结说明）。
+- 不修改 git config；不运行破坏性命令（`push --force`/`reset --hard`/`clean -f`）除非用户明确要求。
+- staging 按文件名添加，不用 `git add -A`/`git add .`。

fcmd-0.1.0/.vscode/settings.json

@@ -0,0 +1,35 @@
+{
+    "[python]": {
+        "editor.codeActionsOnSave": {
+            "source.fixAll.ruff": "always",
+            "source.organizeImports.ruff": "always",
+            "source.sort.json": "always"
+        },
+        "editor.defaultFormatter": "charliermarsh.ruff",
+        "editor.formatOnSave": true
+    },
+    "[toml]": {
+        "editor.defaultFormatter": "tamasfe.even-better-toml",
+        "editor.formatOnSave": true
+    },
+    "evenBetterToml.formatter.alignComments": true,
+    "evenBetterToml.formatter.alignEntries": true,
+    "evenBetterToml.formatter.allowedBlankLines": 1,
+    "evenBetterToml.formatter.arrayAutoCollapse": true,
+    "evenBetterToml.formatter.arrayAutoExpand": true,
+    "evenBetterToml.formatter.arrayTrailingComma": true,
+    "evenBetterToml.formatter.compactEntries": false,
+    "evenBetterToml.formatter.indentEntries": false,
+    "evenBetterToml.formatter.indentTables": false,
+    "evenBetterToml.formatter.reorderArrays": true,
+    "evenBetterToml.formatter.reorderInlineTables": true,
+    "evenBetterToml.formatter.reorderKeys": true,
+    "python.languageServer": "None",
+    "python.testing.pytestArgs": [
+        "src",
+        "tests",
+    ],
+    "python.testing.pytestEnabled": true,
+    "python.testing.unittestEnabled": false,
+    "ruff.importStrategy": "fromEnvironment"
+}

fcmd-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 gooker_young
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fcmd-0.1.0/Makefile

@@ -0,0 +1,59 @@
+# Makefile - fcmd 项目快捷命令
+# 运行 `make help` 查看所有可用命令
+
+PACKAGE := fcmd
+COV_THRESHOLD := 95
+
+.PHONY: help sync build b clean c test cov lint typecheck 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)
+
+sync: ## 安装开发依赖
+	uv sync --extra dev
+
+build b: ## 构建分发包 (wheel + sdist)
+	uv build
+
+clean c: ## 清理构建产物与缓存
+	rm -rf build/ dist/ wheels/ *.egg-info htmlcov/ .coverage .coverage.* coverage.xml docs/_build/ .tox/
+	rm -rf .ruff_cache/ .pyrefly_cache/ .mypy_cache/
+	find src tests -type d -name __pycache__ -exec rm -rf {} +
+	find src tests -type f -name "*.py[oc]" -delete
+
+test: ## 运行测试（不含覆盖率）
+	uv run pytest -m "not slow"
+
+cov: ## 运行测试并检查覆盖率
+	uv run pytest -m "not slow" --cov=$(PACKAGE) --cov-fail-under=$(COV_THRESHOLD)
+
+lint: ## 代码风格检查 (ruff)
+	uv run ruff check src tests
+	uv run ruff format --check src tests
+
+typecheck: ## 类型检查 (pyrefly)
+	uv run pyrefly check
+
+check: lint typecheck cov ## 运行全套门禁 (lint + typecheck + cov)
+
+doc: ## 构建 Sphinx 文档
+	uv run sphinx-build -b html docs docs/_build/html
+
+
+tox: ## 多版本测试 (tox)
+	uvx tox -p auto
+
+BUMP_PART := $(filter-out bump,$(MAKECMDGOALS))
+
+bump: ## 版本号 bump (默认 patch，用法: make bump [minor|major])
+	@uvx bump-my-version bump $(if $(BUMP_PART),$(firstword $(BUMP_PART)),patch) --tag
+
+patch minor major:
+	@:
+
+pub:  ## 推送到pypi
+	uvx twine upload ./dist/**
+
+push: ## 推送代码到所有远程仓库
+	@set -e; for remote in $$(git remote); do echo "推送 $$remote..."; git push $$remote; git push $$remote --tags; done
+

fcmd-0.1.0/PKG-INFO

@@ -0,0 +1,135 @@
+Metadata-Version: 2.4
+Name: fcmd
+Version: 0.1.0
+Summary: 极速 python 工具集。
+Author-email: gooker_young <gooker_young@qq.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Provides-Extra: dev
+Requires-Dist: prek>=0.4.5; extra == 'dev'
+Requires-Dist: pyrefly>=1.1.1; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'dev'
+Requires-Dist: pytest-html>=4.1.1; extra == 'dev'
+Requires-Dist: pytest-xdist>=3.6.1; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Requires-Dist: tox-uv>=1.13.1; extra == 'dev'
+Requires-Dist: tox>=4.25.0; extra == 'dev'
+Provides-Extra: docs
+Requires-Dist: myst-parser>=3.0; extra == 'docs'
+Requires-Dist: sphinx-rtd-theme>=2.0; extra == 'docs'
+Requires-Dist: sphinx>=7.0; extra == 'docs'
+Provides-Extra: lint
+Requires-Dist: pyrefly>=1.1.1; extra == 'lint'
+Requires-Dist: ruff>=0.8.0; extra == 'lint'
+Provides-Extra: test
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'test'
+Requires-Dist: pytest-cov>=5.0.0; extra == 'test'
+Requires-Dist: pytest-html>=4.1.1; extra == 'test'
+Requires-Dist: pytest-xdist>=3.6.1; extra == 'test'
+Requires-Dist: pytest>=8.0.0; extra == 'test'
+Description-Content-Type: text/markdown
+
+# fcmd
+
+> 极速 python 工具集。
+
+[![PyPI](https://img.shields.io/pypi/v/fcmd)](https://pypi.org/project/fcmd/)
+[![CI](https://github.com/gooker_young/fcmd/actions/workflows/ci.yml/badge.svg)](https://github.com/gooker_young/fcmd/actions/workflows/ci.yml)
+![Python](https://img.shields.io/badge/python-3.8%2B-blue.svg)
+![License](https://img.shields.io/badge/license-MIT-green.svg)
+![Coverage](https://img.shields.io/badge/coverage-%E2%89%A595%25-brightgreen.svg)
+
+## 特性
+
+- **构建工具链**：hatchling + uv + ruff + pyrefly + pytest + coverage
+- **Python 版本**：3.8 ~ 3.14
+- **代码质量**：pre-commit 钩子 + ruff lint/format，覆盖率阈值 95%
+- **CI/CD**：GitHub Actions（lint + typecheck + 多版本测试 + 自动发布到 PyPI）
+- **文档**：Sphinx + ReadTheDocs（中文 zh_CN）
+- **多版本测试**：tox + tox-uv（py38, py39, py310, py311, py312, py313, py314）
+- **CLI 入口**：argparse + [project.scripts]
+- **项目结构**：src layout + py.typed 类型标记
+
+## 安装
+
+```bash
+pip install fcmd
+```
+
+或使用 [uv](https://docs.astral.sh/uv/)：
+
+```bash
+uv add fcmd
+```
+
+## 快速上手
+
+```python
+import fcmd
+
+print(fcmd.__version__)
+```
+
+## 开发
+
+```bash
+# 安装开发依赖
+uv sync --extra dev
+
+# 运行测试（含覆盖率，阈值 95%）
+uv run pytest -m "not slow" --cov=fcmd --cov-fail-under=95
+
+# 类型检查
+uv run pyrefly check .
+
+# 代码风格
+uv run ruff check src tests
+uv run ruff format --check src tests
+```
+
+### Make 快捷命令
+
+项目提供 Makefile 封装常用操作，运行 `make help` 查看全部命令：
+
+```bash
+make sync     # 安装开发依赖
+make check    # 全套门禁 (lint + typecheck + cov)
+make build    # 构建分发包
+make clean    # 清理构建产物
+make bump PART=patch  # 版本号 bump
+```
+
+
+## 文档
+
+文档由 Sphinx 构建，托管在 ReadTheDocs：
+
+```bash
+# 本地构建文档
+make doc
+```
+
+
+## 多版本测试
+
+使用 tox 在多个 Python 版本（py38, py39, py310, py311, py312, py313, py314）下运行测试：
+
+```bash
+make tox
+```
+
+## 许可证
+
+MIT