webhooks 0.2.0

Python + Webhooks mMade Easy

Python + Webhooks Made Easy

• Free software: BSD license

• Documentation: http://webhooks.rtfd.org.

WARNING This project is in a pre-alpha state. It’s not ready for use on ANYTHING.

Python Versions

Currently works in:

• Python 2.7

• Python 3.3

• PyPy

Existing Features

• Easy to integrate into any package or project

• Comes with several built-in senders for synchronous webhooks.

• Extendable functionality through the use of custom senders and hash functions.

Planned Features

• Comes with numerous built-in senders for synchronous and asynchronous webhooks.

• Special functions for combining multiple sends of identical payloads going to one target into one.

• Follows http://resthooks.org patterns

• Great documentation

• Great tests

Usage

Follow these easy steps:

1. Import the webhook decorator.

2. Define a function that returns a JSON-serializable dictionary or iterable.

3. Add the webhook decorator and pass in a sender_callable.

4. Call the function!

Synchronous example (async examples to come soon):

from webhooks import webhook
from webhooks.senders import targeted

@webhook(sender_callable=targeted.sender)
def basic(url, wife, husband):
    return {"husband": husband, "wife": wife}

basic(url="http://httpbin.org/post", "Danny", "Audrey")

Projects Powered by Webhooks

• https://github.com/pydanny/dj-webhooks

History

0.2.0 (2014-05-13)

• Added functioning hook decorator.

• Ramped up test coverage.

• Hash functions placed in their own module.

• Cleaned up JSON encoder thanks to Audrey Roy Greenfeld!

0.1.0 (2014-05-07)

• First release on PyPI.