fix(localize): Allow empty xgettext extraction

If xgettext produces no messages, x_extract now detects that the .pot/.po file wasn't created, prints a notice and returns early instead of attempting to rewrite the header. Adds a unit test to verify extraction succeeds when xgettext writes no messages and no template file is produced. This prevents errors when projects have no translatable strings.

Author: ReenigneArcher

scripts/localize.py

@@ -509,6 +509,10 @@ def x_extract(context: LocaleContext):
     ]
 
     run_command(command=command, root_dir=context.root_dir)
+    if not os.path.exists(pot_filepath):
+        print(f'No gettext messages found; {pot_filepath} was not generated.')
+        return
+
     rewrite_pot_header(context=context, pot_filepath=pot_filepath)
 
 

tests/unit/test_localize.py

@@ -426,6 +426,53 @@ def fake_check_output(args, cwd):
         )
 
 
+def test_x_extract_allows_empty_extraction(monkeypatch, tmp_path):
+    """Verify extraction succeeds when xgettext has no messages to write."""
+
+    root_dir = str(tmp_path)
+    os.makedirs(os.path.join(root_dir, 'src'))
+    with open(os.path.join(root_dir, 'src', 'main.cpp'), mode='w', encoding='utf-8') as file:
+        file.write('int main() { return 0; }\n')
+
+    context = localize.build_context(args=parse_args('--root-dir', root_dir, '--project-name', 'Example'))
+    calls = []
+
+    def fake_check_output(args, cwd):
+        """Record xgettext calls without creating a template file."""
+
+        calls.append({
+            'args': args,
+            'cwd': cwd,
+        })
+
+    monkeypatch.setattr(localize.subprocess, 'check_output', fake_check_output)
+
+    localize.x_extract(context=context)
+
+    assert calls == [
+        {
+            'args': [
+                'xgettext',
+                *[f'--keyword={keyword}' for keyword in localize.DEFAULT_KEYWORDS],
+                '--default-domain=example',
+                f'--output={os.path.join(context.locale_dir, "example.po")}',
+                '--language=C++',
+                '--boost',
+                '--from-code=utf-8',
+                '-F',
+                '--msgid-bugs-address=https://github.com/Example/Example',
+                '--copyright-holder=Example',
+                '--package-name=Example',
+                '--package-version=v0',
+                os.path.join('src', 'main.cpp'),
+            ],
+            'cwd': root_dir,
+        },
+    ]
+    assert os.path.isdir(context.locale_dir)
+    assert not os.path.exists(os.path.join(context.locale_dir, 'example.po'))
+
+
 def test_x_extract_requires_source_files(tmp_path):
     """Verify extraction fails clearly when no source files are found."""