abtbb 0.0.1__py3-none-any.whl

abt/__init__.py

@@ -0,0 +1 @@
+# -*- coding:UTF-8 -*-

abt/utils/__init__.py

@@ -0,0 +1 @@
+# -*- coding:UTF-8 -*-

abtbb-0.0.1.dist-info/METADATA

@@ -0,0 +1,111 @@
+Metadata-Version: 2.5
+Name: abtbb
+Version: 0.0.1
+Summary: abt：一个自己也能读懂、自己也能维护的 Python 底层工具包
+Project-URL: Homepage, https://github.com/yanyue/abt
+Author: yayo
+License: MIT
+License-File: LICENSE
+Keywords: library,toolkit,utility
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+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
+Requires-Python: >=3.7
+Requires-Dist: typing-extensions<4.8,>=4.0; python_version < '3.8'
+Requires-Dist: typing-extensions>=4.0; python_version >= '3.8'
+Description-Content-Type: text/markdown
+
+# abt
+
+> 一个自己也能读懂、自己也能维护的 Python 底层工具包。
+
+## 这是什么
+
+`abt` 是对既有工具包 `apiboot` 的**从零重写**。
+
+`apiboot` 的功能是 OK 的，但它几乎全部由 AI 生成：代码量涨得很快，却没有一个字是「自己先想清楚再落笔」的。结果是大量冗余封装、过度抽象，作者本人也读不懂——下游项目一旦出问题，除了「再问一次 AI」没有第二条路。
+
+`abt` 重写它，**验收标准不是功能跑通，而是作者本人能在不询问任何 AI 的情况下，读懂并定位任意一个函数的实现与问题。**
+
+## 两条硬规则
+
+1. **不包装 stdlib**。`pathlib` / `datetime` / `json` 能直接用就直接用，只在语义上做了收敛或增强时才封装。
+2. **一次只做一个模块**。每个函数要能一句话说清，docstring 写「为什么」和「不变量」，不写「做了什么」。
+
+## 特色：第三方依赖全部懒加载
+
+`abt` 的**运行时第三方依赖为零**。
+
+```bash
+pip install abt   # 不会顺带装 requests / sqlalchemy / redis
+```
+
+- `import abt` 和 `import abt.<任意子模块>` **绝不会**因为环境里缺某个第三方包而报错。
+- 只有真正**调用到**用到它的那个函数时才会失败，报错信息里会写清楚缺哪个包、为什么要装它、`pip install` 命令是什么。
+
+换句话说，装了不炸；缺依赖在调用点才暴露，而不是在 import 阶段就让整个服务起不来。
+
+## 运行环境
+
+- **Python 3.7+**（最低 3.7；开发环境 3.11）
+- 3.7 的语法下限由 `vermin` 把关：`uv run vermin --target=3.7- --violations abt/` 必须始终通过
+
+## 设计文档
+
+完整的出发点、验收标准、`apiboot` 模块构成、已知坑位清单、重写路线图，都在 [CLAUDE.md](CLAUDE.md) 里。
+
+## 安装
+
+```bash
+uv add abtbb
+```
+
+```python
+from abt import logger
+```
+
+> **发布名 ≠ import 名。** PyPI 上的 `abt` 已被他人占用，所以发布名用 `abtbb`；但 import 名仍是 `abt`——它由包目录名决定，跟发布名无关。
+> （`pip install pillow` → `import PIL` 同理。）
+
+本地开发：
+
+```bash
+uv sync          # 装依赖（含 dev group：pytest / mypy / ruff / vermin）
+uv run pytest    # 跑测试
+uv run mypy abt  # 静态检查
+uv run ruff check .
+uv run vermin --target=3.7- --violations abt/   # Python 3.7 语法下限闸门
+```
+
+## 命令行
+
+```bash
+abtrun --help
+```
+
+> 命令名用 `abtrun` 而非 `abt`——`abt` 已被 `apiboot` 的 CLI 占用，两个包共存时会互相覆盖 PATH。
+
+## 发布到 PyPI
+
+```bash
+uv sync                                          # 装齐工具链(含 twine)
+python scripts/upload_pypi.py                    # 构建 + 输入 token + 确认上传
+python scripts/upload_pypi.py --dry-run          # 只构建, 不上传, 不用输 token
+python scripts/upload_pypi.py --repository testpypi   # 先发测试仓库试水
+```
+
+流程：清理旧 `dist/` → 重新构建 sdist + wheel → 预检版本号是否已存在 → 提示输入 PyPI API Token（输入不回显，不落盘不进 shell history）→ 询问 `y/n` 确认 → 上传。
+
+Token 申请：<https://pypi.org/manage/account/token/>，用户名固定 `__token__`。
+
+> 同一版本号不能重复发布，报错前请把 `pyproject.toml` 里的 `version` 改大一位。
+
+## License
+
+MIT

abtbb-0.0.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+abt/__init__.py,sha256=YNz7Q28dOfKaQaH-o3INsqQKz_saZMWlozG0SWmCFTk,23
+abt/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+abt/utils/__init__.py,sha256=YNz7Q28dOfKaQaH-o3INsqQKz_saZMWlozG0SWmCFTk,23
+abtbb-0.0.1.dist-info/METADATA,sha256=MlTdHLTpBSr2dl3yXcBRGvb-s4bA3CHE0ifP2TjtYjU,4311
+abtbb-0.0.1.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+abtbb-0.0.1.dist-info/entry_points.txt,sha256=04GJdWX_JIixiLmdu-IX1heRd2zV0T_s0Qiht9V0r2g,40
+abtbb-0.0.1.dist-info/licenses/LICENSE,sha256=RQHSR72-YFlBW8ikm6xPXGR_BXpHMq6PmfhqRPW_Fw4,1061
+abtbb-0.0.1.dist-info/RECORD,,

abtbb-0.0.1.dist-info/WHEEL

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

abtbb-0.0.1.dist-info/entry_points.txt

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

abtbb-0.0.1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 yayo
+
+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.