bundleup-sdk 0.1.0

Python SDK for BundleUp

BundleUp Python SDK

Official Python SDK for the BundleUp API.

Installation

pip install bundleup-sdk

Features

• Pythonic API Design - Context managers, property decorators, and Python best practices
• Custom Exception Hierarchy - Specific exception types for different error scenarios
• Connection Pooling - Efficient HTTP connection reuse with requests.Session
• Type Hints - Full type annotation support for better IDE integration
• Comprehensive Testing - 70+ unit tests with mocked HTTP requests

Usage

Initialize the Client

The SDK supports both regular initialization and context manager usage:

from bundleup import BundleUp

# Regular usage
client = BundleUp("your-api-key")

# Context manager (automatically closes connections)
with BundleUp("your-api-key") as client:
    connections = client.connections.list()

Working with Connections

# List all connections
connections = client.connections.list()

# Create a new connection
connection = client.connections.create({
    "name": "My Connection",
    "integration_id": "integration-id"
})

# Retrieve a specific connection
connection = client.connections.retrieve("connection-id")

# Update a connection
updated = client.connections.update("connection-id", {
    "name": "Updated Name"
})

# Delete a connection
client.connections.delete("connection-id")

Working with Integrations

# List all integrations
integrations = client.integrations.list()

# Retrieve a specific integration
integration = client.integrations.retrieve("integration-id")

Working with Webhooks

# List all webhooks
webhooks = client.webhooks.list()

# Create a new webhook
webhook = client.webhooks.create({
    "url": "https://example.com/webhook",
    "events": ["connection.created"]
})

# Update a webhook
updated = client.webhooks.update("webhook-id", {
    "url": "https://example.com/new-webhook"
})

# Delete a webhook
client.webhooks.delete("webhook-id")

Using the Proxy API

# Create a proxy instance
proxy = client.proxy("connection-id")

# Make requests to the connected service
response = proxy.get("/users")
response = proxy.post("/users", {"name": "John"})
response = proxy.put("/users/123", {"name": "Jane"})
response = proxy.patch("/users/123", {"email": "[e-mail]"})
response = proxy.delete("/users/123")

Using the Unify API

The Unify API provides a standardized interface across different integrations.

Chat

# Get unified chat channels
channels = client.unify("connection-id").chat.channels()

# With pagination parameters
channels = client.unify("connection-id").chat.channels({
    "limit": 50,
    "include_raw": True
})

Git

unify = client.unify("connection-id")

# Get repositories
repos = unify.git.repos()

# Get pull requests
pulls = unify.git.pulls()

# Get tags
tags = unify.git.tags()

# Get releases
releases = unify.git.releases()

Project Management

# Get issues
issues = client.unify("connection-id").pm.issues()

# With pagination
issues = client.unify("connection-id").pm.issues({
    "limit": 100,
    "after": "cursor-id"
})

Error Handling

The SDK uses a hierarchy of custom exceptions:

from bundleup import BundleUp
from bundleup.exceptions import (
    BundleUpError,          # Base exception
    ValidationError,        # Input validation errors
    APIError,              # General API errors
    AuthenticationError,   # 401 errors
    NotFoundError,        # 404 errors
    RateLimitError        # 429 errors
)

try:
    client = BundleUp("your-api-key")
    connections = client.connections.list()
except AuthenticationError:
    print("Invalid API key")
except NotFoundError:
    print("Resource not found")
except RateLimitError:
    print("Rate limit exceeded")
except APIError as e:
    print(f"API error: {e.status_code} - {e}")
except ValidationError as e:
    print(f"Validation error: {e}")

Advanced Usage

Custom Session

You can provide your own requests.Session for advanced configuration:

import requests
from bundleup import BundleUp

session = requests.Session()
session.timeout = 30
session.verify = True

client = BundleUp("your-api-key", session=session)

Query Parameters

The list() method supports query parameters:

# List with filters
connections = client.connections.list(status="active", limit=50)

Requirements

• Python 3.8+
• requests
• typing-extensions

License

MIT License - see LICENSE file for details.

Documentation

For more information, visit https://docs.bundleup.io