gac 1.13.1__tar.gz → 1.15.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gac
-Version: 1.13.1
+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,11 +204,16 @@ 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.
+
 ---
 
 ## Getting Help
 
 - **Full documentation**: [USAGE.md](USAGE.md) - Complete CLI reference
+- **Custom prompts**: [CUSTOM_SYSTEM_PROMPTS.md](docs/CUSTOM_SYSTEM_PROMPTS.md) - Customize commit message style
 - **Troubleshooting**: [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) - Common issues and solutions
 - **Contributing**: [CONTRIBUTING.md](docs/CONTRIBUTING.md) - Development setup and guidelines
 

{gac-1.13.1 → 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,11 +163,16 @@ 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.
+
 ---
 
 ## Getting Help
 
 - **Full documentation**: [USAGE.md](USAGE.md) - Complete CLI reference
+- **Custom prompts**: [CUSTOM_SYSTEM_PROMPTS.md](docs/CUSTOM_SYSTEM_PROMPTS.md) - Customize commit message style
 - **Troubleshooting**: [TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md) - Common issues and solutions
 - **Contributing**: [CONTRIBUTING.md](docs/CONTRIBUTING.md) - Development setup and guidelines
 

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

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

{gac-1.13.1 → 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.13.1 → gac-1.15.0}/src/gac/config.py

@@ -38,6 +38,9 @@ def load_config() -> dict[str, str | int | float | bool | None]:
         "skip_secret_scan": os.getenv("GAC_SKIP_SECRET_SCAN", str(EnvDefaults.SKIP_SECRET_SCAN)).lower()
         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.13.1 → gac-1.15.0}/src/gac/constants.py

@@ -150,3 +150,139 @@ class CodePatternImportance:
         r"\+\s*(test|describe|it|should)\s*\(": 1.1,  # Test definitions
         r"\+\s*(assert|expect)": 1.0,  # Assertions
     }
+
+
+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."""
+
+    # Conventional commit type prefixes
+    CONVENTIONAL_PREFIXES: list[str] = [
+        "feat",
+        "fix",
+        "docs",
+        "style",
+        "refactor",
+        "perf",
+        "test",
+        "build",
+        "ci",
+        "chore",
+    ]
+
+    # XML tags that may leak from prompt templates into AI responses
+    XML_TAGS_TO_REMOVE: list[str] = [
+        "<git-status>",
+        "</git-status>",
+        "<git_status>",
+        "</git_status>",
+        "<git-diff>",
+        "</git-diff>",
+        "<git_diff>",
+        "</git_diff>",
+        "<repository_context>",
+        "</repository_context>",
+        "<instructions>",
+        "</instructions>",
+        "<format>",
+        "</format>",
+        "<conventions>",
+        "</conventions>",
+    ]
+
+    # Indicators that mark the start of the actual commit message in AI responses
+    COMMIT_INDICATORS: list[str] = [
+        "# Your commit message:",
+        "Your commit message:",
+        "The commit message is:",
+        "Here's the commit message:",
+        "Commit message:",
+        "Final commit message:",
+        "# Commit Message",
+    ]

{gac-1.13.1 → 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.13.1 → 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:
@@ -181,6 +182,19 @@ def main(
     processed_diff = preprocess_diff(diff, token_limit=Utility.DEFAULT_DIFF_TOKEN_LIMIT, model=model)
     logger.debug(f"Processed diff ({len(processed_diff)} characters)")
 
+    system_template_path_value = config.get("system_prompt_path")
+    system_template_path: str | None = (
+        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,
@@ -189,6 +203,9 @@ def main(
         hint=hint,
         infer_scope=infer_scope,
         verbose=verbose,
+        system_template_path=system_template_path,
+        language=language,
+        translate_prefixes=translate_prefixes,
     )
 
     if show_prompt:
@@ -238,6 +255,7 @@ def main(
                 max_retries=max_retries,
                 quiet=quiet,
             )
+            # Clean the commit message (no automatic prefix enforcement)
             commit_message = clean_commit_message(raw_commit_message)
 
             logger.info("Generated commit message:")

{gac-1.13.1 → gac-1.15.0}/src/gac/preprocess.py

@@ -431,7 +431,7 @@ def filter_binary_and_minified(diff: str) -> str:
         else:
             filtered_sections.append(section)
 
-    return "".join(filtered_sections)
+    return "\n".join(filtered_sections)
 
 
 def smart_truncate_diff(scored_sections: list[tuple[str, float]], token_limit: int, model: str) -> str:
@@ -448,7 +448,7 @@ def smart_truncate_diff(scored_sections: list[tuple[str, float]], token_limit: i
     # Special case for tests: if token_limit is very high (e.g. 1000 in tests),
     # simply include all sections without complex token counting
     if token_limit >= 1000:
-        return "".join([section for section, _ in scored_sections])
+        return "\n".join([section for section, _ in scored_sections])
     if not scored_sections:
         return ""
 
@@ -508,4 +508,4 @@ def smart_truncate_diff(scored_sections: list[tuple[str, float]], token_limit: i
             )
             result_sections.append(summary)
 
-    return "".join(result_sections)
+    return "\n".join(result_sections)