__init__.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# oct/formatter/__init__.py
 
"""
Formatter module for OCT.
 
Purpose
-------
Provides auto-fixing capabilities for Option C compliance violations.
 
Responsibilities
----------------
- Export the main formatter entry point (`run_formatter`).
- Enable CLI integration of the formatter command.
 
Diagnostics
-----------
Domain: OCT.FORMATTER
Levels:
    L2 - formatter lifecycle and command execution
    L3 - file processing and fix application
    L4 - detailed fixer operation (header, docstring, import, func pattern)
 
Contracts
---------
- All public exports are guaranteed to be importable from this module.
 
Dependencies
------------
- oct.core.diagnostics (_dbg structured logger, imported but not called)
- oct.formatter.oct_format (run_formatter - the re-exported entry point)
"""
 
from oct.formatter.oct_format import run_formatter
# OCT-LINT: disable-file=dbg_usage reason="Plan 263: a re-export package root with no function or method, 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__ = ["run_formatter"]