Metadata-Version: 2.1
Name: pylogx
Version: 0.1.2
Summary: python logging extensions supporting additional levels, colorization and more
Author-email: Claudio Klingler <ck@realtime-projects.com>
Project-URL: Homepage, https://github.com/realtimeprojects/pylogx
Project-URL: Bug Tracker, https://github.com/realtimeprojects/pylogx/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE

# pylogx
> python logging extensions supporting additional levels, colorization, indentation and more

## Features

-   Additional log levels (HINT, NOTE, TRACE) for more granularity
-   Colorize log messages based on the log level
-   Indent log messages
-   Log relative time stamps


## Quickstart

### Colorize your log messages

        import time
        from pylogx import log, ColorFormatter

        console = logging.StreamHandler()
        cf = ColorFormatter(fmt="%(prettyDelta)s [%(prettyRelativeDelta)s] %(indent)s %(message)s",
                              ups=[Level.NOTE]) 
        console.setFormatter(cf)
        console.setLevel(Level.NOTE)
        log.addHandler(console)

        log.trace("Have fun with colorized log messages")
        log.note("This message disappears with the next log message")
        time.sleep(5)
        log.note("Another message disappearing soon..")
        time.sleep(5)
        log.info("Last message is gone")

### Indent your log messages

        from pylogx import log, IndentFilter

        formatter = logging.Formatter(fmt="%(asctime)s %(indent)s%(message)s")
        log.setFormatter(formatter)

        iflt = IndentFilter()
        log.addFilter(iflt)

        log.info("base level")

        iflt.inc()
        log.info("sub level")

        iflt.inc()
        log.info("sub sub level")

        iflt.dec()
        log.info("sub level")

        iflt.dec()
        log.info("base level")

### Print log messages with relative time stamp

        import logging
        from pylogx import log, PrettyDelta

        pd = PrettyDelta()
        log.addFilter(prettyDelta)
        prd = PrettyDelta(name="prettyRelativeDelta", fmt="+%M:%S.%f", relative=True)
        log.addFilter(prd)
        formatter = logging.Formatter(fmt="%(prettyDelta)s [%(prettyRelativeDelta)s] %(indent)s %(message)s")
        log.setFormatter(formatter)
        log.message("enjoy relative timestamps)
