easylambda 0.2.1

No project description provided

EasyLambda

A lightweight, FastAPI-inspired framework for building AWS Lambda functions with Python.

Installation

You can install the library using pip:

pip install easylambda

Quick Start

from easylambda import get

@get("/")
def lambda_handler() -> dict:
    return {"message": "Hello World!"}

Features

Request Parameters

EasyLambda supports various ways to handle request parameters:

Path Parameters

from typing import Annotated
from easylambda import get
from easylambda.path import Path

@get("/items/{item_id}")
def lambda_handler(item_id: Annotated[int, Path("item_id")]) -> dict:
    return {"item_id": item_id}

Query Parameters

from typing import Annotated
from easylambda import get
from easylambda.query import Query

items = [
    {"item_name": "Foo"},
    {"item_name": "Bar"},
    {"item_name": "Baz"},
]


@get("/items")
def lambda_handler(
    skip: Annotated[int, Query("skip")] = 0,
    limit: Annotated[int, Query("limit")] = 10,
) -> list[dict]:
    return items[skip : skip + limit]

Request Body

from typing import Annotated
from easylambda import post
from easylambda.body import Body
from pydantic import BaseModel

class Item(BaseModel):
    name: str
    description: str | None = None
    price: float
    tax: float | None = None

@post("/items")
def lambda_handler(item: Annotated[Item, Body]) -> dict:
    return item.model_dump()

Headers

from typing import Annotated
from easylambda import get
from easylambda.header import Header

@get("/items")
def lambda_handler(
    user_agent: Annotated[str | None, Header("user-agent")] = None,
) -> dict:
    return {"User-Agent": user_agent}

Response Handling

EasyLambda provides flexible response handling options:

Dictionary Response

The simplest way to return a response:

from easylambda import get

@get("/")
def lambda_handler() -> dict:
    return {"message": "Hello World!"}

Pydantic Model Response

For type-safe responses:

from easylambda import get
from pydantic import BaseModel

class HandlerResponse(BaseModel):
    message: str

@get("/")
def lambda_handler() -> HandlerResponse:
    return HandlerResponse(message="Hello World!")

Custom Response

For full control over the response:

from easylambda import get
from easylambda.aws import Response

@get("/")
def lambda_handler() -> Response:
    return Response(
        statusCode=418,
        body="I'm a teapot",
    )

Key Features

• FastAPI-inspired syntax
• Type hints and validation using Pydantic
• Support for path parameters, query parameters, request body, and headers
• Flexible response handling
• Lightweight and optimized for AWS Lambda environment
• No heavy web framework dependencies

Best Practices

1. Use type hints consistently for better code clarity and automatic validation
2. Leverage Pydantic models for request/response validation
3. Keep functions focused and single-purpose
4. Use meaningful parameter names that match your API design
5. Provide default values for optional parameters

Limitations

• When using as a Lambda Layer:
  • Only available in us-east-2 region
  • Requires Python 3.11 or 3.12
  • Must be used as a Lambda Layer

Contributing

The project is available on GitHub at: https://github.com/leandropls/easylambda