ddp_utils.console.layout_logger

import ddp_utils.console.layout_logger

Format log records inside one console layout without writing to stdout.

Each logger appends styled lines only to its bound layout buffer and delegates all text styling to the shared styler module.

Examples

Attach a logger to a live layout:

logger = LayoutLogger(layout)
logger.success("Imported 12 rows")

class ddp_utils.console.layout_logger.LayoutLogStyle(icon: str = '', color: str | None = None, bg: str | None = None, style: str | None = None)

Bases: object

Style config for one layout log level.

Parameters

Name	Type	Description
icon	str	Prefix displayed before the message.
color	str | None	Optional foreground color.
bg	str | None	Optional background color.
style	str | None	Optional text style.

Examples

Define a custom notice appearance:

style = LayoutLogStyle(icon="!", color="yellow", style="bold")

class ddp_utils.console.layout_logger.LayoutLogger(layout, config=None)

Bases: object

Logger bound to a single ConsoleLayout.

This logger never writes to global stdout directly. It appends already formatted lines into the target layout log buffer.

Examples

Append an informational line to one layout:

logger = LayoutLogger(layout)
logger.info("Connected")

Bind the logger to a layout and copy default level styles.

Parameters

Name	Description
layout	Target ConsoleLayout receiving formatted lines.
config	Reserved optional configuration retained for compatibility.

Examples

Create a logger for a task block:

logger = LayoutLogger(task_layout)

log(level: str, message: Any) → None

Append a local log line to the bound layout.

Parameters

Name	Type	Description
level	str	Style key from styles.
message	Any	Value converted to text.

Examples

Append a custom-level message:

logger.log("info", "Connected")

info(message: Any) → None

Log a message at the ‘info’ level.

Parameters

Name	Type	Description
message	Any	Informational value.

Examples

Record ordinary progress:

logger.info("Page loaded")

success(message: Any) → None

Log a message at the ‘success’ level.

Parameters

Name	Type	Description
message	Any	Successful outcome value.

Examples

Record a completed operation:

logger.success("Saved")

warning(message: Any) → None

Log a message at the ‘warning’ level.

Parameters

Name	Type	Description
message	Any	Warning value.

Examples

Record a recoverable condition:

logger.warning("Retrying")

error(message: Any) → None

Log a message at the ‘error’ level.

Parameters

Name	Type	Description
message	Any	Error value.

Examples

Record a failed operation:

logger.error("Download failed")

debug(message: Any) → None

Log a message at the ‘debug’ level.

Parameters

Name	Type	Description
message	Any	Diagnostic value.

Examples

Record internal state:

logger.debug({"page": 3})

service(message: Any) → None

Log a message at the ‘service’ level.

Parameters

Name	Type	Description
message	Any	Service-status value.

Examples

Record infrastructure activity:

logger.service("Proxy rotated")