top369 0.0.1__tar.gz

top369-0.0.1/LICENSE

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

top369-0.0.1/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: top369
+Version: 0.0.1
+Summary: top369 - a minimal, dependency-free Python package.
+Author: top369 maintainers
+License-Expression: MIT
+Keywords: top369
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# top369
+
+一个最小化、零依赖的 Python 包骨架，可直接发布到 PyPI。
+
+- 版本：0.0.1（Pre-Alpha）
+- 依赖：无
+- 支持：Python >= 3.9
+
+## 为什么不做纯空包？
+
+PyPI 的官方策略明确把「空包占名」列为无效项目：
+
+> **Invalid projects** … project is name squatting (**package has no functionality or is empty**) …
+> 这类项目会被直接从索引中移除。
+> —— <https://docs.pypi.org/project-management/name-retention/>
+
+也就是说，一个只含空 `__init__.py` 的包随时可能被管理员删掉，白忙一场。所以这里的做法是：
+**保持体积最小的同时让它是一个真实可用的包**——能 import、有公开 API、有命令行入口、有测试。
+这样它就不落进 "no functionality or is empty" 的判定里，名字也才真正守得住。
+
+## 发布前先改这几处
+
+1. `pyproject.toml` 里的 `description`、`authors`，以及被注释掉的 `[project.urls]`（填上仓库地址）。
+2. `LICENSE` 里的版权主体。
+3. `README.md` 改成你项目真正的内容。
+
+## 本地安装与使用
+
+```bash
+python -m pip install -e .
+python -m top369          # 打印包信息（JSON）
+python -m top369 --version
+top369                    # console script
+```
+
+跑测试：
+
+```bash
+python -m pip install pytest
+python -m pytest -q
+```
+
+## 发布到 PyPI
+
+前置：注册 PyPI 账号并**开启两步验证**（PyPI 强制要求），然后在
+<https://pypi.org/manage/account/token/> 创建 API token。
+
+```bash
+# 1) 安装构建与上传工具
+python -m pip install --upgrade build twine
+
+# 2) 清理旧产物并构建（会在 dist/ 生成 .tar.gz 与 .whl）
+rm -rf dist build src/*.egg-info
+python -m build
+
+# 3) 先上传到 TestPyPI 试一遍（强烈建议）
+python -m twine upload --repository testpypi dist/*
+
+# 4) 确认无误后上传正式 PyPI
+python -m twine upload dist/*
+```
+
+上传时：
+- 用户名填 `__token__`
+- 密码填 `pypi-` 开头的 token 原文
+
+也可以写进 `~/.pypirc` 免得每次输入：
+
+```ini
+[distutils]
+index-servers =
+    pypi
+    testpypi
+
+[pypi]
+username = __token__
+password = pypi-xxxxxxxx
+
+[testpypi]
+repository = https://test.pypi.org/legacy/
+username = __token__
+password = pypi-xxxxxxxx
+```
+
+> 注意：**PyPI 上的版本号只能前进不能复用**。同一个版本号即使删除后也无法重新上传，
+> 所以每次改动记得升 `version`。
+
+## 名字被占了怎么办？
+
+PyPI 不做"占名"服务，但如果原持有者符合"被弃用"条件（联系不上 + 12 个月无发布 + 主页无活动），
+可以走 PEP 541 流程申请转移：在 <https://github.com/pypi/support/issues> 用
+`Name retention related request (PEP 541)` 模板提交。
+
+## 目录结构
+
+```
+top369/
+├─ pyproject.toml          # 包元数据 + 构建配置
+├─ README.md               # 本文件（即 PyPI 项目页的正文）
+├─ LICENSE                 # MIT
+├─ .gitignore
+├─ src/top369/
+│  ├─ __init__.py          # 公开 API：__version__ / info()
+│  ├─ __main__.py          # CLI 入口
+│  └─ py.typed             # 声明带类型标注
+└─ tests/test_smoke.py
+```
+
+## License
+
+MIT

