slack-webhook
=============

|PyPI version| |License: MIT| |codecov| |Build Status|

slack-webhook is a python client library for slack api Incoming Webhooks

Installation
------------

::

    $ pip install slack-webhook

Usage
-----

.. code:: python

    #
    # basic
    #
    from slack_webhook import Slack

    slack = Slack(url='https://hooks.slack.com/services/T00/B00/XXX')
    slack.post(text="Hello, world.")

    #
    # advanced
    #
    from slack_webhook import Slack

    slack = Slack(url='https://hooks.slack.com/services/T00/B00/XXX')
    slack.post(text="Robert DeSoto added a new task",
        attachments = [{
            "fallback": "Plan a vacation",
            "author_name": "Owner: rdesoto",
            "title": "Plan a vacation",
            "text": "I've been working too hard, it's time for a break.",
            "actions": [
                {
                    "name": "action",
                    "type": "button",
                    "text": "Complete this task",
                    "style": "",
                    "value": "complete"
                },
                {
                    "name": "tags_list",
                    "type": "select",
                    "text": "Add a tag...",
                    "data_source": "static",
                    "options": [
                        {
                            "text": "Launch Blocking",
                            "value": "launch-blocking"
                        },
                        {
                            "text": "Enhancement",
                            "value": "enhancement"
                        },
                        {
                            "text": "Bug",
                            "value": "bug"
                        }
                    ]
                }
            ]
        }]
    )

Getting started
---------------

For help getting started with Incoming Webhooks, view our online
`documentation <https://api.slack.com/incoming-webhooks>`__.

Contributing
------------

1. Fork it
2. Create your feature branch (``git checkout -b my-new-feature``)
3. Commit your changes (``git commit -am 'Add some feature'``)
4. Push to the branch (``git push origin my-new-feature``)
5. Create new Pull Request

.. |PyPI version| image:: https://badge.fury.io/py/slack-webhook.svg
   :target: https://badge.fury.io/py/slack-webhook
.. |License: MIT| image:: https://img.shields.io/badge/License-MIT-yellow.svg
   :target: https://opensource.org/licenses/MIT
.. |codecov| image:: https://codecov.io/gh/10mohi6/slack-webhook-python/branch/master/graph/badge.svg
   :target: https://codecov.io/gh/10mohi6/slack-webhook-python
.. |Build Status| image:: https://travis-ci.com/10mohi6/slack-webhook-python.svg?branch=master
   :target: https://travis-ci.com/10mohi6/slack-webhook-python
