allowMultiple

[snackycracky]

Hello,

why can't I use the allowMultiple Fieldname described here:
https://github.com/wordnik/swagger-spec/blob/master/versions/1.2.md#524-parameter-object

Actually I want the multiple option box from:
http://petstore.swagger.wordnik.com/#!/pet/findPetsByStatus

There are predefined values for a parameter with an enum "available, pending, sold":

{
         "path":"/pet/findByStatus",
         "operations":[
            {
               "method":"GET",
               "summary":"Finds Pets by status",
               "notes":"Multiple status values can be provided with comma seperated strings",
               "type":"array",
               "items":{
                  "$ref":"Pet"
               },
               "nickname":"findPetsByStatus",
               "authorizations":{

               },
               "parameters":[
                  {
                     "name":"status",
                     "description":"Status values that need to be considered for filter",
                     "defaultValue":"available",
                     "required":true,
                     "type":"string",
                     "paramType":"query",
                     "allowMultiple":true,
                     "enum":[
                        "available",
                        "pending",
                        "sold"
                     ]
                  }
               ],
               "responseMessages":[
                  {
                     "code":400,
                     "message":"Invalid status value"
                  }
               ]
            }
         ]
      },

[snackycracky]

https://github.com/tim-vandecasteele/grape-swagger/pull/96

[antek-drzewiecki]

#132 plus #105 might have fixed this.
You need to explicitly tell grape that the parameter type is an Array and that it has values. Note that the values need to be an Array in an Array.

params do
  optional :number, type: Array, desc: "Favourite number" , values: [[1],[2],[3]]
  optional :foo_or_bar , type: String, desc: "Foo or Bar?" , values: %w(Foo Bar)
end

Is the behaviour for param number the behaviour you want?

[hut8]

It looks like none of the specs actually test that allowMultiple can be generated. I'm trying to do this:

        optional :mapping, type: Hash, documentation: { is_array: true } do
          requires :from, type: String, desc: 'Mapping done from'
          requires :to, type: String, desc: 'Mapping goes to'
        end

relevant line in doc_methods.rb:

allowMultiple: is_array && data_type != 'array' && %w(query header path).include?(param_type)

What am I missing here? And why can't multiple values be in the body? Thanks.

[LeFnord]

impmented in actual versions