top369-0.0.1/README.md

@@ -0,0 +1,111 @@
+# top369
+
+一个最小化、零依赖的 Python 包骨架，可直接发布到 PyPI。
+
+- 版本：0.0.1（Pre-Alpha）
+- 依赖：无
+- 支持：Python >= 3.9
+
+## 为什么不做纯空包？
+
+PyPI 的官方策略明确把「空包占名」列为无效项目：
+
+> **Invalid projects** … project is name squatting (**package has no functionality or is empty**) …
+> 这类项目会被直接从索引中移除。
+> —— <https://docs.pypi.org/project-management/name-retention/>
+
+也就是说，一个只含空 `__init__.py` 的包随时可能被管理员删掉，白忙一场。所以这里的做法是：
+**保持体积最小的同时让它是一个真实可用的包**——能 import、有公开 API、有命令行入口、有测试。
+这样它就不落进 "no functionality or is empty" 的判定里，名字也才真正守得住。
+
+## 发布前先改这几处
+
+1. `pyproject.toml` 里的 `description`、`authors`，以及被注释掉的 `[project.urls]`（填上仓库地址）。
+2. `LICENSE` 里的版权主体。
+3. `README.md` 改成你项目真正的内容。
+
+## 本地安装与使用
+
+```bash
+python -m pip install -e .
+python -m top369          # 打印包信息（JSON）
+python -m top369 --version
+top369                    # console script
+```
+
+跑测试：
+
+```bash
+python -m pip install pytest
+python -m pytest -q
+```
+
+## 发布到 PyPI
+
+前置：注册 PyPI 账号并**开启两步验证**（PyPI 强制要求），然后在
+<https://pypi.org/manage/account/token/> 创建 API token。
+
+```bash
+# 1) 安装构建与上传工具
+python -m pip install --upgrade build twine
+
+# 2) 清理旧产物并构建（会在 dist/ 生成 .tar.gz 与 .whl）
+rm -rf dist build src/*.egg-info
+python -m build
+
+# 3) 先上传到 TestPyPI 试一遍（强烈建议）
+python -m twine upload --repository testpypi dist/*
+
+# 4) 确认无误后上传正式 PyPI
+python -m twine upload dist/*
+```
+
+上传时：
+- 用户名填 `__token__`
+- 密码填 `pypi-` 开头的 token 原文
+
+也可以写进 `~/.pypirc` 免得每次输入：
+
+```ini
+[distutils]
+index-servers =
+    pypi
+    testpypi
+
+[pypi]
+username = __token__
+password = pypi-xxxxxxxx
+
+[testpypi]
+repository = https://test.pypi.org/legacy/
+username = __token__
+password = pypi-xxxxxxxx
+```
+
+> 注意：**PyPI 上的版本号只能前进不能复用**。同一个版本号即使删除后也无法重新上传，
+> 所以每次改动记得升 `version`。
+
+## 名字被占了怎么办？
+
+PyPI 不做"占名"服务，但如果原持有者符合"被弃用"条件（联系不上 + 12 个月无发布 + 主页无活动），
+可以走 PEP 541 流程申请转移：在 <https://github.com/pypi/support/issues> 用
+`Name retention related request (PEP 541)` 模板提交。
+
+## 目录结构
+
+```
+top369/
+├─ pyproject.toml          # 包元数据 + 构建配置
+├─ README.md               # 本文件（即 PyPI 项目页的正文）
+├─ LICENSE                 # MIT
+├─ .gitignore
+├─ src/top369/
+│  ├─ __init__.py          # 公开 API：__version__ / info()
+│  ├─ __main__.py          # CLI 入口
+│  └─ py.typed             # 声明带类型标注
+└─ tests/test_smoke.py
+```
+
+## License
+
+MIT

