# Copyright (C) 2011-2012 W. Trevor King <wking@tremily.us>
#
# This file is part of pycomedi.
#
# pycomedi 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 2 of the License, or (at your option) any later
# version.
#
# pycomedi 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
# pycomedi.  If not, see <http://www.gnu.org/licenses/>.

"Wrap library-wide Comedi functions in a `Device` class"

import os as _os

from pycomedi cimport _comedilib_h
from . import constant as _constant


def set_loglevel(level):
    """Control the verbosity of Comedilib debugging and error messages

    This function affects the output of debugging and error messages
    from Comedilib. By increasing the loglevel, additional debugging
    information will be printed. Error and debugging messages are
    printed to the stream stderr.

    The default loglevel can be set by using the environment variable
    COMEDI_LOGLEVEL. The default loglevel is 1.

    In order to conserve resources, some debugging information is
    disabled by default when Comedilib is compiled.

    See `constants.LOGLEVEL` for a list of possible levels and their
    meanings.

    Return value
    ============

    This function returns the previous loglevel.

    >>> from constant import LOGLEVEL
    >>> level = set_loglevel(LOGLEVEL.error)
    >>> level
    <_NamedInt bug>
    >>> set_loglevel(level)
    <_NamedInt error>
    """
    ret = _comedilib_h.comedi_loglevel(_constant.bitwise_value(level))
    return _constant.LOGLEVEL.index_by_value(ret)