[BUG] Parameter with enum is not correctly generated for OAS 3.0 and 3.1 about rswag

[romanblanco]

@diei, would this work for you?

parameter name: :test_type, in: :query, required: false, schema: { type: :array, items: { enum: ['type1', 'type2'] } }

[diei]

@romanblanco, thank you for the hint. It is better but not like before and not like I need it.

The code...

parameter name: :test_type, in: :query, required: false, schema: { type: :array, items: { enum: ['type1', 'type2'] } }

... generates:

"parameters": [{
  "name": "test_type",
  "in": "query",
  "required": false,
  "schema": {
    "type": "array",
    "items": {
      "enum": [
        "type1",
        "type2"
      ]
    }
  }
}]

That is rendered as a multi-select-box. Then I can select several values at the same time which should not be possible, only one or nothing.

I tried it out a bit and figured out that this works:

parameter name: :test_type, in: :query, required: false, schema: { enum: ['type1', 'type2'] }

That definition generates the expected JSON which is rendered as a common select box:

"parameters": [{
  "name": "test_type",
  "in": "query",
  "required": false,
  "schema": {
      "enum": [
        "type1",
        "type2"
      ]
  }
}]

[diei]

During my many tries to find a solution, I noticed that the type: :string is also not correctly transferred to the JSON:

parameter name: :test_type, in: :query, type: :string, required: false, schema: { enum: ['type1', 'type2'] }

Generates this JSON:

"parameters": [{
  "name": "test_type",
  "in": "query",
  "type": "string",
  "required": false,
  "schema": {
      "enum": [
        "type1",
        "type2"
      ]
  }
}]

But the type should be within schema:

"parameters": [{
  "name": "test_type",
  "in": "query",
  "required": false,
  "schema": {
      "type": "string",
      "enum": [
        "type1",
        "type2"
      ]
  }
}]

If I omit the custom schema definition of the parameter the type is added automatically to the schema or I have to move the type: :string from parameter to the custom schema definition:

parameter name: :test_type, in: :query, required: false, schema: { type: :string, enum: ['type1', 'type2'] }