lazy-log-formatter 0.6.1

A pre-commit script to make log lines lazzier

Lazy log formatter

Pre-commit hook to automatically detect and convert f-strings in Python code to printf-style logging calls, following W1203 Pylint rule:

https://pylint.readthedocs.io/en/stable/user_guide/messages/warning/logging-fstring-interpolation.html

Usage

To use it with pre-commit, add the following lines to your .pre-commit-config.yaml:

- repo: https://github.com/dmar1n/lazy-log-formatter
  rev: 0.6.1
  hooks:
    - id: lazy-log-formatter
      args: ['--fix']

Options

• --fix: Automatically fix f-strings used in log calls to lazy log calls.
• DIR [DIR ...]: One or more directories to search for Python files. If not specified, defaults to the current directory.

Examples

Check all Python files in the current directory and subdirectories:

python -m src.cli

Check all Python files in two directories:

python -m src.cli src/ tests/

Fix issues in all Python files in a directory:

python -m src.cli mydir --fix

If the --fix option is used, the hook will convert f-strings in log calls to lazy log calls, as follows:

# Before
logger.info(f'Hello {name}')

# After
logger.info('Hello %s', name)

# Before
logger.info(f'Hello {name} {surname}')

# After
logger.info('Hello %s %s', name, surname)

Important

Only works with the native Python logging module. Other libraries, such as loguru, do not support lazy calls.

For loguru, see Lazy evaluation of expensive functions:

logger.opt(lazy=True).debug("If sink level <= DEBUG: {x}", x=lambda: expensive_function(2**64))