infrastructure-core

Core Infrastructure Module

Foundation utilities used across the entire infrastructure layer and all project scripts.

Logging (logging/utils.py)

from infrastructure.core import get_logger, log_operation, log_stage, format_duration
from infrastructure.core.logging.setup import setup_logger
from infrastructure.core.logging.utils import log_timing, log_substep

logger = get_logger(__name__)
logger.info("Processing started")

# log_operation is a context manager (logs start, completion, failure)
with log_operation("Processing data"):
    process()

# Decorator for automatic timing and logging
@log_timing
def expensive_operation():
    pass

# Structured progress logging
log_stage(1, 10, "Running Tests")
log_substep("Unit tests passed")

# ETA calculation
from infrastructure.core.runtime import calculate_eta

Configuration (config/loader.py)

from infrastructure.core.config.loader import load_config, find_config_file, get_config_as_dict

# Load project config.yaml
config = load_config(project_path / "manuscript" / "config.yaml")

# Resolve a named project config; unqualified lookup is intentionally
# ambiguous when a repository contains multiple project manuscripts.
config_path = find_config_file(repo_root, project_name="templates/template_code_project")

Exception Hierarchy (exceptions.py)

All exceptions extend TemplateError. Use context-preserving helpers:

from infrastructure.core import TemplateError
from infrastructure.core.exceptions import (
    ConfigurationError, ValidationError, BuildError,
    RenderingError, LLMError, PublishingError,
    raise_with_context, chain_exceptions, format_file_context,
)

# Raise with file context
raise_with_context(ValidationError("Invalid format"), file_path="doc.md", line=42)

# Chain exceptions
try:
    render()
except RenderingError as e:
    chain_exceptions(BuildError("Pipeline failed"), e)

Exception tree: TemplateError → ConfigurationError, ValidationError, BuildError, FileOperationError, DependencyError, TestError, IntegrationError, LLMError, RenderingError, PublishingError, LiteratureSearchError. Nested children: LLMError → LLMConnectionError, LLMTemplateError; RenderingError → FormatError; PublishingError → UploadError; LiteratureSearchError → APIRateLimitError.