Coverage for python/lsst/pipe/base/task_logging.py: 83%
Shortcuts on this page
r m x p toggle line displays
j k next/prev highlighted chunk
0 (zero) top of page
1 (one) first highlighted chunk
Shortcuts on this page
r m x p toggle line displays
j k next/prev highlighted chunk
0 (zero) top of page
1 (one) first highlighted chunk
1# This file is part of pipe_base.
2#
3# Developed for the LSST Data Management System.
4# This product includes software developed by the LSST Project
5# (https://www.lsst.org).
6# See the COPYRIGHT file at the top-level directory of this distribution
7# for details of code ownership.
8#
9# This program is free software: you can redistribute it and/or modify
10# it under the terms of the GNU General Public License as published by
11# the Free Software Foundation, either version 3 of the License, or
12# (at your option) any later version.
13#
14# This program is distributed in the hope that it will be useful,
15# but WITHOUT ANY WARRANTY; without even the implied warranty of
16# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
17# GNU General Public License for more details.
18#
19# You should have received a copy of the GNU General Public License
20# along with this program. If not, see <https://www.gnu.org/licenses/>.
22__all__ = ("TRACE", "VERBOSE", "getTaskLogger")
24from deprecated.sphinx import deprecated
26from lsst.utils.logging import getLogger, TRACE, VERBOSE
29@deprecated(reason="getTaskLogger has been replaced by lsst.utils.logging.getLogger."
30 " Will be removed after v24.",
31 version="v24", category=FutureWarning)
32def getTaskLogger(name=None, logger=None):
33 """Get a logger compatible with LSST usage.
35 Parameters
36 ----------
37 name : `str`, optional
38 Name of the logger. Root logger if `None`.
39 logger : `logging.Logger`
40 If given the logger is converted to the relevant logger class.
41 If ``name`` is given the logger is assumed to be a child of the
42 supplied logger.
44 Returns
45 -------
46 logger : `lsst.utils.logging.LsstLogAdapter`
47 The relevant logger.
49 Notes
50 -----
51 A `logging.LoggerAdapter` is used since it is easier to provide a more
52 uniform interface than when using `logging.setLoggerClass`. An adapter
53 can be wrapped around the root logger and the `~logging.setLoggerClass`
54 will return the logger first given that name even if the name was
55 used before the `Task` was created.
56 """
57 return getLogger(name=name, logger=logger)