Metadata-Version: 2.1
Name: eraflow
Version: 0.1.0a6
Summary: ERAF 协议的 Python 接入 SDK，统一提供身份与凭据自动安装、轮换恢复、Edge 请求验签、实时鉴权及运行状态诊断，简化服务的 External API 接入。
License: MIT
Project-URL: Repository, https://github.com/deepaint-ai/eraflow
Classifier: License :: OSI Approved :: MIT License
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3 :: Only
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Provides-Extra: fastapi
Provides-Extra: flask
Provides-Extra: dev
License-File: LICENSE
License-File: NOTICE

# eraflow

ERAF 公共 Python SDK：稳定双包生产/安装、Edge 集中准入的本地验证、正式凭据读取及运行诊断。

本版为 `0.1.0a6` Alpha，供隔离验证与下游接入评估；新增管理员显式只读依赖诊断，默认不探测，见 [Status](docs/status.md)。以下联合验证为 a5 已完成的历史证据，供隔离验证与下游接入评估。消费集中准入契约交付 1.0.2（原 Schema `$id` 保持 1.0.0，新增响应/空间覆盖 Schema 为 1.0.2），旧身份/证明不兼容。已完成实际 UAC 测试双包安装及真实 Edge 签名的隔离联合验证：100 个 HTTP/TLS 请求跨三轮根签状态均通过，SDK 业务链零控制面出网。SSO、领域业务及共享 replay 的测试替身边界见[最终联合回执](docs/central-admission-live-joint2-final-20261107.json)；这不代表现场生产验收或授权现场升级。

按宿主选择安装以下 Alpha 版本：

```console
python -m pip install "eraflow[flask]==0.1.0a6"
python -m pip install "eraflow[fastapi]==0.1.0a6"
```

最低 Python 3.7；完整文件安装支持 Windows/Linux。核心导入不启动任务、不联网、不隐式导入 Flask/FastAPI。MIT，见 LICENSE、NOTICE。

```python
from eraflow import Provider, ProviderOperation, prepare_external_target
from eraflow.flask import install_provider

# 目录由宿主软件静态定义，不能从请求或证明生成。
operation = ProviderOperation(
    "readExample", "read_example", ("GET",),
    scopes=("smai.example.read",), path_template="/external/example",
    capability_code="read", software_contract_sha256=software_contract_sha256,
)
```

宿主提供真实请求原字节、管理员保护、共享原子 replay 和领域事务。Flask 使用 `install_provider`；FastAPI 必须最外层 `wrap(app)`。Provider 不再为 External 认证/授权访问 SSO/UAC；单引导安装及按需确认维护单列。`Admission.recheck()` 保留写入最后可拒绝点。

[候选接口与边界](docs/01_central_admission.md) · [API](docs/api-reference.md) · [材料读取](docs/material-views.md) · [FastAPI](docs/fastapi.md) · [交接](docs/00_handoff.md)

发行记录（2026-11-07）：`v0.1.0a5` 已发布至 [GitHub Pre-release](https://github.com/deepaint-ai/eraflow/releases/tag/v0.1.0a5) 与[官方 PyPI](https://pypi.org/project/eraflow/0.1.0a5/)。精确源码提交 `ba30b8bba14322b7b1c92df1b6361326b613e5db`；实际制品摘要、官方双端下载及干净 Windows Python 3.7/3.13 安装验证见[正式发行回执](docs/release-v0.1.0a5.json)。现场业务仍未验收，不自动执行升级或启动。
