cmt-cli 0.1.1__tar.gz → 1.0.0__tar.gz

cmt_cli-1.0.0/.github/workflows/test.yml

@@ -0,0 +1,30 @@
+name: Tests
+
+on:
+    push:
+        branches: [main]
+        paths:
+            - 'src/**'
+            - 'tests/**'
+            - 'pyproject.toml'
+    pull_request:
+        branches: [main]
+
+jobs:
+    test:
+        runs-on: ubuntu-latest
+
+        steps:
+            - name: Checkout code
+              uses: actions/checkout@v4
+
+            - name: Install uv
+              uses: astral-sh/setup-uv@v3
+              with:
+                  enable-cache: true
+
+            - name: Install dependencies
+              run: uv sync --all-groups
+
+            - name: Run tests
+              run: uv run pytest

cmt_cli-1.0.0/PKG-INFO

@@ -0,0 +1,94 @@
+Metadata-Version: 2.5
+Name: cmt-cli
+Version: 1.0.0
+Summary: AI-powered Git commit message generator
+Project-URL: Homepage, https://github.com/bijaydas/cmt
+Project-URL: Documentation, https://github.com/bijaydas/cmt#readme
+Project-URL: Repository, https://github.com/bijaydas/cmt
+Project-URL: Issues, https://github.com/bijaydas/cmt/issues
+Project-URL: Changelog, https://github.com/bijaydas/cmt/releases
+Author-email: Bijay Das <me@bijaydas.com>
+License: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Version Control
+Requires-Python: >=3.12
+Requires-Dist: langchain-openai>=1.6.0
+Requires-Dist: langchain>=1.3.18
+Requires-Dist: pydantic>=2.13.4
+Requires-Dist: typer>=0.27.1
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <img src="art/cmt-cli.svg" alt="cmt-cli logo" width="400">
+</p>
+
+# cmt-cli
+
+<p>
+  <a href="https://pypi.org/project/cmt-cli/"><img src="https://img.shields.io/pypi/v/cmt-cli.svg" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/cmt-cli/"><img src="https://img.shields.io/pypi/pyversions/cmt-cli.svg" alt="Python versions"></a>
+  <a href="https://github.com/bijaydas/cmt/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
+  <img src="https://img.shields.io/badge/status-alpha-orange.svg" alt="Alpha status">
+  <img src="https://img.shields.io/badge/tests-passing-green.svg" alt="Tests">
+</p>
+
+<p>
+  AI-powered CLI tool that analyzes your staged Git changes and suggests a professional commit message.
+</p>
+
+> **Note:** `cmt-cli` is in **alpha**. Expect breaking changes, rough edges, and incomplete features until a stable
+> release.
+
+## Features
+
+- Analyzes staged Git changes (added, modified, deleted, and renamed files, plus diffs)
+- Generates a commit message and description using OpenAI (via LangChain)
+- Review, edit (in `vim`), or reject the suggested message before committing
+- Caches suggestions per diff/model to avoid redundant API calls
+- Simple configuration for your OpenAI API key and model
+  ``
+
+## Installation
+
+```bash
+uv tool install cmt-cli
+```
+
+Requires Python 3.12+.
+
+## Usage
+
+Stage your changes as usual, then run:
+
+```bash
+git add .
+cmt suggest
+```
+
+You'll be shown a suggested commit message and can choose to:
+
+- `y` — commit with the suggested message
+- `e` — edit the message in `vim` before committing
+- `n` — abort
+
+### Configuration
+
+Before first use, configure your OpenAI API key and model:
+
+```bash
+cmt config set
+```
+
+To view your current configuration:
+
+```bash
+cmt config get
+```
+
+## License
+
+This project is licensed under the terms of the MIT license.

cmt_cli-1.0.0/README.md

@@ -0,0 +1,70 @@
+<p align="center">
+  <img src="art/cmt-cli.svg" alt="cmt-cli logo" width="400">
+</p>
+
+# cmt-cli
+
+<p>
+  <a href="https://pypi.org/project/cmt-cli/"><img src="https://img.shields.io/pypi/v/cmt-cli.svg" alt="PyPI version"></a>
+  <a href="https://pypi.org/project/cmt-cli/"><img src="https://img.shields.io/pypi/pyversions/cmt-cli.svg" alt="Python versions"></a>
+  <a href="https://github.com/bijaydas/cmt/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"></a>
+  <img src="https://img.shields.io/badge/status-alpha-orange.svg" alt="Alpha status">
+  <img src="https://img.shields.io/badge/tests-passing-green.svg" alt="Tests">
+</p>
+
+<p>
+  AI-powered CLI tool that analyzes your staged Git changes and suggests a professional commit message.
+</p>
+
+> **Note:** `cmt-cli` is in **alpha**. Expect breaking changes, rough edges, and incomplete features until a stable
+> release.
+
+## Features
+
+- Analyzes staged Git changes (added, modified, deleted, and renamed files, plus diffs)
+- Generates a commit message and description using OpenAI (via LangChain)
+- Review, edit (in `vim`), or reject the suggested message before committing
+- Caches suggestions per diff/model to avoid redundant API calls
+- Simple configuration for your OpenAI API key and model
+  ``
+
+## Installation
+
+```bash
+uv tool install cmt-cli
+```
+
+Requires Python 3.12+.
+
+## Usage
+
+Stage your changes as usual, then run:
+
+```bash
+git add .
+cmt suggest
+```
+
+You'll be shown a suggested commit message and can choose to:
+
+- `y` — commit with the suggested message
+- `e` — edit the message in `vim` before committing
+- `n` — abort
+
+### Configuration
+
+Before first use, configure your OpenAI API key and model:
+
+```bash
+cmt config set
+```
+
+To view your current configuration:
+
+```bash
+cmt config get
+```
+
+## License
+
+This project is licensed under the terms of the MIT license.

