gitinsight-cli 0.1.0__tar.gz → 0.1.1__tar.gz

gitinsight_cli-0.1.1/.github/workflows/release.yml

@@ -0,0 +1,94 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    name: Build distributions
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: "0.11.21"
+
+      - name: Verify tag matches package version
+        shell: bash
+        run: |
+          package_version="$(uv version --short)"
+          tag_version="${GITHUB_REF_NAME#v}"
+
+          if [[ "$tag_version" != "$package_version" ]]; then
+            echo "::error::Tag version $tag_version does not match package version $package_version"
+            exit 1
+          fi
+
+      - name: Build wheel and source distribution
+        run: uv build
+
+      - name: Check distributions
+        run: uvx --no-config twine check dist/*
+
+      - name: Upload distributions
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-package-distributions
+          path: dist/
+          if-no-files-found: error
+
+  release:
+    name: Create GitHub Release
+    needs: build
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v5
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v3
+        with:
+          files: dist/*
+          fail_on_unmatched_files: true
+          generate_release_notes: true
+          make_latest: true
+
+  publish:
+    name: Publish to PyPI
+    needs: release
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/gitinsight-cli/
+    permissions:
+      id-token: write
+
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v5
+        with:
+          name: python-package-distributions
+          path: dist/
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@08807647e7069bb48b6ef5acd8ec9567f424441b # v8.1.0
+        with:
+          version: "0.11.21"
+
+      - name: Publish distributions
+        run: uv publish --trusted-publishing always --check-url https://pypi.org/simple

{gitinsight_cli-0.1.0 → gitinsight_cli-0.1.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gitinsight-cli
-Version: 0.1.0
+Version: 0.1.1
 Summary: A powerful collection of Git repository analysis tools and visualizations.
 Project-URL: Homepage, https://github.com/Rain-kl/GitInsight
 Project-URL: Bug Tracker, https://github.com/Rain-kl/GitInsight/issues
@@ -23,8 +23,9 @@ GitRepository Analysis and Visualization Tool / Git 仓库分析与可视化工
 <!-- PROJECT SHIELDS -->
 
 [![MIT License][license-shield]][license-url]
-
-[![Python Version][python-version]][python-version]
+[![PyPI Version][pypi-version]][pypi-url]
+[![Python Versions][python-version]][pypi-url]
+[![Release][release-shield]][release-url]
 
 ---
 
@@ -38,6 +39,7 @@ GitRepository Analysis and Visualization Tool / Git 仓库分析与可视化工
     - [文件目录说明](#文件目录说明)
     - [开发的架构](#开发的架构)
     - [部署](#部署)
+    - [发布新版本](#发布新版本)
     - [使用到的框架](#使用到的框架)
     - [贡献者](#贡献者)
       - [如何参与开源项目](#如何参与开源项目)
@@ -122,8 +124,30 @@ GitInsight
 
 ### 部署
 
-本项目为 Python 命令行工具，可直接本地运行或打包发布到 PyPI。
-暂无特殊部署部署。
+本项目作为 Python 命令行工具发布到
+[PyPI](https://pypi.org/project/gitinsight-cli/)，安装后的命令名为
+`gitinsight`。
+
+### 发布新版本
+
+1. 更新 `pyproject.toml` 中的版本并刷新锁文件：
+
+```sh
+uv version 0.2.0
+uv lock
+```
+
+2. 提交版本变更，然后创建并推送同版本标签：
+
+```sh
+git tag -a v0.2.0 -m "v0.2.0"
+git push GitInsight main
+git push GitInsight v0.2.0
+```
+
+`v*` 标签会触发 GitHub Actions。工作流会校验标签与项目版本一致，
+构建 wheel 和源码包、创建 GitHub Release，并通过 PyPI Trusted
+Publishing 发布，无需配置长期 PyPI Token。
 
 ### 使用到的框架
 
@@ -149,4 +173,8 @@ GitInsight
 <!-- links -->
 [license-shield]: https://img.shields.io/github/license/shaojintian/Best_README_template.svg?style=flat-square
 [license-url]: https://github.com/Rain-kl/GitInsight/blob/main/LICENSE
-[python-version]:https://img.shields.io/pypi/pyversions/pandas
+[pypi-version]: https://img.shields.io/pypi/v/gitinsight-cli
+[pypi-url]: https://pypi.org/project/gitinsight-cli/
+[python-version]: https://img.shields.io/pypi/pyversions/gitinsight-cli
+[release-shield]: https://github.com/Rain-kl/GitInsight/actions/workflows/release.yml/badge.svg
+[release-url]: https://github.com/Rain-kl/GitInsight/actions/workflows/release.yml

{gitinsight_cli-0.1.0 → gitinsight_cli-0.1.1}/README.md

@@ -5,8 +5,9 @@ GitRepository Analysis and Visualization Tool / Git 仓库分析与可视化工
 <!-- PROJECT SHIELDS -->
 
 [![MIT License][license-shield]][license-url]
-
-[![Python Version][python-version]][python-version]
+[![PyPI Version][pypi-version]][pypi-url]
+[![Python Versions][python-version]][pypi-url]
+[![Release][release-shield]][release-url]
 
 ---
 
@@ -20,6 +21,7 @@ GitRepository Analysis and Visualization Tool / Git 仓库分析与可视化工
     - [文件目录说明](#文件目录说明)
     - [开发的架构](#开发的架构)
     - [部署](#部署)
+    - [发布新版本](#发布新版本)
     - [使用到的框架](#使用到的框架)
     - [贡献者](#贡献者)
       - [如何参与开源项目](#如何参与开源项目)
@@ -104,8 +106,30 @@ GitInsight
 
 ### 部署
 
-本项目为 Python 命令行工具，可直接本地运行或打包发布到 PyPI。
-暂无特殊部署部署。
+本项目作为 Python 命令行工具发布到
+[PyPI](https://pypi.org/project/gitinsight-cli/)，安装后的命令名为
+`gitinsight`。
+
+### 发布新版本
+
+1. 更新 `pyproject.toml` 中的版本并刷新锁文件：
+
+```sh
+uv version 0.2.0
+uv lock
+```
+
+2. 提交版本变更，然后创建并推送同版本标签：
+
+```sh
+git tag -a v0.2.0 -m "v0.2.0"
+git push GitInsight main
+git push GitInsight v0.2.0
+```
+
+`v*` 标签会触发 GitHub Actions。工作流会校验标签与项目版本一致，
+构建 wheel 和源码包、创建 GitHub Release，并通过 PyPI Trusted
+Publishing 发布，无需配置长期 PyPI Token。
 
 ### 使用到的框架
 
@@ -131,4 +155,8 @@ GitInsight
 <!-- links -->
 [license-shield]: https://img.shields.io/github/license/shaojintian/Best_README_template.svg?style=flat-square
 [license-url]: https://github.com/Rain-kl/GitInsight/blob/main/LICENSE
-[python-version]:https://img.shields.io/pypi/pyversions/pandas
+[pypi-version]: https://img.shields.io/pypi/v/gitinsight-cli
+[pypi-url]: https://pypi.org/project/gitinsight-cli/
+[python-version]: https://img.shields.io/pypi/pyversions/gitinsight-cli
+[release-shield]: https://github.com/Rain-kl/GitInsight/actions/workflows/release.yml/badge.svg
+[release-url]: https://github.com/Rain-kl/GitInsight/actions/workflows/release.yml

{gitinsight_cli-0.1.0 → gitinsight_cli-0.1.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "gitinsight-cli"
-version = "0.1.0"
+version = "0.1.1"
 description = "A powerful collection of Git repository analysis tools and visualizations."
 readme = "README.md"
 requires-python = ">=3.12"

{gitinsight_cli-0.1.0 → gitinsight_cli-0.1.1}/uv.lock

@@ -21,7 +21,7 @@ wheels = [
 
 [[package]]
 name = "gitinsight-cli"
-version = "0.1.0"
+version = "0.1.1"
 source = { editable = "." }
 dependencies = [
     { name = "loguru" },

gitinsight_cli-0.1.0/.github/workflows/release.yml

@@ -1,70 +0,0 @@
-name: Auto Release Wheel
-
-on:
-  push:
-    branches: [ "main" ]
-  workflow_dispatch:
-
-permissions:
-  contents: write
-
-jobs:
-  build-and-release:
-    name: Build and Release Wheel
-    runs-on: ubuntu-latest
-    
-    steps:
-      - name: Checkout code
-        uses: actions/checkout@v4
-
-      - name: Install uv
-        uses: astral-sh/setup-uv@v5
-
-      - name: Set up Python
-        run: uv python install
-
-      - name: Generate Version Number
-        id: version
-        run: |
-          # Use current timestamp as version: YYYY.MM.DD.HHMMSS
-          # Using UTC time to avoid timezone confusion and ensure monotonicity
-          VERSION_NUM=$(date -u +'%Y.%m.%d.%H%M%S')
-          echo "VERSION_NUM=$VERSION_NUM" >> $GITHUB_ENV
-          echo "Generated version: $VERSION_NUM"
-
-      - name: Update pyproject.toml version
-        run: |
-          # Simple sed replacement for the version field
-          # Matches 'version = "..."'
-          sed -i "s/version = \".*\"/version = \"${{ env.VERSION_NUM }}\"/" pyproject.toml
-          echo "Updated pyproject.toml version:"
-          grep "version =" pyproject.toml
-
-      - name: Build Wheel
-        run: |
-          uv build
-          
-          # Verify the output
-          echo "Build artifacts:"
-          ls -l dist/
-
-      - name: Create Release
-        uses: softprops/action-gh-release@v2
-        with:
-          tag_name: "v${{ env.VERSION_NUM }}"
-          name: "Release v${{ env.VERSION_NUM }}"
-          files: dist/*.whl
-          make_latest: true
-          body: |
-            Auto-generated release from GitHub Actions.
-            Version: ${{ env.VERSION_NUM }}
-            Build Time: $(date)
-            
-            ## Platform Support
-            This release contains a **Pure Python Wheel** (`*-py3-none-any.whl`).
-            It is compatible with:
-            - ✅ **Windows (x64/ARM64)**
-            - ✅ **Linux (x64/ARM64)**
-            - ✅ **macOS (x64/ARM64)**
-            
-            Requires Python 3.12+.