sdk369 0.0.1__tar.gz

sdk369-0.0.1/LICENSE

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

sdk369-0.0.1/PKG-INFO

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: sdk369
+Version: 0.0.1
+Summary: sdk369 - a minimal, dependency-free Python package.
+Author: sdk369 maintainers
+License-Expression: MIT
+Keywords: sdk369
+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
+
+# sdk369
+
+一个最小化、零依赖的 Python 包，已发布到 PyPI。
+
+- 版本：0.0.1（Pre-Alpha）
+- 依赖：无
+- 支持：Python >= 3.9
+
+```bash
+pip install sdk369
+```
+
+> 名称说明：PyPI 会把 `sdk369`、`sdk-369`、`SDK369`、`sdk_369` 统统归一化成同一个项目名，
+> 所以占住 `sdk369` 等于把这几种写法一起占了。
+
+## 为什么不做纯空包？
+
+PyPI 官方策略把「空包占名」列为无效项目：
+
+> **Invalid projects** … project is name squatting (**package has no functionality or is empty**) …
+> 这类项目会被直接从索引中移除。
+> —— <https://docs.pypi.org/project-management/name-retention/>
+
+所以这里的做法是：保持体积最小的同时让它是一个真实可用的包——
+能 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 sdk369          # 打印包信息（JSON）
+python -m sdk369 --version
+sdk369                    # console script
+```
+
+跑测试：
+
+```bash
+python -m pip install pytest
+python -m pytest -q
+```
+
+## 发布新版本
+
+```bash
+python -m pip install --upgrade build twine
+rm -rf dist build src/*.egg-info
+# 先把 pyproject.toml 里的 version 改成 0.0.2 之类的新版本号
+python -m build
+python -m twine check dist/*
+TWINE_USERNAME=__token__ TWINE_PASSWORD='pypi-你的token' python -m twine upload dist/*
+```
+
+> PyPI 上的版本号**只前进、不可复用**，同一个版本号删除后也无法重传。
+
+## 目录结构
+
+```
+sdk369/
+├─ pyproject.toml          # 包元数据 + 构建配置
+├─ README.md               # 本文件（即 PyPI 项目页正文）
+├─ LICENSE                 # MIT
+├─ .gitignore
+├─ src/sdk369/
+│  ├─ __init__.py          # 公开 API：__version__ / info()
+│  ├─ __main__.py          # CLI 入口
+│  └─ py.typed             # 声明带类型标注
+└─ tests/test_smoke.py
+```
+
+## License
+
+MIT

sdk369-0.0.1/README.md

@@ -0,0 +1,79 @@
+# sdk369
+
+一个最小化、零依赖的 Python 包，已发布到 PyPI。
+
+- 版本：0.0.1（Pre-Alpha）
+- 依赖：无
+- 支持：Python >= 3.9
+
+```bash
+pip install sdk369
+```
+
+> 名称说明：PyPI 会把 `sdk369`、`sdk-369`、`SDK369`、`sdk_369` 统统归一化成同一个项目名，
+> 所以占住 `sdk369` 等于把这几种写法一起占了。
+
+## 为什么不做纯空包？
+
+PyPI 官方策略把「空包占名」列为无效项目：
+
+> **Invalid projects** … project is name squatting (**package has no functionality or is empty**) …
+> 这类项目会被直接从索引中移除。
+> —— <https://docs.pypi.org/project-management/name-retention/>
+
+所以这里的做法是：保持体积最小的同时让它是一个真实可用的包——
+能 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 sdk369          # 打印包信息（JSON）
+python -m sdk369 --version
+sdk369                    # console script
+```
+
+跑测试：
+
+```bash
+python -m pip install pytest
+python -m pytest -q
+```
+
+## 发布新版本
+
+```bash
+python -m pip install --upgrade build twine
+rm -rf dist build src/*.egg-info
+# 先把 pyproject.toml 里的 version 改成 0.0.2 之类的新版本号
+python -m build
+python -m twine check dist/*
+TWINE_USERNAME=__token__ TWINE_PASSWORD='pypi-你的token' python -m twine upload dist/*
+```
+
+> PyPI 上的版本号**只前进、不可复用**，同一个版本号删除后也无法重传。
+
+## 目录结构
+
+```
+sdk369/
+├─ pyproject.toml          # 包元数据 + 构建配置
+├─ README.md               # 本文件（即 PyPI 项目页正文）
+├─ LICENSE                 # MIT
+├─ .gitignore
+├─ src/sdk369/
+│  ├─ __init__.py          # 公开 API：__version__ / info()
+│  ├─ __main__.py          # CLI 入口
+│  └─ py.typed             # 声明带类型标注
+└─ tests/test_smoke.py
+```
+
+## License
+
+MIT

sdk369-0.0.1/pyproject.toml

@@ -0,0 +1,39 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "sdk369"
+version = "0.0.1"
+description = "sdk369 - a minimal, dependency-free Python package."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [{ name = "sdk369 maintainers" }]
+keywords = ["sdk369"]
+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 = []
+
+# TODO: 填上仓库地址后再取消注释（PyPI 项目页侧边栏会显示）
+# [project.urls]
+# Homepage = "https://github.com/<you>/sdk369"
+# Repository = "https://github.com/<you>/sdk369"
+# "Bug Tracker" = "https://github.com/<you>/sdk369/issues"
+
+[project.scripts]
+sdk369 = "sdk369.__main__:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+sdk369 = ["py.typed"]

sdk369-0.0.1/setup.cfg

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

sdk369-0.0.1/src/sdk369/__init__.py

@@ -0,0 +1,26 @@
+"""sdk369 - a minimal, dependency-free Python package.
+
+Intentionally tiny but *real*: it imports, exposes a documented API, ships a
+console script, and has tests. See "为什么不做纯空包" in README.md.
+"""
+
+from __future__ import annotations
+
+__all__ = ["__version__", "info"]
+
+__version__ = "0.0.1"
+
+_SUMMARY = "sdk369 - 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": "sdk369",
+        "version": __version__,
+        "summary": _SUMMARY,
+    }

sdk369-0.0.1/src/sdk369/__main__.py

@@ -0,0 +1,34 @@
+"""Command line entry point: ``python -m sdk369`` / ``sdk369``."""
+
+from __future__ import annotations
+
+import json
+import sys
+
+from . import __version__, info
+
+USAGE = "usage: sdk369 [-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"sdk369: 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())

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

@@ -0,0 +1,98 @@
+Metadata-Version: 2.4
+Name: sdk369
+Version: 0.0.1
+Summary: sdk369 - a minimal, dependency-free Python package.
+Author: sdk369 maintainers
+License-Expression: MIT
+Keywords: sdk369
+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
+
+# sdk369
+
+一个最小化、零依赖的 Python 包，已发布到 PyPI。
+
+- 版本：0.0.1（Pre-Alpha）
+- 依赖：无
+- 支持：Python >= 3.9
+
+```bash
+pip install sdk369
+```
+
+> 名称说明：PyPI 会把 `sdk369`、`sdk-369`、`SDK369`、`sdk_369` 统统归一化成同一个项目名，
+> 所以占住 `sdk369` 等于把这几种写法一起占了。
+
+## 为什么不做纯空包？
+
+PyPI 官方策略把「空包占名」列为无效项目：
+
+> **Invalid projects** … project is name squatting (**package has no functionality or is empty**) …
+> 这类项目会被直接从索引中移除。
+> —— <https://docs.pypi.org/project-management/name-retention/>
+
+所以这里的做法是：保持体积最小的同时让它是一个真实可用的包——
+能 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 sdk369          # 打印包信息（JSON）
+python -m sdk369 --version
+sdk369                    # console script
+```
+
+跑测试：
+
+```bash
+python -m pip install pytest
+python -m pytest -q
+```
+
+## 发布新版本
+
+```bash
+python -m pip install --upgrade build twine
+rm -rf dist build src/*.egg-info
+# 先把 pyproject.toml 里的 version 改成 0.0.2 之类的新版本号
+python -m build
+python -m twine check dist/*
+TWINE_USERNAME=__token__ TWINE_PASSWORD='pypi-你的token' python -m twine upload dist/*
+```
+
+> PyPI 上的版本号**只前进、不可复用**，同一个版本号删除后也无法重传。
+
+## 目录结构
+
+```
+sdk369/
+├─ pyproject.toml          # 包元数据 + 构建配置
+├─ README.md               # 本文件（即 PyPI 项目页正文）
+├─ LICENSE                 # MIT
+├─ .gitignore
+├─ src/sdk369/
+│  ├─ __init__.py          # 公开 API：__version__ / info()
+│  ├─ __main__.py          # CLI 入口
+│  └─ py.typed             # 声明带类型标注
+└─ tests/test_smoke.py
+```
+
+## License
+
+MIT

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

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

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

@@ -0,0 +1 @@
+

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

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

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

@@ -0,0 +1 @@
+sdk369

sdk369-0.0.1/tests/test_smoke.py

@@ -0,0 +1,26 @@
+import json
+
+from sdk369 import __version__, info
+from sdk369.__main__ import main
+
+
+def test_info_matches_version():
+    data = info()
+    assert data["name"] == "sdk369"
+    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"] == "sdk369"
+
+
+def test_cli_rejects_unknown_flag(capsys):
+    assert main(["--nope"]) == 2
+    assert "unrecognized" in capsys.readouterr().err