setup_logging.py

Setup Logging hook sets up the RichHandler for pretty console logs, and file logs to the configured markata's configured log_dir, or output_dir/_logs if log_dir is not configured. The log file will be named after the <levelname>.log

The log files

There will be 6 log files created based on log level and file type.






        
markout/_logs
├── debug
│   └── index.html
├── debug.log
├── info
│   └── index.html
├── info.log
├── warning
│   └── index.html
└── warning.log

Configuration

Ensure that setup_logging is in your hooks. You can check if setup_logging is in your hooks by running markata list --hooks from your terminal and checking the output, or creating an instance of Markata() and checking the Markata().hooks attribute. If its missing or you wan to be more explicit, you can add setup_logging to your markata.toml [markata.hooks].






        
[markata]

# make sure its in your list of hooks
hooks=[
   "markata.plugins.setup_logging",
   ]

Log Template






        
[markata]

# make sure its in your list of hooks
hooks=[
   "markata.plugins.setup_logging",
   ]

# point log template to the path of your logging template
log_template='templates/log_template.html'

You can see the latest default log_template on GitHub

Disable Logging

If you do not want logging, you can explicityly disable it by adding it to your [markata.disabled_hooks] array in your [markata.toml]






        
[markata]

# make sure its in your list of hooks
disabled_hooks=[
   "markata.plugins.setup_logging",
   ]

Function

has_rich_handler function

Returns a boolean whether or not there is a RichHandler attached to the root logger.

has_rich_handler source






        
def has_rich_handler() -> bool:
    """
    Returns a boolean whether or not there is a RichHandler attached to the
    root logger.
    """

    logger = logging.getLogger()
    return bool([h for h in logger.handlers if isinstance(h, RichHandler)])

Function

setup_text_log function

sets up a plain text log in markata's configured log_dir, or output_dir/_logs if log_dir is not configured. The log file will be named after the <levelname>.log

setup_text_log source






        
def setup_text_log(markata: "Markata", level: int = logging.INFO) -> Path:
    """
    sets up a plain text log in markata's configured `log_dir`, or
    `output_dir/_logs` if `log_dir` is not configured.  The log file will be
    named after the `<levelname>.log`
    """
    log_file = markata.config.logging.log_dir / (
        logging.getLevelName(level).lower() + ".log"
    )

    if has_file_handler(log_file):
        return log_file

    if not log_file.parent.exists():
        log_file.parent.mkdir(parents=True)
    fh = logging.FileHandler(log_file)
    fh.setLevel(level)
    fh_formatter = logging.Formatter(
        "%(asctime)s %(name)-12s %(levelname)-8s %(message)s",
    )
    fh.setFormatter(fh_formatter)
    logging.getLogger("").addHandler(fh)

    return log_file

Function

setup_html_log function

sets up an html log in markata's configured log_dir, or output_dir/_logs if log_dir is not configured. The log file will be named after the <levelname>/index.html. The goal of this is to give

setup_html_log source






        
def setup_html_log(markata: "Markata", level: int = logging.INFO) -> Path:
    """
    sets up an html log in markata's configured `log_dir`, or
    `output_dir/_logs` if `log_dir` is not configured.  The log file will be
    named after the `<levelname>/index.html`.  The goal of this is to give
    """

    log_file = (
        markata.config.logging.log_dir
        / logging.getLevelName(level).lower()
        / "index.html"
    )

    if has_file_handler(log_file):
        return log_file

    log_file.parent.mkdir(parents=True, exist_ok=True)

    if not log_file.exists():
        template = Template(
            markata.config.logging.template.read_text(), undefined=SilentUndefined
        )
        log_header = template.render(
            title=markata.config.title + " logs",
            config=markata.config,
        )
        log_file.write_text(log_header)
    with open(log_file, "a") as f:
        command = Path(sys.argv[0]).name + " " + " ".join(sys.argv[1:])
        f.write(
            f"""
            <div style="
            width: 100%;
            height: 20px;
            margin-top: 5rem;
            border-bottom: 1px solid goldenrod;
            text-align: center">
                <span style="padding: 0 10px;">
                    {datetime.datetime.now()} running "{command}"
                </span>
            </div>
    """,
        )
    fh = logging.FileHandler(log_file)
    fh.setLevel(level)
    fh_formatter = logging.Formatter(
        """
        <li>
            <p>
                <span class="time">%(asctime)s</span>
                <span class="name %(name)s">%(name)-12s</span>
                <span class="levelname %(levelname)s">%(levelname)-8s</span>
            </p>
            <p class="message">%(message)s</p>
        </li>
        """,
    )
    fh.setFormatter(fh_formatter)
    logging.getLogger("").addHandler(fh)

    return log_file