top369-0.0.1/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "top369"
+version = "0.0.1"
+description = "top369 - a minimal, dependency-free Python package."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "top369 maintainers" }]
+keywords = ["top369"]
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.scripts]
+top369 = "top369.__main__:main"
+
+# TODO 发布前填上你自己的仓库地址，例如：
+# [project.urls]
+# Homepage = "https://github.com/<you>/top369"
+# Repository = "https://github.com/<you>/top369"
+# Issues = "https://github.com/<you>/top369/issues"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+top369 = ["py.typed"]

top369-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

top369-0.0.1/src/top369/__init__.py

@@ -0,0 +1,28 @@
+"""top369 - a minimal, dependency-free Python package.
+
+This is an intentionally tiny but *real* package: it imports, it exposes a
+documented API, it ships a console script, and it has a test suite. Keeping it
+real (rather than an empty placeholder) is deliberate - see "为什么不做纯空包"
+in README.md.
+"""
+
+from __future__ import annotations
+
+__all__ = ["__version__", "info"]
+
+__version__ = "0.0.1"
+
+_SUMMARY = "top369 - a minimal, dependency-free Python package."
+
+
+def info() -> dict[str, str]:
+    """Return basic metadata about this package as a plain dict.
+
+    Returns:
+        A dict with the keys ``name``, ``version`` and ``summary``.
+    """
+    return {
+        "name": "top369",
+        "version": __version__,
+        "summary": _SUMMARY,
+    }

top369-0.0.1/src/top369/__main__.py

@@ -0,0 +1,34 @@
+"""Command line entry point: ``python -m top369`` / ``top369``."""
+
+from __future__ import annotations
+
+import json
+import sys
+
+from . import __version__, info
+
+USAGE = "usage: top369 [-h | --version]"
+
+
+def main(argv: list[str] | None = None) -> int:
+    """Run the CLI. Returns a process exit code."""
+    args = list(sys.argv[1:] if argv is None else argv)
+
+    if args:
+        flag = args[0]
+        if flag in {"-h", "--help"}:
+            print(USAGE)
+            return 0
+        if flag in {"-V", "--version"}:
+            print(__version__)
+            return 0
+        print(f"top369: unrecognized argument: {flag}", file=sys.stderr)
+        print(USAGE, file=sys.stderr)
+        return 2
+
+    print(json.dumps(info(), indent=2, ensure_ascii=False))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

top369-0.0.1/src/top369.egg-info/PKG-INFO

