fcmd 0.1.0__py3-none-any.whl

fcmd/__init__.py

@@ -0,0 +1,7 @@
+"""fcmd - 极速 python 工具集。."""
+
+from __future__ import annotations
+
+__all__ = ["__version__"]
+
+__version__ = "0.1.0"

fcmd/cli.py

@@ -0,0 +1,25 @@
+"""fcmd CLI 入口."""
+
+from __future__ import annotations
+
+import argparse
+
+from fcmd import __version__
+
+__all__ = ["main"]
+
+
+def _build_parser() -> argparse.ArgumentParser:
+    """构建参数解析器."""
+    parser = argparse.ArgumentParser(prog="fcmd", description="极速 python 工具集。")
+    parser.add_argument("-V", "--version", action="version", version=f"%(prog)s {__version__}")
+    return parser
+
+
+def main() -> None:
+    """主入口，解析参数并执行."""
+    _build_parser().parse_args()
+
+
+if __name__ == "__main__":
+    main()

fcmd-0.1.0.dist-info/METADATA

@@ -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

fcmd-0.1.0.dist-info/RECORD

@@ -0,0 +1,8 @@
+fcmd/__init__.py,sha256=FMDBZXgRBbr7FFaT2ns5LG0QqgAWaswG1rDAypsCge0,127
+fcmd/cli.py,sha256=u2fCNn_PFgyA0nORwwE0dy20BwnI_8eb7RdRkD56eNU,555
+fcmd/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+fcmd-0.1.0.dist-info/METADATA,sha256=6pnP_UEHKUVfgJ3KYxhiXiOUbKFoRGOvFWbxYcOeghs,3834
+fcmd-0.1.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+fcmd-0.1.0.dist-info/entry_points.txt,sha256=2cDG2hclR7g_9St_2ZDhwDdcL-G2ZhcA58MISY5K4ls,39
+fcmd-0.1.0.dist-info/licenses/LICENSE,sha256=TPWFvKEsDvHD0Qow9-dutgWZ2vS5BD0e94IZhrcbw44,1069
+fcmd-0.1.0.dist-info/RECORD,,

fcmd-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.27.0
+Root-Is-Purelib: true
+Tag: py3-none-any

fcmd-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+fcmd = fcmd.cli:main

fcmd-0.1.0.dist-info/licenses/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.