tornado-openapi3 0.2.1

Tornado OpenAPI 3 request and response validation library

Tornado OpenAPI 3 request and response validation library.

Provides integration between the Tornado web framework and Openapi-core library for validating request and response objects against an OpenAPI 3 specification.

Adding validation to request handlers

from openapi_core import create_spec  # type: ignore
from openapi_core.exceptions import OpenAPIError  # type: ignore
from openapi_core.deserializing.exceptions import DeserializeError  # type: ignore
from openapi_core.schema.media_types.exceptions import (  # type: ignore
    InvalidContentType,
)
from openapi_core.unmarshalling.schemas.exceptions import ValidateError  # type: ignore
from tornado.web import RequestHandler
from tornado_openapi3 import RequestValidator
import yaml


class OpenAPIRequestHandler(RequestHandler):
    async def prepare(self) -> None:
        maybe_coro = super().prepare()
        if maybe_coro and asyncio.iscoroutine(maybe_coro):  # pragma: no cover
            await maybe_coro

        spec = create_spec(yaml.safe_load(self.render_string("openapi.yaml")))
        validator = RequestValidator(spec)
        result = validator.validate(self.request)
        try:
            result.raise_for_errors()
        except InvalidContentType:
            self.set_status(415)
            self.finish()
        except (DeserializeError, ValidateError) as e:
            self.set_status(400)
            self.finish()
        except OpenAPIError:
            raise

Validating a response

from tornado.testing import AsyncHTTPTestCase
from tornado_openapi3 import ResponseValidator

from myapplication import create_app, spec


class TestResponses(AsyncHTTPTestCase):
    def get_app(self) -> Application:
        return create_app()

    def test_status(self) -> None:
        validator = ResponseValidator(spec)
        response = self.fetch("/status")
        result = validator.validate(response)
        result.raise_for_errors()