simple-demo-sdk

一个用于演示 打包发布到 PyPI 的完整流程 的极简 Python SDK。

特性

• SimpleClient：极简的 HTTP 客户端（基于 requests），支持 Bearer Token、上下文管理器
• slugify(text)：字符串转 URL slug
• chunked(iterable, size)：分批迭代器
• CLI 命令：simple-demo-sdk get <url> / simple-demo-sdk slug <text>

安装

pip install simple-demo-sdk

快速开始

from simple_demo_sdk import SimpleClient, slugify, chunked

print(slugify("Hello, PyPI World!"))   # -> hello-pypi-world
print(list(chunked(range(7), 3)))       # -> [[0,1,2],[3,4,5],[6]]

with SimpleClient(base_url="https://httpbin.org") as client:
    print(client.get("/get", params={"hello": "world"}))

本地开发

# 1. 创建虚拟环境
python -m venv .venv && source .venv/bin/activate

# 2. 可编辑安装 + 开发依赖
pip install -e ".[dev]"

# 3. 运行测试
pytest

打包与发布到 PyPI

# 1. 安装构建工具
pip install --upgrade build twine

# 2. 构建 sdist + wheel（产物在 dist/ 下）
python -m build

# 3. 检查产物
twine check dist/*

# 4. 上传到 TestPyPI（推荐先测试）
twine upload --repository testpypi dist/*

# 5. 从 TestPyPI 安装验证
pip install -i https://test.pypi.org/simple/ simple-demo-sdk

# 6. 正式上传到 PyPI
twine upload dist/*

关于凭证

推荐使用 API Token，配置 ~/.pypirc：

[distutils]
index-servers =
    pypi
    testpypi

[pypi]
username = __token__
password = pypi-AgEIcHlwaS5vcmc...你的 token

[testpypi]
repository = https://test.pypi.org/legacy/
username = __token__
password = pypi-AgENdGVzdC5weXBpLm9yZw...你的 token

许可证

MIT