diffsage 1.2.0__py3-none-any.whl

diffsage/__main__.py

@@ -0,0 +1,4 @@
+from diffsage.cli import app
+
+if __name__ == "__main__":
+    app()

diffsage/cli.py

@@ -0,0 +1,38 @@
+import logging
+
+import typer
+
+from diffsage.commands.ask import ask
+from diffsage.commands.auth import app as auth_app
+from diffsage.commands.commit import commit
+from diffsage.commands.config import app as config_app
+from diffsage.commands.doctor import doctor
+from diffsage.config.loader import load_settings
+from diffsage.logging.logger import configure_logging
+
+app = typer.Typer(help="DiffSage: AI-aware Git workflow toolkit")
+
+
+@app.callback()
+def main() -> None:
+    """
+    Initialize DiffSage.
+    """
+    settings = load_settings()
+    configure_logging(
+        getattr(
+            logging,
+            settings.log_level.upper(),
+            logging.INFO,
+        )
+    )
+
+
+app.command()(doctor)
+app.command()(ask)
+app.command()(commit)
+app.add_typer(
+    config_app,
+    name="config",
+)
+app.add_typer(auth_app, name="auth")

diffsage/commands/ask.py

@@ -0,0 +1,62 @@
+from diffsage.config.loader import load_settings
+from diffsage.config.paths import get_credentials_path
+from diffsage.exceptions import (
+    AuthenticationError,
+    ConfigError,
+    CredentialNotFoundError,
+    ProviderUnavailableError,
+)
+from diffsage.logging.logger import get_logger
+from diffsage.services.ai_service import AIService
+from diffsage.services.credentials_service import CredentialService
+from diffsage.storage.credentials_repository import CredentialsRepository
+from diffsage.ui.ask_view import AskView
+
+logger = get_logger(__name__)
+
+
+def ask(prompt: str) -> None:
+    """Ask the configured AI provider a question"""
+
+    logger.info("Running ask command")
+    view = AskView()
+
+    try:
+        settings = load_settings()
+
+        credential_path = get_credentials_path()
+        repository = CredentialsRepository(credential_path)
+        credential_service = CredentialService(repository)
+
+        service = AIService(
+            settings,
+            credential_service,
+        )
+
+        response = service.ask(prompt)
+        view.show_response(response)
+
+    except AuthenticationError as e:
+        logger.warning(str(e))
+        view.show_error(str(e))
+        raise SystemExit(1) from None
+
+    except CredentialNotFoundError as e:
+        logger.warning(str(e))
+        view.show_error(str(e))
+        raise SystemExit(1) from None
+
+    except ProviderUnavailableError as e:
+        logger.warning(str(e))
+        view.show_error(str(e))
+        raise SystemExit(1) from None
+
+    except ConfigError as e:
+        logger.warning(str(e))
+        view.show_error(str(e))
+        raise SystemExit(1) from None
+
+    except Exception:
+        logger.exception("Unexpected error while executing ask command.")
+        view.show_error("An unexpected error occurred. Please check the log file for more details.")
+        raise SystemExit(1) from None

diffsage/commands/auth.py

