feat(logger): introduce POWERTOOLS_DEBUG for internal debugging

[heitorlessa]

Issue number: aws-powertools/powertools-lambda#86

Summary

Changes

Please provide a summary of what's being changed

Introduces a new environment variable POWERTOOLS_DEBUG to more easily enable internal debugging for Powertools operations.

User experience

Please share what the user experience looks like before and after this change

BEFORE

from aws_lambda_powertools.logging.logger import set_package_logger

set_package_logger() # 

AFTER

Simple use POWERTOOLS_DEBUG environment variable.

Checklist

If your change doesn't seem to apply, please leave them unchecked.

• Meet tenets criteria
• I have performed a self-review of this change
• Changes have been tested
• Changes are documented
• PR title follows conventional commit semantics
• Test warning messages for both POWERTOOLS_DEBUG and POWERTOOLS_DEV
• Optimize strtobool for most common values "1" and "0" for speed

Is this a breaking change?

RFC issue number:

Checklist:

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

Acknowledgment

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

Disclaimer: We value your time and bandwidth. As such, any pull requests created on non-triaged issues might not be successful.

---

View rendered docs/index.md

[codecov-commenter]

Codecov Report

Base: 99.74% // Head: 99.65% // Decreases project coverage by -0.08% ⚠️

Coverage data is based on head (9cb7a16) compared to base (f906ef7).
Patch coverage: 54.54% of modified lines in pull request are covered.

Additional details and impacted files

@@             Coverage Diff             @@
##           develop    #1572      +/-   ##
===========================================
- Coverage    99.74%   99.65%   -0.09%     
===========================================
  Files          124      124              
  Lines         5772     5783      +11     
  Branches       656      658       +2     
===========================================
+ Hits          5757     5763       +6     
- Misses           8       11       +3     
- Partials         7        9       +2     

Impacted Files	Coverage Δ
aws_lambda_powertools/package_logger.py	77.77% <50.00%> (-22.23%)	⬇️
aws_lambda_powertools/shared/functions.py	83.33% <50.00%> (-5.56%)	⬇️
aws_lambda_powertools/shared/constants.py	100.00% <100.00%> (ø)

Help us with your feedback. Take ten seconds to tell us how you rate us. Have a feature suggestion? Share it here.

☔ View full report at Codecov.
📢 Do you have feedback about the report comment? Let us know in this issue.

[heitorlessa]

merging as @rubenfonseca already approved changes earlier (stand-up) but is busy with V2 last Layer tests