restify-openapi 0.0.1

STILL WIP
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67

use crate::models::paths::{Callback, Example, Header, Link, Parameter, RequestBody, Response};
use crate::models::reference_or::ReferenceOr;
use crate::models::security::SecurityScheme;
use indexmap::IndexMap;
use schemars::schema::Schema;
use serde::Serialize;
use serde_json::Value;
use std::collections::BTreeMap;

/// Holds a set of reusable objects for different aspects of the OAS. All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.
#[derive(Serialize, Clone, Debug, Default)]
#[cfg_attr(
  any(test, feature = "deserialize"),
  derive(serde::Deserialize, PartialEq)
)]
#[serde(rename_all = "camelCase")]
pub struct Components {
  /// An object to hold reusable [Schema Objects](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#schema-object).
  #[serde(skip_serializing_if = "BTreeMap::is_empty", default)]
  pub schemas: BTreeMap<String, ReferenceOr<Schema>>,
  /// An object to hold reusable [Response Objects](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#response-object).
  #[serde(skip_serializing_if = "BTreeMap::is_empty", default)]
  pub responses: BTreeMap<String, ReferenceOr<Response>>,
  /// An object to hold reusable [Parameter Objects](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#parameter-object).
  #[serde(skip_serializing_if = "BTreeMap::is_empty", default)]
  pub parameters: BTreeMap<String, ReferenceOr<Parameter>>,
  /// An object to hold reusable [Example Objects](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#example-object).
  #[serde(skip_serializing_if = "BTreeMap::is_empty", default)]
  pub examples: BTreeMap<String, ReferenceOr<Example>>,
  /// An object to hold reusable [Request Body Objects](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#request-body-object).
  #[serde(skip_serializing_if = "BTreeMap::is_empty", default)]
  pub request_bodies: BTreeMap<String, ReferenceOr<RequestBody>>,
  /// An object to hold reusable [Header Objects](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#header-object).
  #[serde(skip_serializing_if = "BTreeMap::is_empty", default)]
  pub headers: BTreeMap<String, ReferenceOr<Header>>,
  /// An object to hold reusable [Security Scheme Objects](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#security-scheme-object).
  #[serde(skip_serializing_if = "BTreeMap::is_empty", default)]
  pub security_schemes: BTreeMap<String, ReferenceOr<SecurityScheme>>,
  /// An object to hold reusable [Link Objects](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#link-object).
  #[serde(skip_serializing_if = "BTreeMap::is_empty", default)]
  pub links: BTreeMap<String, ReferenceOr<Link>>,
  /// An object to hold reusable [Callback Objects](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#callback-object).
  #[serde(skip_serializing_if = "BTreeMap::is_empty", default)]
  pub callbacks: BTreeMap<String, ReferenceOr<Callback>>,
  /// This object MAY be extended with [Specification Extensions](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#specification-extensions).
  #[serde(
    flatten,
    skip_serializing_if = "IndexMap::is_empty",
    skip_deserializing
  )]
  pub extensions: IndexMap<String, Value>,
}

impl Components {
  pub fn merge(&mut self, other: Components) {
    self.schemas.extend(other.schemas);
    self.responses.extend(other.responses);
    self.parameters.extend(other.parameters);
    self.examples.extend(other.examples);
    self.request_bodies.extend(other.request_bodies);
    self.headers.extend(other.headers);
    self.security_schemes.extend(other.security_schemes);
    self.links.extend(other.links);
    self.callbacks.extend(other.callbacks);
    self.extensions.extend(other.extensions);
  }
}