swagger_doc tag doesn't work

[zddhub]

As comments or rswag (rspec-rails-swagger based on rswag):

By default, the operations defined in spec files are added to the first document below. You can override this behavior by adding a swagger_doc tag to the the root example_group in your specs, e.g.

describe '...', swagger_doc: 'v2/swagger.json'

But it doesn't work if I used it with RSpec, like below:

RSpec.describe 'mock allocation summary', type: :request, swagger_doc: 'v2/swagger.yml' do
...
    path '/post' do
...
end

Is there anybody have some idea?

[zddhub]

Got some idea from source code

rspec-rails-swagger/lib/rspec/rails/swagger/request_builder.rb

Line 20 in 5e6127c

name = metadata[:swagger_document]

I found a workaround way:

RSpec.describe 'mock allocation summary', type: :request, swagger_doc: 'v2/swagger.yml' do
...
    path '/post', swagger_document: 'v2/swagger.yml' do
...
end

It works but not perfect ???

[drewish]

Ah yeah I would have though it would work the way you expected. Looking at the helper:

rspec-rails-swagger/lib/rspec/rails/swagger/helpers.rb

Line 48 in f8fb9d4

swagger_document: attributes[:swagger_document] || RSpec.configuration.swagger_docs.keys.first,

It seems like it should looking for a document in the following order:

• attributes hash passed in to the path call
• metadata passed down from the parent context block
• default to the first of the documents

So I'll look at adding a PR to fix this.

[drewish]

Give #45 a look and see how that works for you.