Add examples schema keyword

schemars/src/flatten.rs

@@ -51,6 +51,7 @@ impl Merge for Metadata {
             deprecated: self.deprecated || other.deprecated,
             read_only: self.read_only || other.read_only,
             write_only: self.write_only || other.write_only,
+            examples: self.examples.merge(other.examples),
         }
     }
 }

schemars/src/schema.rs

@@ -261,6 +261,11 @@ pub struct Metadata {
     /// See [JSON Schema Validation 9.4. "readOnly" and "writeOnly"](https://tools.ietf.org/html/draft-handrews-json-schema-validation-02#section-9.4).
     #[serde(skip_serializing_if = "is_false")]
     pub write_only: bool,
+    /// The `examples` keyword.
+    ///
+    /// See [JSON Schema Validation 9.5. "examples"](https://tools.ietf.org/html/draft-handrews-json-schema-validation-02#section-9.5).
+    #[serde(skip_serializing_if = "Vec::is_empty")]
+    pub examples: Vec<Value>,
 }
 
 #[allow(clippy::trivially_copy_pass_by_ref)]

schemars/tests/expected/schema-2019_09.json

@@ -121,6 +121,11 @@
       ],
       "items": true
     },
+    "examples": {
+      "description": "The `examples` keyword.\n\nSee [JSON Schema Validation 9.5. \"examples\"](https://tools.ietf.org/html/draft-handrews-json-schema-validation-02#section-9.5).",
+      "type": "array",
+      "items": true
+    },
     "exclusiveMaximum": {
       "description": "The `exclusiveMaximum` keyword.\n\nSee [JSON Schema Validation 6.2.3. \"exclusiveMaximum\"](https://tools.ietf.org/html/draft-handrews-json-schema-validation-02#section-6.2.3).",
       "type": [
@@ -483,6 +488,11 @@
           ],
           "items": true
         },
+        "examples": {
+          "description": "The `examples` keyword.\n\nSee [JSON Schema Validation 9.5. \"examples\"](https://tools.ietf.org/html/draft-handrews-json-schema-validation-02#section-9.5).",
+          "type": "array",
+          "items": true
+        },
         "exclusiveMaximum": {
           "description": "The `exclusiveMaximum` keyword.\n\nSee [JSON Schema Validation 6.2.3. \"exclusiveMaximum\"](https://tools.ietf.org/html/draft-handrews-json-schema-validation-02#section-6.2.3).",
           "type": [

schemars/tests/expected/schema-openapi3.json

@@ -101,6 +101,11 @@
       "items": {},
       "nullable": true
     },
+    "examples": {
+      "description": "The `examples` keyword.\n\nSee [JSON Schema Validation 9.5. \"examples\"](https://tools.ietf.org/html/draft-handrews-json-schema-validation-02#section-9.5).",
+      "type": "array",
+      "items": {}
+    },
     "exclusiveMaximum": {
       "description": "The `exclusiveMaximum` keyword.\n\nSee [JSON Schema Validation 6.2.3. \"exclusiveMaximum\"](https://tools.ietf.org/html/draft-handrews-json-schema-validation-02#section-6.2.3).",
       "type": "number",
@@ -405,6 +410,11 @@
           "items": {},
           "nullable": true
         },
+        "examples": {
+          "description": "The `examples` keyword.\n\nSee [JSON Schema Validation 9.5. \"examples\"](https://tools.ietf.org/html/draft-handrews-json-schema-validation-02#section-9.5).",
+          "type": "array",
+          "items": {}
+        },
         "exclusiveMaximum": {
           "description": "The `exclusiveMaximum` keyword.\n\nSee [JSON Schema Validation 6.2.3. \"exclusiveMaximum\"](https://tools.ietf.org/html/draft-handrews-json-schema-validation-02#section-6.2.3).",
           "type": "number",

schemars/tests/expected/schema.json

@@ -121,6 +121,11 @@
       ],
       "items": true
     },
+    "examples": {
+      "description": "The `examples` keyword.\n\nSee [JSON Schema Validation 9.5. \"examples\"](https://tools.ietf.org/html/draft-handrews-json-schema-validation-02#section-9.5).",
+      "type": "array",
+      "items": true
+    },
     "exclusiveMaximum": {
       "description": "The `exclusiveMaximum` keyword.\n\nSee [JSON Schema Validation 6.2.3. \"exclusiveMaximum\"](https://tools.ietf.org/html/draft-handrews-json-schema-validation-02#section-6.2.3).",
       "type": [
@@ -487,6 +492,11 @@
           ],
           "items": true
         },
+        "examples": {
+          "description": "The `examples` keyword.\n\nSee [JSON Schema Validation 9.5. \"examples\"](https://tools.ietf.org/html/draft-handrews-json-schema-validation-02#section-9.5).",
+          "type": "array",
+          "items": true
+        },
         "exclusiveMaximum": {
           "description": "The `exclusiveMaximum` keyword.\n\nSee [JSON Schema Validation 6.2.3. \"exclusiveMaximum\"](https://tools.ietf.org/html/draft-handrews-json-schema-validation-02#section-6.2.3).",
           "type": [