[Feature]: Support kwargs in logger functions

[eruvanos]

What would you like?

Python power tools logger accepts extra parameter as kwargs which makes it very convenient. This would be great for the durable logger, too.

Possible Implementation

Instead of the current extra kwarg I suggest to use **kwargs, which would make the logger an in-place replacement for the Python

Is this a breaking change?

Yes

Does this require an RFC?

No

Additional Context

No response

[yaythomas]

stdlib logger

In stdlib, https://docs.python.org/3/library/logging.html

There are four keyword arguments in kwargs which are inspected: exc_info, stack_info, stacklevel and extra.

stdlib doesn't allow for arbitrary kwargs. See here for code: https://github.com/python/cpython/blob/3.14/Lib/logging/__init__.py#L1641

Using the extra arg is how stdlib allows you to pass additional data. It does not allow for arbitrary kwargs.

this will "just work" with stdlib:

from aws_durable_execution_sdk_python import DurableContext, durable_execution

@durable_execution
def handler(event: dict, context: DurableContext) -> dict:
    # works immediately with the stdlib logger
    context.logger.info("Processing order", extra={"order_id": "12345", "arb": "value"})

PowerTools

PowerTools extra parameter: https://docs.aws.amazon.com/powertools/python/latest/core/logger/#extra-parameter

  logger.info("Collecting payment", extra=fields)

Powertools ephemeral metadata: https://docs.aws.amazon.com/powertools/python/latest/core/logger/#ephemeral-metadata

logger.info("Collecting payment", request_id="1123")

PowerTools has this additional feature of forwarding on arbitrary kwargs to the underlying logger's extra, but this is not a stdlib feature. https://github.com/aws-powertools/powertools-lambda-python/blob/develop/aws_lambda_powertools/logging/logger.py#L580-L581

integrating with Powertools:

from aws_lambda_powertools import Logger
from aws_durable_execution_sdk_python import DurableContext, durable_execution

logger = Logger(service="order-processing")

@durable_execution
def handler(event: dict, context: DurableContext) -> str:
    # Set Powertools for AWS Lambda (Python) on the context
    context.set_logger(logger)
    context.logger.info("Processing order", extra={"order_id": "12345", "arb": "value"})

summary

The durable context logger already is a drop-in replacement for both stdlib and powertools logger. The commonality between the two is to use extra, but the durable logger allows for wider drop-in compatibility than just Powertools by not being opinionated about the handing of the other kwargs.

The durable context logger intentionally does not replicate the Powertools-specific feature of merging arbitrary kwargs into extra, as this would couple the interface to Powertools behavior and break compatibility with stdlib (which raises TypeError on unknown kwargs passed to _log()).