id_translation.logging#

Logging utilities; see Logging for help.

Module Attributes

`ENABLE_VERBOSE_LOGGING`	Set to enable additional `DEBUG`-level messages.
`LOGGER`	Root logger instance.

Functions

`enable_verbose_debug_messages`()	Verbose logging context.
`generate_task_id`([seed])	Generate a new task ID.
`get_event_key`(method, stage)	Construct event_key value.

ENABLE_VERBOSE_LOGGING = False#

Set to enable additional DEBUG-level messages.

The default (False) is controlled by the ID_TRANSLATION_VERBOSE variable. Use enable_verbose_debug_messages() to enable temporarily.

LOGGER = <Logger id_translation (WARNING)>#

Root logger instance.

Level is set to logging.WARNING=30 by default (or DEBUG if ENABLE_VERBOSE_LOGGING is set). See Logging for details.

enable_verbose_debug_messages()[source]#

Verbose logging context.

Temporarily set ENABLE_VERBOSE_LOGGING=True and logger.getLogger('id_translation') level to DEBUG.

>>> from id_translation.mapping import Mapper
>>> from id_translation.logging import enable_verbose_debug_messages
>>> with enable_verbose_debug_messages():
...     Mapper().apply("ab", candidates="abc")

generate_task_id(seed=None)[source]#: Generate a new task ID.

get_event_key(method, stage)[source]#: Construct event_key value.