Overview

These are the instructions to install and use the Python client library for Tacklebox. Tacklebox is an open-source serverless framework that offers webhooks as a service.

It includes:

• a CLI tool to deploy and manage AWS infrastructure
• 4 client libraries (JavaScript, Ruby, Python, and Go)
• a RESTful API
• a management UI

You can read more about our case study here.

The Team

Juan Palma Software Engineer Phoenix, AZ

Kevin Counihan Software Engineer Seattle, WA

Armando Mota Software Engineer Los Angeles, CA

Kayl Thomas Software Engineer Atlanta, GA

Getting Started

Install the Python library

To install the Python library for Tacklebox, run:

pip install tacklebox-webhooks

Use the Python library

Once you install the Python library for Tacklebox, you can start using it like so:

from tacklebox_webhooks import Tacklebox

# Initialize a Tacklebox object using the API Key and API Host
# obtained after running 'tacklebox deploy'
tacklebox = Tacklebox(API_KEY, API_HOST)

Once you include the package and initialize a Tacklebox object, you can do many things. For example, you can create a service like so:

tacklebox.service.create({ "name": "service1" })

Once you create services, event types, users and subscriptions, you can create a new event like so:

service_id = "d90af763-5839-4a90-834c-5512980984f5"
user_id = "cabea1b5-b485-41b7-8146-72ece22dc458"

event_data = {
    "event_type": "greet",
    "payload": {
        "message": "Hello from the Python wrapper!"
    },
    "idempotency_key": "1"
}

tacklebox.event.create(service_id, user_id, event_data)

If you want to see the message log for a specific user and service:

service_id = "d90af763-5839-4a90-834c-5512980984f5"
user_id = "cabea1b5-b485-41b7-8146-72ece22dc458"

tacklebox.message.list(service_id, user_id)