cmt_cli-1.0.0/art/cmt-cli.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="1584" zoomAndPan="magnify" viewBox="0 0 1188 296.999993" height="396" preserveAspectRatio="xMidYMid meet" version="1.0"><defs><g/><clipPath id="8fdfe6cc69"><rect x="0" width="344" y="0" height="139"/></clipPath></defs><g transform="matrix(1, 0, 0, 1, 420, 79)"><g clip-path="url(#8fdfe6cc69)"><g fill="#3d3b3a" fill-opacity="1"><g transform="translate(0.871423, 99.480686)"><g><path d="M 36.5625 -42.0625 C 32.90625 -42.0625 29.757812 -40.707031 27.125 -38 C 24.488281 -35.289062 23.171875 -32.03125 23.171875 -28.21875 C 23.171875 -24.34375 24.488281 -21.050781 27.125 -18.34375 C 29.757812 -15.632812 32.90625 -14.28125 36.5625 -14.28125 C 38.320312 -14.28125 39.988281 -14.5 41.5625 -14.9375 C 43.132812 -15.375 44.285156 -15.8125 45.015625 -16.25 L 46.015625 -16.90625 L 52.59375 -3.40625 C 52.082031 -3.039062 51.367188 -2.582031 50.453125 -2.03125 C 49.546875 -1.476562 47.460938 -0.726562 44.203125 0.21875 C 40.941406 1.164062 37.445312 1.640625 33.71875 1.640625 C 25.4375 1.640625 18.164062 -1.265625 11.90625 -7.078125 C 5.65625 -12.898438 2.53125 -19.875 2.53125 -28 C 2.53125 -36.195312 5.65625 -43.242188 11.90625 -49.140625 C 18.164062 -55.035156 25.4375 -57.984375 33.71875 -57.984375 C 37.445312 -57.984375 40.882812 -57.539062 44.03125 -56.65625 C 47.175781 -55.78125 49.410156 -54.90625 50.734375 -54.03125 L 52.59375 -52.703125 L 46.015625 -39.421875 C 43.597656 -41.179688 40.445312 -42.0625 36.5625 -42.0625 Z M 36.5625 -42.0625 "/></g></g></g><g fill="#3d3b3a" fill-opacity="1"><g transform="translate(50.17971, 99.480686)"><g><path d="M 6.59375 0 L 6.59375 -56.328125 L 26.03125 -56.328125 L 26.03125 -50.40625 L 26.25 -50.40625 C 31.300781 -55.457031 36.679688 -57.984375 42.390625 -57.984375 C 46.484375 -57.984375 50.320312 -57.140625 53.90625 -55.453125 C 57.5 -53.765625 60.210938 -51.164062 62.046875 -47.65625 C 67.753906 -54.539062 73.976562 -57.984375 80.71875 -57.984375 C 86.71875 -57.984375 91.875 -56.296875 96.1875 -52.921875 C 100.507812 -49.554688 102.671875 -44.285156 102.671875 -37.109375 L 102.671875 0 L 83.234375 0 L 83.234375 -31.84375 C 83.234375 -34.84375 82.410156 -37.347656 80.765625 -39.359375 C 79.117188 -41.378906 76.648438 -42.390625 73.359375 -42.390625 C 70.503906 -42.390625 68.320312 -41.523438 66.8125 -39.796875 C 65.3125 -38.078125 64.488281 -36.015625 64.34375 -33.609375 L 64.34375 0 L 44.90625 0 L 44.90625 -31.84375 C 44.90625 -34.84375 44.082031 -37.347656 42.4375 -39.359375 C 40.789062 -41.378906 38.320312 -42.390625 35.03125 -42.390625 C 32.03125 -42.390625 29.78125 -41.453125 28.28125 -39.578125 C 26.78125 -37.710938 26.03125 -35.5 26.03125 -32.9375 L 26.03125 0 Z M 6.59375 0 "/></g></g></g><g fill="#3d3b3a" fill-opacity="1"><g transform="translate(153.298845, 99.480686)"><g><path d="M 9.890625 -56.328125 L 9.890625 -77.3125 L 29.3125 -77.3125 L 29.3125 -56.328125 L 41.171875 -56.328125 L 41.171875 -41.515625 L 29.3125 -41.515625 L 29.3125 -23.609375 C 29.3125 -18.410156 30.78125 -15.8125 33.71875 -15.8125 C 34.445312 -15.8125 35.210938 -15.957031 36.015625 -16.25 C 36.816406 -16.539062 37.441406 -16.832031 37.890625 -17.125 L 38.546875 -17.5625 L 43.375 -1.859375 C 39.195312 0.472656 34.4375 1.640625 29.09375 1.640625 C 25.4375 1.640625 22.289062 0.996094 19.65625 -0.28125 C 17.019531 -1.5625 15.023438 -3.28125 13.671875 -5.4375 C 12.316406 -7.59375 11.347656 -9.859375 10.765625 -12.234375 C 10.179688 -14.617188 9.890625 -17.164062 9.890625 -19.875 L 9.890625 -41.515625 L 1.75 -41.515625 L 1.75 -56.328125 Z M 9.890625 -56.328125 "/></g></g></g><g fill="#3d3b3a" fill-opacity="1"><g transform="translate(192.284217, 99.480686)"><g><path d="M 6.59375 -40.1875 L 41.953125 -40.1875 L 41.953125 -23.390625 L 6.59375 -23.390625 Z M 6.59375 -40.1875 "/></g></g></g><g fill="#3d3b3a" fill-opacity="1"><g transform="translate(236.431027, 99.480686)"><g><path d="M 36.5625 -42.0625 C 32.90625 -42.0625 29.757812 -40.707031 27.125 -38 C 24.488281 -35.289062 23.171875 -32.03125 23.171875 -28.21875 C 23.171875 -24.34375 24.488281 -21.050781 27.125 -18.34375 C 29.757812 -15.632812 32.90625 -14.28125 36.5625 -14.28125 C 38.320312 -14.28125 39.988281 -14.5 41.5625 -14.9375 C 43.132812 -15.375 44.285156 -15.8125 45.015625 -16.25 L 46.015625 -16.90625 L 52.59375 -3.40625 C 52.082031 -3.039062 51.367188 -2.582031 50.453125 -2.03125 C 49.546875 -1.476562 47.460938 -0.726562 44.203125 0.21875 C 40.941406 1.164062 37.445312 1.640625 33.71875 1.640625 C 25.4375 1.640625 18.164062 -1.265625 11.90625 -7.078125 C 5.65625 -12.898438 2.53125 -19.875 2.53125 -28 C 2.53125 -36.195312 5.65625 -43.242188 11.90625 -49.140625 C 18.164062 -55.035156 25.4375 -57.984375 33.71875 -57.984375 C 37.445312 -57.984375 40.882812 -57.539062 44.03125 -56.65625 C 47.175781 -55.78125 49.410156 -54.90625 50.734375 -54.03125 L 52.59375 -52.703125 L 46.015625 -39.421875 C 43.597656 -41.179688 40.445312 -42.0625 36.5625 -42.0625 Z M 36.5625 -42.0625 "/></g></g></g><g fill="#3d3b3a" fill-opacity="1"><g transform="translate(285.739315, 99.480686)"><g><path d="M 6.59375 0 L 6.59375 -94.4375 L 26.03125 -94.4375 L 26.03125 0 Z M 6.59375 0 "/></g></g></g><g fill="#3d3b3a" fill-opacity="1"><g transform="translate(313.962521, 99.480686)"><g><path d="M 8.453125 -87.734375 C 10.722656 -90.003906 13.429688 -91.140625 16.578125 -91.140625 C 19.722656 -91.140625 22.429688 -90.003906 24.703125 -87.734375 C 26.972656 -85.472656 28.109375 -82.765625 28.109375 -79.609375 C 28.109375 -76.460938 26.972656 -73.753906 24.703125 -71.484375 C 22.429688 -69.210938 19.722656 -68.078125 16.578125 -68.078125 C 13.429688 -68.078125 10.722656 -69.210938 8.453125 -71.484375 C 6.179688 -73.753906 5.046875 -76.460938 5.046875 -79.609375 C 5.046875 -82.765625 6.179688 -85.472656 8.453125 -87.734375 Z M 6.59375 -56.328125 L 6.59375 0 L 26.03125 0 L 26.03125 -56.328125 Z M 6.59375 -56.328125 "/></g></g></g></g></g></svg>

