http://swagger.io/specification/#parameterObject

Currently the only support type of input parameters is body. It should be possible to consume all types of documented parameters.

• query
• header
• path
• formData
• body

Query parameters should be supported. From within a handler it should be possible to use processed parameters.

• collectionFormat — For query and formData.
• standard schema options

Since the parameters are mostly implemented by a JSON schema, their definition can be expressed using one. This can be either a JSON schema or **kwargs passed as a JSON schema.

Thoughts explained by a usage example:

app = Flask(__name__)
oauth = OAuth(app)


@app.route('/')
@oauth.query_param('type', 'BeverageType')
@oauth.query_param('names', collection_format=CollectionFormat.pipes, type='string')
def handler():
    assert isinstance(oauth.parameters.type, str)
    assert isinstance(oauth.parameters.names, list)


assert isinstance(CollectionFormat, enum.Enum)
assert CollectionFormat.pipes == '|'

client = app.test_client()
client.get('/?type=beer&names=Hertog%20Jan|Palm')

http://swagger.io/specification/#schemaObject

At the moment, there is an OpenAPISchemaValidator which extends Draft4Validator. This validator should be extended so it supports the full schemaObject definition.

• default — Fill in the default value, and validate the default against the schema.
• discriminator — I shouldn't be creating issues on a saturday morning… ☕
• readOnly — Should eventually be used to validate a response, but should not be accepted in the request.
• xml — Not needed for schema validation.
• externalDocs — Not needed for schema validation.
• example — Not needed for schema validation.

Incoming primitive types / formats should be converted to Python types according to the schema.

byte / binary

Keep as-is or decode? Keep as str or convert to bytes? Or BytesIO?

date / datetime

Convert to a timezone aware object or convert to UTC?