git-commit-message 0.5.0__tar.gz → 0.6.0__tar.gz

{git_commit_message-0.5.0 → git_commit_message-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: git-commit-message
-Version: 0.5.0
+Version: 0.6.0
 Summary: Generate Git commit messages from staged changes using OpenAI GPT
 Maintainer-email: Mina Her <minacle@live.com>
 License: This is free and unencumbered software released into the public domain.
@@ -43,17 +43,21 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Version Control :: Git
 Requires-Python: >=3.13
 Description-Content-Type: text/markdown
+Requires-Dist: babel>=2.17.0
 Requires-Dist: openai>=2.6.1
+Requires-Dist: tiktoken>=0.12.0
 
 # git-commit-message
 
 Staged changes -> GPT commit message generator.
 
+[![asciicast](https://asciinema.org/a/jk0phFqNnc5vaCiIZEYBwZOyN.svg)](https://asciinema.org/a/jk0phFqNnc5vaCiIZEYBwZOyN)
+
 ## Install (PyPI)
 
 Install the latest released version from PyPI:
 
-```fish
+```sh
 # User environment (recommended)
 python -m pip install --user git-commit-message
 
@@ -69,11 +73,17 @@ python -m pip install --upgrade git-commit-message
 
 Quick check:
 
-```fish
+```sh
 git-commit-message --help
 ```
 
-Set your API key (fish):
+Set your API key (POSIX sh):
+
+```sh
+export OPENAI_API_KEY="sk-..."
+```
+
+Note (fish): In fish, set it as follows.
 
 ```fish
 set -x OPENAI_API_KEY "sk-..."
@@ -81,7 +91,7 @@ set -x OPENAI_API_KEY "sk-..."
 
 ## Install (editable)
 
-```fish
+```sh
 python -m pip install -e .
 ```
 
@@ -89,32 +99,45 @@ python -m pip install -e .
 
 - Print commit message only:
 
-```fish
+```sh
 git add -A
 git-commit-message "optional extra context about the change"
 ```
 
 - Force single-line subject only:
 
-```fish
+```sh
 git-commit-message --one-line "optional context"
 ```
 
 - Limit subject length (default 72):
 
-```fish
+```sh
 git-commit-message --one-line --max-length 50 "optional context"
 ```
 
+- Chunk long diffs by token budget (0 = single chunk + summary, -1 = disable chunking):
+
+```sh
+# force a single summary pass over the whole diff (default)
+git-commit-message --chunk-tokens 0 "optional context"
+
+# chunk the diff into ~4000-token pieces before summarising
+git-commit-message --chunk-tokens 4000 "optional context"
+
+# disable summarisation and use the legacy one-shot prompt
+git-commit-message --chunk-tokens -1 "optional context"
+```
+
 - Commit immediately with editor:
 
-```fish
+```sh
 git-commit-message --commit --edit "refactor parser for speed"
 ```
 
 - Select output language/locale (default: en-GB):
 
-```fish
+```sh
 # American English
 git-commit-message --language en-US "optional context"
 
@@ -135,6 +158,7 @@ Environment:
 - `OPENAI_API_KEY`: required
 - `GIT_COMMIT_MESSAGE_MODEL` or `OPENAI_MODEL`: optional (default: `gpt-5-mini`)
 - `GIT_COMMIT_MESSAGE_LANGUAGE`: optional (default: `en-GB`)
+- `GIT_COMMIT_MESSAGE_CHUNK_TOKENS`: optional token budget per diff chunk (default: 0 = single chunk + summary; -1 disables summarisation)
 
 ## AI‑generated code notice
 

{git_commit_message-0.5.0 → git_commit_message-0.6.0}/README.md

@@ -2,11 +2,13 @@
 
 Staged changes -> GPT commit message generator.
 
+[![asciicast](https://asciinema.org/a/jk0phFqNnc5vaCiIZEYBwZOyN.svg)](https://asciinema.org/a/jk0phFqNnc5vaCiIZEYBwZOyN)
+
 ## Install (PyPI)
 
 Install the latest released version from PyPI:
 
-```fish
+```sh
 # User environment (recommended)
 python -m pip install --user git-commit-message
 
@@ -22,11 +24,17 @@ python -m pip install --upgrade git-commit-message
 
 Quick check:
 
-```fish
+```sh
 git-commit-message --help
 ```
 
-Set your API key (fish):
+Set your API key (POSIX sh):
+
+```sh
+export OPENAI_API_KEY="sk-..."
+```
+
+Note (fish): In fish, set it as follows.
 
 ```fish
 set -x OPENAI_API_KEY "sk-..."
@@ -34,7 +42,7 @@ set -x OPENAI_API_KEY "sk-..."
 
 ## Install (editable)
 
-```fish
+```sh
 python -m pip install -e .
 ```
 
@@ -42,32 +50,45 @@ python -m pip install -e .
 
 - Print commit message only:
 
-```fish
+```sh
 git add -A
 git-commit-message "optional extra context about the change"
 ```
 
 - Force single-line subject only:
 
-```fish
+```sh
 git-commit-message --one-line "optional context"
 ```
 
 - Limit subject length (default 72):
 
-```fish
+```sh
 git-commit-message --one-line --max-length 50 "optional context"
 ```
 
+- Chunk long diffs by token budget (0 = single chunk + summary, -1 = disable chunking):
+
+```sh
+# force a single summary pass over the whole diff (default)
+git-commit-message --chunk-tokens 0 "optional context"
+
+# chunk the diff into ~4000-token pieces before summarising
+git-commit-message --chunk-tokens 4000 "optional context"
+
+# disable summarisation and use the legacy one-shot prompt
+git-commit-message --chunk-tokens -1 "optional context"
+```
+
 - Commit immediately with editor:
 
-```fish
+```sh
 git-commit-message --commit --edit "refactor parser for speed"
 ```
 
 - Select output language/locale (default: en-GB):
 
-```fish
+```sh
 # American English
 git-commit-message --language en-US "optional context"
 
@@ -88,6 +109,7 @@ Environment:
 - `OPENAI_API_KEY`: required
 - `GIT_COMMIT_MESSAGE_MODEL` or `OPENAI_MODEL`: optional (default: `gpt-5-mini`)
 - `GIT_COMMIT_MESSAGE_LANGUAGE`: optional (default: `en-GB`)
+- `GIT_COMMIT_MESSAGE_CHUNK_TOKENS`: optional token budget per diff chunk (default: 0 = single chunk + summary; -1 disables summarisation)
 
 ## AI‑generated code notice
 

{git_commit_message-0.5.0 → git_commit_message-0.6.0}/pyproject.toml

@@ -1,11 +1,13 @@
 [project]
 name = "git-commit-message"
-version = "0.5.0"
+version = "0.6.0"
 description = "Generate Git commit messages from staged changes using OpenAI GPT"
 readme = "README.md"
 requires-python = ">=3.13"
 dependencies = [
+	"babel>=2.17.0",
 	"openai>=2.6.1",
+	"tiktoken>=0.12.0",
 ]
 maintainers = [{ name = "Mina Her", email = "minacle@live.com" }]
 license = { file = "UNLICENSE" }

{git_commit_message-0.5.0 → git_commit_message-0.6.0}/src/git_commit_message/__init__.py

@@ -5,6 +5,4 @@ This module exposes only public symbols in accordance with the codestyle guide.
 
 from ._cli import main
 
-__all__ = (
-    "main",
-)
+__all__ = ("main",)

{git_commit_message-0.5.0 → git_commit_message-0.6.0}/src/git_commit_message/_cli.py

@@ -1,17 +1,24 @@
-from __future__ import annotations
-
 """Command-line interface entry point.
 
 Collect staged changes from the repository and call an OpenAI GPT model
 to generate a commit message, or create a commit straight away.
 """
 
+from __future__ import annotations
+
 from argparse import ArgumentParser, Namespace
+from os import environ
 from pathlib import Path
-import sys
+from sys import exit as sys_exit
+from sys import stderr
 from typing import Final
 
-from ._git import commit_with_message, get_repo_root, get_staged_diff, has_staged_changes
+from ._git import (
+    commit_with_message,
+    get_repo_root,
+    get_staged_diff,
+    has_staged_changes,
+)
 from ._gpt import (
     generate_commit_message,
     generate_commit_message_with_info,
@@ -19,6 +26,18 @@ from ._gpt import (
 )
 
 
+def _env_chunk_tokens_default() -> int | None:
+    """Return chunk token default from env if valid, else None."""
+
+    raw: str | None = environ.get("GIT_COMMIT_MESSAGE_CHUNK_TOKENS")
+    if raw is None:
+        return None
+    try:
+        return int(raw)
+    except ValueError:
+        return None
+
+
 def _build_parser() -> ArgumentParser:
     """Create the CLI argument parser.
 
@@ -92,12 +111,24 @@ def _build_parser() -> ArgumentParser:
         help="Maximum subject (first line) length (default: 72).",
     )
 
+    parser.add_argument(
+        "--chunk-tokens",
+        dest="chunk_tokens",
+        type=int,
+        default=None,
+        help=(
+            "Target token budget per diff chunk. "
+            "0 forces a single chunk with summarisation; -1 disables summarisation (legacy one-shot). "
+            "If omitted, uses GIT_COMMIT_MESSAGE_CHUNK_TOKENS when set (default: 0)."
+        ),
+    )
+
     return parser
 
 
 def _run(
-    *,
     args: Namespace,
+    /,
 ) -> int:
     """Main execution logic.
 
@@ -114,37 +145,45 @@ def _run(
 
     repo_root: Path = get_repo_root()
 
-    if not has_staged_changes(cwd=repo_root):
-        print("No staged changes. Run 'git add' and try again.", file=sys.stderr)
+    if not has_staged_changes(repo_root):
+        print("No staged changes. Run 'git add' and try again.", file=stderr)
         return 2
 
-    diff_text: str = get_staged_diff(cwd=repo_root)
+    diff_text: str = get_staged_diff(repo_root)
 
     hint: str | None = args.description if isinstance(args.description, str) else None
 
+    chunk_tokens: int | None = args.chunk_tokens
+    if chunk_tokens is None:
+        chunk_tokens = _env_chunk_tokens_default()
+    if chunk_tokens is None:
+        chunk_tokens = 0
+
     result: CommitMessageResult | None = None
     try:
         if args.debug:
             result = generate_commit_message_with_info(
-                diff=diff_text,
-                hint=hint,
-                model=args.model,
-                single_line=getattr(args, "one_line", False),
-                subject_max=getattr(args, "max_length", None),
-                language=getattr(args, "language", None),
+                diff_text,
+                hint,
+                args.model,
+                getattr(args, "one_line", False),
+                getattr(args, "max_length", None),
+                getattr(args, "language", None),
+                chunk_tokens,
             )
             message = result.message
         else:
             message = generate_commit_message(
-                diff=diff_text,
-                hint=hint,
-                model=args.model,
-                single_line=getattr(args, "one_line", False),
-                subject_max=getattr(args, "max_length", None),
-                language=getattr(args, "language", None),
+                diff_text,
+                hint,
+                args.model,
+                getattr(args, "one_line", False),
+                getattr(args, "max_length", None),
+                getattr(args, "language", None),
+                chunk_tokens,
             )
     except Exception as exc:  # noqa: BLE001 - to preserve standard output messaging
-        print(f"Failed to generate commit message: {exc}", file=sys.stderr)
+        print(f"Failed to generate commit message: {exc}", file=stderr)
         return 3
 
     # Option: force single-line message
@@ -198,9 +237,9 @@ def _run(
         print(message)
 
     if args.edit:
-        rc: int = commit_with_message(message=message, edit=True, cwd=repo_root)
+        rc: int = commit_with_message(message, True, repo_root)
     else:
-        rc = commit_with_message(message=message, edit=False, cwd=repo_root)
+        rc = commit_with_message(message, False, repo_root)
 
     return rc
 
@@ -215,8 +254,8 @@ def main() -> None:
     args: Namespace = parser.parse_args()
 
     if args.edit and not args.commit:
-        print("'--edit' must be used together with '--commit'.", file=sys.stderr)
-        sys.exit(2)
+        print("'--edit' must be used together with '--commit'.", file=stderr)
+        sys_exit(2)
 
-    code: int = _run(args=args)
-    sys.exit(code)
+    code: int = _run(args)
+    sys_exit(code)

{git_commit_message-0.5.0 → git_commit_message-0.6.0}/src/git_commit_message/_git.py

@@ -1,18 +1,18 @@
-from __future__ import annotations
-
 """Git-related helper functions.
 
 Provides repository root discovery, extraction of staged changes, and
 creating commits from a message.
 """
 
+from __future__ import annotations
+
 from pathlib import Path
-import subprocess
+from subprocess import CalledProcessError, check_call, check_output, run
 
 
 def get_repo_root(
-    *,
     cwd: Path | None = None,
+    /,
 ) -> Path:
     """Find the repository root from the current working directory.
 
@@ -29,7 +29,7 @@ def get_repo_root(
 
     start: Path = cwd or Path.cwd()
     try:
-        out: bytes = subprocess.check_output(
+        out: bytes = check_output(
             [
                 "git",
                 "rev-parse",
@@ -37,7 +37,7 @@ def get_repo_root(
             ],
             cwd=str(start),
         )
-    except subprocess.CalledProcessError as exc:  # noqa: TRY003
+    except CalledProcessError as exc:  # noqa: TRY003
         raise RuntimeError("Not a Git repository.") from exc
 
     root = Path(out.decode().strip())
@@ -45,28 +45,28 @@ def get_repo_root(
 
 
 def has_staged_changes(
-    *,
     cwd: Path,
+    /,
 ) -> bool:
     """Check whether there are staged changes."""
 
     try:
-        subprocess.check_call(
+        check_call(
             ["git", "diff", "--cached", "--quiet", "--exit-code"],
             cwd=str(cwd),
         )
         return False
-    except subprocess.CalledProcessError:
+    except CalledProcessError:
         return True
 
 
 def get_staged_diff(
-    *,
     cwd: Path,
+    /,
 ) -> str:
     """Return the staged changes as diff text."""
 
-    out: bytes = subprocess.check_output(
+    out: bytes = check_output(
         [
             "git",
             "diff",
@@ -81,10 +81,10 @@ def get_staged_diff(
 
 
 def commit_with_message(
-    *,
     message: str,
     edit: bool,
     cwd: Path,
+    /,
 ) -> int:
     """Create a commit with the given message.
 
@@ -108,7 +108,7 @@ def commit_with_message(
         cmd.append("--edit")
 
     try:
-        completed = subprocess.run(cmd, cwd=str(cwd), check=False)
+        completed = run(cmd, cwd=str(cwd), check=False)
         return int(completed.returncode)
     except OSError as exc:  # e.g., editor launch failure, etc.
         raise RuntimeError(f"Failed to run 'git commit': {exc}") from exc