Skip to content

logging

frequenz.core.logging ¤

Logging tools.

Functions¤

frequenz.core.logging.get_public_logger ¤

get_public_logger(module_name: str) -> Logger

Get a logger for the public module containing the given module name.

  • Modules are considered private if they start with _.
  • All modules inside a private module are also considered private, even if they don't start with _.
  • If there is no leading public part, the root logger is returned.
Example

Here are a few examples of how this function will resolve module names:

  • some.pub -> some.pub
  • some.pub._some._priv -> some.pub
  • some.pub._some._priv.public -> some.pub
  • some.pub._some._priv.public._private -> some.pub
  • _priv -> root
PARAMETER DESCRIPTION
module_name

The fully qualified name of the module to get the logger for (normally the __name__ built-in variable).

TYPE: str

RETURNS DESCRIPTION
Logger

The logger for the public module containing the given module name.
Source code in frequenz/core/logging.py 
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
def get_public_logger(module_name: str) -> logging.Logger:
    """Get a logger for the public module containing the given module name.

    * Modules are considered private if they start with `_`.
    * All modules inside a private module are also considered private, even if they
      don't start with `_`.
    * If there is no leading public part, the root logger is returned.

    Example:
        Here are a few examples of how this function will resolve module names:

        * `some.pub` -> `some.pub`
        * `some.pub._some._priv` -> `some.pub`
        * `some.pub._some._priv.public` -> `some.pub`
        * `some.pub._some._priv.public._private` -> `some.pub`
        * `_priv` -> `root`

    Args:
        module_name: The fully qualified name of the module to get the logger for
            (normally the `__name__` built-in variable).

    Returns:
        The logger for the public module containing the given module name.
    """
    public_parts: list[str] = []
    for part in module_name.split("."):
        if part.startswith("_"):
            break
        public_parts.append(part)
    return logging.getLogger(".".join(public_parts))