python-slack-logger

.. image:: https://img.shields.io/pypi/pyversions/slack-logger.svg?maxAge=2592000?style=flat-square :target: https://pypi.python.org/pypi/slack-logger

Python logging handler for Slack web hook integration with simple configuration.

Installation

.. code-block:: bash

pip install slack-logger

Example

Simple '''''' .. code-block:: python

import logging from slack_logger import SlackHandler, SlackFormatter

sh = SlackHandler('YOUR_WEB_HOOK_URL') # url is like 'https://hooks.slack.com/...' sh.setFormatter(SlackFormatter()) logging.basicConfig(handlers=[sh]) logging.warning('warn message')

Using logger '''''''''''' .. code-block:: python

import logging from slack_logger import SlackHandler, SlackFormatter

logger = logging.getLogger(name) logger.setLevel(logging.DEBUG)

sh = SlackHandler(username='logger', icon_emoji=':robot_face:', url='YOUR_WEB_HOOK_URL') sh.setLevel(logging.DEBUG)

f = SlackFormatter() sh.setFormatter(f) logger.addHandler(sh)

logger.debug('debug message') logger.info('info message') logger.warn('warn message') logger.error('error message') logger.critical('critical message')

Using filter ''''''''''''

You can also filter some messages only

.. code-block:: python

from slack_logger import SlackLogFilter

sf = SlackLogFilter()
sh.addFilter(sf)

logger.info('info message')  # Not posted to slack
logger.info('info message to slack', extra={'notify_slack': True})  # Posted to slack

Mentioning someone ''''''''''''''''''

Use mention option to send message with mentioning someone:

.. code-block:: python

sh = SlackHandler('YOUR_WEB_HOOK_URL', mention='U012ABC34')

You can find a member ID (e.g., U012ABC34) from user's profile view.