gac 1.14.0__tar.gz → 1.15.0__tar.gz

{gac-1.14.0 → gac-1.15.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gac
-Version: 1.14.0
+Version: 1.15.0
 Summary: LLM-powered Git commit message generator with multi-provider support
 Project-URL: Homepage, https://github.com/cellwebb/gac
 Project-URL: Documentation, https://github.com/cellwebb/gac#readme
@@ -108,6 +108,13 @@ gac
 - **Standard** (default): Summary with bullet points explaining implementation details
 - **Verbose** (-v flag): Comprehensive explanations including motivation, technical approach, and impact analysis
 
+### 🌍 **Multilingual Support**
+
+- **25+ languages**: Generate commit messages in English, Chinese, Japanese, Korean, Spanish, French, German, and 20+ more languages
+- **Flexible translation**: Choose to keep conventional commit prefixes in English for tool compatibility, or fully translate them
+- **Multiple workflows**: Set a default language with `gac language`, or use `-l <language>` flag for one-time overrides
+- **Native script support**: Full support for non-Latin scripts including CJK, Cyrillic, Arabic, and more
+
 ### 💻 **Developer Experience**
 
 - **Interactive feedback**: Regenerate messages with specific requests like `r "make it shorter"` or `r "focus on the bug fix"`
@@ -197,6 +204,8 @@ ANTHROPIC_API_KEY=your_key_here
 
 See `.gac.env.example` for all available options.
 
+**Want commit messages in another language?** Run `gac language` to select from 25+ languages including Español, Français, 日本語, and more.
+
 **Want to customize commit message style?** See [docs/CUSTOM_SYSTEM_PROMPTS.md](docs/CUSTOM_SYSTEM_PROMPTS.md) for guidance on writing custom system prompts.
 
 ---

{gac-1.14.0 → gac-1.15.0}/README.md

@@ -67,6 +67,13 @@ gac
 - **Standard** (default): Summary with bullet points explaining implementation details
 - **Verbose** (-v flag): Comprehensive explanations including motivation, technical approach, and impact analysis
 
+### 🌍 **Multilingual Support**
+
+- **25+ languages**: Generate commit messages in English, Chinese, Japanese, Korean, Spanish, French, German, and 20+ more languages
+- **Flexible translation**: Choose to keep conventional commit prefixes in English for tool compatibility, or fully translate them
+- **Multiple workflows**: Set a default language with `gac language`, or use `-l <language>` flag for one-time overrides
+- **Native script support**: Full support for non-Latin scripts including CJK, Cyrillic, Arabic, and more
+
 ### 💻 **Developer Experience**
 
 - **Interactive feedback**: Regenerate messages with specific requests like `r "make it shorter"` or `r "focus on the bug fix"`
@@ -156,6 +163,8 @@ ANTHROPIC_API_KEY=your_key_here
 
 See `.gac.env.example` for all available options.
 
+**Want commit messages in another language?** Run `gac language` to select from 25+ languages including Español, Français, 日本語, and more.
+
 **Want to customize commit message style?** See [docs/CUSTOM_SYSTEM_PROMPTS.md](docs/CUSTOM_SYSTEM_PROMPTS.md) for guidance on writing custom system prompts.
 
 ---

{gac-1.14.0 → gac-1.15.0}/src/gac/__version__.py

@@ -1,3 +1,3 @@
 """Version information for gac package."""
 
-__version__ = "1.14.0"
+__version__ = "1.15.0"

{gac-1.14.0 → gac-1.15.0}/src/gac/cli.py

@@ -13,10 +13,11 @@ import click
 from gac import __version__
 from gac.config import load_config
 from gac.config_cli import config as config_cli
-from gac.constants import Logging
+from gac.constants import Languages, Logging
 from gac.diff_cli import diff as diff_cli
 from gac.errors import handle_error
 from gac.init_cli import init as init_cli
+from gac.language_cli import language as language_cli
 from gac.main import main
 from gac.utils import setup_logging
 
@@ -43,6 +44,9 @@ logger = logging.getLogger(__name__)
 @click.option("--hint", "-h", default="", help="Additional context to include in the prompt")
 # Model options
 @click.option("--model", "-m", help="Override the default model (format: 'provider:model_name')")
+@click.option(
+    "--language", "-l", help="Override the language for commit messages (e.g., 'Spanish', 'es', 'zh-CN', 'ja')"
+)
 # Output options
 @click.option("--quiet", "-q", is_flag=True, help="Suppress non-error output")
 @click.option(
@@ -75,6 +79,7 @@ def cli(
     yes: bool = False,
     hint: str = "",
     model: str | None = None,
+    language: str | None = None,
     version: bool = False,
     dry_run: bool = False,
     verbose: bool = False,
@@ -98,6 +103,9 @@ def cli(
         # Determine if verbose mode should be enabled based on -v flag or verbose config setting
         use_verbose = bool(verbose or config.get("verbose", False))
 
+        # Resolve language code to full name if provided
+        resolved_language = Languages.resolve_code(language) if language else None
+
         try:
             main(
                 stage_all=add_all,
@@ -113,6 +121,7 @@ def cli(
                 verbose=use_verbose,
                 no_verify=no_verify,
                 skip_secret_scan=skip_secret_scan or bool(config.get("skip_secret_scan", False)),
+                language=resolved_language,
             )
         except Exception as e:
             handle_error(e, exit_program=True)
@@ -131,6 +140,7 @@ def cli(
             "yes": yes,
             "hint": hint,
             "model": model,
+            "language": language,
             "version": version,
             "dry_run": dry_run,
             "verbose": verbose,
@@ -141,6 +151,7 @@ def cli(
 
 cli.add_command(config_cli)
 cli.add_command(init_cli)
+cli.add_command(language_cli)
 cli.add_command(diff_cli)
 
 if __name__ == "__main__":

{gac-1.14.0 → gac-1.15.0}/src/gac/config.py

@@ -39,6 +39,8 @@ def load_config() -> dict[str, str | int | float | bool | None]:
         in ("true", "1", "yes", "on"),
         "verbose": os.getenv("GAC_VERBOSE", str(EnvDefaults.VERBOSE)).lower() in ("true", "1", "yes", "on"),
         "system_prompt_path": os.getenv("GAC_SYSTEM_PROMPT_PATH"),
+        "language": os.getenv("GAC_LANGUAGE"),
+        "translate_prefixes": os.getenv("GAC_TRANSLATE_PREFIXES", "false").lower() in ("true", "1", "yes", "on"),
     }
 
     return config

{gac-1.14.0 → gac-1.15.0}/src/gac/constants.py

@@ -152,6 +152,93 @@ class CodePatternImportance:
     }
 
 
+class Languages:
+    """Language code mappings and utilities."""
+
+    # Language code to full name mapping
+    # Supports ISO 639-1 codes and common variants
+    CODE_MAP: dict[str, str] = {
+        # English
+        "en": "English",
+        # Chinese
+        "zh": "Simplified Chinese",
+        "zh-cn": "Simplified Chinese",
+        "zh-hans": "Simplified Chinese",
+        "zh-tw": "Traditional Chinese",
+        "zh-hant": "Traditional Chinese",
+        # Japanese
+        "ja": "Japanese",
+        # Korean
+        "ko": "Korean",
+        # Spanish
+        "es": "Spanish",
+        # Portuguese
+        "pt": "Portuguese",
+        # French
+        "fr": "French",
+        # German
+        "de": "German",
+        # Russian
+        "ru": "Russian",
+        # Hindi
+        "hi": "Hindi",
+        # Italian
+        "it": "Italian",
+        # Polish
+        "pl": "Polish",
+        # Turkish
+        "tr": "Turkish",
+        # Dutch
+        "nl": "Dutch",
+        # Vietnamese
+        "vi": "Vietnamese",
+        # Thai
+        "th": "Thai",
+        # Indonesian
+        "id": "Indonesian",
+        # Swedish
+        "sv": "Swedish",
+        # Arabic
+        "ar": "Arabic",
+        # Hebrew
+        "he": "Hebrew",
+        # Greek
+        "el": "Greek",
+        # Danish
+        "da": "Danish",
+        # Norwegian
+        "no": "Norwegian",
+        "nb": "Norwegian",
+        "nn": "Norwegian",
+        # Finnish
+        "fi": "Finnish",
+    }
+
+    @staticmethod
+    def resolve_code(language: str) -> str:
+        """Resolve a language code to its full name.
+
+        Args:
+            language: Language name or code (e.g., 'Spanish', 'es', 'zh-CN')
+
+        Returns:
+            Full language name (e.g., 'Spanish', 'Simplified Chinese')
+
+        If the input is already a full language name, it's returned as-is.
+        If it's a recognized code, it's converted to the full name.
+        Otherwise, the input is returned unchanged (for custom languages).
+        """
+        # Normalize the code to lowercase for lookup
+        code_lower = language.lower().strip()
+
+        # Check if it's a recognized code
+        if code_lower in Languages.CODE_MAP:
+            return Languages.CODE_MAP[code_lower]
+
+        # Return as-is (could be a full name or custom language)
+        return language
+
+
 class CommitMessageConstants:
     """Constants for commit message generation and cleaning."""
 

{gac-1.14.0 → gac-1.15.0}/src/gac/init_cli.py

@@ -151,4 +151,79 @@ def init() -> None:
     elif is_ollama or is_lmstudio:
         click.echo("Skipping API key. You can add one later if needed.")
 
+    # Language selection
+    click.echo("\n")
+    languages = [
+        ("English", "English"),
+        ("简体中文", "Simplified Chinese"),
+        ("繁體中文", "Traditional Chinese"),
+        ("日本語", "Japanese"),
+        ("한국어", "Korean"),
+        ("Español", "Spanish"),
+        ("Português", "Portuguese"),
+        ("Français", "French"),
+        ("Deutsch", "German"),
+        ("Русский", "Russian"),
+        ("हिन्दी", "Hindi"),
+        ("Italiano", "Italian"),
+        ("Polski", "Polish"),
+        ("Türkçe", "Turkish"),
+        ("Nederlands", "Dutch"),
+        ("Tiếng Việt", "Vietnamese"),
+        ("ไทย", "Thai"),
+        ("Bahasa Indonesia", "Indonesian"),
+        ("Svenska", "Swedish"),
+        ("العربية", "Arabic"),
+        ("עברית", "Hebrew"),
+        ("Ελληνικά", "Greek"),
+        ("Dansk", "Danish"),
+        ("Norsk", "Norwegian"),
+        ("Suomi", "Finnish"),
+        ("Custom", "Custom"),
+    ]
+
+    display_names = [lang[0] for lang in languages]
+    language_selection = questionary.select(
+        "Select a language for commit messages:", choices=display_names, use_shortcuts=True, use_arrow_keys=True
+    ).ask()
+
+    if not language_selection:
+        click.echo("Language selection cancelled. Using English (default).")
+    elif language_selection == "English":
+        click.echo("Set language to English (default)")
+    else:
+        # Handle custom input
+        if language_selection == "Custom":
+            custom_language = questionary.text("Enter the language name (e.g., 'Spanish', 'Français', '日本語'):").ask()
+            if not custom_language or not custom_language.strip():
+                click.echo("No language entered. Using English (default).")
+                language_value = None
+            else:
+                language_value = custom_language.strip()
+        else:
+            # Find the English name for the selected language
+            language_value = next(lang[1] for lang in languages if lang[0] == language_selection)
+
+        if language_value:
+            # Ask about prefix translation
+            prefix_choice = questionary.select(
+                "How should conventional commit prefixes be handled?",
+                choices=[
+                    "Keep prefixes in English (feat:, fix:, etc.)",
+                    f"Translate prefixes into {language_value}",
+                ],
+            ).ask()
+
+            if not prefix_choice:
+                click.echo("Prefix translation selection cancelled. Using English prefixes.")
+                translate_prefixes = False
+            else:
+                translate_prefixes = prefix_choice.startswith("Translate prefixes")
+
+            # Set the language and prefix translation preference
+            set_key(str(GAC_ENV_PATH), "GAC_LANGUAGE", language_value)
+            set_key(str(GAC_ENV_PATH), "GAC_TRANSLATE_PREFIXES", "true" if translate_prefixes else "false")
+            click.echo(f"Set GAC_LANGUAGE={language_value}")
+            click.echo(f"Set GAC_TRANSLATE_PREFIXES={'true' if translate_prefixes else 'false'}")
+
     click.echo(f"\ngac environment setup complete. You can edit {GAC_ENV_PATH} to update values later.")

gac-1.15.0/src/gac/language_cli.py

@@ -0,0 +1,111 @@
+"""CLI for selecting commit message language interactively."""
+
+from pathlib import Path
+
+import click
+import questionary
+from dotenv import set_key, unset_key
+
+GAC_ENV_PATH = Path.home() / ".gac.env"
+
+
+@click.command()
+def language() -> None:
+    """Set the language for commit messages interactively."""
+    click.echo("Select a language for your commit messages:\n")
+
+    # Languages sorted by programmer population likelihood
+    # Based on GitHub statistics and global developer demographics
+    languages = [
+        ("English", "English"),
+        ("简体中文", "Simplified Chinese"),
+        ("繁體中文", "Traditional Chinese"),
+        ("日本語", "Japanese"),
+        ("한국어", "Korean"),
+        ("Español", "Spanish"),
+        ("Português", "Portuguese"),
+        ("Français", "French"),
+        ("Deutsch", "German"),
+        ("Русский", "Russian"),
+        ("हिन्दी", "Hindi"),
+        ("Italiano", "Italian"),
+        ("Polski", "Polish"),
+        ("Türkçe", "Turkish"),
+        ("Nederlands", "Dutch"),
+        ("Tiếng Việt", "Vietnamese"),
+        ("ไทย", "Thai"),
+        ("Bahasa Indonesia", "Indonesian"),
+        ("Svenska", "Swedish"),
+        ("العربية", "Arabic"),
+        ("עברית", "Hebrew"),
+        ("Ελληνικά", "Greek"),
+        ("Dansk", "Danish"),
+        ("Norsk", "Norwegian"),
+        ("Suomi", "Finnish"),
+        ("Custom", "Custom"),
+    ]
+
+    display_names = [lang[0] for lang in languages]
+    selection = questionary.select(
+        "Choose your language:", choices=display_names, use_shortcuts=True, use_arrow_keys=True
+    ).ask()
+
+    if not selection:
+        click.echo("Language selection cancelled.")
+        return
+
+    # Ensure .gac.env exists
+    if not GAC_ENV_PATH.exists():
+        GAC_ENV_PATH.touch()
+        click.echo(f"Created {GAC_ENV_PATH}")
+
+    # Handle English (default) - remove the setting
+    if selection == "English":
+        try:
+            unset_key(str(GAC_ENV_PATH), "GAC_LANGUAGE")
+            click.echo("✓ Set language to English (default)")
+            click.echo(f"  Removed GAC_LANGUAGE from {GAC_ENV_PATH}")
+        except Exception:
+            click.echo("✓ Set language to English (default)")
+        return
+
+    # Handle custom input
+    if selection == "Custom":
+        custom_language = questionary.text("Enter the language name (e.g., 'Spanish', 'Français', '日本語'):").ask()
+        if not custom_language or not custom_language.strip():
+            click.echo("No language entered. Cancelled.")
+            return
+        language_value = custom_language.strip()
+    else:
+        # Find the English name for the selected language
+        language_value = next(lang[1] for lang in languages if lang[0] == selection)
+
+    # Ask about prefix translation
+    click.echo()  # Blank line for spacing
+    prefix_choice = questionary.select(
+        "How should conventional commit prefixes be handled?",
+        choices=[
+            "Keep prefixes in English (feat:, fix:, etc.)",
+            f"Translate prefixes into {language_value}",
+        ],
+    ).ask()
+
+    if not prefix_choice:
+        click.echo("Prefix translation selection cancelled.")
+        return
+
+    translate_prefixes = prefix_choice.startswith("Translate prefixes")
+
+    # Set the language and prefix translation preference in .gac.env
+    set_key(str(GAC_ENV_PATH), "GAC_LANGUAGE", language_value)
+    set_key(str(GAC_ENV_PATH), "GAC_TRANSLATE_PREFIXES", "true" if translate_prefixes else "false")
+
+    click.echo(f"\n✓ Set language to {selection}")
+    click.echo(f"  GAC_LANGUAGE={language_value}")
+    if translate_prefixes:
+        click.echo("  GAC_TRANSLATE_PREFIXES=true")
+        click.echo("\n  Prefixes will be translated (e.g., 'corrección:' instead of 'fix:')")
+    else:
+        click.echo("  GAC_TRANSLATE_PREFIXES=false")
+        click.echo(f"\n  Prefixes will remain in English (e.g., 'fix: <{language_value} description>')")
+    click.echo(f"\n  Configuration saved to {GAC_ENV_PATH}")

{gac-1.14.0 → gac-1.15.0}/src/gac/main.py

@@ -46,6 +46,7 @@ def main(
     verbose: bool = False,
     no_verify: bool = False,
     skip_secret_scan: bool = False,
+    language: str | None = None,
 ) -> None:
     """Main application logic for gac."""
     try:
@@ -186,6 +187,14 @@ def main(
         system_template_path_value if isinstance(system_template_path_value, str) else None
     )
 
+    # Use language parameter if provided, otherwise fall back to config
+    if language is None:
+        language_value = config.get("language")
+        language = language_value if isinstance(language_value, str) else None
+
+    translate_prefixes_value = config.get("translate_prefixes")
+    translate_prefixes: bool = bool(translate_prefixes_value) if isinstance(translate_prefixes_value, bool) else False
+
     system_prompt, user_prompt = build_prompt(
         status=status,
         processed_diff=processed_diff,
@@ -195,6 +204,8 @@ def main(
         infer_scope=infer_scope,
         verbose=verbose,
         system_template_path=system_template_path,
+        language=language,
+        translate_prefixes=translate_prefixes,
     )
 
     if show_prompt:
@@ -244,10 +255,8 @@ def main(
                 max_retries=max_retries,
                 quiet=quiet,
             )
-            # Don't enforce conventional commits when using custom system prompts
-            commit_message = clean_commit_message(
-                raw_commit_message, enforce_conventional_commits=(system_template_path is None)
-            )
+            # Clean the commit message (no automatic prefix enforcement)
+            commit_message = clean_commit_message(raw_commit_message)
 
             logger.info("Generated commit message:")
             logger.info(commit_message)

{gac-1.14.0 → gac-1.15.0}/src/gac/prompt.py

@@ -263,6 +263,12 @@ IMMEDIATELY AFTER ANALYZING THE CHANGES, RESPOND WITH ONLY THE COMMIT MESSAGE.
 DO NOT include any preamble, reasoning, explanations or anything other than the commit message itself.
 DO NOT use markdown formatting, headers, or code blocks.
 The entire response will be passed directly to 'git commit -m'.
+
+<language>
+IMPORTANT: You MUST write the entire commit message in <language_name></language_name>.
+All text in the commit message, including the summary line and body, must be in <language_name></language_name>.
+<prefix_instruction></prefix_instruction>
+</language>
 </instructions>"""
 
 
@@ -449,6 +455,8 @@ def build_prompt(
     hint: str = "",
     verbose: bool = False,
     system_template_path: str | None = None,
+    language: str | None = None,
+    translate_prefixes: bool = False,
 ) -> tuple[str, str]:
     """Build system and user prompts for the AI model using the provided templates and git information.
 
@@ -461,6 +469,8 @@ def build_prompt(
         hint: Optional hint to guide the AI
         verbose: Whether to generate detailed commit messages with motivation, architecture, and impact sections
         system_template_path: Optional path to custom system template
+        language: Optional language for commit messages (e.g., "Spanish", "French", "Japanese")
+        translate_prefixes: Whether to translate conventional commit prefixes (default: False keeps them in English)
 
     Returns:
         Tuple of (system_prompt, user_prompt) ready to be sent to an AI model
@@ -484,6 +494,33 @@ def build_prompt(
         user_template = _remove_template_section(user_template, "hint")
         logger.debug("No hint provided")
 
+    if language:
+        user_template = user_template.replace("<language_name></language_name>", language)
+
+        # Set prefix instruction based on translate_prefixes setting
+        if translate_prefixes:
+            prefix_instruction = f"""CRITICAL: You MUST translate the conventional commit prefix into {language}.
+DO NOT use English prefixes like 'feat:', 'fix:', 'docs:', etc.
+Instead, translate them into {language} equivalents.
+Examples:
+- 'feat:' → translate to {language} word for 'feature' or 'add'
+- 'fix:' → translate to {language} word for 'fix' or 'correct'
+- 'docs:' → translate to {language} word for 'documentation'
+The ENTIRE commit message, including the prefix, must be in {language}."""
+            logger.debug(f"Set commit message language to: {language} (with prefix translation)")
+        else:
+            prefix_instruction = (
+                "The conventional commit prefix (feat:, fix:, etc.) should remain in English, but everything after the prefix must be in "
+                + language
+                + "."
+            )
+            logger.debug(f"Set commit message language to: {language} (English prefixes)")
+
+        user_template = user_template.replace("<prefix_instruction></prefix_instruction>", prefix_instruction)
+    else:
+        user_template = _remove_template_section(user_template, "language")
+        logger.debug("Using default language (English)")
+
     user_template = re.sub(r"\n(?:[ \t]*\n){2,}", "\n\n", user_template)
 
     return system_template.strip(), user_template.strip()
@@ -636,20 +673,18 @@ def _normalize_whitespace(message: str) -> str:
 # ============================================================================
 
 
-def clean_commit_message(message: str, enforce_conventional_commits: bool = True) -> str:
+def clean_commit_message(message: str) -> str:
     """Clean up a commit message generated by an AI model.
 
     This function:
     1. Removes any preamble or reasoning text
     2. Removes code block markers and formatting
     3. Removes XML tags that might have leaked into the response
-    4. Ensures the message starts with a conventional commit prefix (if enforce_conventional_commits is True)
-    5. Fixes double type prefix issues (e.g., "chore: feat(scope):")
+    4. Fixes double type prefix issues (e.g., "chore: feat(scope):")
+    5. Normalizes whitespace
 
     Args:
         message: Raw commit message from AI
-        enforce_conventional_commits: If True, ensures message has conventional commit prefix.
-                                      Set to False when using custom system prompts.
 
     Returns:
         Cleaned commit message ready for use
@@ -660,7 +695,5 @@ def clean_commit_message(message: str, enforce_conventional_commits: bool = True
     message = _extract_commit_from_reasoning(message)
     message = _remove_xml_tags(message)
     message = _fix_double_prefix(message)
-    if enforce_conventional_commits:
-        message = _ensure_conventional_prefix(message)
     message = _normalize_whitespace(message)
     return message