format_path(swagger, subPath, path, method, operation) ::= <<
<format_title(swagger, method, subPath)>
<format_description(operation)>
<if(operation.parameters)><format_parameters(operation.parameters)><endif>
<format_responses(operation)>
>>
format_title(swagger, method, subPath) ::= "==== <method> <swagger.basePath><subPath>"
format_description(operation) ::= "===== Description<\n><operation.description>"
format_parameters(parameters) ::= <<===== Parameters
[options="header"]
|===
|Where|Name|Description|Required|Schema|Default
<parameters:format_parameter()>|===
>>
format_parameter(p) ::= "|<p.in>|<p.name>|<p.description>|<p.required>|<format_parameter_type(p)>|<p.defaultValue><\n>"
format_parameter_type(p) ::= "<if (p.type)><p.type><elseif(p.schema)>\<\<<p.schema.simpleRef>>><endif>"
format_responses(operation) ::= <<===== Responses
[options="header"]
|===
|HTTP Code|Description|Schema
<operation.responses.keys:{
k | |<k>|<operation.responses.(k).description>|<format_response_type(operation.responses.(k).schema)><\n>}>|===
>>
format_response_type(p) ::= "<if (p.items)>[\<\<<p.items.simpleRef>>>]<elseif(p.simpleRef)>\<\<<p.simpleRef>>><endif>"
# |
Change |
User |
Description |
Committed |
|
#1
|
20014 |
Paul Allen |
Moved swagger gneration inside project. |
|
|
//guest/paul_allen/hws/dev/swagger/src/main/resources/asciidoc/paths.stg |
#1
|
19966 |
Paul Allen |
Refactor... |
|
|