add log() to BoundLoggerFiltering*

[FlorianLudwig]

Summary

add log() to BoundLoggerFiltering* to better match BoundLogger signature

Pull Request Check List

• Added tests for changed code.
  • The CI fails with less than 100% coverage.
• [?] New APIs are added to typing_examples.py (not actually new, just fixes stdlib.get_logger().log())
• Updated documentation for changed code.
  • I think no documentation update is needed for this addition
  • New functions/classes have to be added to docs/api.rst by hand.
  • Changed/added classes/methods/functions have appropriate versionadded, versionchanged, or deprecated directives.
    Find the appropriate next version in our __init__.py file.
• Documentation in .rst and .md files is written using semantic newlines.
• Changes (and possible deprecations) are documented in the changelog.
• Consider granting push permissions to the PR branch, so maintainers can fix minor issues themselves without pestering you.

[hynek]

When you say BoundLogger, I presume you mean stdlib's one (yes, calling them all same was stupid)?

There's really no guarantee to mirror stdlib APIs in general, do you find that method practically useful and if so how? Because it completely obliterates the performance gains we got by pre-creating concrete classes.

[FlorianLudwig]

When you say BoundLogger, I presume you mean stdlib's one (yes, calling them all same was stupid)?

Indeed. I like using structlog.stdlib.get_logger for the type hints.

There's really no guarantee to mirror stdlib APIs in general, do you find that method practically useful and if so how?

I use it to pipe stdlib logs into structlog.

Because it completely obliterates the performance gains we got by pre-creating concrete classes.

It should only effect performance for calls that use .log but the .info etc should be still the same performance, right?

[hynek]

OK thanks! I'll fix a few tiny quibbles myself, really weird to document this. 🤔

[tjb9dc]

@hynek would you mind cutting a release that has this PR? Thanks!

[hynek]

I plan on pushing 22.1 once #407 is merged.