small-toolkit 0.1.1__tar.gz → 0.1.3__tar.gz

{small_toolkit-0.1.1 → small_toolkit-0.1.3}/.github/workflows/publish-test.yml

@@ -9,10 +9,10 @@ jobs:
     permissions:
       contents: read
     steps:
-      - uses: actions/checkout@v4
-      - uses: astral-sh/setup-uv@v5
+      - uses: actions/checkout@v5
+      - uses: astral-sh/setup-uv@v6
       - run: uv build
-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@v5
         with:
           name: dist
           path: dist/
@@ -24,7 +24,7 @@ jobs:
     permissions:
       id-token: write
     steps:
-      - uses: actions/download-artifact@v4
+      - uses: actions/download-artifact@v5
         with:
           name: dist
           path: dist/

{small_toolkit-0.1.1 → small_toolkit-0.1.3}/.github/workflows/publish.yml

@@ -10,7 +10,7 @@ jobs:
     permissions:
       contents: read
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: 校验 tag 与 pyproject 版本一致
         # PyPI 同版本不可覆盖，tag/版本不一致会在上传时才报错，这里提前拦
@@ -18,11 +18,11 @@ jobs:
           version=$(python3 -c "import pathlib,tomllib;print(tomllib.loads(pathlib.Path('pyproject.toml').read_text(encoding='utf-8'))['project']['version'])")
           test "v${version}" = "${GITHUB_REF_NAME}"
 
-      - uses: astral-sh/setup-uv@v5
+      - uses: astral-sh/setup-uv@v6
 
       - run: uv build
 
-      - uses: actions/upload-artifact@v4
+      - uses: actions/upload-artifact@v5
         with:
           name: dist
           path: dist/
@@ -34,7 +34,7 @@ jobs:
     permissions:
       id-token: write # Trusted Publishing（OIDC），无需 API token
     steps:
-      - uses: actions/download-artifact@v4
+      - uses: actions/download-artifact@v5
         with:
           name: dist
           path: dist/

{small_toolkit-0.1.1 → small_toolkit-0.1.3}/PKG-INFO

@@ -1,7 +1,9 @@
 Metadata-Version: 2.5
 Name: small_toolkit
-Version: 0.1.1
+Version: 0.1.3
 Summary: 纯标准库的通用小工具：产物目录、日志初始化、命令行参数与终端表格
+Project-URL: Homepage, https://github.com/jalousiex/py-small_toolkit
+Project-URL: Repository, https://github.com/jalousiex/py-small_toolkit
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 
@@ -14,13 +16,20 @@ Description-Content-Type: text/markdown
 - **零第三方依赖**：只用标准库（`pathlib` / `logging` / `argparse` / `unicodedata`）。
 - **无凭据、无内网地址**：不读环境里的密钥，不内置任何内网域名；环境变量只做**名字**层面的回退。
 - 只抽跨项目复用的通用能力，业务逻辑（平台 SDK、数据源客户端、领域规则）留在各自仓库。
+- **不接收需要三方依赖或本机环境的能力**（如 SSH、端口转发、系统命令调用）：这些留在各自的本地工具包。
 
 ## 安装
 
-从 tag 安装（跨仓依赖固定到 tag，不跟浮动分支）：
+从 PyPI 安装（发版后）：
 
 ```bash
-uv add "small_toolkit @ git+https://github.com/jalousiex/py-toolkit.git@v0.1.1"
+uv add small_toolkit
+```
+
+固定到 tag 的 git 安装（尚未发版时用）：
+
+```bash
+uv add "small_toolkit @ git+https://github.com/jalousiex/py-small_toolkit.git@v0.1.1"
 ```
 
 本地开发：

{small_toolkit-0.1.1 → small_toolkit-0.1.3}/README.md

@@ -7,13 +7,20 @@
 - **零第三方依赖**：只用标准库（`pathlib` / `logging` / `argparse` / `unicodedata`）。
 - **无凭据、无内网地址**：不读环境里的密钥，不内置任何内网域名；环境变量只做**名字**层面的回退。
 - 只抽跨项目复用的通用能力，业务逻辑（平台 SDK、数据源客户端、领域规则）留在各自仓库。
+- **不接收需要三方依赖或本机环境的能力**（如 SSH、端口转发、系统命令调用）：这些留在各自的本地工具包。
 
 ## 安装
 
-从 tag 安装（跨仓依赖固定到 tag，不跟浮动分支）：
+从 PyPI 安装（发版后）：
 
 ```bash
-uv add "small_toolkit @ git+https://github.com/jalousiex/py-toolkit.git@v0.1.1"
+uv add small_toolkit
+```
+
+固定到 tag 的 git 安装（尚未发版时用）：
+
+```bash
+uv add "small_toolkit @ git+https://github.com/jalousiex/py-small_toolkit.git@v0.1.1"
 ```
 
 本地开发：

{small_toolkit-0.1.1 → small_toolkit-0.1.3}/pyproject.toml

@@ -1,11 +1,15 @@
 [project]
 name = "small_toolkit"