{cmt_cli-0.1.1 → cmt_cli-1.0.0}/pyproject.toml

@@ -1,14 +1,12 @@
 [project]
 name = "cmt-cli"
-version = "0.1.1"
+version = "1.0.0"
 description = "AI-powered Git commit message generator"
 readme = "README.md"
 requires-python = ">=3.12"
 license = { text = "MIT" }
 license-files = ["LICENSE"]
-authors = [
-    { name = "Bijay Das", email = "me@bijaydas.com" },
-]
+authors = [{ name = "Bijay Das", email = "me@bijaydas.com" }]
 dependencies = [
     "langchain>=1.3.18",
     "langchain-openai>=1.6.0",
@@ -39,9 +37,7 @@ build-backend = "hatchling.build"
 keywords = ["ai", "git", "commit", "message", "generator"]
 
 [dependency-groups]
-dev = [
-    "ruff>=0.16.5",
-]
+dev = ["pytest>=9.1.1", "ruff>=0.16.5"]
 [tool.ruff]
 line-length = 100
 target-version = "py312"
@@ -49,11 +45,11 @@ src = ["src"]
 
 [tool.ruff.lint]
 select = [
-    "E", # pycodestyle errors
-    "F", # pyflakes
-    "I", # isort (import sorting)
-    "UP", # pyupgrade (modern syntax)
-    "B", # flake8-bugbear (common bugs)
+    "E",   # pycodestyle errors
+    "F",   # pyflakes
+    "I",   # isort (import sorting)
+    "UP",  # pyupgrade (modern syntax)
+    "B",   # flake8-bugbear (common bugs)
     "SIM", # flake8-simplify
 ]
 ignore = []
@@ -62,4 +58,4 @@ ignore = []
 quote-style = "double"
 
 [tool.hatch.build.targets.wheel]
-packages = ["src/cmt"]
+packages = ["src/cmt"]

{cmt_cli-0.1.1 → cmt_cli-1.0.0}/src/cmt/ai/cache.py

@@ -2,13 +2,13 @@ import hashlib
 import json
 from pathlib import Path
 
-from cmt.config.settings import Settings
+from cmt.core.settings import settings
 from cmt.models.suggestion import CommitSuggestion
 
 
 class CommitMessageCache:
     def __init__(self):
-        self.cache_dir = Path(Settings().CACHE_DIR)
+        self.cache_dir = Path(settings.CACHE_DIR)
         self.cache_dir.mkdir(parents=True, exist_ok=True)
 
     @staticmethod

{cmt_cli-0.1.1 → cmt_cli-1.0.0}/src/cmt/ai/openai.py

@@ -1,25 +1,29 @@
+import logging
+from typing import cast
+
 from langchain.agents import create_agent
+from langchain.agents.middleware.types import InputAgentState
+from langchain_core.messages import BaseMessage, get_buffer_string
 from langchain_openai import ChatOpenAI
 from pydantic import SecretStr
 
 from cmt.ai.cache import CommitMessageCache
 from cmt.ai.prompt import COMMIT_PROMPT, COMMIT_SYSTEM_PROMPT
 from cmt.ai.provider import AIProvider
-from cmt.config.settings import Settings
+from cmt.core.settings import settings
 from cmt.models.changes import AnalysisResult, StagedChangeSet, StagedFile
 from cmt.models.suggestion import CommitSuggestion
 
+logger = logging.getLogger(__name__)
+
 
 class OpenAIProvider(AIProvider):
     def __init__(self) -> None:
-        settings = Settings()
         self.config = settings.get()
 
     def _build_prompt(
-        self,
-        changes: StagedChangeSet,
-        analysis: AnalysisResult
-    ) -> str:
+        self, changes: StagedChangeSet, analysis: AnalysisResult
+    ) -> list[BaseMessage]:
         staged_files = self._process_files(changes.files)
         staged_diffs = changes.diff
 