@@ -0,0 +1,153 @@
+import typer
+
+from diffsage.config.paths import get_credentials_path
+from diffsage.logging.logger import get_logger
+from diffsage.services.credentials_service import CredentialService
+from diffsage.storage.credentials_repository import CredentialsRepository
+from diffsage.ui.auth_view import AuthView
+
+logger = get_logger(__name__)
+
+app = typer.Typer(
+    help="DiffSage credential management",
+    invoke_without_command=False,
+)
+
+
+@app.command("set")
+def set_credential(
+    provider: str,
+    api_key: str,
+    name: str = typer.Option(
+        "default",
+        "--name",
+        help="Credential profile name.",
+    ),
+) -> None:
+    """Store a DiffSage provider credential."""
+
+    view = AuthView()
+
+    try:
+        path = get_credentials_path()
+        repository = CredentialsRepository(path)
+        service = CredentialService(repository)
+
+        service.set_credential(
+            provider,
+            api_key,
+            name,
+        )
+
+        view.show_success("Credential saved.")
+
+    except ValueError as e:
+        logger.warning(str(e))
+        view.show_error(str(e))
+        raise SystemExit(1) from None
+
+    except Exception:
+        logger.exception("Unexpected error while executing auth command.")
+        view.show_error("An unexpected error occurred. Please check the log file for more details.")
+        raise SystemExit(1) from None
+
+
+@app.command("get")
+def get_credential(
+    provider: str,
+    name: str = typer.Option(
+        "default",
+        "--name",
+        help="Credential profile name.",
+    ),
+) -> None:
+    """Get a DiffSage provider credential."""
+
+    view = AuthView()
+
+    try:
+        path = get_credentials_path()
+        repository = CredentialsRepository(path)
+        service = CredentialService(repository)
+
+        credential = service.get_credential(
+            provider,
+            name,
+        )
+
+        if credential is None:
+            view.show_error(f"Credential not found for provider '{provider}' and profile '{name}'.")
+            raise SystemExit(1)
+
+        view.show_credential(credential)
+
+    except ValueError as e:
+        logger.warning(str(e))
+        view.show_error(str(e))
+        raise SystemExit(1) from None
+
+    except Exception:
+        logger.exception("Unexpected error while executing auth command.")
+        view.show_error("An unexpected error occurred. Please check the log file for more details.")
+        raise SystemExit(1) from None
+
+
+@app.command("list")
+def list_credentials() -> None:
+    """List configured DiffSage credentials."""
+
+    view = AuthView()
+
+    try:
+        path = get_credentials_path()
+        repository = CredentialsRepository(path)
+        service = CredentialService(repository)
+
+        credentials = service.list_credentials()
+
+        view.show_credentials(credentials)
+
+    except Exception:
+        logger.exception("Unexpected error while executing auth command.")
+        view.show_error("An unexpected error occurred. Please check the log file for more details.")
+        raise SystemExit(1) from None
+
+
+@app.command("unset")
+def unset_credential(
+    provider: str,
+    name: str = typer.Option(
+        "default",
+        "--name",
+        help="Credential profile name.",
+    ),
+) -> None:
+    """Unset DiffSage provider credential."""
+
+    view = AuthView()
+
+    try:
+        path = get_credentials_path()
+        repository = CredentialsRepository(path)
+        service = CredentialService(repository)
+
+        deleted = service.delete_credential(
+            provider,
+            name,
+        )
+
+        if not deleted:
+            view.show_error(f"Credential not found for provider '{provider}' and profile '{name}'.")
+            raise SystemExit(1)
+
+        view.show_success("Credential removed.")
+
+    except ValueError as e:
+        logger.warning(str(e))
+        view.show_error(str(e))
+        raise SystemExit(1) from None
+
+    except Exception:
+        logger.exception("Unexpected error while executing auth command.")
+        view.show_error("An unexpected error occurred. Please check the log file for more details.")
+        raise SystemExit(1) from None

diffsage/commands/commit.py

@@ -0,0 +1,125 @@
+from diffsage.config.loader import load_settings
+from diffsage.config.paths import get_credentials_path
+from diffsage.exceptions import (
+    ConfigError,
+    CredentialNotFoundError,
+    NoStagedChangesError,
+    NotGitRepositoryError,
+    ProviderError,
+)
+from diffsage.git.client import GitClient
+from diffsage.logging.logger import get_logger
+from diffsage.parsers.commit_message_parser import CommitMessageParser
+from diffsage.services.ai_service import AIService
+from diffsage.services.commit_service import CommitService
+from diffsage.services.credentials_service import CredentialService
+from diffsage.services.editor_service import EditorService
+from diffsage.services.git_service import GitService
+from diffsage.services.prompt_service import PromptService
+from diffsage.storage.credentials_repository import CredentialsRepository
+from diffsage.ui.commit_view import CommitView
+
+logger = get_logger(__name__)
+
+
+def generate_message(commit_service: CommitService) -> str:
+    return commit_service.generate_commit_message()
+
+
+def commit() -> None:
+    """Generate a conventional commit message"""
+
+    try:
+        git_client = GitClient()
+        view = CommitView()
+        editor = EditorService()
+
+        settings = load_settings()
+
+        credential_path = get_credentials_path()
+        credential_repository = CredentialsRepository(credential_path)
+        credential_service = CredentialService(credential_repository)
+
+        git_service = GitService(git_client)
+        ai_service = AIService(
+            settings,
+            credential_service,
+        )
+        prompt_service = PromptService()
+
+        commit_service = CommitService(
+            git_client,
+            git_service,
+            prompt_service,
+            ai_service,
+        )
+
+        with view.generating():
+            raw_message = generate_message(commit_service)
+            commit_message = CommitMessageParser.parse(raw_message)
+
+        view.show_generated()
+        view.show_commit(commit_message)
+
+        while True:
+            choice = view.prompt_action()
+
+            if choice in ("", "y"):
+                logger.info("User selected commit.")
+                git_client.commit(raw_message)
+                view.show_success(raw_message)
+                break
+
+            if choice == "e":
+                logger.info("User selected edit.")
+                raw_message = editor.edit(raw_message)
+                commit_message = CommitMessageParser.parse(raw_message)
+                view.show_commit(commit_message)
+                continue
+
+            if choice == "r":
+                logger.info("User selected regenerate.")
+                with view.generating():
+                    raw_message = generate_message(commit_service)
+                    commit_message = CommitMessageParser.parse(raw_message)
+
+                view.show_generated()
+                view.show_commit(commit_message)
+                continue
+
+            if choice == "n":
+                logger.info("User cancelled commit.")
+                view.show_cancelled()
+                break
+
+            view.show_invalid_option()
+
+    except NotGitRepositoryError:
+        logger.info("Command aborted: not a Git repository.")
+        view.show_not_git_repository()
+        raise SystemExit(1) from None
+
+    except NoStagedChangesError:
+        logger.info("Command aborted: no staged changes.")
+        view.show_no_staged_changes()
+        raise SystemExit(1) from None
+
+    except CredentialNotFoundError as e:
+        logger.warning(str(e))
+        view.show_error(str(e))
+        raise SystemExit(1) from None
+
+    except ProviderError as e:
+        logger.warning(str(e))
+        view.show_error(str(e))
+        raise SystemExit(1) from None
+
+    except ConfigError as e:
+        logger.warning(str(e))
+        view.show_error(str(e))
+        raise SystemExit(1) from None
+
+    except Exception:
+        logger.exception("Unexpected error while executing commit command.")
+        view.show_error("An unexpected error occurred. Please check the log file for more details.")
+        raise SystemExit(1) from None

