Metadata-Version: 2.4
Name: auth-client-sdk
Version: 0.1.0
Summary: 授权管理系统客户端 SDK（支持授权码/离线许可证/混合模式，带 ECDSA 验签与防篡改）
Author: Auth Team
License: Proprietary
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: License :: Other/Proprietary License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.8
Description-Content-Type: text/x-rst
Requires-Dist: requests>=2.28
Requires-Dist: cryptography>=41.0.0
Provides-Extra: tests
Requires-Dist: pytest>=7; extra == "tests"
Requires-Dist: pytest-mock>=3; extra == "tests"

auth-client-sdk
===============

授权管理系统客户端 SDK，支持三种授权模式：

* **授权码模式（AUTH_CODE）**：在线校验授权码，返回离线 Token 缓存
* **许可证文件模式（LICENSE）**：本地 + 在线双重校验许可证文件
* **混合模式（COMBINED）**：授权码激活生成许可证文件

核心特性
--------

* Cython 编译核心模块，防逆向与篡改自检（MD5 校验）
* ES256 (ECDSA P-256) 离线 Token 验签
* 设备指纹绑定（机器 ID + MAC + 系统盘卷序列号）
* 时钟回拨检测
* 自动静默续期（离线 TTL ≤ 1 天触发）
* 完善的错误层级（15 种业务错误子类）

快速开始
--------

示例见 ``examples/`` 目录：

* ``mode_a_auth_code.py`` — 授权码模式
* ``mode_b_license_file.py`` — 许可证文件模式
* ``mode_c_combined.py`` — 混合模式

构建与发布
----------

Windows::

    powershell -ExecutionPolicy Bypass -File scripts/build_and_cythonize.ps1

Linux / macOS::

    bash scripts/build_and_cythonize.sh

脚本会依次：清理旧产物 → Cython 编译扩展 → 注入核心二进制 MD5 → 构建 wheel。
最后请手动执行 devpi 上传到私有化仓库。