@@ -30,7 +34,7 @@ class OpenAIProvider(AIProvider):
             deleted_files=analysis.deleted_files,
             renamed_files=analysis.renamed_files,
             staged_files=staged_files,
-            staged_diffs=staged_diffs
+            staged_diffs=staged_diffs,
         )
 
     @staticmethod
@@ -41,12 +45,14 @@ class OpenAIProvider(AIProvider):
 
         return output.strip()
 
-    def _invoke(self, prompt: str) -> CommitSuggestion:
+    def _invoke(self, prompt: list[BaseMessage]) -> CommitSuggestion:
         model = ChatOpenAI(
             model=self.config.model,
             api_key=SecretStr(self.config.api_key),
             timeout=30,
-            max_tokens=1200,
+        )
+        logger.info(
+            "Invoking %s model with prompt:\n%s", self.config.model, get_buffer_string(prompt)
         )
 
         agent = create_agent(
@@ -55,14 +61,12 @@ class OpenAIProvider(AIProvider):
             response_format=CommitSuggestion,
         )
 
-        result = agent.invoke({"messages": prompt})
+        result = agent.invoke(cast(InputAgentState, prompt))
 
         return result["structured_response"]
 
     def generate_commit_message(
-        self,
-        change_set: StagedChangeSet,
-        analysis: AnalysisResult
+        self, change_set: StagedChangeSet, analysis: AnalysisResult
     ) -> CommitSuggestion:
         prompt = self._build_prompt(change_set, analysis)
 
@@ -70,17 +74,25 @@ class OpenAIProvider(AIProvider):
         cached_message = cache.get(change_set.diff, self.config.model)
 
         if cached_message:
