fixup! feat: Add aider translation support

Author: josix

Diff for: .scripts/intercept.py

@@ -1,8 +1,17 @@
-# /// script
-# dependencies = [
-#     "polib",
-# ]
-# ///
+"""
+A utility script to extract message IDs from PO files.
+
+This script extracts a specific message ID from a PO file based on the file name
+and occurrence number. It's useful for retrieving translation strings for
+specific occurrences in the Python documentation.
+
+Usage:
+    python intercept.py path/to/file.po [-n OCCURRENCE_NUMBER]
+
+Arguments:
+    path: Path to a PO file
+    -n, --occurrence_number: The occurrence number to match (default: 1)
+"""
 import argparse
 from pathlib import Path
 
@@ -24,11 +33,13 @@ def get_pofile_from_path(path: Path) -> polib.POFile:
 
 
 if __name__ == '__main__':
-    parser = argparse.ArgumentParser()
+    parser = argparse.ArgumentParser(
+        description="Extract message IDs from PO files"
+    )
     parser.add_argument("path", type=Path,
                         help="the path of a PO file")
     parser.add_argument("-n", '--occurrence_number',
-                        type=int, default=1)
+                        type=int, default=1, help="the occurrence number to match")
     args = parser.parse_args()
     path = args.path.resolve()
     pofile = get_pofile_from_path(path)