pyflowx 0.1.1__tar.gz

pyflowx-0.1.1/.github/workflows/ci.yml

@@ -0,0 +1,138 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  # ─────────────────────────────────────────────────────────────
+  # lint：代码风格与格式检查（单平台即可）
+  # ─────────────────────────────────────────────────────────────
+  lint:
+    name: Lint (ruff)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: 安装 uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: latest
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: 设置 Python 3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: 安装依赖
+        run: uv sync --extra dev --frozen
+
+      - name: Ruff 检查
+        run: uv run ruff check src tests examples
+
+      - name: Ruff 格式检查
+        run: uv run ruff format --check src tests examples
+
+  # ─────────────────────────────────────────────────────────────
+  # typecheck：mypy 严格类型检查
+  # ─────────────────────────────────────────────────────────────
+  typecheck:
+    name: Typecheck (mypy)
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: 安装 uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: latest
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: 设置 Python 3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: 安装依赖
+        run: uv sync --extra dev --frozen
+
+      - name: Mypy 严格类型检查
+        run: uv run mypy
+
+  # ─────────────────────────────────────────────────────────────
+  # test：多平台 × 多 Python 版本矩阵测试 + 覆盖率
+  # ─────────────────────────────────────────────────────────────
+  test:
+    name: Test (${{ matrix.os }} / py${{ matrix.python-version }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python-version: ['3.8', '3.9', '3.10', '3.11', '3.12', '3.13']
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: 安装 uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: latest
+          enable-cache: true
+          cache-dependency-glob: uv.lock
+
+      - name: 设置 Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: 安装依赖
+        run: uv sync --extra dev --frozen
+
+      - name: 运行测试（含覆盖率，强制 100%）
+        run: uv run pytest -v --cov=pyflowx --cov-report=xml --cov-report=term-missing --cov-fail-under=100
+
+      - name: 运行示例冒烟测试
+        run: |
+          uv run python examples/etl_pipeline.py
+          uv run python examples/parallel_run.py
+          uv run python examples/async_aggregation.py
+
+      - name: 上传覆盖率
+        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.13'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-${{ matrix.os }}-py${{ matrix.python-version }}
+          path: coverage.xml
+          retention-days: 7
+
+  # ─────────────────────────────────────────────────────────────
+  # 聚合：所有检查通过后才标记完成
+  # ─────────────────────────────────────────────────────────────
+  ci-pass:
+    name: CI Pass
+    runs-on: ubuntu-latest
+    needs: [lint, typecheck, test]
+    if: always()
+    steps:
+      - name: 检查依赖任务结果
+        if: ${{ needs.lint.result != 'success' || needs.typecheck.result != 'success' || needs.test.result != 'success' }}
+        run: |
+          echo "lint: ${{ needs.lint.result }}"
+          echo "typecheck: ${{ needs.typecheck.result }}"
+          echo "test: ${{ needs.test.result }}"
+          exit 1
+      - name: 全部通过
+        run: echo "✅ 所有 CI 检查通过"

pyflowx-0.1.1/.github/workflows/release.yml

@@ -0,0 +1,193 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: '发布版本号（如 v0.1.0）'
+        required: true
+        type: string
+
+permissions:
+  contents: write
+  # Trusted Publishing (OIDC) 上传 PyPI 所需
+  id-token: write
+
+jobs:
+  # ─────────────────────────────────────────────────────────────
+  # 预检：版本号校验 + 与 pyproject.toml 一致性检查
+  # ─────────────────────────────────────────────────────────────
+  pre-check:
+    name: Pre-release Check
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.meta.outputs.version }}
+      tag: ${{ steps.meta.outputs.tag }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: 解析版本号
+        id: meta
+        run: |
+          if [ -n "${{ inputs.tag }}" ]; then
+            TAG="${{ inputs.tag }}"
+          else
+            TAG="${GITHUB_REF#refs/tags/}"
+          fi
+          # 去除前缀 v
+          VERSION="${TAG#v}"
+          echo "tag=$TAG" >> $GITHUB_OUTPUT
+          echo "version=$VERSION" >> $GITHUB_OUTPUT
+          echo "发布版本: $VERSION (tag: $TAG)"
+
+      - name: 校验版本号格式
+        run: |
+          VERSION="${{ steps.meta.outputs.version }}"
+          if ! echo "$VERSION" | grep -qE '^[0-9]+\.[0-9]+\.[0-9]+(-[a-zA-Z0-9.]+)?$'; then
+            echo "❌ 版本号格式错误: $VERSION（应为 x.y.z 或 x.y.z-rc.n）"
+            exit 1
+          fi
+
+      - name: 校验 pyproject.toml 版本一致
+        run: |
+          # 精确提取 [project] 段的 version 字段（避免匹配到依赖的 version）
+          PY_VERSION=$(awk '/^\[project\]/{f=1} f&&/^version[[:space:]]*=/{gsub(/[" ]/,"",$3); print $3; exit}' pyproject.toml)
+          echo "pyproject.toml version: $PY_VERSION"
+          if [ "$PY_VERSION" != "${{ steps.meta.outputs.version }}" ]; then
+            echo "❌ pyproject.toml 版本($PY_VERSION) 与 tag 版本(${{ steps.meta.outputs.version }}) 不一致"
+            echo "请先更新 pyproject.toml 中的 version 字段"
+            exit 1
+          fi
+
+  # ─────────────────────────────────────────────────────────────
+  # 构建：wheel + sdist（纯 Python，单平台即可）
+  # ─────────────────────────────────────────────────────────────
+  build:
+    name: Build Artifacts
+    needs: pre-check
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: 安装 uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          version: latest
+          enable-cache: true
+
+      - name: 设置 Python 3.13
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.13'
+
+      - name: 安装依赖
+        run: uv sync --extra dev --frozen
+
+      - name: 构建 wheel + sdist
+        run: uv build
+
+      - name: 校验产物
+        run: |
+          echo "待上传产物："
+          ls -la dist/
+          if [ -z "$(ls -A dist/*.whl dist/*.tar.gz 2>/dev/null)" ]; then
+            echo "❌ 未找到 wheel 或 sdist 产物"
+            exit 1
+          fi
+
+      - name: 上传构建产物
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/*
+          retention-days: 30
+
+  # ─────────────────────────────────────────────────────────────
+  # 发布：上传到 PyPI（Trusted Publishing / OIDC）
+  # ─────────────────────────────────────────────────────────────
+  publish-pypi:
+    name: Publish to PyPI
+    needs: [pre-check, build]
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/pyflowx/${{ needs.pre-check.outputs.version }}
+    permissions:
+      id-token: write
+    steps:
+      - name: 下载构建产物
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist
+
+      - name: 上传到 PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          attestations: true
+
+  # ─────────────────────────────────────────────────────────────
+  # 发布：创建 GitHub Release
+  # ─────────────────────────────────────────────────────────────
+  release:
+    name: Publish Release
+    needs: [pre-check, build, publish-pypi]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: 下载构建产物
+        uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: assets
+
+      - name: 整理发布产物
+        run: |
+          ls -la assets/
+
+      - name: 生成 Release Notes
+        id: notes
+        run: |
+          {
+            echo "## pyflowx ${{ needs.pre-check.outputs.version }}"
+            echo ""
+            echo "### 下载"
+            echo ""
+            echo "- **Wheel**: \`pyflowx-${{ needs.pre-check.outputs.version }}-py3-none-any.whl\`"
+            echo "- **源码包**: \`pyflowx-${{ needs.pre-check.outputs.version }}.tar.gz\`"
+            echo ""
+            echo "### 安装"
+            echo ""
+            echo '```bash'
+            echo "pip install pyflowx==${{ needs.pre-check.outputs.version }}"
+            echo '```'
+            echo ""
+            echo "### 完整变更日志"
+          } > RELEASE_NOTES.md
+          {
+            echo "content<<EOF"
+            cat RELEASE_NOTES.md
+            echo "EOF"
+          } >> $GITHUB_OUTPUT
+
+      - name: 创建 GitHub Release
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ needs.pre-check.outputs.tag }}
+          name: pyflowx ${{ needs.pre-check.outputs.version }}
+          body: ${{ steps.notes.outputs.content }}
+          files: assets/*
+          draft: false
+          prerelease: ${{ contains(needs.pre-check.outputs.version, '-') }}
+          generate_release_notes: true

pyflowx-0.1.1/.gitignore

@@ -0,0 +1,11 @@
+# Python-generated files
+__pycache__/
+*.py[oc]
+build/
+dist/
+wheels/
+*.egg-info
+
+# Virtual environments
+.venv
+.coverage

pyflowx-0.1.1/.pre-commit-config.yaml

@@ -0,0 +1,22 @@
+# prek compatible configuration
+# See https://pre-commit.com for more information
+repos:
+  - repo: https://gitcode.com/gh_mirrors/ru/ruff-pre-commit.git
+    # Ruff version - keep in sync with pyproject.toml
+    rev: v0.15.4
+    hooks:
+      # Run the linter
+      - id: ruff
+        args: [ --fix, --exit-non-zero-on-fix ]
+      # Run the formatter
+      - id: ruff-format
+        args: [ --config=pyproject.toml]
+  - repo: https://gitcode.com/gh_mirrors/pr/pre-commit-hooks.git
+    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

pyflowx-0.1.1/.python-version

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

pyflowx-0.1.1/.vscode/settings.json

@@ -0,0 +1,36 @@
+{
+    "[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.columnWidth": 120,
+    "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"
+}

pyflowx-0.1.1/PKG-INFO

@@ -0,0 +1,274 @@
+Metadata-Version: 2.4
+Name: pyflowx
+Version: 0.1.1
+Summary: Lightweight, type-safe DAG task scheduler with multi-strategy execution.
+Author: pyflowx
+License: MIT
+Keywords: async,dag,scheduler,task,workflow
+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: Topic :: Software Development :: Libraries :: Application Frameworks
+Requires-Python: >=3.8
+Requires-Dist: graphlib-backport>=1.0.0; python_version < '3.9'
+Provides-Extra: dev
+Requires-Dist: hatch>=1.14.2; extra == 'dev'
+Requires-Dist: httpx>=0.28.0; extra == 'dev'
+Requires-Dist: mypy>=1.0; extra == 'dev'
+Requires-Dist: prek>=0.4.5; 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-mock>=3.14.0; 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'
+Description-Content-Type: text/markdown
+
+# PyFlowX
+
+> 轻量、类型安全的 DAG 任务调度器。
+
+[![CI](https://github.com/pyflowx/pyflowx/actions/workflows/ci.yml/badge.svg)](https://github.com/pyflowx/pyflowx/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/pyflowx.svg)](https://pypi.org/project/pyflowx/)
+[![Python](https://img.shields.io/pypi/pyversions/pyflowx.svg)](https://pypi.org/project/pyflowx/)
+[![Coverage](https://img.shields.io/badge/coverage-100%25-brightgreen.svg)](https://github.com/pyflowx/pyflowx)
+[![License](https://img.shields.io/pypi/l/pyflowx.svg)](https://github.com/pyflowx/pyflowx/blob/main/LICENSE)
+
+PyFlowX 把"任务依赖"这件事做到极致简单：**参数名就是依赖声明**。无需装饰器、
+无需样板包装器，写一个普通函数，框架按参数名自动注入上游结果。
+
+## 特性
+
+- **零样板** —— 参数名即依赖，框架自动注入上游结果
+- **三种执行策略** —— `sequential`（调试）/ `thread`（I/O 密集同步）/ `async`（I/O 密集异步）
+- **类型安全** —— `TaskSpec[T]` 把返回类型一路传到 `RunReport`，mypy strict 通过
+- **DAG 校验** —— 构建时即时校验重名、缺失依赖、环
+- **自动分层** —— Kahn 算法分组，同层任务可并行
+- **重试与超时** —— 每个任务独立配置 `retries` 与 `timeout`
+- **断点续跑** —— `MemoryBackend` / `JSONBackend`，成功结果可缓存复用
+- **可观测** —— `on_event` 回调、`dry_run` 预览、Mermaid 可视化
+- **零运行时依赖** —— 仅依赖标准库（3.8 需 `graphlib_backport`）
+- **100% 测试覆盖** —— 分支覆盖率达 100%
+
+## 安装
+
+```bash
+pip install pyflowx
+```
+
+或使用 [uv](https://docs.astral.sh/uv/)：
+
+```bash
+uv add pyflowx
+```
+
+## 快速上手
+
+```python
+import pyflowx as px
+
+def extract() -> list[int]:
+    return [1, 2, 3]
+
+# 参数名 extract 自动匹配上游任务名 → 自动注入
+def double(extract: list[int]) -> list[int]:
+    return [x * 2 for x in extract]
+
+graph = px.Graph.from_specs([
+    px.TaskSpec("extract", extract),
+    px.TaskSpec("double", double, ("extract",)),
+])
+
+report = px.run(graph, strategy="sequential")
+print(report["double"])  # [2, 4, 6]
+```
+
+## 核心概念
+
+### TaskSpec —— 任务描述
+
+`TaskSpec` 是不可变的任务描述符，是唯一需要配置的东西：
+
+```python
+px.TaskSpec(
+    name="fetch_user",           # 唯一标识
+    fn=fetch_user,               # 同步或异步函数
+    depends_on=("auth",),        # 依赖的任务名
+    args=(uid,),                 # 静态位置参数（追加在注入参数后）
+    kwargs={"timeout": 30},      # 静态关键字参数
+    retries=3,                   # 失败重试次数（0 = 仅一次）
+    timeout=30.0,                # 超时秒数（None = 不限制）
+    tags=("api", "user"),        # 自由标签，用于子图过滤
+)
+```
+
+### Graph —— DAG 构建
+
+```python
+graph = px.Graph.from_specs([...])   # 整批校验（推荐）
+# 或增量构建
+graph = px.Graph()
+graph.add(px.TaskSpec("a", fn_a))
+graph.add(px.TaskSpec("b", fn_b, ("a",)))
+
+graph.validate()              # 显式校验（环检测）
+graph.layers()                # 拓扑分层
+graph.to_mermaid()            # Mermaid 可视化
+graph.describe()              # 人类可读摘要
+graph.subgraph(("api",))      # 按标签切片
+graph.subgraph_by_names(("a", "b"))  # 按名称切片
+```
+
+### run —— 执行
+
+```python
+report = px.run(
+    graph,
+    strategy="async",          # sequential | thread | async
+    max_workers=8,             # thread 策略的线程池大小
+    dry_run=False,             # True = 仅打印计划
+    on_event=callback,         # 状态转换回调
+    state=px.JSONBackend("state.json"),  # 断点续跑后端
+)
+```
+
+### RunReport —— 结果
+
+```python
+report["task_name"]            # 任务返回值
+report.result_of("task_name")  # 完整 TaskResult
+report.success                 # 整体是否成功
+report.summary()               # 统计字典
+report.failed_tasks()          # 失败任务名列表
+report.describe()              # 人类可读报告
+```
+
+## 上下文注入规则
+
+按顺序求值：
+
+1. **标注为 `Context`** 的参数 → 接收完整上游结果映射
+2. **名称匹配依赖** 的参数 → 接收该依赖的结果
+3. **`**kwargs`** 参数 → 接收所有依赖结果（dict）
+4. **`TaskSpec.args` / `kwargs`** → 为非依赖参数提供静态值
+
+```python
+from typing import Any, Dict
+
+def aggregate(ctx: px.Context) -> Dict[str, Any]:
+    """ctx 包含所有 depends_on 任务的返回值。"""
+    return dict(ctx)
+
+def merge(fetch_a: str, fetch_b: str) -> str:
+    """fetch_a / fetch_b 自动注入。"""
+    return fetch_a + fetch_b
+
+def fetch_user(uid: int) -> dict:  # uid 来自 TaskSpec.args
+    ...
+```
+
+## 执行策略对比
+
+| 策略 | 并发模型 | 适用场景 | 同步任务 | 异步任务 |
+|------|---------|---------|---------|---------|
+| `sequential` | 串行 | 调试、CPU 密集 | 直接调用 | 事件循环 |
+| `thread` | 线程池 | I/O 密集同步 | 线程池 | 不支持 |
+| `async` | 事件循环 | I/O 密集异步 | 卸载到线程池 | 事件循环 |
+
+所有策略都遵循 `retries`、`timeout`、上下文注入、状态后端，并发出 `TaskEvent`。
+
+## 示例
+
+仓库 `examples/` 目录包含完整示例：
+
+- [`etl_pipeline.py`](examples/etl_pipeline.py) —— ETL 流水线（sequential）
+- [`parallel_run.py`](examples/parallel_run.py) —— 并行执行对比（thread vs sequential）
+- [`async_aggregation.py`](examples/async_aggregation.py) —— 异步聚合 + Context 注入
+
+运行：
+
+```bash
+python examples/etl_pipeline.py
+python examples/parallel_run.py
+python examples/async_aggregation.py
+```
+
+## 断点续跑
+
+```python
+from pyflowx import JSONBackend
+
+# 第一次运行：成功结果写入 state.json
+backend = JSONBackend("state.json")
+report = px.run(graph, strategy="sequential", state=backend)
+
+# 第二次运行：已缓存任务自动跳过
+report = px.run(graph, strategy="sequential", state=backend)
+# report.results 中缓存任务状态为 SKIPPED
+```
+
+## 错误处理
+
+所有错误都是 `PyFlowXError` 的子类：
+
+| 错误 | 触发时机 |
+|------|---------|
+| `DuplicateTaskError` | 任务名重复注册 |
+| `MissingDependencyError` | 依赖了不存在的任务 |
+| `CycleError` | 依赖图存在环 |
+| `TaskFailedError` | 任务耗尽重试后仍失败 |
+| `TaskTimeoutError` | 任务超时 |
+| `InjectionError` | 上下文注入无法满足签名 |
+| `StorageError` | 状态后端持久化失败 |
+
+```python
+try:
+    report = px.run(graph, strategy="async")
+except px.TaskFailedError as exc:
+    print(f"{exc.task} 失败: {exc.cause}（尝试 {exc.attempts} 次）")
+except px.PyFlowXError:
+    # 捕获整个错误家族
+    raise
+```
+
+## 与其他库对比
+
+| 特性 | PyFlowX | Airflow | Prefect | Dask |
+|------|---------|---------|---------|------|
+| 零样板 | 参数名即依赖 | 装饰器 + XCom | 装饰器 | 装饰器 |
+| 运行时依赖 | 仅标准库 | 重型 | 中型 | 中型 |
+| 类型安全 | mypy strict | 弱 | 中 | 中 |
+| 异步原生 | 是 | 否 | 部分 | 否 |
+| 断点续跑 | 内置 | 需配置 | 需配置 | 需配置 |
+| 学习曲线 | 极低 | 高 | 中 | 中 |
+| 适用规模 | 单机 | 集群 | 单机/集群 | 集群 |
+
+PyFlowX 专注于**单机 DAG 调度**的极致简洁，适合 ETL、数据处理、CI 流水线等场景。
+
+## 开发
+
+```bash
+# 安装开发依赖
+uv sync --extra dev
+
+# 运行测试（含覆盖率）
+uv run pytest --cov=pyflowx --cov-fail-under=100
+
+# 类型检查
+uv run mypy
+
+# 代码风格
+uv run ruff check src tests examples
+uv run ruff format --check src tests examples
+```
+
+## 许可证
+
+MIT