Drop-in replacement for Python's built-in `logging` module
Project description
loggingx.py
loggingx
is a drop-in replacement for Python's built-in logging
module. Even better, once you've imported loggingx
, you don't need to modify your existing logging
module.
python3 -m pip install loggingx-py
Additional Format
Attribute name | Format | Description |
---|---|---|
caller | %(caller)s | Caller(<pathname>:<lineno> ) |
ctxFields | %(ctxFields)s | Context fields |
Optimization
Configuration | Description |
---|---|
logging.logThreads |
If False , Record will not collect thread and threadName . |
logging.logProcesses |
If False , Record will not collect process . |
logging.logMultiprocessing |
If False , Record will not collect processName . |
Context
import loggingx as logging
logging.basicConfig(
level=logging.INFO,
format="%(asctime)s\t%(levelname)s\t%(caller)s\t%(message)s\t%(ctxFields)s",
)
def A() -> None:
logging.info("A")
with logging.addFields(A="a"):
B()
def B() -> None:
logging.info("B")
with logging.addFields(B="b"):
C()
def C() -> None:
logging.info("C")
if __name__ == "__main__":
A()
2023-07-19 01:15:33,981 INFO loggingx.py/main.py:10 A {}
2023-07-19 01:15:33,981 INFO loggingx.py/main.py:16 B {'A': 'a'}
2023-07-19 01:15:33,982 INFO loggingx.py/main.py:22 C {'A': 'a', 'B': 'b'}
JSONFormatter
import loggingx as logging
handler = logging.StreamHandler()
handler.setFormatter(logging.JSONFormatter())
logging.basicConfig(level=logging.INFO, handlers=[handler])
if __name__ == "__main__":
with logging.addFields(ctx="ctx"):
logging.info("test", extra={"extra": "extra"})
{"time": 1689697694.9980711, "level": "info", "caller": "loggingx.py/main.py:9", "msg": "test", "ctx": "ctx", "extra": "extra"}
With logging
import logging
import loggingx
# handler = loggingx.StreamHandler()
handler = logging.StreamHandler()
handler.setFormatter(loggingx.JSONFormatter())
# loggingx.basicConfig(level=loggingx.INFO, handlers=[handler])
logging.basicConfig(level=logging.INFO, handlers=[handler])
if __name__ == "__main__":
with loggingx.addFields(ctx="ctx"):
# loggingx.info("test", extra={"extra": "extra"})
logging.info("test", extra={"extra": "extra"})
jq
alias log2jq="jq -R -r '. as \$line | try fromjson catch \$line'"
python3 <path> 2>&1 | log2jq
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
loggingx-py-0.5.0.tar.gz
(39.8 kB
view hashes)
Built Distribution
Close
Hashes for loggingx_py-0.5.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 70501b2222201816a398ab36b71408e6ba72f4525f876e3e3681a9f496a43c63 |
|
MD5 | cc721faecaa2c6c02b6bc3995f5976a1 |
|
BLAKE2b-256 | 49bd3452b0ee727f78e82504bf66612ec193006aad85e2238c45daa3699dab4e |