build: 更新构建配置和依赖管理

- 添加 setuptools 构建系统配置
- 使用 importlib.metadata 替代自定义版本管理
- 更新 GitHub Actions 工作流中的 actions 版本
- 优化文档构建流程和依赖安装

Author: xinetzone

.github/workflows/pages.yml

@@ -33,35 +33,30 @@ jobs:
         with:
           egress-policy: audit # TODO: change to 'egress-policy: block' after couple of runs
       - name: Checkout
-        uses: actions/checkout@main
+        uses: actions/checkout@v4
       - name: 🐍 Set up Python
-        uses: actions/setup-python@main
+        uses: actions/setup-python@v5
         with:
           python-version: "3.12"
           cache: "pip"
           cache-dependency-path: "pyproject.toml"
-      - name: 🔧 PyPI 配置
+      - name: 🔧 环境与依赖
         run: |
-          sudo apt-get install graphviz
-          apt-get update && sudo apt-get upgrade
-          pip install --upgrade pip
-          pip install -ve .[doc,dev] --upgrade
-          git clone --recursive https://github.com/xinetzone/maple-font.git
-          cd maple-font
-          pip install -ve .
-          maple-font build --full
-          conda install -c conda-forge pandoc compilers podman
+          sudo apt-get update
+          sudo apt-get install -y graphviz
+          python -m pip install --upgrade pip
+          pip install .[doc,dev] --upgrade
       - name: 🔧 Build HTML
         run: |
           invoke doc
       - name: Setup Pages
-        uses: actions/configure-pages@main
+        uses: actions/configure-pages@v5
       - name: Upload artifact
-        uses: actions/upload-pages-artifact@main
+        uses: actions/upload-pages-artifact@v2
         with:
           # Upload entire repository
           path: 'doc/_build/html/'
       - name: 🚀 Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@main
+        uses: actions/deploy-pages@v4
         # uses: peaceiris/[email protected]

.github/workflows/python-publish.yml

@@ -15,9 +15,9 @@ jobs:
   deploy:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@main
+      - uses: actions/checkout@v4
       - name: Set up Python
-        uses: actions/setup-python@main
+        uses: actions/setup-python@v5
         with:
           python-version: "3.x"
       - name: Install dependencies
@@ -27,7 +27,7 @@ jobs:
       - name: Build package
         run: python -m build
       - name: Publish package
-        uses: pypa/gh-action-pypi-publish@unstable/v1
+        uses: pypa/gh-action-pypi-publish@release/v1
         with:
           user: __token__
           password: ${{ secrets.PYPI_API_TOKEN }}

doc/conf.py

@@ -23,8 +23,11 @@ def get_project_root():
     return Path(__file__).resolve().parents[1]
 
 ROOT = get_project_root()
-sys.path.extend([str(ROOT/'doc')])
-from taolib import get_version  # 引入获取版本号的函数
+try:
+    from importlib.metadata import version as _pkg_version
+    release = _pkg_version("taolib")
+except Exception:
+    release = os.environ.get("TAOLIB_VERSION", "0.0.0")
 
 # === 注入本地修复版 sphinx_tippy 扩展路径 ===
 # 说明：为修复 Wikipedia 抓取告警，优先加载仓库内修复版扩展。
@@ -34,9 +37,8 @@ def get_project_root():
     # 将本地扩展源码路径插入到 sys.path 前部，确保优先导入
     sys.path.insert(0, str(TIPPY_LOCAL_SRC))
 # ================================= 项目基本信息 =================================
-project = "tao"  # 文档项目名称
-author = "xinetzone"    # 文档作者
-release = get_version("taolib")  # 获取taolib主题的版本号
+project = "tao"
+author = "xinetzone"
 copyright = '2021, xinetzone'  # 版权信息
 # ================================= 国际化与本地化设置 ==============================
 language = 'zh_CN'       # 文档语言（中文简体）

pyproject.toml

@@ -55,3 +55,13 @@ dev = [
   "numpy",
   "matplotlib",
 ]
+
+[build-system]
+requires = ["setuptools>=61", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

src/taolib/__init__.py

@@ -1,15 +1,8 @@
-"""taolib - 实用工具库
+from importlib.metadata import version, PackageNotFoundError
 
-该模块提供了一系列实用工具函数和类，用于各种日常开发任务。
-"""
-# 导入版本模块
-try:
-    from .version import __version__, get_version
-except ImportError:
-    # 如果版本模块不可用，设置默认版本号
-    __version__ = "0.0.0"
 
-    def get_version(package_name: str = "taolib", fallback: str = "0.0.0") -> str:
-        return fallback
-
-__all__ = ["__version__", "get_version", "doc"]
+def get_version(pkg_name: str) -> str:
+    try:
+        return version(pkg_name)
+    except PackageNotFoundError:
+        return "0.0.0"