Opinionated setup for Python's logging module.

logging_demo.py

# Get a logger, put this in the beginning of every file:
import logging

log = logging.getLogger(__name__)
del logging


# Function to set up logging
def setup_logging():
    import datetime
    import logging

    log.setLevel(logging.DEBUG)

    # Custom log output format
    msg_fmt = "[%(asctime)s %(levelname)s %(name)s.%(funcName)s] %(message)s"
    fmt = logging.Formatter(fmt=msg_fmt)

    # Log to a file
    time_string = datetime.datetime.now().strftime("%Y%m%d_%H%M%S")
    log_filename = f"hydrus-tool.{time_string}.log"
    h = logging.FileHandler(log_filename, "w", encoding="utf8")
    h.setLevel(logging.DEBUG)
    h.setFormatter(fmt)
    log.addHandler(h)

    # Log to stdout
    h = logging.StreamHandler()
    h.setLevel(logging.WARNING)
    h.setFormatter(fmt)
    log.addHandler(h)


# Your own code here:
setup_logging()

log.info("get file sources for file %s", file.file_id)