You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
41 lines
1.5 KiB
HTML
41 lines
1.5 KiB
HTML
{{/*
|
|
|
|
Render the parameters of a given type, given:
|
|
|
|
* `parameters`: OpenAPI data specifying the parameters
|
|
* `type`: the type of parameters to render: "header", "path", "query"
|
|
* `caption`: caption to use for the table
|
|
* `path`: the path where this definition was found, to enable us to resolve "$ref"
|
|
|
|
This template renders a single table containing parameters of the given type.
|
|
|
|
*/}}
|
|
|
|
{{ $parameters := .parameters }}
|
|
{{ $type := .type }}
|
|
{{ $caption := .caption }}
|
|
{{ $path := .path }}
|
|
|
|
{{/* build a dict mapping from name->parameter, which render-object-table expects */}}
|
|
{{ $param_dict := dict }}
|
|
|
|
{{ range $parameter := $parameters }}
|
|
{{/*
|
|
Per https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.1.0.md#operation-object:
|
|
the parameters can be reference objects; resolve them now.
|
|
*/}}
|
|
{{ $parameter = partial "openapi/resolve-ref-object" (dict "schema" $parameter "path" $path) }}
|
|
{{ if (eq $parameter.in $type) }}
|
|
{{/*
|
|
merge the schema at the same level as the rest of the other fields because that is
|
|
what `render-object-table` expects. Put the schema first so examples in it are
|
|
overwritten.
|
|
*/}}
|
|
{{ $param := merge $parameter.schema $parameter }}
|
|
{{ $param_dict = merge $param_dict (dict $parameter.name $param )}}
|
|
{{ end }}
|
|
{{ end }}
|
|
|
|
{{/* and render the parameters */}}
|
|
{{ partial "openapi/render-object-table" (dict "title" $caption "properties" $param_dict) }}
|