toolkitx 0.0.1__tar.gz → 0.0.2__tar.gz

toolkitx-0.0.2/.github/workflows/python-publish.yml

@@ -0,0 +1,91 @@
+name: Python Package CI/CD
+
+on:
+  push:
+    branches:
+      - '**'  # 在推送到任何分支时运行测试
+    tags:
+      - 'v*'  # 在推送版本标签 (例如 v0.1.0) 时触发发布
+  pull_request:
+    branches:
+      - main   # 在向 main 分支发起 Pull Request 时运行测试
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12"] # 与 pyproject.toml 中的 requires-python = ">=3.12" 对齐
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+      with:
+        # Install a specific version of uv.
+        version: "0.7.3"
+
+    - name: "Set up Python"
+      uses: actions/setup-python@v5
+      with:
+        python-version-file: ".python-version"
+
+    - name: Install the project
+      run: uv sync --locked --all-extras --dev
+
+    - name: Run tests with pytest
+      run: |
+        pytest
+
+    - name: Run tests
+      # For example, using `pytest`
+      run: uv run pytest tests
+
+  publish:
+    needs: test # 确保测试通过后才发布
+    runs-on: ubuntu-latest
+    # 仅在推送 'v*' 格式的标签时运行
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+
+    permissions:
+      # 对于受信任的发布 (Trusted Publishing) 至 PyPI，此权限是必需的
+      id-token: write
+      contents: read # 检出仓库需要
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v5
+      with:
+        # Install a specific version of uv.
+        version: "0.7.3"
+
+    - name: "Set up Python"
+      uses: actions/setup-python@v5
+      with:
+        python-version-file: ".python-version"
+
+    - name: Install the project
+      run: uv sync --locked --all-extras --dev
+
+    - name: Build
+      run: uv build
+
+    - name: Publish
+      run: uv publish --token ${{ secrets.PYPI_API_TOKEN }}
+
+
+    - name: Create GitHub Release (Optional)
+      uses: softprops/action-gh-release@v2
+      if: success() # 仅在发布成功时创建 Release
+      with:
+        token: ${{ secrets.GITHUB_TOKEN }} # Actions 自动提供此 token
+        tag_name: ${{ github.ref_name }}   # 使用当前的 tag 名称
+        name: Release ${{ github.ref_name }}
+        # body_path: CHANGELOG.md # 可选：如果您的项目有 CHANGELOG.md，可以用它填充发布说明
+        draft: false
+        prerelease: false

{toolkitx-0.0.1 → toolkitx-0.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: toolkitx
-Version: 0.0.1
+Version: 0.0.2
 Summary: A personal Python toolkit for common tasks
 Project-URL: Homepage, https://github.com/ider-zh/toolkitx
 Project-URL: Bug Tracker, https://github.com/ider-zh/toolkitx/issues

{toolkitx-0.0.1 → toolkitx-0.0.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "toolkitx"
-version = "0.0.1"
+version = "0.0.2"
 description = "A personal Python toolkit for common tasks"
 readme = "README.md"
 requires-python = ">=3.12"

toolkitx-0.0.2/toolkitx/__init__.py

@@ -0,0 +1,26 @@
+# 从子模块导入，使其可以直接从 toolkitx 包导入
+from .hello import hello
+from .text_utils import truncate_text_smart, split_text_by_word_count
+from . import lab
+
+# 定义 __all__，当用户使用 from toolkitx import * 时，会导入这些符号
+__all__ = [
+    "hello",
+    "truncate_text_smart",
+    "split_text_by_word_count",
+    "lab",
+]
+
+import importlib.metadata
+
+try:
+    # 这将从已安装包的元数据中读取版本号
+    # 包名 "toolkitx" 与 pyproject.toml 中的 name 一致
+    __version__ = importlib.metadata.version("toolkitx")
+except importlib.metadata.PackageNotFoundError:
+    # 如果包尚未安装（例如，在未执行 editable install 的源码状态下运行），则会发生此错误。
+    # 在开发初期，或者在当前环境尚未执行 `pip install -e .` 时可能会遇到。
+    # 构建系统 (Hatchling) 在构建包时会使用 pyproject.toml 中的版本。
+    # 一旦安装（即使是可编辑模式安装），importlib.metadata.version 应该能正常工作。
+    # 对于未安装状态，可以设置一个占位符版本。
+    __version__ = "0.0.0.dev0" # 或者 "unknown"

toolkitx-0.0.2/toolkitx/lab/__init__.py

@@ -0,0 +1,5 @@
+from .translator import Translator
+
+__all__ = [
+    "Translator"
+]

toolkitx-0.0.1/toolkitx/__init__.py

@@ -1,13 +0,0 @@
-# 从子模块导入，使其可以直接从 toolkitx 包导入
-from .hello import hello
-from .text_utils import truncate_text_smart, split_text_by_word_count
-
-# 定义 __all__，当用户使用 from toolkitx import * 时，会导入这些符号
-__all__ = [
-    "hello",
-    "truncate_text_smart",
-    "split_text_by_word_count"
-]
-
-# 你也可以在这里定义包级别的版本号等元数据
-__version__ = "0.0.1" # 与 pyproject.toml 中的 version 一致