Skip to main content

Build routes using swagger specification

Project description

aiohttp_apiset Documentation Status

Package to build routes using swagger specification.

Extends specification with directives $include, $view and $handler.


  • Building of the routing from specification swagger

  • Using inclusions other specifications with concatenate url

  • Optional output of the resulting specification and view embed swagger-ui

  • Advanced router with TreeResource

  • Extract specify parameters from request and validate with jsonschema

  • Serialize data as response with middleware




from aiohttp import web

async def handler(request):
    return web.json_response(
        {'test': 'Hello'}

Swagger spec:

swagger: '2.0'

basePath: /api/1


      $handler: mymodule.handler
      summary: and other not required for working route



Setup to application

Create router:

from aiohttp_apiset import SwaggerRouter

router = SwaggerRouter(

Setup to application:


or use as router:



0.3.0 (2016-11-24)

  • Added class OperationIdMapping and param operationId_mapping in SwaggerRouter.include for load authentic specification with specify operationId (#2)

  • Fixed validation form with file

  • Fixed overriding basePath

  • Added jinja2 decorator for working with aiohttp_jinja2

  • Loading operation body from docstring

  • Blank string param for number and integer treated as a missed

0.2.5 (2016-11-08)

0.2.4 (2016-11-06)

  • Added verbosity errors validate with jsonschema

0.2.3 (2016-11-05)

  • Added compatibility with aiohttp >= 1.1

  • Added safe decode form and json

  • Fixed extract body

0.2.2 (2016-10-28)

  • Fixed convertation from match_info

0.2.1 (2016-10-27)

  • Output conversion parameter errors in response

  • Fix validation

0.2.0 (2016-10-26)

0.1.13 (2016-05-02)

Project details

Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aiohttp_apiset-0.3.0.tar.gz (953.9 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page