lambda-universal-router 1.0.0

A flexible AWS Lambda event router with support for multiple event sources

Lambda Universal Router

A flexible and type-safe router for AWS Lambda functions that supports multiple event sources. This library makes it easy to handle different types of AWS Lambda events in a clean and organized way.

Documentation

📚 Full Documentation

• API Reference
• Examples
• Event Types
• Contributing Guide
• Changelog

Features

• 🎯 Type-safe event handling with proper Python type hints
• 🔄 Support for multiple AWS event sources
• 🎨 Clean decorator-based routing
• 📦 Easy to extend with new event sources
• 🔒 Structured event objects with proper typing
• 🔍 Custom event handler support for unknown event types

Installation

pip install lambda-universal-router

Quick Start

from lambda_universal_router import Router
from lambda_universal_router.events import APIGatewayEvent, SQSEvent, CustomEvent

router = Router()

@router.apigateway("/hello", method="GET")
def hello(event: APIGatewayEvent, context):
    name = event.query_string_parameters.get('name', 'World')
    return {
        "statusCode": 200,
        "body": f"Hello, {name}!"
    }

@router.sqs()
def process_queue(event: SQSEvent, context):
    for msg in event.records:
        print(f"Processing message {msg.message_id}: {msg.body}")

@router.custom()
def handle_unknown(event: CustomEvent, context):
    print(f"Handling unknown event type: {event.event_data}")

def lambda_handler(event, context):
    return router.dispatch(event, context)

Supported Event Sources

• API Gateway (REST/HTTP APIs)
• SQS (Simple Queue Service)
• S3 (Object Storage)
• DynamoDB Streams
• Kinesis Streams
• SNS (Simple Notification Service)
• EventBridge (CloudWatch Events)
• Custom Events

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

See our Contributing Guide for more details.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Changelog

See CHANGELOG.md for a list of changes and version history.