LSSTApplications  19.0.0-14-gb0260a2+72efe9b372,20.0.0+7927753e06,20.0.0+8829bf0056,20.0.0+995114c5d2,20.0.0+b6f4b2abd1,20.0.0+bddc4f4cbe,20.0.0-1-g253301a+8829bf0056,20.0.0-1-g2b7511a+0d71a2d77f,20.0.0-1-g5b95a8c+7461dd0434,20.0.0-12-g321c96ea+23efe4bbff,20.0.0-16-gfab17e72e+fdf35455f6,20.0.0-2-g0070d88+ba3ffc8f0b,20.0.0-2-g4dae9ad+ee58a624b3,20.0.0-2-g61b8584+5d3db074ba,20.0.0-2-gb780d76+d529cf1a41,20.0.0-2-ged6426c+226a441f5f,20.0.0-2-gf072044+8829bf0056,20.0.0-2-gf1f7952+ee58a624b3,20.0.0-20-geae50cf+e37fec0aee,20.0.0-25-g3dcad98+544a109665,20.0.0-25-g5eafb0f+ee58a624b3,20.0.0-27-g64178ef+f1f297b00a,20.0.0-3-g4cc78c6+e0676b0dc8,20.0.0-3-g8f21e14+4fd2c12c9a,20.0.0-3-gbd60e8c+187b78b4b8,20.0.0-3-gbecbe05+48431fa087,20.0.0-38-ge4adf513+a12e1f8e37,20.0.0-4-g97dc21a+544a109665,20.0.0-4-gb4befbc+087873070b,20.0.0-4-gf910f65+5d3db074ba,20.0.0-5-gdfe0fee+199202a608,20.0.0-5-gfbfe500+d529cf1a41,20.0.0-6-g64f541c+d529cf1a41,20.0.0-6-g9a5b7a1+a1cd37312e,20.0.0-68-ga3f3dda+5fca18c6a4,20.0.0-9-g4aef684+e18322736b,w.2020.45
LSSTDataManagementBasePackage
log.cc
Go to the documentation of this file.
1 /*
2  * LSST Data Management System
3  * Copyright 2008-2016 AURA/LSST.
4  *
5  * This product includes software developed by the
6  * LSST Project (http://www.lsst.org/).
7  *
8  * This program is free software: you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License as published by
10  * the Free Software Foundation, either version 3 of the License, or
11  * (at your option) any later version.
12  *
13  * This program is distributed in the hope that it will be useful,
14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16  * GNU General Public License for more details.
17  *
18  * You should have received a copy of the LSST License Statement and
19  * the GNU General Public License along with this program. If not,
20  * see <https://www.lsstcorp.org/LegalNotices/>.
21  */
22 
23 #include "pybind11/pybind11.h"
24 
25 #include "lsst/log/Log.h"
26 
27 namespace py = pybind11;
28 
29 namespace lsst {
30 namespace log {
31 
32 // Wrapper for Python callable object to make sure that we have GIL
33 // when we call Python. Note that we are leaking Python callable,
34 // as C++ callables may be (and actually are in our particular case)
35 // outliving Python interpreter and attempt to delete Python object
36 // will result in crash.
37 //
38 // See DM-9708
40 public:
41  callable_wrapper(PyObject* callable) : _callable(callable) { Py_XINCREF(_callable); }
42  void operator()() {
43  // make sure we own GIL before doing Python call
44  auto state = PyGILState_Ensure();
45  PyObject_CallObject(_callable, nullptr);
46  PyGILState_Release(state);
47  }
48 
49 private:
50  PyObject* _callable;
51 };
52 
54  py::class_<Log> cls(mod, "Log");
55 
56  /* Constructors */
57  cls.def(py::init<>());
58 
59  /* Members */
60  cls.attr("TRACE") = py::int_(5000);
61  cls.attr("DEBUG") = py::int_(10000);
62  cls.attr("INFO") = py::int_(20000);
63  cls.attr("WARN") = py::int_(30000);
64  cls.attr("ERROR") = py::int_(40000);
65  cls.attr("FATAL") = py::int_(50000);
66 
67  cls.def("isDebugEnabled", &Log::isDebugEnabled);
68  cls.def("isErrorEnabled", &Log::isErrorEnabled);
69  cls.def("isFatalEnabled", &Log::isFatalEnabled);
70  cls.def("isInfoEnabled", &Log::isInfoEnabled);
71  cls.def("isTraceEnabled", &Log::isTraceEnabled);
72  cls.def("isWarnEnabled", &Log::isWarnEnabled);
73  cls.def("getName", &Log::getName);
74  cls.def("setLevel", &Log::setLevel);
75  cls.def("getLevel", &Log::getLevel);
76  cls.def("isEnabledFor", &Log::isEnabledFor);
77  cls.def("getChild", &Log::getChild);
78  cls.def("logMsg", [](Log& log, int level, std::string const& filename, std::string const& funcname,
79  unsigned int lineno, std::string const& msg) {
80  log.logMsg(log4cxx::Level::toLevel(level),
81  log4cxx::spi::LocationInfo(filename.c_str(), funcname.c_str(), lineno), msg.c_str());
82  });
83  cls.def("lwpID", [](Log const& log) -> unsigned { return lsst::log::lwpID(); });
84 
85  cls.def_static("getDefaultLogger", Log::getDefaultLogger);
86  cls.def_static("configure", (void (*)())Log::configure);
87  cls.def_static("configure", (void (*)(std::string const&))Log::configure);
88  cls.def_static("configure_prop", Log::configure_prop);
89  cls.def_static("getLogger", (Log(*)(Log const&))Log::getLogger);
90  cls.def_static("getLogger", (Log(*)(std::string const&))Log::getLogger);
91  cls.def_static("MDC", Log::MDC);
92  cls.def_static("MDCRemove", Log::MDCRemove);
93  cls.def_static("MDCRegisterInit", [](py::function func) {
94  auto handle = func.release(); // will leak as described in callable_wrapper
95  Log::MDCRegisterInit(std::function<void()>(callable_wrapper(handle.ptr())));
96  });
97 }
98 
99 } // log
100 } // lsst
std::string
STL class.
lsst::log::Log::MDCRemove
static void MDCRemove(std::string const &key)
Remove the value associated with KEY within the MDC.
Definition: Log.cc:288
lsst::log::Log::getLevel
int getLevel() const
Retrieve the logging threshold.
Definition: Log.cc:318
lsst::log::Log::isEnabledFor
bool isEnabledFor(int level) const
Return whether the logging threshold of the logger is less than or equal to LEVEL.
Definition: Log.cc:333
lsst::log::Log::getLogger
static Log getLogger(Log const &logger)
Definition: Log.h:760
std::function
lsst::log::Log::configure_prop
static void configure_prop(std::string const &properties)
Configures log4cxx using a string containing the list of properties, equivalent to configuring from a...
Definition: Log.cc:220
lsst::afw::geom.transform.transformContinued.cls
cls
Definition: transformContinued.py:33
lsst::log::callable_wrapper::callable_wrapper
callable_wrapper(PyObject *callable)
Definition: log.cc:41
lsst::log::Log::isWarnEnabled
bool isWarnEnabled() const
Check whether the logger is enabled for the WARN Level.
Definition: Log.h:744
lsst::log::Log::isTraceEnabled
bool isTraceEnabled() const
Check whether the logger is enabled for the TRACE Level.
Definition: Log.h:740
lsst::log::Log::isFatalEnabled
bool isFatalEnabled() const
Check whether the logger is enabled for the FATAL Level.
Definition: Log.h:732
lsst::log::PYBIND11_MODULE
PYBIND11_MODULE(log, mod)
Definition: log.cc:53
lsst::base.packages.log
log
Definition: packages.py:38
lsst::log::lwpID
unsigned lwpID()
Function which returns LWP ID on platforms which support it.
Definition: Log.cc:413
std::string::c_str
T c_str(T... args)
lsst::log::Log::configure
static void configure()
Explicitly configures log4cxx and initializes logging system.
Definition: Log.cc:177
lsst::log::Log::getName
std::string getName() const
Get the logger name associated with the Log object.
Definition: Log.cc:240
lsst::log::Log::getDefaultLogger
static Log getDefaultLogger()
Return default logger instance, same as default constructor.
Definition: Log.h:754
lsst::log::Log::isDebugEnabled
bool isDebugEnabled() const
Check whether the logger is enabled for the DEBUG Level.
Definition: Log.h:724
lsst
A base class for image defects.
Definition: imageAlgorithm.dox:1
lsst::log::Log::MDCRegisterInit
static int MDCRegisterInit(std::function< void()> function)
Definition: Log.cc:292
lsst::log::callable_wrapper::operator()
void operator()()
Definition: log.cc:42
pybind11
Definition: _GenericMap.cc:40
lsst::log::Log::isInfoEnabled
bool isInfoEnabled() const
Check whether the logger is enabled for the INFO Level.
Definition: Log.h:736
lsst::log::Log::MDC
static std::string MDC(std::string const &key, std::string const &value)
Places a KEY/VALUE pair in the Mapped Diagnostic Context (MDC) for the current thread.
Definition: Log.cc:274
lsst::log::callable_wrapper
Definition: log.cc:39
lsst::log::Log
This static class includes a variety of methods for interacting with the the logging module.
Definition: Log.h:713
lsst::log::Log::getChild
Log getChild(std::string const &suffix) const
Return a logger which is a descendant to this logger.
Definition: Log.cc:354
Log.h
LSST DM logging module built on log4cxx.
lsst::log::Log::setLevel
void setLevel(int level)
Set the logging threshold to LEVEL.
Definition: Log.cc:311
lsst::log::Log::isErrorEnabled
bool isErrorEnabled() const
Check whether the logger is enabled for the ERROR Level.
Definition: Log.h:728