https://github.com/fmakdemir/colored-logger

Colored Logger library for python
https://github.com/fmakdemir/colored-logger

colored colored-log library logger logging python python-3

Last synced: 9 months ago
JSON representation

Colored Logger library for python

• Host: GitHub
• URL: https://github.com/fmakdemir/colored-logger
• Owner: fmakdemir
• License: mit
• Created: 2016-08-05T12:48:44.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2021-04-20T17:05:14.000Z (about 5 years ago)
• Last Synced: 2024-08-08T16:11:57.519Z (almost 2 years ago)
• Topics: colored, colored-log, library, logger, logging, python, python-3
• Language: Python
• Size: 67.4 KB
• Stars: 1
• Watchers: 2
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

          
.. role:: cmd(code)

   :language: python

.. role:: red

.. role:: green

.. role:: blue

.. role:: teal

************************

ColoredLogger for Python

************************

.. image:: https://img.shields.io/pypi/v/coloredlogger.svg

    :target: https://pypi.python.org/pypi/coloredlogger/

.. image:: https://img.shields.io/badge/wheel-yes-brightgreen.svg

    :target: https://pypi.python.org/pypi/coloredlogger/

.. image:: https://travis-ci.org/fmakdemir/colored-logger.svg?branch=master

    :target: https://travis-ci.org/fmakdemir/colored-logger

Colored Logger for Python that uses clorama for colorful output with timestamp

and customizable format. Colored Logger has timestamp, colored header or full line,

and custom time format

Colored Logger for Python that uses clorama for colorful output with timestamp and customizable format

Setup

#####

Use :cmd:`pip install coloredlogger` to install using pip or

use source code and install requirements with :cmd:`pip install -r requirements.txt`

get a logger with:

.. code-block:: python

    from coloredlogger import ColoredLogger

    logger = ColoredLogger(name=OPTIONAL_LOGGER_NAME)

or get logger with optional config name and config

.. code-block:: python

    import coloredlogger

    logger = coloredlogger.get_logger(name=OPTIONAL_LOGGER_NAME, OPTIONAL_CONFIG_LIST)

log using pre-setup methods:

.. code-block:: python

    logger.wtf('WTF??')

    logger.error('Omg red as rose error')

    logger.success('Such success much green wow')

    logger.info('just a blue info')

    logger.verbose('some log here')

And you should see:

.. image:: https://github.com/Fmakdemir/colored-logger/blob/master/assets/coloredlog-1.png?raw=true

..

    | 2016-11-05 21:35:55 :red:`[-] Omg red as rose error`

    | 2016-11-05 21:35:55 :green:`[+] Such success much green wow`

    | 2016-11-05 21:35:55 :blue:`[?] just a blue info`

    | 2016-11-05 21:35:55 [ ] some log here

or make your own log method using a name prefix color level and whether only

header will be colored or the whole line:

.. code-block:: python

    logger.add_config('my-log', {'prefix': "ROCK!",'color': ColoredLogger.COLORS.CYAN, 'header-only': True})

    logger.log('my-log', 'YOU!')

    logger.log('my-log', 'ALL!')

    logger.log('my-log', 'test', 'with', 'at', 'symbols', sep='@')

..

    | 2016-11-05 21:35:55 :teal:`ROCK!` YOU!

    | 2016-11-05 21:35:55 :teal:`ROCK!` ALL!

    | 2016-11-05 21:35:55 :teal:`ROCK!` test@with@at@symbols

And you should see:

.. image:: https://github.com/Fmakdemir/colored-logger/blob/master/assets/coloredlog-2.png?raw=true

You can also overwrite previous configs by:

.. code-block:: python

    logger.add_config('error', {'prefix': 'Custom error with {{TIME}}: ', 'timestamp': '[%Hh:%Mm:%Ss]', 'header-only': True})

This will overwrite :code:`error` config's properties with given ones which

are :code:`prefix`, :code:`timestamp` and :code:`header-only`

.. image:: https://github.com/Fmakdemir/colored-logger/blob/master/assets/coloredlog-3.png?raw=true

Adding a new config using logger name and init configs is done as in following:

.. code-block:: python

    logger = get_logger('MY LOG', [{'config_name': 'custom-log', 'config': {'timestamp': '%Y/%m/%d %H:%M:%S'}}])

    logger.info('This should have [MY LOG] [?] as prefix')

    logger.success('This should have [MY LOG] [+] as prefix')

    logger.verbose('Yeey')

    logger.log('custom-log', 'This custom log should have overwritten timestamp')

.. image:: https://github.com/Fmakdemir/colored-logger/blob/master/assets/coloredlog-4.png?raw=true

Config object

#############

All keys are optional and if not given will be overridden by defaults

.. code-block:: python

    {

        'level': 10, # integer

        'timestamp': '%Y-%m-%d %H:%M:%S', # timestamp format used with strftime

        'prefix': '[ ]', # prefix which can include {{TIME}} to put timestamp with

        'color': coloredlogger.COLORS.WHITE, # one of coloredlogger.COLORS

        'header-only': False # whether or not color whole line or just header

    }

COLORS Object

*************

Following colors are supported:

**Normal:** :code:`BLACK, BLUE, CYAN, GREEN, MAGENTA, RED, WHITE, YELLOW`

**Light:** :code:`LIGHTBLACK_EX, LIGHTBLUE_EX, LIGHTCYAN_EX, LIGHTGREEN_EX, LIGHTMAGENTA_EX, LIGHTRED_EX, LIGHTWHITE_EX, LIGHTYELLOW_EX`