__init__.py

Go to the documentation of this file.

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# oct/timing/__init__.py
 
"""
Purpose
-------
Provide local timing ledger and advisory report modules.
 
Responsibilities
----------------
- Keep local timing data bounded, private and advisory.
 
Diagnostics
-----------
Domain: GENERAL
Levels:
    L1 -- instrumentation failures
    L2 -- lifecycle
    L3 -- semantic details
    L4 -- deep tracing
 
Contracts
---------
- Timing instrumentation never changes the wrapped operation's outcome.
- Only the fixed timing schema is persisted; command arguments are never stored.
 
Dependencies
------------
- oc_diagnostics (structured timing diagnostics)
- oct.timing.tiers (re-exported: stage tiers and tier budgets)
- oct.core.diagnostics (_dbg structured logger; imported but never called here)
"""
from oct.timing.tiers import (
    STAGE_TIERS, TIER_BUDGETS_MS, budget_for, budgets_ms, tier_for,
)
# 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__ = ["STAGE_TIERS", "TIER_BUDGETS_MS", "budget_for", "budgets_ms", "tier_for"]