lazyhooks 0.1.3

A lightweight, resilient webhook sender and receiver.

LazyHooks

A lightweight, standalone Python package for sending and receiving webhooks with optional persistence.

Full Documentation & Examples on GitHub

Features

• Simple API: Send webhooks with minimal boilerplate.
• Async First: Built on asyncio and aiohttp for high performance.
• Secure: Built-in HMAC-SHA256 signing and verification.
• Reliable: Optional SQLite storage to persist and retry failed webhooks.

Installation

pip install lazyhooks

Quick Start

Sending a Webhook (Fire & Forget)

import asyncio
from lazyhooks import WebhookSender

async def main():
    sender = WebhookSender(signing_secret="super-secret")
    await sender.send(
        url="https://example.com/webhook",
        payload={"event": "user.created", "id": 123}
    )

asyncio.run(main())

Receiving a Webhook

from lazyhooks import verify_signature

# In your Flask/FastAPI/Django handler:
def handle_webhook(request):
    signature = request.headers.get("X-Hub-Signature-256")
    body = request.body
    
    if verify_signature(body, signature, "super-secret"):
        # Process webhook
        return "OK", 200
    else:
        return "Invalid Signature", 401

Links

• GitHub: https://github.com/StackTactician/LazyHooks
• Issues: https://github.com/StackTactician/LazyHooks/issues
• Documentation: See the GitHub repo for full docs, advanced usage, and examples.