LSSTApplications  21.0.0+75b29a8a7f,21.0.0+e70536a077,21.0.0-1-ga51b5d4+62c747d40b,21.0.0-11-ga6ea59e8e+47cba9fc36,21.0.0-2-g103fe59+914993bf7c,21.0.0-2-g1367e85+e2614ded12,21.0.0-2-g45278ab+e70536a077,21.0.0-2-g4bc9b9f+7b2b5f8678,21.0.0-2-g5242d73+e2614ded12,21.0.0-2-g54e2caa+6403186824,21.0.0-2-g7f82c8f+3ac4acbffc,21.0.0-2-g8dde007+04a6aea1af,21.0.0-2-g8f08a60+9402881886,21.0.0-2-ga326454+3ac4acbffc,21.0.0-2-ga63a54e+81dd751046,21.0.0-2-gc738bc1+5f65c6e7a9,21.0.0-2-gde069b7+26c92b3210,21.0.0-2-gecfae73+0993ddc9bd,21.0.0-2-gfc62afb+e2614ded12,21.0.0-21-gba890a8+5a4f502a26,21.0.0-23-g9966ff26+03098d1af8,21.0.0-3-g357aad2+8ad216c477,21.0.0-3-g4be5c26+e2614ded12,21.0.0-3-g6d51c4a+4d2fe0280d,21.0.0-3-g7d9da8d+75b29a8a7f,21.0.0-3-gaa929c8+522e0f12c2,21.0.0-3-ge02ed75+4d2fe0280d,21.0.0-4-g3300ddd+e70536a077,21.0.0-4-gc004bbf+eac6615e82,21.0.0-4-gccdca77+f94adcd104,21.0.0-4-gd1c1571+18b81799f9,21.0.0-5-g7b47fff+4d2fe0280d,21.0.0-5-gb155db7+d2632f662b,21.0.0-5-gdf36809+637e4641ee,21.0.0-6-g722ad07+28c848f42a,21.0.0-7-g959bb79+522e0f12c2,21.0.0-7-gfd72ab2+cf01990774,21.0.0-9-g87fb7b8d+e2ab11cdd6,w.2021.04
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