[FEATURE] Create multiple examples for multiple tests for same error code. about rspec-openapi

[exoego]

Interesting. I did not know examples that can contain multiple examples https://swagger.io/docs/specification/adding-examples/

I am happy to accept pull request.

I prefer it defaults to single example and add a feature dlag for new behavior (examples)

[lpender]

Ok great. I'm in the middle of a project with a deadline and I haven't looked at the code yet.

So I'm not sure when I'll be able to get started but I will notify here if and when I do.

Please let me know if you have any recommendations on how you would architect / implement this.

Thanks again!

[lpender]

Hey--I'm realizing that this may be a killer bug for me... The issue effects not only outputs but inputs.

I need to test that the API gives a 200 for good input and 400 for bad input--a very common use case.

Unfortunately, the requestBody example will randomly generate the OAI schema using the bad input from time to time.

Let me know if there are any workarounds or if you think this might be a quick fix.

Thank you

[exoego]

Let me know if there are any workarounds or if you think this might be a quick fix.

Test cases can be excluded from OpenAPI generation with openapi: false argument.
So you can include only valid inputs.

RSpec.describe '/resources', type: :request do
  it 'returns a resource', openapi: false do
    # ...
  end
end

[lpender]

The thing is, I'd like to document 400 responses as well.

I think this will tide me over for now actually:

# Disable generating `example`
RSpec::OpenAPI.enable_example = false

Thanks !