public static void WriteOpenApiDocument(IParseNodeWriter writer, OpenApiDocument doc)
{
writer.WriteStartMap();
writer.WritePropertyName("openapi");
writer.WriteValue("3.0.0");
writer.WriteObject("info", doc.Info, WriteInfo);
writer.WriteList("servers", doc.Servers, WriteServer);
writer.WritePropertyName("paths");
writer.WriteStartMap();
WritePaths(writer, doc.Paths);
writer.WriteEndMap();
writer.WriteList("tags", doc.Tags, WriteTag);
if (!doc.Components.IsEmpty())
{
writer.WriteObject("components", doc.Components, WriteComponents);
}
if (doc.ExternalDocs.Url != null)
{
writer.WriteObject("externalDocs", doc.ExternalDocs, WriteExternalDocs);
}
writer.WriteList("security", doc.SecurityRequirements, WriteSecurityRequirement);
writer.WriteExtensions(doc.Extensions);
writer.WriteEndMap();
}
void IModel.Write(IParseNodeWriter writer)
{
writer.WriteStartMap();
writer.WritePropertyName("openapi");
writer.WriteValue("3.0.0");
writer.WriteObject("info", Info, ModelHelper.Write);
writer.WriteList("servers", Servers, ModelHelper.Write);
writer.WritePropertyName("paths");
if (Paths.PathItems.Count() > 0)
{
ModelHelper.Write(writer, Paths);
}
else
{
writer.WriteValue("{}");
}
writer.WriteList("tags", Tags, ModelHelper.Write);
if (!Components.IsEmpty())
{
writer.WriteObject("components", Components, ModelHelper.Write);
}
if (ExternalDocs.Url != null)
{
writer.WriteObject("externalDocs", ExternalDocs, ModelHelper.Write);
}
writer.WriteList("security", SecurityRequirements, ModelHelper.Write);
writer.WriteEndMap();
}
private static void WriteSchemaProperties(IParseNodeWriter writer, Schema schema)
{
writer.WriteStringProperty("title", schema.Title);
writer.WriteStringProperty("type", schema.Type);
writer.WriteStringProperty("format", schema.Format);
writer.WriteStringProperty("description", schema.Description);
writer.WriteNumberProperty("maxLength", schema.MaxLength);
writer.WriteNumberProperty("minLength", schema.MinLength);
writer.WriteStringProperty("pattern", schema.Pattern);
writer.WriteStringProperty("default", schema.Default);
writer.WriteList("required", schema.Required, (nodeWriter, s) => nodeWriter.WriteValue(s));
writer.WriteNumberProperty("maximum", schema.Maximum);
writer.WriteBoolProperty("exclusiveMaximum", schema.ExclusiveMaximum, false);
writer.WriteNumberProperty("minimum", schema.Minimum);
writer.WriteBoolProperty("exclusiveMinimum", schema.ExclusiveMinimum, false);
if (schema.AdditionalProperties != null)
{
writer.WritePropertyName("additionalProperties");
WriteSchemaOrReference(writer, schema.AdditionalProperties);
}
if (schema.Items != null)
{
writer.WritePropertyName("items");
WriteSchemaOrReference(writer, schema.Items);
}
writer.WriteNumberProperty("maxItems", schema.MaxItems);
writer.WriteNumberProperty("minItems", schema.MinItems);
if (schema.Properties != null)
{
writer.WritePropertyName("properties");
writer.WriteStartMap();
foreach (var prop in schema.Properties)
{
writer.WritePropertyName(prop.Key);
if (prop.Value != null)
{
WriteSchemaOrReference(writer, prop.Value);
}
else
{
writer.WriteValue("null");
}
}
writer.WriteEndMap();
}
writer.WriteNumberProperty("maxProperties", schema.MaxProperties);
writer.WriteNumberProperty("minProperties", schema.MinProperties);
writer.WriteList("enum", schema.Enum, (nodeWriter, s) => nodeWriter.WriteValue(s));
writer.WriteExtensions(schema.Extensions);
}
public static void WriteOperation(IParseNodeWriter writer, Operation operation)
{
writer.WriteStartMap();
writer.WriteList("tags", operation.Tags, Tag.WriteRef);
writer.WriteStringProperty("summary", operation.Summary);
writer.WriteStringProperty("description", operation.Description);
writer.WriteObject("externalDocs", operation.ExternalDocs, WriteExternalDocs);
writer.WriteStringProperty("operationId", operation.OperationId);
var parameters = new List <Parameter>(operation.Parameters);
Parameter bodyParameter = null;
if (operation.RequestBody != null)
{
writer.WritePropertyName("consumes");
writer.WriteStartList();
var consumes = operation.RequestBody.Content.Keys.Distinct();
foreach (var mediaType in consumes)
{
writer.WriteListItem(mediaType, (w, s) => w.WriteValue(s));
}
writer.WriteEndList();
// Create bodyParameter
bodyParameter = new BodyParameter()
{
Name = "body",
Description = operation.RequestBody.Description,
Schema = operation.RequestBody.Content.First().Value.Schema
};
// add to parameters
parameters.Add(bodyParameter);
}
var produces = operation.Responses.Where(r => r.Value.Content != null).SelectMany(r => r.Value.Content?.Keys).Distinct();
if (produces.Count() > 0)
{
writer.WritePropertyName("produces");
writer.WriteStartList();
foreach (var mediaType in produces)
{
writer.WriteListItem(mediaType, (w, s) => w.WriteValue(s));
}
writer.WriteEndList();
}
writer.WriteList <Parameter>("parameters", parameters, WriteParameterOrReference);
writer.WriteMap <Response>("responses", operation.Responses, WriteResponseOrReference);
writer.WriteBoolProperty("deprecated", operation.Deprecated, Operation.DeprecatedDefault);
writer.WriteList("security", operation.Security, WriteSecurityRequirement);
writer.WriteExtensions(operation.Extensions);
writer.WriteEndMap();
}
public static void WritePathItem(IParseNodeWriter writer, PathItem pathItem)
{
writer.WriteStartMap();
writer.WriteStringProperty("summary", pathItem.Summary);
writer.WriteStringProperty("description", pathItem.Description);
if (pathItem.Parameters != null && pathItem.Parameters.Count > 0)
{
writer.WritePropertyName("parameters");
writer.WriteStartList();
foreach (var parameter in pathItem.Parameters)
{
WriteParameter(writer, parameter);
}
writer.WriteEndList();
}
writer.WriteList("servers", pathItem.Servers, WriteServer);
foreach (var operationPair in pathItem.Operations)
{
writer.WritePropertyName(operationPair.Key);
WriteOperation(writer, operationPair.Value);
}
writer.WriteExtensions(pathItem.Extensions);
writer.WriteEndMap();
}
void IModel.Write(IParseNodeWriter writer)
{
writer.WriteStartMap();
writer.WriteList("tags", Tags, Tag.WriteRef);
writer.WriteStringProperty("summary", Summary);
writer.WriteStringProperty("description", Description);
writer.WriteObject("externalDocs", ExternalDocs, ModelHelper.Write);
writer.WriteStringProperty("operationId", OperationId);
writer.WriteList <Parameter>("parameters", Parameters, ModelHelper.Write);
writer.WriteObject("requestBody", RequestBody, ModelHelper.Write);
writer.WriteMap <Response>("responses", Responses, ModelHelper.Write);
writer.WriteMap <Callback>("callbacks", Callbacks, ModelHelper.Write);
writer.WriteBoolProperty("deprecated", Deprecated, DeprecatedDefault);
writer.WriteList("security", Security, ModelHelper.Write);
writer.WriteList("servers", Servers, ModelHelper.Write);
writer.WriteEndMap();
}
public static void WriteOperation(IParseNodeWriter writer, Operation operation)
{
writer.WriteStartMap();
writer.WriteList("tags", operation.Tags, Tag.WriteRef);
writer.WriteStringProperty("summary", operation.Summary);
writer.WriteStringProperty("description", operation.Description);
writer.WriteObject("externalDocs", operation.ExternalDocs, WriteExternalDocs);
writer.WriteStringProperty("operationId", operation.OperationId);
writer.WriteList <Parameter>("parameters", operation.Parameters, WriteParameterOrReference);
writer.WriteObject("requestBody", operation.RequestBody, WriteRequestBodyOrReference);
writer.WriteMap <Response>("responses", operation.Responses, WriteResponseOrReference);
writer.WriteMap <Callback>("callbacks", operation.Callbacks, WriteCallbackOrReference);
writer.WriteBoolProperty("deprecated", operation.Deprecated, Operation.DeprecatedDefault);
writer.WriteList("security", operation.Security, WriteSecurityRequirement);
writer.WriteList("servers", operation.Servers, WriteServer);
writer.WriteExtensions(operation.Extensions);
writer.WriteEndMap();
}
public static void WriteServerVariable(IParseNodeWriter writer, ServerVariable variable)
{
writer.WriteStartMap();
writer.WriteList("enum", variable.Enum, (nodeWriter, s) => nodeWriter.WriteValue(s));
writer.WriteStringProperty("default", variable.Default);
writer.WriteStringProperty("description", variable.Description);
writer.WriteExtensions(variable.Extensions);
writer.WriteEndMap();
}
public static void WriteHeader(IParseNodeWriter writer, Header header)
{
writer.WriteStartMap();
writer.WriteStringProperty("description", header.Description);
writer.WriteBoolProperty("required", header.Required, false);
writer.WriteBoolProperty("deprecated", header.Deprecated, false);
writer.WriteBoolProperty("allowEmptyValue", header.AllowEmptyValue, false);
writer.WriteStringProperty("style", header.Style);
writer.WriteBoolProperty("explode", header.Explode, false);
writer.WriteBoolProperty("allowReserved", header.AllowReserved, false);
writer.WriteObject("schema", header.Schema, WriteSchema);
writer.WriteList("examples", header.Examples, AnyNode.Write);
writer.WriteObject("example", header.Example, AnyNode.Write);
writer.WriteEndMap();
}
void IModel.Write(IParseNodeWriter writer)
{
writer.WriteStartMap();
writer.WriteStringProperty("description", Description);
writer.WriteBoolProperty("required", Required, false);
writer.WriteBoolProperty("deprecated", Deprecated, false);
writer.WriteBoolProperty("allowEmptyValue", AllowEmptyValue, false);
writer.WriteStringProperty("style", Style);
writer.WriteBoolProperty("explode", Explode, false);
writer.WriteBoolProperty("allowReserved", AllowReserved, false);
writer.WriteObject("schema", Schema, ModelHelper.Write);
writer.WriteList("examples", Examples, AnyNode.Write);
writer.WriteObject("example", Example, AnyNode.Write);
writer.WriteMap("content", Content, ModelHelper.Write);
writer.WriteEndMap();
}
public static void WriteParameter(IParseNodeWriter writer, Parameter parameter)
{
writer.WriteStartMap();
writer.WriteStringProperty("name", parameter.Name);
writer.WriteStringProperty("in", parameter.In.ToString());
writer.WriteStringProperty("description", parameter.Description);
writer.WriteBoolProperty("required", parameter.Required, false);
writer.WriteBoolProperty("deprecated", parameter.Deprecated, false);
writer.WriteBoolProperty("allowEmptyValue", parameter.AllowEmptyValue, false);
writer.WriteStringProperty("style", parameter.Style);
writer.WriteBoolProperty("explode", parameter.Explode, false);
writer.WriteBoolProperty("allowReserved", parameter.AllowReserved, false);
writer.WriteObject("schema", parameter.Schema, WriteSchemaOrReference);
writer.WriteList("examples", parameter.Examples, AnyNode.Write);
writer.WriteObject("example", parameter.Example, AnyNode.Write);
writer.WriteMap("content", parameter.Content, WriteMediaType);
writer.WriteExtensions(parameter.Extensions);
writer.WriteEndMap();
}
public void Write(IParseNodeWriter writer)
{
writer.WriteStartMap();
writer.WriteStringProperty("summary", Summary);
writer.WriteStringProperty("description", Description);
if (Parameters != null && Parameters.Count > 0)
{
writer.WritePropertyName("parameters");
writer.WriteStartList();
foreach (var parameter in this.Parameters)
{
ModelHelper.Write(writer, parameter);
}
writer.WriteEndList();
}
writer.WriteList("servers", Servers, ModelHelper.Write);
foreach (var operationPair in Operations)
{
writer.WritePropertyName(operationPair.Key);
ModelHelper.Write(writer, operationPair.Value);
}
writer.WriteEndMap();
}