diffsage/commands/config.py

@@ -0,0 +1,216 @@
+import typer
+
+from diffsage.config.loader import load_settings
+from diffsage.config.resolver import get_local_config_path, resolve_config_path
+from diffsage.config.scope import ConfigScope
+from diffsage.exceptions import InvalidConfigurationValueError, UnknownConfigurationKeyError
+from diffsage.logging.logger import get_logger
+from diffsage.services.config_service import ConfigService
+from diffsage.storage.config_repository import ConfigRepository
+from diffsage.ui.config_view import ConfigView
+
+logger = get_logger(__name__)
+
+app = typer.Typer(help="DiffSage configuration", invoke_without_command=False)
+
+
+def _resolve_scope(*, local: bool, global_: bool) -> ConfigScope:
+    if local and global_:
+        raise typer.BadParameter("Cannot specify both --local and --global.")
+
+    if local:
+        return ConfigScope.LOCAL
+
+    return ConfigScope.GLOBAL
+
+
+@app.command("list")
+def list_config(
+    local: bool = typer.Option(False, "--local"), global_: bool = typer.Option(False, "--global")
+) -> None:
+    """List the current DiffSage configuration."""
+
+    view = ConfigView()
+
+    try:
+        settings = load_settings()
+        scope = _resolve_scope(
+            local=local,
+            global_=global_,
+        )
+
+        if local or global_:
+            path = resolve_config_path(scope)
+
+            repository = ConfigRepository(path)
+            service = ConfigService(settings, repository)
+
+            report = service.get_configuration_raw()
+
+        else:
+            path = get_local_config_path()
+
+            repository = ConfigRepository(path)
+            service = ConfigService(settings, repository)
+
+            report = service.get_configuration()
+
+        view.show_path(path)
+        view.show_configuration(report)
+
+    except typer.BadParameter as e:
+        logger.warning(str(e))
+        view.show_error(str(e))
+        raise SystemExit(1) from None
+
+    except Exception:
+        logger.exception("Unexpected error while executing config command.")
+        view.show_error("An unexpected error occurred. Please check the log file for more details.")
+        raise SystemExit(1) from None
+
+
+@app.command("get")
+def get_config(
+    key: str,
+    local: bool = typer.Option(False, "--local"),
+    global_: bool = typer.Option(False, "--global"),
+) -> None:
+    """Get the value of a DiffSage configuration."""
+
+    view = ConfigView()
+
+    try:
+        settings = load_settings()
+
+        if local or global_:
+            scope = _resolve_scope(
+                local=local,
+                global_=global_,
+            )
+
+            path = resolve_config_path(scope)
+            repository = ConfigRepository(path)
+            service = ConfigService(settings, repository)
+
+            report = service.get_configuration_value_raw(key.strip().lower())
+
+        else:
+            path = get_local_config_path()
+            repository = ConfigRepository(path)
+            service = ConfigService(settings, repository)
+
+            report = service.get_value(key.strip().lower())
+
+        view.show_path(path)
+        view.show_value(report)
+
+    except UnknownConfigurationKeyError as e:
+        logger.warning(str(e))
+        view.show_error(str(e))
+        raise SystemExit(1) from None
+
+    except typer.BadParameter as e:
+        logger.warning(str(e))
+        view.show_error(str(e))
+        raise SystemExit(1) from None
+
+    except Exception:
+        logger.exception("Unexpected error while executing config command.")
+        view.show_error("An unexpected error occurred. Please check the log file for more details.")
+        raise SystemExit(1) from None
+
+
+@app.command("set")
+def set_config(
+    key: str,
+    value: str,
+    local: bool = typer.Option(
+        False, "--local", help="Write to the repository's local configuration."
+    ),
+    global_: bool = typer.Option(
+        False, "--global", help="Write to the repository's global configuration."
+    ),
+) -> None:
+    """Set the value of a DiffSage configuration."""
+
+    view = ConfigView()
+
+    try:
+        settings = load_settings()
+
+        scope = _resolve_scope(local=local, global_=global_)
+        path = resolve_config_path(scope)
+        repository = ConfigRepository(path)
+
+        service = ConfigService(settings, repository)
+
+        report = service.set_value(key.strip().lower(), value)
+
+        view.show_success(f"{scope.value.capitalize()} configuration updated.")
+        view.show_path(path)
+        view.show_configuration(report)
+
+    except UnknownConfigurationKeyError as e:
+        logger.warning(str(e))
+        view.show_error(str(e))
+        raise SystemExit(1) from None
+
+    except InvalidConfigurationValueError as e:
+        logger.warning(str(e))
+        view.show_error(str(e))
+        raise SystemExit(1) from None
+
+    except typer.BadParameter as e:
+        logger.warning(str(e))
+        view.show_error(str(e))
+        raise SystemExit(1) from None
+
+    except Exception:
+        logger.exception("Unexpected error while executing config command.")
+        view.show_error("An unexpected error occurred. Please check the log file for more details.")
+        raise SystemExit(1) from None
+
+
+@app.command("unset")
+def unset_config(
+    key: str,
+    local: bool = typer.Option(
+        False, "--local", help="Write to the repository's local configuration."
+    ),
+    global_: bool = typer.Option(
+        False, "--global", help="Write to the repository's global configuration."
+    ),
+) -> None:
+    """Remove a DiffSage configuration value."""
+
+    view = ConfigView()
+
+    try:
+        settings = load_settings()
+
+        scope = _resolve_scope(local=local, global_=global_)
+        path = resolve_config_path(scope)
+        repository = ConfigRepository(path)
+
+        service = ConfigService(settings, repository)
+
+        report = service.unset_value(key.strip().lower())
+
+        view.show_success(f"{scope.value.capitalize()} configuration removed.")
+        view.show_path(path)
+        view.show_configuration(report)
+
+    except UnknownConfigurationKeyError as e:
+        logger.warning(str(e))
+        view.show_error(str(e))
+        raise SystemExit(1) from None
+
+    except typer.BadParameter as e:
+        logger.warning(str(e))
+        view.show_error(str(e))
+        raise SystemExit(1) from None
+
+    except Exception:
+        logger.exception("Unexpected error while executing config command.")
+        view.show_error("An unexpected error occurred. Please check the log file for more details.")
+        raise SystemExit(1) from None

