aiohttp-swagger3 0.1

validation for aiohttp swagger openAPI 3

aiohttp-swagger3

!!! Testers are needed !!!

Feel free to try this library and raise an issue if it does not work as expected, thanks!

About

Package to validating requests using swagger specification 3.0.
It's marked as pre-alpha on pypi.org, but that's because I haven't decided architecture yet. However, we use it in production :)

Limitations

• only application/json supported for now, but you can create own handler
• header/query parameters only supported simple/form array serialization, e.g. 1,2,3,4
• see TODO below

Installation

pip install aiohttp-swagger3

Example

from aiohttp import web
from aiohttp_swagger3 import SwaggerDocs

async def get_one_pet(request: web.Request, pet_id: int) -> web.Response:
    """
    Optional route description
    ---
    summary: Info for a specific pet
    tags:
      - pets
    parameters:
      - name: pet_id
        in: path
        required: true
        description: The id of the pet to retrieve
        schema:
          type: integer
          format: int32
    responses:
      '200':
        description: Expected response to a valid request
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/Pet"
    """
    if pet_id not in request.app['storage']:
        raise web.HTTPNotFound()
    return web.json_response(request.app['storage'][pet_id])

def main():
    app = web.Application()
    s = SwaggerDocs(app, '/docs', title="Swagger Petstore", version="1.0.0", components="components.yaml")
    s.add_routes([
        web.get("/pets/{pet_id}", get_one_pet),
    ])
    app['storage'] = {}
    web.run_app(app)

More examples

Features

• items
• properties
• pattern
• required
• enum
• minimum
• maximum
• exclusiveMinimum
• exclusiveMaximum
• minLength
• maxLength
• minItems
• maxItems
• uniqueItems
• minProperties
• maxProperties
• default (only primitives)
• additionalProperties
• nullable
• allOf
• oneOf
• anyOf

TODO (raise an issue if needed)

• cookies
• multipleOf
• not
• allowEmptyValue
• Common Parameters for All Methods of a Path (spec file only)
• readOnly, writeOnly
• more serialization methods, see: https://swagger.io/docs/specification/serialization/
• encoding
• form data serialization out of the box
• default (array, object)