feat: Add aider translation support

Author: josix

.gitignore

@@ -10,3 +10,4 @@ venv/
 ENV/
 env.bak/
 venv.bak/
+.aider*

.scripts/intercept.py

@@ -0,0 +1,42 @@
+# /// script
+# dependencies = [
+#     "polib",
+# ]
+# ///
+import argparse
+from pathlib import Path
+
+import polib
+
+
+def get_pofile_from_path(path: Path) -> polib.POFile:
+    if not path.exists():
+        raise ValueError(f"The path '{path.absolute()}' does not exist!")
+
+    if not (path.is_file() and path.suffix == ".po"):
+        raise ValueError(f"{path} doesn't seem to be a .po file")
+
+    try:
+        pofile = polib.pofile(path)
+    except OSError:
+        raise ValueError(f"{path} doesn't seem to be a .po file")
+    return pofile
+
+
+if __name__ == '__main__':
+    parser = argparse.ArgumentParser()
+    parser.add_argument(
+        "path",
+        help="the path of a PO file",
+    )
+    parser.add_argument("-n", '--occurrence_number', type=int, default=1)
+    args = parser.parse_args()
+    path = Path(args.path).resolve()
+    pofile = get_pofile_from_path(path)
+    occurrence_number = args.occurrence_number
+
+    for entry in pofile:
+        if not any(path.stem in p and int(n) == occurrence_number for p, n in entry.occurrences):
+            continue
+        print(entry.msgid)
+        break

Makefile

@@ -100,6 +100,9 @@ $(VENV)/bin/sphinx-lint: $(VENV)/bin/activate
 $(VENV)/bin/blurb: $(VENV)/bin/activate
 	. $(VENV)/bin/activate; python3 -m pip install blurb
 
+$(VENV)/bin/aider: $(VENV)/bin/activate
+	. $(VENV)/bin/activate; python3 -m pip install aider-chat
+
 
 .PHONY: upgrade_venv
 upgrade_venv: $(VENV)/bin/activate ## Upgrade the venv that compiles the doc
@@ -156,6 +159,16 @@ rm_cpython: ## Remove cloned cpython repo
 lint:  $(VENV)/bin/sphinx-lint  ## Run sphinx-lint
 	$(VENV)/bin/sphinx-lint --enable default-role
 
+.PHONY: translate
+translate:  $(VENV)/bin/aider  ## Run translation with aider. Usage: make translate FILE=path/to/file.po LINE=number
+	@if [ -z "$(FILE)" ] || [ -z "$(LINE)" ]; then \
+		echo "\x1B[1;31mError: Both FILE and LINE arguments are required.\x1B[0m"; \
+		echo "Usage: make translate FILE=path/to/file.po LINE=number"; \
+		exit 1; \
+	fi
+	$(eval MESSAGE=$(shell python3 .scripts/intercept.py $(FILE) -n $(LINE)))
+	aider --no-auto-commits --message 'Translate the following Python documentation into Tranditional Chinese for $(FILE):$(LINE) with message $(MESSAGE). Ensure that the translation is accurate and uses appropriate technical terminology. The output must be in Traditional Chinese. Pay careful attention to context, idiomatic expressions, and any specialized vocabulary related to Python programming. Maintain the structure and format of the original documentation as much as possible to ensure clarity and usability for readers.' $(FILE)
+
 # This allows us to accept extra arguments (by doing nothing when we get a job that doesn't match, rather than throwing an error)
 %:
 	@: