chore: refine pypi github workflows (#16)

chore: refine pypi publish workflow

- make version dynamic
- publish to TestPyPI on tag pushes only
- publish to PyPI via manual dispatch only

Author: bsbds

.github/workflows/publish.yml

@@ -1,6 +1,14 @@
+# This workflow handles the distribution of Python packages.
+# 1. Automatic: Every push/tag builds the distribution.
+# 2. Automatic: Tag pushes (refs/tags/*) deploy to TestPyPI.
+# 3. Manual: Production releases to PyPI require a manual trigger (workflow_dispatch)
+#    to prevent accidental deployments.
+
 name: Publish Python 🐍 distribution 📦 to PyPI and TestPyPI
 
-on: push
+on:
+    push:
+    workflow_dispatch:
 
 jobs:
     build:
@@ -32,7 +40,8 @@ jobs:
     publish-to-pypi:
         name: >-
             Publish Python 🐍 distribution 📦 to PyPI
-        if: startsWith(github.ref, 'refs/tags/') # only publish to PyPI on tag pushes
+        # Manual dispatch required to prevent accidental production releases
+        if: github.event_name == 'workflow_dispatch'
         needs:
             - build
         runs-on: ubuntu-latest
@@ -53,6 +62,7 @@ jobs:
 
     publish-to-testpypi:
         name: Publish Python 🐍 distribution 📦 to TestPyPI
+        if: startsWith(github.ref, 'refs/tags/') # only publish to TestPyPI on tag pushes
         needs:
             - build
         runs-on: ubuntu-latest

pyproject.toml

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["setuptools >= 77.0.3", "wheel"]
+requires = ["setuptools >= 77.0.3", "setuptools-scm", "wheel"]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "deepdoc_lib"
-version = "0.1.0"
+dynamic = ["version"]
 description = "[RAGFlow](https://ragflow.io/) is an open-source RAG (Retrieval-Augmented Generation) engine based on deep document understanding. It offers a streamlined RAG workflow for businesses of any scale, combining LLM (Large Language Models) to provide truthful question-answering capabilities, backed by well-founded citations from various complex formatted data."
 authors = [{ name = "Zhichang Yu", email = "yuzhichang@gmail.com" }]
 license-files = ["LICENSE"]
@@ -94,3 +94,7 @@ markers = [
     "p2: medium priority test cases",
     "p3: low priority test cases",
 ]
+
+[tool.setuptools_scm]
+write_to = "deepdoc/_version.py"
+fallback_version = "0.1.0"