feat(logger): add option to clear state per invocation

[heitorlessa]

Issue #, if available:

Description of changes:

Checklist

• Meet tenets criteria
• Update tests
• Update docs
• PR title follows conventional commit semantics

UX

from aws_lambda_powertools import Logger

logger = Logger(service="payment")

@logger.inject_lambda_context(clear_state=True)
def handler(event, context):
    if event.get("special_key"):
        # Should only be available in the first request log
        # as the second request doesn't contain `special_key`
        logger.append_keys(debugging_key="value")

    logger.info("Collecting payment")

Breaking change checklist

RFC issue #:

• Migration process documented
• Implement warnings (if it can live side by side)

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[codecov-commenter]

Codecov Report

Merging #467 (a691676) into develop (086be96) will increase coverage by 0.00%.
The diff coverage is 100.00%.

@@           Coverage Diff            @@
##           develop     #467   +/-   ##
========================================
  Coverage    99.90%   99.90%           
========================================
  Files          105      105           
  Lines         4231     4233    +2     
  Branches       205      206    +1     
========================================
+ Hits          4227     4229    +2     
  Misses           1        1           
  Partials         3        3           

Impacted Files	Coverage Δ
aws_lambda_powertools/logging/logger.py	100.00% <100.00%> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 086be96...a691676. Read the comment docs.