@@ -0,0 +1,130 @@
+Metadata-Version: 2.4
+Name: top369
+Version: 0.0.1
+Summary: top369 - a minimal, dependency-free Python package.
+Author: top369 maintainers
+License-Expression: MIT
+Keywords: top369
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# top369
+
+一个最小化、零依赖的 Python 包骨架，可直接发布到 PyPI。
+
+- 版本：0.0.1（Pre-Alpha）
+- 依赖：无
+- 支持：Python >= 3.9
+
+## 为什么不做纯空包？
+
+PyPI 的官方策略明确把「空包占名」列为无效项目：
+
+> **Invalid projects** … project is name squatting (**package has no functionality or is empty**) …
+> 这类项目会被直接从索引中移除。
+> —— <https://docs.pypi.org/project-management/name-retention/>
+
+也就是说，一个只含空 `__init__.py` 的包随时可能被管理员删掉，白忙一场。所以这里的做法是：
+**保持体积最小的同时让它是一个真实可用的包**——能 import、有公开 API、有命令行入口、有测试。
+这样它就不落进 "no functionality or is empty" 的判定里，名字也才真正守得住。
+
+## 发布前先改这几处
+
+1. `pyproject.toml` 里的 `description`、`authors`，以及被注释掉的 `[project.urls]`（填上仓库地址）。
+2. `LICENSE` 里的版权主体。
+3. `README.md` 改成你项目真正的内容。
+
+## 本地安装与使用
+
+```bash
+python -m pip install -e .
+python -m top369          # 打印包信息（JSON）
+python -m top369 --version
+top369                    # console script
+```
+
+跑测试：
+
+```bash
+python -m pip install pytest
+python -m pytest -q
+```
+
+## 发布到 PyPI
+
+前置：注册 PyPI 账号并**开启两步验证**（PyPI 强制要求），然后在
+<https://pypi.org/manage/account/token/> 创建 API token。
+
+```bash
+# 1) 安装构建与上传工具
+python -m pip install --upgrade build twine
+
+# 2) 清理旧产物并构建（会在 dist/ 生成 .tar.gz 与 .whl）
+rm -rf dist build src/*.egg-info
+python -m build
+
+# 3) 先上传到 TestPyPI 试一遍（强烈建议）
+python -m twine upload --repository testpypi dist/*
+
+# 4) 确认无误后上传正式 PyPI
+python -m twine upload dist/*
+```
+
+上传时：
+- 用户名填 `__token__`
+- 密码填 `pypi-` 开头的 token 原文
+
+也可以写进 `~/.pypirc` 免得每次输入：
+
+```ini
+[distutils]
+index-servers =
+    pypi
+    testpypi
+
+[pypi]
+username = __token__
+password = pypi-xxxxxxxx
+
+[testpypi]
+repository = https://test.pypi.org/legacy/
+username = __token__
+password = pypi-xxxxxxxx
+```
+
+> 注意：**PyPI 上的版本号只能前进不能复用**。同一个版本号即使删除后也无法重新上传，
+> 所以每次改动记得升 `version`。
+
+## 名字被占了怎么办？
+
+PyPI 不做"占名"服务，但如果原持有者符合"被弃用"条件（联系不上 + 12 个月无发布 + 主页无活动），
+可以走 PEP 541 流程申请转移：在 <https://github.com/pypi/support/issues> 用
+`Name retention related request (PEP 541)` 模板提交。
+
+## 目录结构
+
+```
+top369/
+├─ pyproject.toml          # 包元数据 + 构建配置
+├─ README.md               # 本文件（即 PyPI 项目页的正文）
+├─ LICENSE                 # MIT
+├─ .gitignore
+├─ src/top369/
+│  ├─ __init__.py          # 公开 API：__version__ / info()
+│  ├─ __main__.py          # CLI 入口
+│  └─ py.typed             # 声明带类型标注
+└─ tests/test_smoke.py
+```
+
+## License
+
+MIT

top369-0.0.1/src/top369.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+LICENSE
+README.md
+pyproject.toml
+src/top369/__init__.py
+src/top369/__main__.py
+src/top369/py.typed
+src/top369.egg-info/PKG-INFO
+src/top369.egg-info/SOURCES.txt
+src/top369.egg-info/dependency_links.txt
+src/top369.egg-info/entry_points.txt
+src/top369.egg-info/top_level.txt
+tests/test_smoke.py

top369-0.0.1/src/top369.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

top369-0.0.1/src/top369.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+top369 = top369.__main__:main

top369-0.0.1/src/top369.egg-info/top_level.txt

@@ -0,0 +1 @@
+top369

top369-0.0.1/tests/test_smoke.py

@@ -0,0 +1,26 @@
+import json
+
+from top369 import __version__, info
+from top369.__main__ import main
+
+
+def test_info_matches_version():
+    data = info()
+    assert data["name"] == "top369"
+    assert data["version"] == __version__
+
+
+def test_cli_version(capsys):
+    assert main(["--version"]) == 0
+    assert capsys.readouterr().out.strip() == __version__
+
+
+def test_cli_default_prints_json(capsys):
+    assert main([]) == 0
+    payload = json.loads(capsys.readouterr().out)
+    assert payload["name"] == "top369"
+
+
+def test_cli_rejects_unknown_flag(capsys):
+    assert main(["--nope"]) == 2
+    assert "unrecognized" in capsys.readouterr().err