__init__.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# oct/git/__init__.py
 
"""
Purpose
-------
Phase 4B ``oct git`` package: user-facing Click commands, quality-gate
orchestration, audit logging, and profile policy. Imported lazily by
:mod:`oct.cli` via :func:`git_group` so that CLI startup does not pay
the cost of loading the linter, formatter, or subprocess machinery for
non-git commands.
 
Responsibilities
----------------
- Expose the ``git`` Click command group for :mod:`oct.cli` registration.
- Re-export the stable public API consumed by other oct modules.
 
Contracts
---------
- All Click command functions go through the :func:`audited` decorator
  defined in :mod:`oct.git.audit`.
- Every read-only git state query delegates to :mod:`oct.core.git`
  (Phase 4A foundation). This module never calls ``subprocess.run``
  directly.
- No write operations land in Phase 4B - both ``oct git status`` and
  ``oct git check`` are strictly read-only. Writes come in Phase 4C/4D.
 
Diagnostics
-----------
Domain: GIT
Levels:
    L2 - (none) the lazy re-export resolves before diagnostics start
    L3 - (none) the git commands report in their own modules
    L4 - (none)
 
Dependencies
------------
- oct.core.diagnostics (_dbg imported but never called - the dbg_usage waiver says why)
- oct.git.oct_git (lazy; the git Click group re-exported as git_group)
"""
 
# OCT-LINT: disable-file=dbg_usage reason="Plan 263: its lazy __getattr__ resolves during `import oct.cli`, before init(), so any _dbg call here would run before oc_diagnostics.init() and add a RuntimeWarning to every oct invocation"
from oct.core.diagnostics import _dbg
 
__all__ = ["git_group"]
 
 
def __getattr__(name: str):
    """Lazy re-export of :data:`git_group` from :mod:`oct.git.oct_git`.
 
    ``oct.git.oct_git`` imports Click and the linter/formatter
    orchestrators, which are heavy. Using ``__getattr__`` keeps those
    imports deferred until :mod:`oct.cli` actually touches the group,
    mirroring the pattern the existing ``diag`` package uses.
    """
    if name == "git_group":
        from oct.git.oct_git import git as _git
        return _git
    raise AttributeError(f"module 'oct.git' has no attribute {name!r}")