yaml: null != 'null'

Author: brandonbloom

Sources/swift-openapi-generator/Documentation.docc/Development/Handling-nullable-schemas.md

@@ -37,7 +37,7 @@ For example:
 
 ```yaml
 MyOptionalString:
-  type: [string, null]
+  type: [string, 'null']
 ```
 
 > The rule can be summarized as: `schema is optional := schema is nullable`, where being `nullable` is represented slightly differently between the two JSON Schema versions.
@@ -75,7 +75,7 @@ MyPerson:
     name:
       type: string
     age:
-      type: [integer, null]
+      type: [integer, 'null']
   required:
     - name
     - age # even though required, the nullability of the schema "wins"

Tests/OpenAPIGeneratorReferenceTests/Resources/Docs/petstore.yaml

@@ -403,9 +403,9 @@ components:
       type: object
       properties:
         foo:
-          type: [array, null]
+          type: [array, 'null']
           items:
-            type: [string, null]
+            type: [string, 'null']
     CodeError:
       type: object
       properties:

Tests/OpenAPIGeneratorReferenceTests/SnippetBasedReferenceTests.swift

@@ -192,7 +192,7 @@ final class SnippetBasedReferenceTests: XCTestCase {
               StringArrayNullableItems:
                 type: array
                 items:
-                  type: [string, null]
+                  type: [string, 'null']
             """,
             """
             public enum Schemas {
@@ -213,7 +213,7 @@ final class SnippetBasedReferenceTests: XCTestCase {
                 items:
                   $ref: '#/components/schemas/NullableString'
               NullableString:
-                type: [string, null]
+                type: [string, 'null']
             """,
             """
             public enum Schemas {
@@ -255,9 +255,9 @@ final class SnippetBasedReferenceTests: XCTestCase {
                   fooRequired:
                     type: string
                   fooOptionalNullable:
-                    type: [string, null]
+                    type: [string, 'null']
                   fooRequiredNullable:
-                    type: [string, null]
+                    type: [string, 'null']
 
                   fooOptionalArray:
                     type: array
@@ -268,30 +268,30 @@ final class SnippetBasedReferenceTests: XCTestCase {
                     items:
                       type: string
                   fooOptionalNullableArray:
-                    type: [array, null]
+                    type: [array, 'null']
                     items:
                       type: string
                   fooRequiredNullableArray:
-                    type: [array, null]
+                    type: [array, 'null']
                     items:
                       type: string
 
                   fooOptionalArrayOfNullableItems:
                     type: array
                     items:
-                      type: [string, null]
+                      type: [string, 'null']
                   fooRequiredArrayOfNullableItems:
                     type: array
                     items:
-                      type: [string, null]
+                      type: [string, 'null']
                   fooOptionalNullableArrayOfNullableItems:
-                    type: [array, null]
+                    type: [array, 'null']
                     items:
-                      type: [string, null]
+                      type: [string, 'null']
                   fooRequiredNullableArrayOfNullableItems:
-                    type: [array, null]
+                    type: [array, 'null']
                     items:
-                      type: [string, null]
+                      type: [string, 'null']
                 required:
                   - fooRequired
                   - fooRequiredNullable
@@ -499,7 +499,7 @@ final class SnippetBasedReferenceTests: XCTestCase {
               MyRequiredString:
                 type: string
               MyNullableString:
-                type: [string, null]
+                type: [string, 'null']
               MyObject:
                 type: object
                 properties:
@@ -2692,7 +2692,7 @@ final class SnippetBasedReferenceTests: XCTestCase {
                   content:
                     application/json:
                       schema:
-                        type: [string, null]
+                        type: [string, 'null']
                 responses:
                   default:
                     description: Response
@@ -2848,7 +2848,7 @@ final class SnippetBasedReferenceTests: XCTestCase {
                   content:
                     application/json:
                       schema:
-                        type: [string, null]
+                        type: [string, 'null']
                 responses:
                   default:
                     description: Response