Merge branch '3.12' into library/math

Author: Carisa-Li

.github/workflows/summarize_progress.yml

@@ -6,6 +6,7 @@ on:
 
 jobs:
   ci:
+    if: github.repository == 'python/python-docs-zh-tw'
     runs-on: ubuntu-latest
     permissions:
         # Give the default GITHUB_TOKEN write permission to commit and push the
@@ -32,7 +33,7 @@ jobs:
 
       - name: Copy content
         run: |
-            cp .scripts/summarize_progress/dist/summarize_progress.md markdown/各檔案翻譯進度清單.md
+            cp .scripts/summarize_progress/result.md markdown/各檔案翻譯進度清單.md
         shell: bash
 
       - name: Commit wiki code

.scripts/poetry.lock

@@ -1,7 +1,6 @@
 import re
 import polib
 import glob
-import datetime
 import requests
 
 from pathlib import Path
@@ -23,7 +22,7 @@ def entry_check(pofile: polib.POFile) -> str:
         lines_all = lines_tranlated + lines_untranlated
         progress = lines_tranlated / lines_all
         progress_percentage = round(progress * 100, 2)
-        result = f"Ongoing, {progress_percentage} %"
+        result = f"{progress_percentage} %"
 
     return result
 
@@ -51,9 +50,11 @@ def get_github_issues() -> list:
 
     Steps:
     1. Fetch GitHub API and get open issue list
-    2. Filter the issue if it have no assignee
-    3. Filter the issue if it have no "Translate" in the title
-    4. Filter the issue if it have no correct filepath in the title
+    2. Filter the issue if it have no "Translate" in the title
+    3. Filter the issue if it have no correct filepath in the title
+
+    Expected Output:
+    [ ((dirname, filename), assignee_id, issue_url), ... ]
     '''
     NUMBER_OF_ISSUES = get_open_issues_count()
 
@@ -67,31 +68,41 @@ def get_github_issues() -> list:
 
     result_list = []
     for issue in result["items"]:
-        if issue["assignee"] is None:
-            continue
+        assignee = issue["assignee"]["login"] if issue["assignee"] else ""
 
         title = issue["title"]
         if "翻譯" not in title and "translate" not in title.lower():
             continue
 
-        match = re.search("(?P<dirname>[^\s`][a-zA-z-]+)/(?P<filename>[a-zA-Z0-9._-]+(.po)?)", title)
+        match = re.search(
+            "(?P<dirname>[^\s`][a-zA-z-]+)/(?P<filename>[a-zA-Z0-9._-]+(.po)?)", title)
         if not match:
             continue
 
         dirname, filename = match.group('dirname', 'filename')
         if not filename.endswith('.po'):
             filename += '.po'
 
-        result_list.append(((dirname, filename), issue["assignee"]["login"]))
+        result_list.append(((dirname, filename), assignee, issue["html_url"]))
 
     return result_list
 
-def format_line_file(filename: str, result: str) -> str:
-    return f"  - {filename.ljust(37, '-')}{result}\r\n"
+
+def format_line_table_header() -> list:
+    return [f"|Filename|Progress|Issue|Assignee|\r\n",
+            f"|-------:|:-------|:----|:-------|\r\n"]
+
+
+def format_issue_link(url: str) -> str:
+    return f"[{url.split('/')[-1]}]({url})" if len(url) > 0 else ''
+
+
+def format_line_file(filename: str, data: dict) -> str:
+    return f"|`{filename}`|{data['progress']}|{format_issue_link(data['issue'])}|{data['assignee']}|\r\n"
 
 
 def format_line_directory(dirname: str) -> str:
-    return f"- {dirname}/\r\n"
+    return f"## {dirname}\r\n"
 
 
 if __name__ == "__main__":
@@ -108,17 +119,27 @@ def format_line_directory(dirname: str) -> str:
         filename = path.name
         dirname = path.parent.name if path.parent.name != BASE_DIR.name else '/'
         po = polib.pofile(filepath)
-        summary.setdefault(dirname, {})[filename] = entry_check(po)
+
+        summary.setdefault(dirname, {})[filename] = {
+            'progress': entry_check(po),
+            'issue': '',
+            'assignee': '',
+        }
 
     '''
     Unpack the open issue list, and add assignee after the progress
     '''
-    for (category, filename), assignee in issue_list:
+    for (category, filename), assignee, issue_url in issue_list:
         try:
-            summary[category][filename] += f", 💻 {assignee}"
+            summary[category][filename]['issue'] = issue_url
+            summary[category][filename]['assignee'] = assignee
         except KeyError:
             pass
 
+    '''
+    Adding Space for Formatting Markdown Link
+    '''
+
     '''
     Format the lines that will write into the markdown file,
     also sort the directory name and file name.