-version = "0.1.1"
+version = "0.1.3"
 description = "纯标准库的通用小工具：产物目录、日志初始化、命令行参数与终端表格"
 readme = "README.md"
 requires-python = ">=3.11"
 dependencies = []
 
+[project.urls]
+Homepage = "https://github.com/jalousiex/py-small_toolkit"
+Repository = "https://github.com/jalousiex/py-small_toolkit"
+
 [build-system]
 requires = ["hatchling"]
 build-backend = "hatchling.build"

{small_toolkit-0.1.1 → small_toolkit-0.1.3}/small_toolkit/cli.py

@@ -116,10 +116,11 @@ def resolve_env_var(env: str, base_name: str) -> str | None:
 
     1. ``{base_name}_LIST`` — 分号分隔的 ``env=value`` 格式（最高优先级）
     2. ``{base_name}_{ENV}`` — 单环境变量
-    3. ``{base_name}`` — 仅 ``env=prod`` 时回退到原生变量名
+    3. ``{base_name}`` — 原生变量名（任何环境都回退）
 
-    任一来源有值（含空字符串）即返回，全缺失返回 ``None``。非 prod 环境不会读原生变量，
-    避免旧单环境凭据被误当作测试/开发环境配置。
+    任一来源有值（含空字符串）即返回，全缺失返回 ``None``。三层对所有环境一致：
+    ``tst`` / ``uat`` 在没有 ``_LIST`` 条目、也没有 ``_{ENV}`` 后缀变量时同样回退到原生名，
+    便于变量整合后只保留裸名的场景。
 
     例（值由外部注入，本库不读写凭据）::
 
@@ -133,14 +134,13 @@ def resolve_env_var(env: str, base_name: str) -> str | None:
             part = part.strip()
             if "=" in part:
                 k, v = part.split("=", 1)
-                if k.strip() == env:
+                # 环境键大小写不敏感：PROD=/Prod= 与 prod= 等价
+                if k.strip().lower() == env.strip().lower():
                     return v.strip()
     # 2. 单环境变量 {KEY}_{ENV}
     env_val = os.environ.get(f"{base_name}_{env.upper()}", "").strip()
     if env_val:
         return env_val
-    # 3. 回退原生变量（仅 prod 环境）
-    if env.lower() == "prod":
-        fallback = os.environ.get(base_name, "").strip()
-        return fallback or None
-    return None
+    # 3. 回退原生变量（所有环境统一）
+    fallback = os.environ.get(base_name, "").strip()
+    return fallback or None

{small_toolkit-0.1.1 → small_toolkit-0.1.3}/tests/test_cli.py

@@ -90,11 +90,31 @@ def test_resolve_env_var_reads_list_first(monkeypatch):
     assert resolve_env_var("tst", "TOOLKIT_TEST_URL") == "a:8030"
 
 
-def test_resolve_env_var_prefers_single_env_then_native_for_prod(monkeypatch):
+def test_resolve_env_var_list_key_is_case_insensitive(monkeypatch):
+    monkeypatch.setenv("TOOLKIT_TEST_URL_LIST", "PROD=b:8030;Uat=c:8030")
     monkeypatch.setenv("TOOLKIT_TEST_URL", "native")
+
+    assert resolve_env_var("prod", "TOOLKIT_TEST_URL") == "b:8030"
+    assert resolve_env_var("uat", "TOOLKIT_TEST_URL") == "c:8030"
+
+
+def test_resolve_env_var_falls_back_to_native_for_any_env(monkeypatch):
+    monkeypatch.setenv("TOOLKIT_TEST_URL", "native")
+
     assert resolve_env_var("prod", "TOOLKIT_TEST_URL") == "native"
-    # 非 prod 环境不读原生变量
-    assert resolve_env_var("uat", "TOOLKIT_TEST_URL") is None
+    # 非 prod 环境同样回退原生变量
+    assert resolve_env_var("tst", "TOOLKIT_TEST_URL") == "native"
+    assert resolve_env_var("uat", "TOOLKIT_TEST_URL") == "native"
+
+
+def test_resolve_env_var_list_and_suffix_win_over_native(monkeypatch):
+    monkeypatch.setenv("TOOLKIT_TEST_URL", "native")
+    monkeypatch.setenv("TOOLKIT_TEST_URL_TST", "single")
+
+    assert resolve_env_var("tst", "TOOLKIT_TEST_URL") == "single"
+
+    monkeypatch.setenv("TOOLKIT_TEST_URL_LIST", "tst=listed")
+    assert resolve_env_var("tst", "TOOLKIT_TEST_URL") == "listed"
 
 
 def test_resolve_env_var_missing_returns_none(monkeypatch):

{small_toolkit-0.1.1 → small_toolkit-0.1.3}/uv.lock

@@ -65,7 +65,7 @@ wheels = [
 
 [[package]]
 name = "small-toolkit"
-version = "0.1.1"
+version = "0.1.2"
 source = { editable = "." }
 
 [package.dev-dependencies]