Merge remote-tracking branch 'upstream/3.13' into library/math

Author: Carisa-Li

.github/dependabot.yml

@@ -0,0 +1,6 @@
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: monthly

.github/workflows/ci.yml

@@ -7,7 +7,7 @@ jobs:
   ci:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
 
       - name: Install Dependencies
         run: sudo apt-get install gettext

.github/workflows/deploy-gh-page.yml

@@ -3,13 +3,13 @@ name: deploy-gh-page
 on:
   push:
     branches:
-      - "3.12"
+      - "3.13"
 
 jobs:
   cd:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
 
       - name: Install Dependencies
         run: sudo apt-get install gettext
@@ -18,7 +18,7 @@ jobs:
         run: make all
 
       - name: Deploy to gh page
-        uses: JamesIves/github-pages-deploy-action@3.7.1
+        uses: JamesIves/github-pages-deploy-action@v4.6.4
         with:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           BRANCH: gh-pages

.github/workflows/py312-sync-cpython.yml renamed to .github/workflows/py313-sync-cpython.yml

@@ -1,20 +1,20 @@
-name: python-3.12-sync-with-cpython
+name: python-3.13-sync-with-cpython
 
 on:
   push:
     branches:
-      - "3.12"
+      - "3.13"
   schedule:
     - cron: "0 0 * * *"
 
 jobs:
   sync:
     runs-on: ubuntu-latest
     env:
-      VERSION: "3.12"
-      BRANCH: "cron/sync/3.12"
+      VERSION: "3.13"
+      BRANCH: "cron/sync/3.13"
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
         with:
           ref: ${{ env.VERSION }}
 
@@ -33,15 +33,15 @@ jobs:
       - name: Sync with CPython
         run: make clone && make merge && make rm_cpython
 
-      - uses: tibdex/github-app-token@v1
+      - uses: tibdex/github-app-token@v2
         id: generate-token
         with:
           app_id: ${{ secrets.APP_ID }}
           private_key: ${{ secrets.APP_PRIVATE_KEY }}
 
       - name: Create Pull Request
         id: cpr
-        uses: peter-evans/create-pull-request@v3
+        uses: peter-evans/create-pull-request@v6
         with:
           token: ${{ steps.generate-token.outputs.token }}
           commit-message: sync with cpython ${{ env.LATEST_COMMIT_ID }}
@@ -50,15 +50,15 @@ jobs:
           base: ${{ env.VERSION }}
           branch: ${{ env.BRANCH }}
           delete-branch: false
-          title: 'Sync with CPython ${{ env.VERSION }}'
+          title: "Sync with CPython ${{ env.VERSION }}"
           body: |
             Sync with CPython ${{ env.VERSION }}
           draft: true
           labels: |
             sync-cpython
             automation
-          
+
       - name: Check outputs
         run: |
           echo "Pull Request Number - ${{ steps.cpr.outputs.pull-request-number }}"
-          echo "Pull Request URL - ${{ steps.cpr.outputs.pull-request-url }}"
+          echo "Pull Request URL - ${{ steps.cpr.outputs.pull-request-url }}"

.github/workflows/summarize_progress.yml

@@ -13,10 +13,10 @@ jobs:
         # added or changed files to the repository.
         contents: write
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
 
       - name: Install poetry
-        uses: abatilo/actions-poetry@v2
+        uses: abatilo/actions-poetry@v3
 
       - name: Execute Check Process
         run: |
@@ -26,7 +26,7 @@ jobs:
 
 
       - name: Checkout wiki code
-        uses: actions/checkout@v2
+        uses: actions/checkout@v4
         with:
           repository: ${{github.repository}}.wiki
           path: markdown

.gitignore

@@ -1,3 +1,12 @@
 *.mo
 __pycache__
 .DS_Store
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/

.scripts/poetry.lock

@@ -3,6 +3,7 @@
 # Here is what you can do:
 #
 # - make all # Automatically build an html local version
+# - make build <po-file>  # To build a single .po file
 # - make todo  # To list remaining tasks
 # - make merge  # To merge pot from upstream
 # - make fuzzy  # To find fuzzy strings
@@ -36,25 +37,23 @@ print('\n'.join(output))
 endef
 export PRINT_HELP_PYSCRIPT # End of python section
 
-CPYTHON_CLONE := ../cpython/
+CPYTHON_CLONE := ../cpython
+VERSION := $(or $(VERSION), 3.13)
 SPHINX_CONF := $(CPYTHON_CLONE)/Doc/conf.py
 LANGUAGE := zh_TW
 LC_MESSAGES := $(CPYTHON_CLONE)/Doc/locales/$(LANGUAGE)/LC_MESSAGES
 VENV := ~/.venvs/python-docs-i18n/
-PYTHON := $(shell which python3)
 MODE := autobuild-dev-html
-BRANCH := $(or $(VERSION), $(shell git describe --contains --all HEAD))
 JOBS := 4
 
 .PHONY: all