@@ -127,12 +148,14 @@ def format_line_directory(dirname: str) -> str:
     summary_sorted = dict(sorted(summary.items()))
     for dirname, filedict in summary_sorted.items():
         writeliner.append(format_line_directory(dirname))
+        writeliner.extend(format_line_table_header())
+
         filedict_sorted = dict(sorted(filedict.items()))
-        for filename, result in filedict_sorted.items():
-            writeliner.append(format_line_file(filename, result))
+        for filename, filedata in filedict_sorted.items():
+            writeliner.append(format_line_file(filename, filedata))
 
     with open(
-        f"summarize_progress/dist/summarize_progress.md",
+        f"summarize_progress/result.md",
         "w",
     ) as file:
         file.writelines(writeliner)

.scripts/summarize_progress/dist/summarize_progress.md

@@ -53,6 +53,35 @@ all: $(VENV)/bin/sphinx-build $(VENV)/bin/blurb clone ## Automatically build an
 	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
+	@$(eval target=$(filter-out $@,$(MAKECMDGOALS)))
+	@if [ -z $(target) ]; then \
+		echo "\x1B[1;31m""Please provide a file argument.""\x1B[m"; \
+		exit 1; \
+	fi
+	@if [ "$(suffix $(target))" != ".po" ]; then \
+		echo "\x1B[1;31m""Incorrect file extension. Only '.po' files are allowed.""\x1B[m"; \
+		exit 1; \
+	fi
+	@if [[ ! -f "$(target)" ]] ; then \
+		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 "----"
+	@. $(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)
 
@@ -133,3 +162,7 @@ rm_cpython: ## Remove cloned cpython repo
 .PHONY: lint
 lint:  $(VENV)/bin/sphinx-lint  ## Run sphinx-lint
 	$(VENV)/bin/sphinx-lint --enable default-role
+
+# This allows us to accept extra arguments (by doing nothing when we get a job that doesn't match, rather than throwing an error)
+%:
+	@:

.scripts/summarize_progress/main.py

@@ -13,7 +13,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: Python 3.12\n"
 "Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-11-05 09:50+0000\n"
+"POT-Creation-Date: 2024-04-18 00:04+0000\n"
 "PO-Revision-Date: 2022-08-31 12:34+0800\n"
 "Last-Translator: Steven Hsu <[email protected]>\n"
 "Language-Team: Chinese - TAIWAN (https://github.com/python/python-docs-zh-"
@@ -82,7 +82,7 @@ msgstr ""
 "（程式碼執行的錯誤可以寄到 [email protected]）。「docs@」是一個由志工們"
 "所運行的郵寄清單；您的請求會被注意到，但可能需要一些時間才會被處理。"
 
-#: ../../bugs.rst:33
+#: ../../bugs.rst:32
 msgid "`Documentation bugs`_"
 msgstr "`說明文件錯誤`_"
 
@@ -92,7 +92,7 @@ msgid ""
 "tracker."
 msgstr "一系列已被提交至 Python 問題追蹤系統的有關說明文件的錯誤。"
 
-#: ../../bugs.rst:36
+#: ../../bugs.rst:35
 msgid "`Issue Tracking <https://devguide.python.org/tracker/>`_"
 msgstr "`問題追蹤系統 <https://devguide.python.org/tracker/>`_"
 
@@ -101,7 +101,7 @@ msgid ""
 "Overview of the process involved in reporting an improvement on the tracker."
 msgstr "在追蹤系統上回報改進建議的過程簡介。"
 
-#: ../../bugs.rst:39
+#: ../../bugs.rst:38
 msgid ""
 "`Helping with Documentation <https://devguide.python.org/docquality/#helping-"
 "with-documentation>`_"
@@ -209,7 +209,7 @@ msgstr ""
 "每一份問題報告都會被一位開發人員查核，並由他決定要做出什麼變更來修正這個問"
 "題。每當該問題有修正動作時，您會收到更新回報。"
 
-#: ../../bugs.rst:89
+#: ../../bugs.rst:87
 msgid ""
 "`How to Report Bugs Effectively <https://www.chiark.greenend.org.uk/"
 "~sgtatham/bugs.html>`_"
@@ -225,7 +225,7 @@ msgstr ""
 "這篇文章詳細說明如何建立一份有用的錯誤報告。它描述了什麼樣的資訊是有用的，以"
 "及這些資訊為什麼有用。"
 
-#: ../../bugs.rst:92
+#: ../../bugs.rst:91
 msgid ""
 "`Bug Writing Guidelines <https://bugzilla.mozilla.org/page.cgi?id=bug-"
 "writing.html>`_"