aiohttp-apiset 0.9.4.2

Build routes using swagger specification

Package to build routes and validate request using swagger specification 2.0.

Features

• 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

Usecase

Package aiohttp_apiset allows supports several strategies:

• The foreign specification. When the specification is made and maintained by another team.
• The specification in the code. When the fragments of specification are placed in the docstrings.
• Mixed strategy. When routing are located in the specification files and operations are described in the docstrings.

Example

async def handler(request, pet_id):
    """
    ---
    tags: [Pet]
    description: Info about pet
    parameters:
      - name: pet_id
        in: path
        type: integer
        minimum: 0
    responses:
      200:
        description: OK
      400:
        description: Validation error
      404:
        description: Not found
    """
    pet = await db.pets.find(pet_id)

    if not pet:
        return {'status': 404, 'msg': 'Not Found'}

    return {
        'pet': pet,  # dict serialized inside jsonify
    }


def main():
    router = SwaggerRouter(
        swagger_ui='/swagger/',
        version_ui=2,
    )
    router.add_get('/pets/{pet_id}', handler=handler)

    app = web.Application(
        router=router,
        middlewares=[jsonify],
    )

    web.run_app(app)

Is now available in the swagger-ui to the address http://localhost:8080/swagger/. Available both branch swagger-ui. For use branch 3.x visit http://localhost:8080/swagger/?version=3

Examples: examples

History

0.9.4 (2018-08-09)

• replace scheme to X-Forwarded-Proto for spec_url
• up swagger-ui to 3.18.0

0.9.3 (2018-07-26)

• Fix copy from schema loader
• Default check_schema in Validator
• support aiohttp 3.3
• up swagger-ui to 3.17.5

0.9.2 (2018-07-04)

• Add spec_url param to SwaggerRouter
• up swagger-ui to 3.17.2

0.9.1 (2018-05-08)

• fix sort of dynamic locations
• middleware binary
• support aiohttp 3.2
• up swagger-ui to 3.14.1

0.9 (2018-03-26)

• Support $ref in docstrings
• Added ContentReceiver
• Drop support py34
• Renamed SubLocation to Location

0.8.1 (2018-02-25)

• Support parameters in PathItem

0.8.0 (2018-02-22)

• Support aiohttp 3.0.1
• Support subapp
• UrlTreeDispatcher.resources now return resources only
• Default_operation & setdefault responses
• Up swagger-ui to 3.10.0
• Await Future in jsonify

0.7.4 (2017-12-22)

• Support aiohttp 2.3.6
• Up swagger-ui to 3.7.0

0.7.3 (2017-11-01)

• Support OrderedDict in loader with yaml tag merge

0.7.2 (2017-10-31)

• Fix ValidationError constructor
• Modify Errors instance through the attribute

0.7.1 (2017-10-31)

• Keep the order of the URLs from the specification
• More error content in the response
• swagger-ui up to 3.4.1

0.7.0 (2017-10-23)

• Introduced Errors and ValidationError
• Access to original spec by name
• Now the default_validate is True
• Added param headers to set_cors for specify default headers
• swagger-ui up to 3.4.0

0.6.2 (2017-08-29)

• Loader support encoding
• Absolute url in ui
• swagger-ui up to 3.1.7

0.6.1 (2017-08-26)

• Method set_cors

0.6 (2017-08-25)

• New loader for load schemas
• Customization format_checkers for check and convert value
• Support swagger-ui version 2 & 3
• Fixed resolve route and middleware
• Optional coromethod init in cbv

0.5.2 (2017-06-21)

• Add method Jsonify.resolve_exception
• Add class Validator with method factory

0.5.1 (2017-06-20)

• Param default_options_handler
• Refactoring middleware jsonify
• Now require aiohttp>=1.2

0.5.0 (2017-06-16)

• fix naming SubLocation
• add to Sublocation add_route
• swagger-ui.min.js as default instead swagger-ui.js
• default tag ‘default’ instead ‘without swagger’
• kwargs as parts in sublocation.url

0.4.5 (2017-05-27)

• Default show single spec in ui
• URL filtering for generated specifications by spec param

0.4.4 (2017-05-26)

• Fix swagger-ui prefix

0.4.3 (2017-05-26)

• Use default value for array when collectionFormat is brackets or multi (#9)
• Back swagger-ui to 2.x

0.4.2 (2017-04-28)

• Up swagger-ui and fix prefix static url
• Support for decimal in JsonEncoder

0.4.1 (2017-03-26)

• Added check for similar patterns on one location
• Fix static return default if filename empty

0.4.0 (2017-03-22)

• TreeUrlDispatcher is stand-alone router
• swagger_ui param now str url location for swagger-ui
• spec query param for swagger-ui location to point to basePath
• Take into account the default value for array parameters (Alain Leufroy #6)
• Extract docstring swagger data in route_factory
• Compatibility with py36 and aiohttp2.0

0.3.4 (2016-12-20)

• fixed swagger extractor from docstring
• support aiohttp 1.2

0.3.3 (2016-12-16)

• Added support pathlib
• Drop deprecated methods in views

0.3.2 (2016-12-14)

• Added support for collectionFormat (#4)

0.3.1 (2016-11-25)

• fix zero for number parameter
• transfer validation errors into client handler if specified argument errors

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)

• Fixed verbosity errors
• Set default value from swagger operationObject
• Started docs on http://aiohttp-apiset.readthedocs.io
• Swagger-ui index on basePath/apidoc/

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)