summaryrefslogtreecommitdiffstats
path: root/combox/log.py
blob: 2ebbdd8e74fef0d24a867003947f7e888a260c2d (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
# -*- coding: utf-8 -*-
#
#    Copyright (C) 2016 Dr. Robert C. Green II.
#
#    This file is part of Combox.
#
#   Combox is free software: you can redistribute it and/or modify it
#   under the terms of the GNU General Public License as published by
#   the Free Software Foundation, either version 3 of the License, or
#   (at your option) any later version.
#
#   Combox is distributed in the hope that it will be useful, but
#   WITHOUT ANY WARRANTY; without even the implied warranty of
#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
#   General Public License for more details.
#
#   You should have received a copy of the GNU General Public License
#   along with Combox (see COPYING).  If not, see
#   <http://www.gnu.org/licenses/>.

import logging

def log_config(level, format_):
    """Configures combox logging module.

    Called by all types of log functions in this module.

    :param int level:
        Logging level. Must be any one of the following constants:

            - :const:`logging.CRITICAL`
            - :const:`logging.DEBUG`
            - :const:`logging.ERROR`
            - :const:`logging.FATAL`
            - :const:`logging.INFO`
            - :const:`logging.WARN`
            - :const:`logging.WARNING`
    :param str format_:
          Format string to pass to :func:`logging.basicConfig`
          function.

    """
    logging.basicConfig(level=level,
                        format=format_,
                        datefmt='%Y-%m-%d %H:%M:%S')


def log_i(msg, format_='%(asctime)s - %(message)s'):
    """Function for logging information.

    :param str msg:
        Log message.
    :param str format_:
          Format string to pass to :func:`log_config` function.

    """
    log_config(logging.INFO, format_=format_)
    logging.info(msg)


def log_e(msg, format_='%(asctime)s - %(message)s'):
    """Function for logging errors.

    :param str msg:
        Log message.
    :param str format_:
          Format string to pass to :func:`log_config` function.

    """
    log_config(logging.ERROR, format_=format_)
    logging.error(msg)