Pass extension documentation into schema

Author: numbata

lib/grape-swagger/entity/attribute_parser.rb

@@ -19,6 +19,7 @@ def call(entity_options)
           entity_model_type = entity_model_type(name, entity_options)
           return entity_model_type unless documentation
 
+          add_extension_documentation(entity_model_type, documentation)
           add_array_documentation(entity_model_type, documentation) if documentation[:is_array]
 
           entity_model_type

spec/grape-swagger/entities/response_model_spec.rb

@@ -60,7 +60,8 @@ def app
             'kind3' => { '$ref' => '#/definitions/ThisApi_Entities_Kind', 'description' => 'Tertiary kind.' },
             'tags' => { 'type' => 'array', 'items' => { '$ref' => '#/definitions/ThisApi_Entities_Tag' },
                         'description' => 'Tags.' },
-            'relation' => { '$ref' => '#/definitions/ThisApi_Entities_Relation', 'description' => 'A related model.' },
+            'relation' => { '$ref' => '#/definitions/ThisApi_Entities_Relation', 'description' => 'A related model.',
+                            'x-other' => 'stuff' },
             'code' => { 'type' => 'string', 'description' => 'Error code' },
             'message' => { 'type' => 'string', 'description' => 'Error message' },
             'attr' => { 'type' => 'string', 'description' => 'Attribute' } },

spec/support/shared_contexts/this_api.rb

@@ -36,7 +36,7 @@ class Something < Grape::Entity
           expose :kind3, using: ThisApi::Entities::Kind, documentation: { desc: 'Tertiary kind.' }
           expose :tags, using: ThisApi::Entities::Tag, documentation: { desc: 'Tags.', is_array: true }
           expose :relation, using: ThisApi::Entities::Relation,
-                            documentation: { type: 'ThisApi::Relation', desc: 'A related model.' }
+                            documentation: { type: 'ThisApi::Relation', desc: 'A related model.', x: { other: 'stuff' } }
           expose :merged_attribute, using: ThisApi::Entities::Nested, merge: true
         end
       end