infomercial.py

"""
"Has this ever happened to you?"

Here's an example of some ostensibly well-instrumented code.
"""





import logging

_user():
    'a dummy function that supposedly creates the user'
    return None


def create_user(name):
    logging.info('creating user with name %r', name)
    try:
        user = _create_user()
        if user is not None:
            logging.info('successfully created user %r', name)
        else:
            logging.error('failed to create user %r', name)
    except Exception:
        logging.critical('exception encountered while creating user %r',
                         name, exc_info=True)
    return user












"""
Notice how the logging statements tend to dominate the code, almost
drowning out the meaning of the code.

Here's lithoxyl's take
"""

from log import dal_log


def create_user(name):
    with dal_log.critical('user creation', reraise=False) as act:
        user = _create_user()
        if user is None:
            act.failure()
    return user