apistos_models/
components.rs

1use crate::paths::{Callback, Example, Header, Link, Parameter, RequestBody, Response};
2use crate::reference_or::ReferenceOr;
3use crate::security::SecurityScheme;
4use indexmap::IndexMap;
5use schemars::schema::Schema;
6use serde::Serialize;
7use serde_json::Value;
8use std::collections::BTreeMap;
9
10/// 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.
11#[derive(Serialize, Clone, Debug, Default)]
12#[cfg_attr(any(test, feature = "deserialize"), derive(serde::Deserialize, PartialEq))]
13#[serde(rename_all = "camelCase")]
14pub struct Components {
15  /// An object to hold reusable [Schema Objects](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#schema-object).
16  #[serde(skip_serializing_if = "BTreeMap::is_empty", default)]
17  pub schemas: BTreeMap<String, ReferenceOr<Schema>>,
18  /// An object to hold reusable [Response Objects](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#response-object).
19  #[serde(skip_serializing_if = "BTreeMap::is_empty", default)]
20  pub responses: BTreeMap<String, ReferenceOr<Response>>,
21  /// An object to hold reusable [Parameter Objects](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#parameter-object).
22  #[serde(skip_serializing_if = "BTreeMap::is_empty", default)]
23  pub parameters: BTreeMap<String, ReferenceOr<Parameter>>,
24  /// An object to hold reusable [Example Objects](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#example-object).
25  #[serde(skip_serializing_if = "BTreeMap::is_empty", default)]
26  pub examples: BTreeMap<String, ReferenceOr<Example>>,
27  /// An object to hold reusable [Request Body Objects](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#request-body-object).
28  #[serde(skip_serializing_if = "BTreeMap::is_empty", default)]
29  pub request_bodies: BTreeMap<String, ReferenceOr<RequestBody>>,
30  /// An object to hold reusable [Header Objects](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#header-object).
31  #[serde(skip_serializing_if = "BTreeMap::is_empty", default)]
32  pub headers: BTreeMap<String, ReferenceOr<Header>>,
33  /// An object to hold reusable [Security Scheme Objects](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#security-scheme-object).
34  #[serde(skip_serializing_if = "BTreeMap::is_empty", default)]
35  pub security_schemes: BTreeMap<String, ReferenceOr<SecurityScheme>>,
36  /// An object to hold reusable [Link Objects](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#link-object).
37  #[serde(skip_serializing_if = "BTreeMap::is_empty", default)]
38  pub links: BTreeMap<String, ReferenceOr<Link>>,
39  /// An object to hold reusable [Callback Objects](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#callback-object).
40  #[serde(skip_serializing_if = "BTreeMap::is_empty", default)]
41  pub callbacks: BTreeMap<String, ReferenceOr<Callback>>,
42  /// This object MAY be extended with [Specification Extensions](https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#specification-extensions).
43  #[serde(flatten, skip_serializing_if = "IndexMap::is_empty", skip_deserializing)]
44  pub extensions: IndexMap<String, Value>,
45}
apistos_models/components.rs

apistos_models/
components.rs
