powertools-oas-validator 0.5.4

No project description provided

powertools-oas-validator

Introduction

Powertools for AWS Lambda (Python) is an awesome set of tools for supercharging your lambdas. Powertools supports validating incoming requests (or event in PT lingo) against JSONSchema which is not ideal if you are using OpenAPI schemas to define your API contracts.

The Powertools OAS Validator adds a decorator that you can use with your lambda handlers and have the events validated against an OpenAPI schema instead.

Installation

Poetry: poetry add powertools-oas-validator

Pip: pip install powertools-oas-validator

Usage

Decorate your functions with @validate_request(oas_path="openapi.yaml") and your request/event (and schema) will be validated on a request.

Minimal Example

from typing import Dict
from aws_lambda_powertools.event_handler import APIGatewayRestResolver, Response
from aws_lambda_powertools.utilities.typing import LambdaContext
from powertools_oas_validator.middleware import validate_request


app = APIGatewayRestResolver()

@app.post("/example")
def example() -> Response:
  ...

@validate_request(oas_path="openapi.yaml")
def lambda_handler(event: Dict, context: LambdaContext) -> Dict:
    response = app.resolve(event, context)

    return response

Error Handling

If the validation fails, the decorator throws a SchemaValidatonError with relevant information about the failed validation.

Know Issues

While all validation errors are caught, there is only limited information about the various errors. The decorator will try its best to throw a SchemaValidatonError (same as the Powertools validator would), with as much of the optional attributes as possible.

In summary, it is possible that not all SchemaValidationErrors's will have a nice validation message, in case you rely on piping it straight back to the client.

Contributions

Please make a pull request and I will review it ASAP.