diffsage/commands/doctor.py

@@ -0,0 +1,18 @@
+from diffsage.logging.logger import get_logger
+from diffsage.services.doctor_service import DoctorService
+from diffsage.ui.doctor_view import DoctorView
+
+logger = get_logger(__name__)
+
+
+def doctor() -> None:
+    """Run environment diagnostics"""
+
+    logger.info("Running doctor command.")
+
+    service = DoctorService()
+    view = DoctorView()
+
+    report = service.run()
+
+    view.show_report(report)

diffsage/config/defaults.py

@@ -0,0 +1,20 @@
+from diffsage.config.schema import (
+    AIConfig,
+    DiffSageConfig,
+    LoggingConfig,
+    NetworkConfig,
+)
+
+DEFAULT_CONFIG = DiffSageConfig(
+    ai=AIConfig(
+        provider="gemini",
+        model="gemini-3.5-flash-lite",
+    ),
+    network=NetworkConfig(
+        timeout=30,
+        max_retries=3,
+    ),
+    logging=LoggingConfig(
+        level="INFO",
+    ),
+)

diffsage/config/file_loader.py

@@ -0,0 +1,21 @@
+import tomllib
+from pathlib import Path
+
+from diffsage.config.schema import PartialDiffSageConfig
+from diffsage.exceptions import ConfigError
+
+
+def load_config(path: Path) -> PartialDiffSageConfig:
+    """Load a configuration file."""
+
+    try:
+        with path.open("rb") as file:
+            data = tomllib.load(file)
+
+        return PartialDiffSageConfig.model_validate(data)
+
+    except FileNotFoundError as error:
+        raise ConfigError(f"Configuration file not found: {path}") from error
+
+    except tomllib.TOMLDecodeError as error:
+        raise ConfigError(f"Invalid TOML syntax: {path}") from error

diffsage/config/loader.py

@@ -0,0 +1,8 @@
+from diffsage.config.resolver import resolve_settings
+from diffsage.config.settings import Settings
+
+
+def load_settings() -> Settings:
+    """Load application settings."""
+
+    return resolve_settings()