Merge pull request python#1030 from python/migrate-to-uv

josix · web-flow · commit 3a5eeb5942e2 · 2025-03-15T20:26:42.000+08:00
chore: Replace python3 -m venv and pip with uv for virtual environment management
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -16,5 +16,8 @@ jobs:
       - name: Install Dependencies
         run: sudo apt-get install gettext
 
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+
       - name: Validate
         run: VERSION=${{ github.event.repository.default_branch }} JOBS=4 MODE=html make all
diff --git a/Makefile b/Makefile
@@ -89,21 +89,21 @@ prepare_cpython:  ## Prepare CPython clone at `../cpython/`.
 
 
 $(VENV)/bin/activate:
-	python3 -m venv $(VENV)
+	uv venv $(VENV)
 
 $(VENV)/bin/sphinx-build: $(VENV)/bin/activate
-	. $(VENV)/bin/activate; python3 -m pip install sphinx python-docs-theme
+	. $(VENV)/bin/activate; uv pip install sphinx python-docs-theme
 
 $(VENV)/bin/sphinx-lint: $(VENV)/bin/activate
-	. $(VENV)/bin/activate; python3 -m pip install sphinx-lint
+	. $(VENV)/bin/activate; uv pip install sphinx-lint
 
 $(VENV)/bin/blurb: $(VENV)/bin/activate
-	. $(VENV)/bin/activate; python3 -m pip install blurb
+	. $(VENV)/bin/activate; uv pip install blurb
 
 
 .PHONY: upgrade_venv
 upgrade_venv: $(VENV)/bin/activate ## Upgrade the venv that compiles the doc
-	@. $(VENV)/bin/activate; python3 -m pip install -q --upgrade sphinx python-docs-theme blurb sphinx-lint
+	@. $(VENV)/bin/activate; uv pip install -q --upgrade sphinx python-docs-theme blurb sphinx-lint
 
 
 .PHONY: progress
diff --git a/README.rst b/README.rst
@@ -84,6 +84,7 @@ the PSF for inclusion in the documentation.
 - `安裝好 git <https://help.github.com/articles/set-up-git/>`_\ （Windows
   上請參考 https://gitforwindows.org/）
 - 一個 ``.po`` 檔的編輯器。推薦使用 `Poedit <https://poedit.net>`_，若熟悉 po 檔用一般文字編輯器亦可。
+- 參考 `uv Installation <https://docs.astral.sh/uv/getting-started/installation/>`_ 安裝 uv，以便在本機端預覽翻譯成果。
 - macOS 的使用者還需要先利用 `homebrew <https://brew.sh/index_zh-tw>`_ 安裝 gettext，屆時 Sphinx 會使用到。
 
   .. code-block:: bash
