App Context

Application context for managing configuration, authentication, and HTTP clients.

Application context and dependency injection.

AppContext is a framework-agnostic dependency injection container that works with CLI, web applications, and programmatic usage. It provides access to config, auth, logging, and runtime configuration.

Typical usage::

from qlam_core.common.context import AppContext

# Basic usage
ctx = AppContext(context_name="dev", verbose=True)
print(ctx.config.context_name)

# Web application usage
web_ctx = AppContext(
    context_name=f"user_{user_id}",
    output_format="json",
    verbose=False
)

# Usage with display options
cli_ctx = AppContext(
    context_name="production",
    output_format="table",
    wrap=True
)

AppContext

AppContext(context_name: str | None = None, output_format: str | None = None, verbose: bool = False, wrap: bool = False, logger: Logger | None = None, cached_config: 'Config' | None = None, visibility: Visibility | None = None, default_headers: Mapping[str, str] | None = None)

Framework-agnostic dependency injection container.

This class provides access to config, authentication, and logging for any application interface (CLI, web, programmatic).

:param context_name: Optional context name override for user/session isolation. :param output_format: Output format preference ("table" or "json"). :param verbose: Enable verbose logging. :param wrap: Allow multiline wrapping in table output (display hint). :param logger: Logger instance to use; defaults to module logger. :param cached_config: Inject config (avoids reloading from disk). :param visibility: API visibility mode override (None defers to config resolution). :param default_headers: Default HTTP headers to apply to SDK-created clients. Stored as a read-only mapping after construction.

Source code in qlam_core/common/context.py

def __init__(
    self,
    context_name: str | None = None,
    output_format: str | None = None,
    verbose: bool = False,
    wrap: bool = False,
    logger: logging.Logger | None = None,
    cached_config: "Config" | None = None,
    visibility: Visibility | None = None,
    default_headers: Mapping[str, str] | None = None,
) -> None:
    self.verbose = verbose
    self.output_format = output_format
    self.wrap = wrap
    self.visibility = visibility
    self._default_headers = self._validate_default_headers(default_headers)
    self.default_headers: Mapping[str, str] = MappingProxyType(self._default_headers)
    self.logger = logger or logging.getLogger(__name__)

    # Use cached config if provided, otherwise load fresh
    if cached_config:
        self.config = cached_config
        self.logger.debug(f"Using cached config for context: {self.config.context_name}")
    else:
        # Load config (with context selection) - fallback for non-cached usage
        self.config = Config.load(context_name)
        self.logger.debug(f"Loaded config for context: {self.config.context_name}")

    # No default auth provider - will be configured via plugins as needed
    self.auth: BaseAuthProvider | None = None

    # Plugins use the new client system directly via ClientConfigResolver
    # No centralized client factory or facades needed

    self.logger.debug("AppContext initialized successfully")

effective_output_format property

effective_output_format: str

Get the effective output format, considering TTY detection.

This property provides smart defaults for output formatting based on the execution environment. Useful for CLI but can be overridden for web/programmatic usage.

:return: "table" for TTY environments, "json" otherwise, unless explicitly set.

qpu property

qpu: str

Get the QPU from config.

:return: Currently configured QPU identifier.

credentials_view

credentials_view(redacted: bool = True) -> list[dict]

Get a read-only view of cached credentials across all providers.

:param redacted: If True, hide sensitive fields. :return: List of cache metadata dicts.

Source code in qlam_core/common/context.py

def credentials_view(self, redacted: bool = True) -> list[dict]:
    """Get a read-only view of cached credentials across all providers.

    :param redacted: If True, hide sensitive fields.
    :return: List of cache metadata dicts.
    """
    return auth_registry.list_cache_metadata(redacted=redacted)