ring.swagger.openapi3 — metosin/ring-swagger 1.1.0

convert-content-schema clj

(convert-content-schema contents options)

convert-operation clj

(convert-operation operation options)

Returns a map with methods as keys and the Operation maps with parameters and responses transformed to comply with Swagger spec as values

convert-parameters clj

(convert-parameters parameters options)

convert-responses clj

(convert-responses responses options)

endpoint-processor clj

(endpoint-processor endpoint)

ensure-body-and-response-schema-names clj

(ensure-body-and-response-schema-names swagger)

Takes a ring-swagger spec and returns a new version with a generated names for all anonymous nested schemas that come as body parameters or response models.

ensure-body-sub-schemas clj

(ensure-body-sub-schemas route)

ensure-response-sub-schemas clj

(ensure-response-sub-schemas route)

extract-models clj

(extract-models swagger)

extract-parameter clj

(extract-parameter in model options)

extract-paths-and-definitions clj

(extract-paths-and-definitions swagger options)

get-response-ref clj

(get-response-ref v)

move-schemas clj

(move-schemas swagger)

OpenApi clj

openapi-defaults clj

openapi-json clj

(openapi-json openapi)

(openapi-json openapi options)

Inputs: ([openapi :- (s/maybe OpenApi)] [openapi :- (s/maybe OpenApi) options :- (s/maybe Options)])

Produces openapi-json output from ring-swagger openapi3 spec. Optional second argument is a options map, supporting the following options with defaults:

:ignore-missing-mappings? - (false) boolean whether to silently ignore missing schema to JSON Schema mappings. if set to false, IllegalArgumentException is thrown if a Schema can't be presented as JSON Schema.

:default-response-description-fn - ((constantly "")) - a fn to generate default response descriptions from http status code. Takes a status code (Int) and returns a String.

:handle-duplicate-schemas-fn - (ring.swagger.core/ignore-duplicate-schemas), a function to handle possible duplicate schema definitions. Takes schema-name and set of found attached schema values as parameters. Returns sequence of schema-name and selected schema value.

:collection-format - Sets the collectionFormat for query and formData parameters. Possible values: multi, ssv, csv, tsv, pipes.

option-defaults clj

Options clj

process-contents clj

(process-contents content prefix)

remove-req-body-name clj

(remove-req-body-name {:keys [content]})

remove-response-content-name clj

(remove-response-content-name {:keys [content] :as schema})

remove-response-name clj

(remove-response-name schemas)

security-operations clj

(security-operations swagger)

security-processor clj

(security-processor endpoint)

swagger-path clj

(swagger-path uri)

Replaces Compojure/Clout style path params in uri with Swagger style path params.

Does not support wildcard-paths or inline-regexes.

The regex is copied from Clout.

to-responses-defn clj

(to-responses-defn responses)

transform-models clj

(transform-models schemas options)

transform-operations clj

(transform-operations f swagger)

Transforms the operations under the :paths of a ring-swagger spec by applying (f operation) to all operations. If the function returns nil, the given operation is removed.