"""

biogeme.biogeme_logging
=======================

Examples of use of several functions.

This is designed for programmers who need examples of use of the
functions of the module. The examples are designed to illustrate the
syntax. They do not correspond to any meaningful model.

Michel Bierlaire
Sun Jun 29 2025, 02:24:09
"""

# %%
import os

import biogeme.biogeme_logging as blog
from biogeme.version import get_text

# %%
# Version of Biogeme.
print(get_text())

# %%
# In Python, the levels of reporting are:
#
#     - DEBUG
#     - INFO
#     - WARNING
#     - ERROR
#     - CRITICAL
#
# In Biogeme, we basically use the first three.

# %%
# If we request a specific level, all messages from this level and all
# levels above are displayed. For example, if INFO is requested,
# everything except DEBUG will be displayed.
logger = blog.get_screen_logger(level=blog.INFO)


# %%
logger.info('A test')

# %%
# If a debug message is generated, it is not displayed, as the INFO
# level has been requested above.

# %%
logger.debug('A debug message')

# %%
# But a warning message is displayed, as it comes higher in the hierarchy.

# %%
logger.warning('A warning message')

# %%
# It is also possible to log the messages on file.

# %%
THE_FILE = '_test.log'

# %%
# Let's first erase the file if it happens to exist.
try:
    os.remove(THE_FILE)
    print(f'File {THE_FILE} has been erased.')
except FileNotFoundError:
    print('File {THE_FILE} does not exist.')

# %%
file_logger = blog.get_file_logger(filename=THE_FILE, level=blog.DEBUG)

# %%
file_logger.debug('A debug message')
file_logger.warning('A warning message')
file_logger.info('A info message')

# %%
# Here is the content of the log file. Note that the message includes
# the filename, which is not informative in the context of this
# Notebook.

# %%
with open(THE_FILE, encoding='utf-8') as f:
    print(f.read())