Support example and x-example in Swagger Properties

Author: Phil Sturgeon

src/parsers/swagger/v2.0/Parser.js

@@ -1252,6 +1252,12 @@ methods.convertParameterObjectIntoParameter = (parameterEntry) => {
     applicableContexts
   }
 
+  if (parameter.example) {
+    paramInstance.examples = List([parameter.example])
+  } else if (parameter['x-example']) {
+    paramInstance.examples = List([parameter['x-example']])
+  }
+
   if (parameter.type === 'array' && parameter.items) {
     const { value } = methods.convertParameterObjectIntoParameter({
       key: null,

src/parsers/swagger/v2.0/__tests__/Parser.spec.js

@@ -2772,7 +2772,8 @@ describe('parsers/swagger/v2.0/Parser.js', () => {
           maximum: 321,
           minimum: 123,
           multipleOf: 5,
-          default: 100
+          default: 100,
+          example: 12345
         }
       }
 
@@ -2787,6 +2788,9 @@ describe('parsers/swagger/v2.0/Parser.js', () => {
           required: true,
           type: 'integer',
           default: 100,
+          examples: List([
+            12345
+          ]),
           constraints: List([
             new Constraint.Maximum(321),
             new Constraint.Minimum(123),
@@ -2816,7 +2820,8 @@ describe('parsers/swagger/v2.0/Parser.js', () => {
             maximum: 321,
             minimum: 123,
             multipleOf: 5,
-            default: 100
+            default: 100,
+            example: 12345
           }
         }
       }
@@ -2838,6 +2843,7 @@ describe('parsers/swagger/v2.0/Parser.js', () => {
             required: true,
             type: 'integer',
             default: 100,
+            examples: List([12345]),
             constraints: List([
               new Constraint.Maximum(321),
               new Constraint.Minimum(123),
@@ -2920,6 +2926,38 @@ describe('parsers/swagger/v2.0/Parser.js', () => {
       const actual = inputs.map(input => __internals__.convertParameterObjectIntoParameter(input))
       expect(actual).toEqual(expected)
     })
+
+    it('should respect x-example too', () => {
+      const entry = {
+        key: 'UserId',
+        value: {
+          name: 'userId',
+          in: 'query',
+          type: 'integer',
+          required: true,
+          'x-example': 23456
+        }
+      }
+
+      const expected = {
+        key: 'UserId',
+        value: new Parameter({
+          key: 'userId',
+          name: 'userId',
+          in: 'queries',
+          uuid: 'UserId',
+          required: true,
+          type: 'integer',
+          examples: List([
+            23456
+          ]),
+          constraints: List()
+        })
+      }
+
+      const actual = __internals__.convertParameterObjectIntoParameter(entry)
+      expect(actual).toEqual(expected)
+    })
   })
 
   describe('@convertParameterObjectArrayIntoParameterMap', () => {