Openapi parameters

[ikitommi]

Initial implementaiton for #627.

• lifts :request into top-level route paramters (was: under :parameters)
• separate coercer for :request and :parameters
• migrated tests

["/foo" {:post {:request {:description ...
                          :content {"application/json" {:schema <schema>
                                                        :examples ...}
                                    :default {:schema <schema>}}
                          :body <schema>} ;; symmetry with response
                :parameters {:body <schema>} ;; backwards compatibility & simple use cases
                :responses {200 {:description ...
                                 :content {"application/json" {:schema <schema>
                                                               :examples ...}
                                           :default {:schema <schema>}}
                                 :body <schema>}}}] ;; backwards compatibility

TODO

• support for accumulating swagger/openapi data under :content, e.g. :examples, :openapi/examples, :openapi, ...
• [ ] convert example projects

[ikitommi]

generating openapi from schema/spec/malli should be inlined in reitit. updating 4 libraties just for sake of small rendering changes is not fun. Also, code is mostly duplicate between the three.

[opqdonut]

some drive-by comments

[ikitommi]

need to add some more tests + port examples.

[ikitommi]

I think this is done, TODO:

1. refactor openapi-docs creationg from spec-tools and schema-tools into reitit
2. cleanup code and tests

[opqdonut]

mostly questions, some suggestions