-            return CommitSuggestion(
-                message=cached_message.message,
-                description=cached_message.description
+            suggestion = CommitSuggestion(
+                message=cached_message.message, description=cached_message.description
+            )
+            logger.info(
+                "Returning cached commit suggestion for the following changes:\n\n%s\n\n"
+                "Commit message: %s",
+                change_set.diff,
+                suggestion.message,
             )
+            return suggestion
 
         suggestion = self._invoke(prompt)
+        logger.info("Generated new commit suggestion.\n%s", suggestion)
 
         cache.set(change_set.diff, self.config.model, suggestion)
+        logger.info("Cached new commit suggestion.")
 
         return suggestion
 
     @staticmethod
     def commit_command(commit_suggestion: CommitSuggestion) -> str:
-        return f"{commit_suggestion.message} \n\n{commit_suggestion.description}"
+        return f"{commit_suggestion.message} \n\n{commit_suggestion.description}"

{cmt_cli-0.1.1 → cmt_cli-1.0.0}/src/cmt/ai/prompt.py

@@ -59,7 +59,13 @@ Renamed: {renamed_files}
 Generate the commit message now.
 """
 
-COMMIT_PROMPT = ChatPromptTemplate.from_messages(
+COMMIT_PROMPT1 = ChatPromptTemplate.from_messages(
+    [
+        ("human", COMMIT_DATA_PROMPT),
+    ]
+)
+
+COMMIT_PROMPT = ChatPromptTemplate(
     [
         ("human", COMMIT_DATA_PROMPT),
     ]

cmt_cli-1.0.0/src/cmt/cli.py

@@ -0,0 +1,171 @@
+import logging
+import sys
+from importlib.metadata import version
+
+import typer
+
+from cmt.ai.openai import OpenAIProvider
+from cmt.analysis.analyzer import Analyzer
+from cmt.core import settings, setup_logging
+from cmt.enums.config import ConfigTask
+from cmt.exceptions import CmtError
+from cmt.git.repository import Repository
+from cmt.schemas.config import AIConfig
+from cmt.services import PyPIService
+from cmt.utils import edit_with_vim
+
+logger = logging.getLogger(__name__)
+
+app = typer.Typer(
+    add_completion=False,
+)
+
+
+def version_callback(value: bool) -> None:
+    if value:
+        typer.echo(f"cmt-cli version: {version(settings.APP_NAME)}")
+        raise typer.Exit()
+
+
+@app.callback(invoke_without_command=True)
+def main(
+    ctx: typer.Context,
+    flag: bool = typer.Option(False, "--version", callback=version_callback, is_eager=True),
+) -> None:
+    setup_logging()
+    if ctx.invoked_subcommand is None:
+        logger.info("No subcommand invoked, displaying help.")
+        typer.echo(ctx.get_help())
+        raise typer.Exit(code=0)
+
+
+@app.command()
+def suggest() -> None:
+    """Suggest a commit message based on staged changes."""
+    try:
+        repository = Repository()
+        analyzer = Analyzer()
+
+        if not repository.is_git_repository():
+            logger.error("Not a git repository.")
+            raise CmtError("Not a git repository.")
+
+        staged_files = repository.get_staged_changes()
+
+        if not staged_files.files:
+            logger.warning(
+                "No staged files found. Please stage your changes before running this command."
+            )
+            typer.echo(
+                "No staged files found. Please stage your changes before running this command."
+            )
+            raise typer.Exit(code=0)
+
+        analysis_result = analyzer.analyze(staged_files)
+
+        open_ai = OpenAIProvider()
+
+        commit = open_ai.generate_commit_message(staged_files, analysis_result)
+        sys.exit()
+        commit_command = OpenAIProvider.commit_command(commit)
+
+        logger.info("Suggested commit:\n\n%s", commit_command)
+        typer.echo(f"Suggested commit:\n\n{commit_command}")
+
+        while True:
+            action = (
+                typer.prompt("Use this message? [y]es / [e]dit / [n]o", default="y")
+                .strip()
+                .lower()[0]
+            )
+
+            if action == "n":
+                typer.echo("Aborted.")
+                break
+
+            if action == "e":
+                commit_command = edit_with_vim(commit_command)
+                typer.echo(f"Edited commit:\n\n{commit_command}")
+
+            if action == "y":
+                logger.info("Committing with message:\n\n%s", commit_command)
+                result = repository.commit(commit_command)
+
+                logger.info("Commit result:\n\n%s", result.stdout)
+                typer.echo(f"Commit result:\n\n{result.stdout}")
+                break
+
+    except CmtError as e:
+        typer.echo(f"Error: {e}", err=True)
+        raise typer.Exit(code=1) from None
+    except typer.Exit:
+        raise
+    except KeyboardInterrupt:
+        logger.info("Operation cancelled by user.")
+        typer.echo("\nOperation cancelled by user.", err=True)
+        raise typer.Exit(code=1) from None
+    except Exception as e:
+        logger.error("Unexpected error: %s", e)
+        typer.echo(f"Unexpected error: {e}", err=True)
+        raise typer.Exit(code=1) from None
+
+
+@app.command()
+def config(task: ConfigTask) -> None:
+    """Configure cmt-cli configuration for OpenAI API key and model."""
+    if task == ConfigTask.set:
+        open_ai_key = typer.prompt("Enter your OpenAI API key", default=None)
+        open_ai_model = typer.prompt(
+            "Enter your OpenAI model", default=settings.OPEN_AI_DEFAULT_MODEL
+        )
+        logger.info("Configuration updated with OpenAI API key and model.")
+        settings.set(AIConfig(api_key=open_ai_key, model=open_ai_model))
+
+    if task == ConfigTask.get:
+        setting_values = settings.get()
+
+        if setting_values.api_key:
+            typer.echo(f"OpenAI API key: {setting_values.api_key[:10]} ****")
+
+        if setting_values.model:
+            typer.echo(f"OpenAI model: {setting_values.model}")
+
+        logger.info("Retrieved current configuration.")
+
+        raise typer.Exit(code=0)
+
+
+@app.command()
+def update() -> None:
+    """Update cmt-cli to the latest version."""
+    logger.info("Starting update process for %s.", settings.APP_NAME)
+
+    current_version = version(settings.APP_NAME)
+    logger.info("Current %s version: %s", settings.APP_NAME, current_version)
+
+    pypi_service = PyPIService()
+    latest_info_response = pypi_service.any_update(current_version=current_version)
+
+    if latest_info_response.updated_required:
+        logger.info(
+            "Update required: current version %s, latest version %s",
+            latest_info_response.current_version,
+            latest_info_response.latest_version,
+        )
+        typer.echo(
+            f"A new version of {settings.APP_NAME} is available: "
+            f"{latest_info_response.latest_version}.\n\n"
+            f"upgrade {settings.APP_NAME} using your package manager.",
+        )
+    else:
+        logger.info(
+            "No update required. You are using the latest version: %s",
+            latest_info_response.current_version,
+        )
+        typer.echo(f"You are using the latest version of {settings.APP_NAME}")
+
+    raise typer.Exit(code=0)
+
+
+if __name__ == "__main__":
+    app()

cmt_cli-1.0.0/src/cmt/core/__init__.py

@@ -0,0 +1,4 @@
+from cmt.core.logging import setup_logging
+from cmt.core.settings import settings
+
+__all__ = ["settings", "setup_logging"]

cmt_cli-1.0.0/src/cmt/core/logging.py

@@ -0,0 +1,18 @@
+import logging
+from logging.handlers import RotatingFileHandler
+
+from cmt.core.settings import settings
+
+
+def setup_logging():
+    settings.LOGS_DIR.mkdir(parents=True, exist_ok=True)
+
+    handler = RotatingFileHandler(
+        settings.LOGS_DIR / f"{settings.APP_NAME}.log", maxBytes=1024 * 1024, backupCount=9
+    )
+
+    logging.basicConfig(
+        level=logging.DEBUG,
+        format="%(asctime)s - %(name)s - %(levelname)s - %(message)s",
+        handlers=[handler],
+    )

{cmt_cli-0.1.1/src/cmt/config → cmt_cli-1.0.0/src/cmt/core}/settings.py

@@ -1,36 +1,37 @@
 from configparser import ConfigParser
 from pathlib import Path
 
-from pydantic import BaseModel
-
 from cmt.exceptions import ConfigurationError
-
-
-class OpenAIConfig(BaseModel):
-    api_key: str
-    model: str
+from cmt.schemas.config import AIConfig
 
 
 class Settings:
+    APP_NAME: str = "cmt-cli"
     CONFIG_DIR: Path = Path.home() / ".config" / "cmt"
     CACHE_DIR: Path = CONFIG_DIR / "cache"
+    LOGS_DIR: Path = CONFIG_DIR / "logs"
 
     CONFIG_FILE: Path = CONFIG_DIR / "config.ini"
     OPEN_AI_DEFAULT_MODEL: str = "gpt-4o-mini"
 
-    def set(self, openai_config: OpenAIConfig):
+    def set(self, openai_config: AIConfig):
         self.CONFIG_DIR.mkdir(parents=True, exist_ok=True)
 
         config = ConfigParser()
-        config["openai"] = {
-            "api_key": openai_config.api_key,
-            "model": openai_config.model
-        }
+
+        if openai_config.api_key:
+            config["openai"] = {}
+
+            if openai_config.api_key:
+                config["openai"]["api_key"] = openai_config.api_key
+
+            if openai_config.model:
+                config["openai"]["model"] = openai_config.model
 
         with open(self.CONFIG_FILE, "w") as f:
             config.write(f)
 
-    def get(self) -> OpenAIConfig:
+    def get(self) -> AIConfig:
         if not self.CONFIG_FILE.exists():
             raise FileNotFoundError(
                 "Configuration file not found. Run `cmt config set` to set it up."
@@ -52,7 +53,7 @@ class Settings:
                 "Model not found in the configuration. Run `cmt config set` to set it up."
             )
 
-        return OpenAIConfig(
-            api_key=api_key,
-            model=model
-        )
+        return AIConfig(api_key=api_key, model=model)
+
+
+settings = Settings()

cmt_cli-1.0.0/src/cmt/enums/config.py

@@ -0,0 +1,6 @@
+from enum import StrEnum
+
+
+class ConfigTask(StrEnum):
+    set = "set"
+    get = "get"

cmt_cli-1.0.0/src/cmt/schemas/config.py

@@ -0,0 +1,6 @@
+from pydantic import BaseModel
+
+
+class AIConfig(BaseModel):
+    api_key: str
+    model: str

cmt_cli-1.0.0/src/cmt/schemas/general.py

@@ -0,0 +1,7 @@
+from pydantic import BaseModel
+
+
+class VersionInfo(BaseModel):
+    current_version: str
+    latest_version: str
+    updated_required: bool

cmt_cli-1.0.0/src/cmt/services/__init__.py

@@ -0,0 +1,3 @@
+from cmt.services.pypi import PyPIService
+
+__all__ = ["PyPIService"]

cmt_cli-1.0.0/src/cmt/services/pypi.py

@@ -0,0 +1,34 @@
+import logging
+
+import httpx
+
+from cmt.core import settings
+from cmt.schemas.general import VersionInfo
+
+logger = logging.getLogger(__name__)
+
+
+class PyPIService:
+    def __init__(self):
+        self._base_url = "https://pypi.org/pypi"
+
+    def _get_package_info(self) -> dict:
+        url = f"{self._base_url}/{settings.APP_NAME}/json"
+        response = httpx.get(url)
+
+        logger.debug("Received response with status code: %s", response.status_code)
+        response.raise_for_status()
+
+        return response.json()
+
+    def any_update(self, current_version: str) -> VersionInfo:
+        latest_info = self._get_package_info()
+        latest_version = latest_info["info"]["version"]
+
+        logger.debug("Current version: %s, Latest version: %s", current_version, latest_version)
+
+        return VersionInfo(
+            current_version=current_version,
+            latest_version=latest_version,
+            updated_required=latest_version != current_version,
+        )

cmt_cli-1.0.0/tests/unit/test_repository.py

@@ -0,0 +1,24 @@
+from cmt.git.repository import Repository
+
+
+def test_invalid_git_repository(tmp_path):
+    repo_path = tmp_path / "test_repo"
+    repo_path.mkdir()
+
+    repo = Repository(tmp_path)
+
+    assert repo.is_git_repository() is False
+
+
+def test_valid_git_repository(tmp_path):
+    repo_path = tmp_path / "test_repo"
+    repo_path.mkdir()
+
+    # Initialize a git repository
+    import subprocess
+
+    subprocess.run(["git", "init"], cwd=repo_path)
+
+    repo = Repository(repo_path)
+
+    assert repo.is_git_repository() is True

{cmt_cli-0.1.1 → cmt_cli-1.0.0}/uv.lock

@@ -175,7 +175,7 @@ wheels = [
 
 [[package]]
 name = "cmt-cli"
-version = "0.1.0"
+version = "0.2.0"
 source = { editable = "." }
 dependencies = [
     { name = "langchain" },
@@ -186,6 +186,7 @@ dependencies = [
 
 [package.dev-dependencies]
 dev = [
+    { name = "pytest" },
     { name = "ruff" },
 ]
 
@@ -198,7 +199,10 @@ requires-dist = [
 ]
 
 [package.metadata.requires-dev]
-dev = [{ name = "ruff", specifier = ">=0.16.5" }]
+dev = [
+    { name = "pytest", specifier = ">=9.1.1" },
+    { name = "ruff", specifier = ">=0.16.5" },
+]
 
 [[package]]
 name = "colorama"
@@ -303,6 +307,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/57/b0/0e52c878c53f245edd3a11020f20979b3f490f245af532c7cae3027754b5/idna-3.19-py3-none-any.whl", hash = "sha256:815e7be7a7806d54abb586dc943addc79e8b2ee16915059658cbeff4b1b43bf4", size = 68550, upload-time = "2026-08-18T05:14:22.343Z" },
 ]
 
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
+]
+
 [[package]]
 name = "jiter"
 version = "0.16.0"
@@ -676,6 +689,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/63/34/ba1c580383c9eada3711951fef0795c80b829a078d72188184bcab9dd527/packaging-26.3-py3-none-any.whl", hash = "sha256:d7193f7c8e4e93f444fde0262bf90af30e16fa0ad0ad44cb553c87339b23cd1c", size = 129956, upload-time = "2026-08-04T18:15:27.159Z" },
 ]
 
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
+]
+
 [[package]]
 name = "pydantic"
 version = "2.13.4"
@@ -775,6 +797,22 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/71/46/17f022dd3e953bf20a04a028a21ec746d942f8d2af30fa0f124fa0e6a684/pygments-2.21.0-py3-none-any.whl", hash = "sha256:2363c69b61c4a97c838da3b130dcd6468f4848992b21a82f2a63ec34377137d9", size = 1250147, upload-time = "2026-08-17T08:02:44.912Z" },
 ]
 
+[[package]]
+name = "pytest"
+version = "9.1.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/e4/47/b9efed96c114afcfa3c9d3fe98a76a1d14c74a9e266d397cf6eb64be5e01/pytest-9.1.1.tar.gz", hash = "sha256:1088fbde8f2b49d95a549a195707afa7a76a3ce9bcadc26b6d71f0ffda5fe313", size = 1636369, upload-time = "2026-06-19T10:58:32.857Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/24/25/1de2678b631f5a49215c6c96fff41ba892b0a34df68d6d80292b1b48aa7f/pytest-9.1.1-py3-none-any.whl", hash = "sha256:37a86b45efb9a47a61a36449063e8e18d0cab3161329fc099eb21783169c4f0c", size = 386536, upload-time = "2026-06-19T10:58:31.347Z" },
+]
+
 [[package]]
 name = "pyyaml"
 version = "6.0.3"

cmt_cli-0.1.1/PKG-INFO

@@ -1,31 +0,0 @@
-Metadata-Version: 2.5
-Name: cmt-cli
-Version: 0.1.1
-Summary: AI-powered Git commit message generator
-Project-URL: Homepage, https://github.com/bijaydas/cmt
-Project-URL: Documentation, https://github.com/bijaydas/cmt#readme
-Project-URL: Repository, https://github.com/bijaydas/cmt
-Project-URL: Issues, https://github.com/bijaydas/cmt/issues
-Project-URL: Changelog, https://github.com/bijaydas/cmt/releases
-Author-email: Bijay Das <me@bijaydas.com>
-License: MIT
-License-File: LICENSE
-Classifier: Development Status :: 3 - Alpha
-Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Topic :: Software Development :: Version Control
-Requires-Python: >=3.12
-Requires-Dist: langchain-openai>=1.6.0
-Requires-Dist: langchain>=1.3.18
-Requires-Dist: pydantic>=2.13.4
-Requires-Dist: typer>=0.27.1
-Description-Content-Type: text/markdown
-
-# cmt
-
-`cmt` is a CLI tool that checks the currently staged Git changes and suggests a professional commit message.
-
-## License
-
-MIT

cmt_cli-0.1.1/README.md

@@ -1,7 +0,0 @@
-# cmt
-
-`cmt` is a CLI tool that checks the currently staged Git changes and suggests a professional commit message.
-
-## License
-
-MIT

cmt_cli-0.1.1/src/cmt/cli.py

@@ -1,85 +0,0 @@
-import typer
-
-from cmt.ai.openai import OpenAIProvider
-from cmt.analysis.analyzer import Analyzer
-from cmt.config.settings import OpenAIConfig, Settings
-from cmt.exceptions import CmtError
-from cmt.git.repository import Repository
-from cmt.utils import edit_with_vim
-
-app = typer.Typer()
-
-
-@app.command()
-def suggest() -> None:
-    try:
-        repository = Repository()
-        analyzer = Analyzer()
-
-        if not repository.is_git_repository():
-            raise CmtError("Not a git repository.")
-
-        staged_files = repository.get_staged_changes()
-
-        if not staged_files.files:
-            typer.echo(
-                "No staged files found. Please stage your changes before running this command."
-            )
-            raise typer.Exit(code=0)
-
-        analysis_result = analyzer.analyze(staged_files)
-
-        open_ai = OpenAIProvider()
-
-        commit = open_ai.generate_commit_message(staged_files, analysis_result)
-        commit_command = OpenAIProvider.commit_command(commit)
-
-        typer.echo(f"Suggested commit:\n\n{commit_command}")
-
-        while True:
-            action = (
-                typer.prompt("\nUse this message? [y]es / [e]dit / [n]o", default="y")
-                .strip()
-                .lower()[0]
-            )
-
-            if action == "n":
-                typer.echo("Aborted.")
-                break
-
-            if action == "e":
-                commit_command = edit_with_vim(commit_command)
-                typer.echo(f"Edited commit:\n\n{commit_command}")
-
-            if action == "y":
-                result = repository.commit(commit_command)
-                typer.echo(f"Commit result:\n\n{result.stdout}")
-                break
-
-    except CmtError as e:
-        typer.echo(f"Error: {e}", err=True)
-        raise typer.Exit(code=1) from None
-    except typer.Exit:
-        raise
-    except KeyboardInterrupt:
-        typer.echo("\nOperation cancelled by user.", err=True)
-        raise typer.Exit(code=1) from None
-    except Exception as e:
-        typer.echo(f"Unexpected error: {e}", err=True)
-        raise typer.Exit(code=1) from None
-
-
-@app.command()
-def config(task: str) -> None:
-    if task == "set":
-        settings = Settings()
-
-        open_ai_key = typer.prompt("Enter your OpenAI API key")
-        open_ai_model = typer.prompt(
-            "Enter your OpenAI model", default=settings.OPEN_AI_DEFAULT_MODEL
-        )
-        settings.set(OpenAIConfig(api_key=open_ai_key, model=open_ai_model))
-
-
-if __name__ == "__main__":
-    app()