-all: $(VENV)/bin/sphinx-build $(VENV)/bin/blurb clone ## Automatically build an html local version
-	mkdir -p $(LC_MESSAGES)
+all: prepare_deps ## Automatically build an html local version
 	for dirname in $$(find . -name '*.po' | xargs -n1 dirname | sort -u | grep -v '^\.$$'); do mkdir -p $(LC_MESSAGES)/$$dirname; done
 	for file in *.po */*.po; do ln -f $$file $(LC_MESSAGES)/$$file; done
 	. $(VENV)/bin/activate; $(MAKE) -C $(CPYTHON_CLONE)/Doc/ SPHINXOPTS='-j$(JOBS) -D locale_dirs=locales -D language=$(LANGUAGE) -D gettext_compact=0' $(MODE)
 
 .PHONY: build
-build: $(VENV)/bin/sphinx-build $(VENV)/bin/blurb clone ## Automatically build an html local version
+build: prepare_deps ## Automatically build an html local version for a single file
 	@$(eval target=$(filter-out $@,$(MAKECMDGOALS)))
 	@if [ -z $(target) ]; then \
 		echo "\x1B[1;31m""Please provide a file argument.""\x1B[m"; \
@@ -68,32 +67,29 @@ build: $(VENV)/bin/sphinx-build $(VENV)/bin/blurb clone ## Automatically build a
 		echo "\x1B[1;31m""ERROR: $(target) not exist.""\x1B[m"; \
 		exit 1; \
 	fi
-	@mkdir -p $(LC_MESSAGES)
+
 	@$(eval dir=`echo $(target) | xargs -n1 dirname`) ## Get dir
-# If the build target is in under directory
-# We should make direcotry in $(LC_MESSAGES) and link the file.
-	@if [ $(dir) != "." ]; then \
-		echo "mkdir -p $(LC_MESSAGES)/$(dir)"; \
-		mkdir -p $(LC_MESSAGES)/$(dir); \
-		echo "ln -f ./$(target) $(LC_MESSAGES)/$(target)"; \
-		ln -f ./$(target) $(LC_MESSAGES)/$(target); \
-	fi
-# Build
-	@echo "----"
+	@mkdir -p $(LC_MESSAGES)/$(dir)
+	@ln -f ./$(target) $(LC_MESSAGES)/$(target)
+
 	@. $(VENV)/bin/activate; $(MAKE) -C $(CPYTHON_CLONE)/Doc/ SPHINXOPTS='-j$(JOBS) -D language=$(LANGUAGE) -D locale_dirs=locales -D gettext_compact=0' SOURCES='$(basename $(target)).rst' html
 
+
 help:
 	@python3 -c "$$PRINT_HELP_PYSCRIPT" < $(MAKEFILE_LIST)
 
-clone: ## Clone latest cpython repository to `../cpython/` if it doesn't exist
+.PHONY: prepare_deps
+prepare_deps: $(VENV)/bin/sphinx-build $(VENV)/bin/blurb upgrade_venv prepare_cpython  ## Prepare dependencies
+
+.PHONY: prepare_cpython
+prepare_cpython:  ## Prepare CPython clone at `../cpython/`.
 	git clone --depth 1 --no-single-branch https://github.com/python/cpython.git $(CPYTHON_CLONE)  || echo "cpython exists"
-	cd $(CPYTHON_CLONE) && git checkout $(BRANCH)
+	cd $(CPYTHON_CLONE) && git checkout $(VERSION) && git pull origin $(VERSION)
+	mkdir -p $(LC_MESSAGES)
 
 
 $(VENV)/bin/activate:
-	mkdir -p $(VENV)
-	$(PYTHON) -m venv $(VENV)
-
+	python3 -m venv $(VENV)
 
 $(VENV)/bin/sphinx-build: $(VENV)/bin/activate
 	. $(VENV)/bin/activate; python3 -m pip install sphinx python-docs-theme
@@ -107,7 +103,7 @@ $(VENV)/bin/blurb: $(VENV)/bin/activate
 
 .PHONY: upgrade_venv
 upgrade_venv: $(VENV)/bin/activate ## Upgrade the venv that compiles the doc
-	. $(VENV)/bin/activate; python3 -m pip install --upgrade sphinx python-docs-theme blurb sphinx-lint
+	@. $(VENV)/bin/activate; python3 -m pip install -q --upgrade sphinx python-docs-theme blurb sphinx-lint
 
 
 .PHONY: progress
@@ -123,10 +119,7 @@ todo: ## List remaining tasks
 
 
 .PHONY: merge
-merge: upgrade_venv ## To merge pot from upstream
-ifneq "$(shell cd $(CPYTHON_CLONE) 2>/dev/null && git describe --contains --all HEAD)" "$(BRANCH)"
-	$(error "You're merging from a different branch")
-endif
+merge: prepare_deps  ## To merge pot from upstream
 	(cd $(CPYTHON_CLONE)/Doc; rm -f build/NEWS)
 	(cd $(CPYTHON_CLONE)/Doc; $(VENV)/bin/sphinx-build -Q -b gettext -D gettext_compact=0 . locales/pot/)
 	find $(CPYTHON_CLONE)/Doc/locales/pot/ -name '*.pot' |\
@@ -145,7 +138,7 @@ endif
 
 .PHONY: update_txconfig
 update_txconfig:
-	curl -L https://rawgit.com/python-doc-ja/cpython-doc-catalog/catalog-$(BRANCH)/Doc/locales/.tx/config |\
+	curl -L https://rawgit.com/python-doc-ja/cpython-doc-catalog/catalog-$(VERSION)/Doc/locales/.tx/config |\
 		grep --invert-match '^file_filter = *' |\
 		sed -e 's/source_file = pot\/\(.*\)\.pot/trans.zh_TW = \1.po/' |\
 		sed -n 'w .tx/config'