git-commit-msg-ai 1.4.2__py3-none-any.whl → 1.5.1__py3-none-any.whl

git_commit_msg_ai/ai_client.py

@@ -1,3 +1,4 @@
+import logging
 import textwrap
 from typing import Final, cast
 
@@ -5,6 +6,8 @@ import anthropic
 
 from git_commit_msg_ai.exceptions import AIError
 
+logger = logging.getLogger(__name__)
+
 SYSTEM_PROMPT: Final[str] = textwrap.dedent("""\
     You are a Git commit message generator. Output only the commit message, nothing else. Follow the Conventional Commits specification:
     - First line: <type>(<optional scope>)<!>: <short subject> (50 chars max); append ! before the colon if the commit introduces a breaking change
@@ -13,7 +16,7 @@ SYSTEM_PROMPT: Final[str] = textwrap.dedent("""\
     - If there is a breaking change, add a blank line after the body followed by "BREAKING CHANGE: <description of what breaks and why>
     Types: feat, fix, docs, style, refactor, test, chore""")
 
-MODEL: Final[str] = 'claude-haiku-4-5-20251001'
+MODEL: Final[str] = "claude-haiku-4-5-20251001"
 MAX_TOKENS: Final[int] = 1024
 
 
@@ -21,22 +24,29 @@ def generate_commit_message(diff: str) -> str:
     try:
         anthropic_client = anthropic.Anthropic()
 
+        logger.debug("Calling Anthropic API: model=%s max_tokens=%d", MODEL, MAX_TOKENS)
         anthropic_api_response = anthropic_client.messages.create(
             model=MODEL,
             max_tokens=MAX_TOKENS,
             system=SYSTEM_PROMPT,
-            messages=[{'role': 'user', 'content': diff}],
+            messages=[{"role": "user", "content": diff}],
         )
     except anthropic.AuthenticationError:
-        raise AIError('Anthropic API key is missing or invalid. Set the ANTHROPIC_API_KEY environment variable.')
+        logger.error("Anthropic authentication error")
+        raise AIError("Anthropic API key is missing or invalid. Set the ANTHROPIC_API_KEY environment variable.")
     except anthropic.RateLimitError:
-        raise AIError('Anthropic API rate limit reached. Wait a moment and try again.')
+        logger.error("Anthropic rate limit error")
+        raise AIError("Anthropic API rate limit reached. Wait a moment and try again.")
     except anthropic.APIConnectionError:
-        raise AIError('Could not reach the Anthropic API. Check your network connection.')
+        logger.error("Anthropic API connection error")
+        raise AIError("Could not reach the Anthropic API. Check your network connection.")
     except anthropic.APIStatusError as error:
-        raise AIError(f'Anthropic API returned an error: {error.status_code}.')
+        logger.error("Anthropic API status error: %s", error.status_code)
+        raise AIError(f"Anthropic API returned an error: {error.status_code}.")
 
     anthropic_api_response_message = anthropic_api_response.content[0]
     commit_message = cast(anthropic.types.TextBlock, anthropic_api_response_message).text.strip()
 
+    logger.info("Commit message generated: %d chars", len(commit_message))
+
     return commit_message

git_commit_msg_ai/cli.py

@@ -1,35 +1,51 @@
+import logging
+import os
 import sys
+from typing import Final
 
 from git_commit_msg_ai import ai_client, editor, git_ops
 from git_commit_msg_ai.exceptions import GitCommitAIError
 
+LOG_LEVEL_ENV_VAR: Final[str] = "GIT_COMMIT_AI_LOG_LEVEL"
+
 
 def main() -> None:
+    log_level_name = os.environ.get(LOG_LEVEL_ENV_VAR, "WARNING").upper()
+    numeric_log_level = getattr(logging, log_level_name, None)
+
+    if not isinstance(numeric_log_level, int):
+        numeric_log_level = logging.WARNING
+
+    logging.basicConfig(level=numeric_log_level, format="%(levelname)s:%(name)s:%(message)s", stream=sys.stderr)
+
+    if not isinstance(getattr(logging, log_level_name, None), int):
+        logging.warning("Invalid %s value %r, defaulting to WARNING", LOG_LEVEL_ENV_VAR, log_level_name)
+
     try:
         diff = git_ops.get_staged_diff()
         commit_message = ai_client.generate_commit_message(diff)
         print(commit_message)
 
         print()
-        user_selection = input('[a]ccept / [e]dit / [r]eject: ').strip().lower()
+        user_selection = input("[a]ccept / [e]dit / [r]eject: ").strip().lower()
 
-        if user_selection == 'a':
+        if user_selection == "a":
             git_ops.commit(commit_message)
-        elif user_selection == 'e':
+        elif user_selection == "e":
             updated_commit_message = editor.open_in_editor(commit_message)
             git_ops.commit(updated_commit_message)
-        elif user_selection == 'r':
-            print('User rejected the generated commit message. No commit made.')
+        elif user_selection == "r":
+            print("User rejected the generated commit message. No commit made.")
         else:
-            print('Invalid selection.')
+            print("Invalid selection.")
             sys.exit(1)
     except GitCommitAIError as error:
         print(str(error))
         sys.exit(1)
     except (KeyboardInterrupt, EOFError):
-        print('Aborted.')
+        print("Aborted.")
         sys.exit(1)
 
 
-if __name__ == '__main__':  # pragma: no cover
+if __name__ == "__main__":  # pragma: no cover
     main()

git_commit_msg_ai/editor.py

@@ -1,3 +1,4 @@
+import logging
 import os
 import platform
 import subprocess
@@ -5,39 +6,54 @@ import tempfile
 
 from git_commit_msg_ai.exceptions import EditorError
 
+logger = logging.getLogger(__name__)
+
 
 def get_default_editor() -> str:
     current_platform = platform.system()
-    is_windows = current_platform == 'Windows'
+    is_windows = current_platform == "Windows"
 
-    return 'notepad' if is_windows else 'vi'
+    return "notepad" if is_windows else "vi"
 
 
 def open_in_editor(initial_text: str) -> str:
     try:
-        with tempfile.NamedTemporaryFile(suffix='.txt', mode='w', delete=False) as temp_file:
+        with tempfile.NamedTemporaryFile(suffix=".txt", mode="w", delete=False) as temp_file:
             temp_file.write(initial_text)
             temp_file_path = temp_file.name
     except OSError:
-        raise EditorError('Could not create a temporary file.')
+        logger.error("Could not create temporary file")
+        raise EditorError("Could not create a temporary file.")
+
+    logger.debug("Temporary file created: %s", temp_file_path)
 
     platform_default_editor = get_default_editor()
-    editor_command = os.environ.get('EDITOR', platform_default_editor)
+    editor_command = os.environ.get("EDITOR", platform_default_editor)
+
+    logger.debug("Selected editor: %s", editor_command)
 
     try:
         try:
+            logger.debug("Opening editor: %s %s", editor_command, temp_file_path)
             subprocess.run([editor_command, temp_file_path], check=True)
         except FileNotFoundError:
+            logger.error("Editor not found: %s", editor_command)
             raise EditorError(f'Editor "{editor_command}" was not found. Set the EDITOR environment variable to a valid editor.')
         except subprocess.CalledProcessError:
+            logger.error("Editor exited with error: %s", editor_command)
             raise EditorError(f'Editor "{editor_command}" exited with an error.')
 
+        logger.debug("Editor closed, reading edited content")
+
         try:
             with open(temp_file_path) as temp_file:
                 edited_text = temp_file.read().strip()
         except OSError:
-            raise EditorError('Could not read the edited commit message from the temporary file.')
+            logger.error("Could not read temporary file: %s", temp_file_path)
+            raise EditorError("Could not read the edited commit message from the temporary file.")
     finally:
         os.unlink(temp_file_path)
 
+    logger.debug("Edited text read: %d chars", len(edited_text))
+
     return edited_text

git_commit_msg_ai/git_ops.py

@@ -1,36 +1,52 @@
+import logging
 import subprocess
 from typing import Final
 
 from git_commit_msg_ai.exceptions import GitError
 
-GIT_COMMAND: Final[str] = 'git'
-DIFF_SUBCOMMAND: Final[str] = 'diff'
-CACHED_FLAG: Final[str] = '--cached'
-COMMIT_SUBCOMMAND: Final[str] = 'commit'
-MESSAGE_FLAG: Final[str] = '-m'
-UTF8_ENCODING: Final[str] = 'utf-8'
+GIT_COMMAND: Final[str] = "git"
+DIFF_SUBCOMMAND: Final[str] = "diff"
+CACHED_FLAG: Final[str] = "--cached"
+COMMIT_SUBCOMMAND: Final[str] = "commit"
+MESSAGE_FLAG: Final[str] = "-m"
+UTF8_ENCODING: Final[str] = "utf-8"
+
+logger = logging.getLogger(__name__)
 
 
 def get_staged_diff() -> str:
     try:
-        staged_diff = subprocess.check_output([GIT_COMMAND, DIFF_SUBCOMMAND, CACHED_FLAG]).decode(UTF8_ENCODING)
+        logger.debug("Running: %s %s %s", GIT_COMMAND, DIFF_SUBCOMMAND, CACHED_FLAG)
+        raw_diff_bytes = subprocess.check_output([GIT_COMMAND, DIFF_SUBCOMMAND, CACHED_FLAG])
+        staged_diff = raw_diff_bytes.decode(UTF8_ENCODING)
     except FileNotFoundError:
-        raise GitError('git is not installed or not on PATH.')
+        logger.error("git not found on PATH")
+        raise GitError("git is not installed or not on PATH.")
     except subprocess.CalledProcessError:
-        raise GitError('Failed to get staged diff. Are you inside a git repository?')
+        logger.error("git diff --cached exited non-zero")
+        raise GitError("Failed to get staged diff. Are you inside a git repository?")
     except UnicodeDecodeError:
-        raise GitError('Staged diff contains bytes that could not be decoded as UTF-8.')
+        logger.error("Staged diff could not be decoded as UTF-8")
+        raise GitError("Staged diff contains bytes that could not be decoded as UTF-8.")
+
+    logger.debug("Staged diff received: %d chars", len(staged_diff))
 
     if not staged_diff:
-        raise GitError('No staged changes found. Stage files with git add before running.')
+        logger.warning("No staged changes found")
+        raise GitError("No staged changes found. Stage files with git add before running.")
 
     return staged_diff
 
 
 def commit(message: str) -> None:
     try:
+        logger.debug("Running: %s %s %s <message>", GIT_COMMAND, COMMIT_SUBCOMMAND, MESSAGE_FLAG)
         subprocess.run([GIT_COMMAND, COMMIT_SUBCOMMAND, MESSAGE_FLAG, message], check=True)
     except FileNotFoundError:
-        raise GitError('git is not installed or not on PATH.')
+        logger.error("git not found on PATH")
+        raise GitError("git is not installed or not on PATH.")
     except subprocess.CalledProcessError:
-        raise GitError('git commit failed.')
+        logger.error("git commit exited non-zero")
+        raise GitError("git commit failed.")
+
+    logger.info("Commit created successfully")

{git_commit_msg_ai-1.4.2.dist-info → git_commit_msg_ai-1.5.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: git-commit-msg-ai
-Version: 1.4.2
+Version: 1.5.1
 Summary: AI-powered git commit message generator following Conventional Commits
 License-Expression: MIT
 Requires-Python: >=3.10
@@ -113,3 +113,25 @@ BREAKING CHANGE: /v1/legacy is no longer available
 ```
 
 Supported types: `feat`, `fix`, `docs`, `style`, `refactor`, `test`, `chore`
+
+## Debugging
+
+By default the tool produces no diagnostic output. To enable logging, set the `GIT_COMMIT_AI_LOG_LEVEL` environment variable before running the command. Logs are written to **stderr** and do not interfere with the generated commit message on **stdout**.
+
+Valid values: `DEBUG`, `INFO`, `WARNING`, `ERROR`, `CRITICAL`
+
+```sh
+# macOS/Linux - show all internal diagnostic messages
+GIT_COMMIT_AI_LOG_LEVEL=DEBUG git-commit-msg-ai
+
+# Windows PowerShell
+$env:GIT_COMMIT_AI_LOG_LEVEL = 'DEBUG'
+git-commit-msg-ai
+```
+
+| Level | What you see |
+|---|---|
+| `DEBUG` | git commands run, API model/token params, temp file paths, char counts |
+| `INFO` | commit message generated, commit created |
+| `WARNING` | no staged changes found |
+| `ERROR` | git not found, API failures, editor errors |

git_commit_msg_ai-1.5.1.dist-info/RECORD

@@ -0,0 +1,11 @@
+git_commit_msg_ai/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+git_commit_msg_ai/ai_client.py,sha256=ET7wWfgiIPzXsuGi1bV8bV8UWOThPXn5JzRgcnh3yNI,2340
+git_commit_msg_ai/cli.py,sha256=IBU_BhBbd5azbTI6Rso92LtabLHlVUsO3ZUYA2Zr9wE,1686
+git_commit_msg_ai/editor.py,sha256=PycIvOuvHIAx8fSl6_L8AkzAWOS5PRNGTHb6yE11KN0,2087
+git_commit_msg_ai/exceptions.py,sha256=7Hwluf3zHMjs4lpGktWS-Lwgo8y_4Xbb1WqzPQHkkUA,352
+git_commit_msg_ai/git_ops.py,sha256=jJJ_8E_tOIl-SQ5Nf51XawO767P-5VMVXQ7gNNMLDyM,1974
+git_commit_msg_ai-1.5.1.dist-info/METADATA,sha256=VqmEAniNF6yKUNU7VP0-T2plMIDuJWQCkWyDlW3hnHE,3586
+git_commit_msg_ai-1.5.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+git_commit_msg_ai-1.5.1.dist-info/entry_points.txt,sha256=KTu6wUhl0p3nf27k8L4vpSH_hpeRQpwzMPSmKv7K5Cs,65
+git_commit_msg_ai-1.5.1.dist-info/top_level.txt,sha256=XYQC2BXvrcREGKEG7sm9nbwO7ifqcUSVgU7SW8BTURs,18
+git_commit_msg_ai-1.5.1.dist-info/RECORD,,

git_commit_msg_ai-1.4.2.dist-info/RECORD

@@ -1,11 +0,0 @@
-git_commit_msg_ai/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-git_commit_msg_ai/ai_client.py,sha256=RnzgIx1ieuiiH6w2VijA6_F-cs6tIQR57W1x3avg8lE,1887
-git_commit_msg_ai/cli.py,sha256=s94orvxin-38vqUYWAO-j5_JZTzxBXbZSVOHYZ5KO_k,1059
-git_commit_msg_ai/editor.py,sha256=JnVm5SZwkunyfOjisDKvTuPm3_NPbijVk_ho_yQy-3o,1430
-git_commit_msg_ai/exceptions.py,sha256=7Hwluf3zHMjs4lpGktWS-Lwgo8y_4Xbb1WqzPQHkkUA,352
-git_commit_msg_ai/git_ops.py,sha256=k2kjwcvj0Ac-WAttSsMP8pIl4-WXUKK47thgjaB62Og,1263
-git_commit_msg_ai-1.4.2.dist-info/METADATA,sha256=BzSJx7Vdzjo9CrRi2-88_HvbR1aQjJnci2deJQvtthQ,2768
-git_commit_msg_ai-1.4.2.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-git_commit_msg_ai-1.4.2.dist-info/entry_points.txt,sha256=KTu6wUhl0p3nf27k8L4vpSH_hpeRQpwzMPSmKv7K5Cs,65
-git_commit_msg_ai-1.4.2.dist-info/top_level.txt,sha256=XYQC2BXvrcREGKEG7sm9nbwO7ifqcUSVgU7SW8BTURs,18
-git_commit_msg_ai-1.4.2.dist-info/RECORD,,