当前现状
自 RapidOCR 有 whl 包以来，一直就使用 setuptools 来打包。在我看来，打包程序需要满足一个硬性条件：自动化版本号。根据 tag 来自动生成版本号。
为了实现自动化版本号功能，我写了一个库：GetPyPiLatestVersion[1]。这个库可以获得指定库的最新版本。
后来我发现 Github Actions 中可以指定在打 tag 时，获取 tag 号来传到 setuptools 中，从而自动化版本号。部分代码如下：
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(linename: Push rapidocr to pypi
on: push: tags: - v*
jobs: TestAndPublish: runs-on: ubuntu-latest steps: - name: Build wheel package run: | cd python python setup.py bdist_wheel ${{ github.ref_name }} mv dist ../
我按照上面的逻辑用了很久，也逐渐习惯了这种模式。直到前几天 @vshawrh[2] 提的两个问题：#667[3]#685[4]，暴漏了当前模式的缺陷。
当前模式并未考虑下游伙伴们自行构建 whl 包。下游小伙伴如果要自己构建，就需要参考 CI 中复杂的流程，一步步执行查看结果。同时 setup.py 中也耦合了许多其他逻辑，让打包这一步变得异常复杂。
基于 pyproject.toml 打包
在小伙伴的建议下，我调研了基于 pyproject.toml 配置文件来打包现有程序。我发现通过 setuptools-scm 库可以完美解决自动化版本号问题。同时，通过配置文件形式，可以将下载打包必需的模型这一步分离出去。
还解决了之前需要将 rapidocr 目录包裹一层才能正确导入的问题。现在整个打包程序异常简洁。源码：link[5]
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(line[build-system]requires = [ "setuptools>=77", "wheel", "setuptools-scm>=8",]build-backend = "setuptools.build_meta"
[project]name = "rapidocr"dynamic = ["version", "dependencies"]description = "Awesome OCR Library"readme = { file = "README.md", content-type = "text/markdown" }requires-python = ">=3.8,license = "Apache-2.0"authors = [ { name = "SWHL", email = "[email protected]" },]keywords = [ "ocr", "text_detection", "text_recognition", "db", "onnxruntime", "paddleocr", "openvino", "rapidocr",]classifiers = [ "Programming Language :: Python :: 3.8", "Programming Language :: Python :: 3.9", "Programming Language :: Python :: 3.10", "Programming Language :: Python :: 3.11", "Programming Language :: Python :: 3.12", "Programming Language :: Python :: 3.13",]
[project.urls]Documentation = "https://rapidai.github.io/RapidOCRDocs"Changelog = "https://github.com/RapidAI/RapidOCR/releases"
[project.scripts]rapidocr = "rapidocr.main:main"
[tool.setuptools]include-package-data = trueplatforms = ["Any"]
[tool.setuptools.dynamic]dependencies = { file = ["requirements.txt"] }
[tool.setuptools.packages.find]where = ["."]include = ["rapidocr*"]exclude = ["tests*"]namespaces = false
[tool.setuptools.package-data]rapidocr = [ "**/*.yaml",]
[tool.setuptools_scm]root = ".."tag_regex = "^v?(?Pversion_file = "rapidocr/_version.py"local_scheme = "no-local-version"
自定义打包
这一块，我写了相关文档：如何自行构建指定版本的 rapidocr whl 包[6]
总结下来就以下几步：
ounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(lineounter(linegit clone https://github.com/RapidAI/RapidOCR.gitcd RapidOCR/python
python -m pip install --upgrade pippython -m pip install build setuptools wheel setuptools-scm PyYAMLpython tools/prepare_wheel_assets.py
SETUPTOOLS_SCM_PRETEND_VERSION_FOR_RAPIDOCR=3.1.0 python -m build --wheel
写在最后
每个问题的出现都是让我们变得更好的契机。所以不妨换个更加积极一些的角度看问题。
[登录查看剩余 70% 内容](javascript:void (0);)