create_logger() — flask Function Reference

Architecture documentation for the create_logger() function in logging.py from the flask codebase.

Function python ApplicationCore Scaffolding calls 2 called by 1

Entity Profile

ApplicationCore→ Scaffolding→ create_logger() — flask Function Reference

Dependency Diagram

graph TD
  68cd95ab_083f_10cb_160b_2c2acdef5579["create_logger()"]
  3bd07725_f871_e2d4_476f_62e7d3f6e96a["logging.py"]
  68cd95ab_083f_10cb_160b_2c2acdef5579 -->|defined in| 3bd07725_f871_e2d4_476f_62e7d3f6e96a
  68cd95ab_083f_10cb_160b_2c2acdef5579["create_logger()"]
  68cd95ab_083f_10cb_160b_2c2acdef5579 -->|calls| 68cd95ab_083f_10cb_160b_2c2acdef5579
  68cd95ab_083f_10cb_160b_2c2acdef5579["create_logger()"]
  68cd95ab_083f_10cb_160b_2c2acdef5579 -->|calls| 68cd95ab_083f_10cb_160b_2c2acdef5579
  0aa86bfa_8a21_6a90_c08b_00b371c0af5c["has_level_handler()"]
  68cd95ab_083f_10cb_160b_2c2acdef5579 -->|calls| 0aa86bfa_8a21_6a90_c08b_00b371c0af5c
  style 68cd95ab_083f_10cb_160b_2c2acdef5579 fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

src/flask/logging.py lines 58–79

def create_logger(app: App) -> logging.Logger:
    """Get the Flask app's logger and configure it if needed.

    The logger name will be the same as
    :attr:`app.import_name <flask.Flask.name>`.

    When :attr:`~flask.Flask.debug` is enabled, set the logger level to
    :data:`logging.DEBUG` if it is not set.

    If there is no handler for the logger's effective level, add a
    :class:`~logging.StreamHandler` for
    :func:`~flask.logging.wsgi_errors_stream` with a basic format.
    """
    logger = logging.getLogger(app.name)

    if app.debug and not logger.level:
        logger.setLevel(logging.DEBUG)

    if not has_level_handler(logger):
        logger.addHandler(default_handler)

    return logger