swagger-docs 0.2.1 → 0.2.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: c9fdc3f4f644a149fff976af8f32e4a084749d95
-  data.tar.gz: ec345458634e9e25fee45ace966b271d1d8bd273
+  metadata.gz: 850e7d77a965af9ee323f25bc7ab3e3a91d370c8
+  data.tar.gz: 6b724ad6dd87abc8cab15e2b4a30055c6910e198
 SHA512:
-  metadata.gz: 45bb296a5aa61b7b7ecae8eb1706da6483bb7febe4b189f36490203e39732ffc2e0f54271298aec7d1a0d0615eeedc808fa599ce5ff7bab1ba8ed2afb92911c6
-  data.tar.gz: 566577465f61ef479399c9ef270f5762905e4b9f173ce2d11d1111a3162ace73621b78b6b39fc489dca7793e7bbb47e301bafb65cf823a3b346d4302f8fe8ded
+  metadata.gz: e155052e677d44500ce278b910766d6c0e9eae07cacd5bc9514b79af5f61a98d510dd073ce1bc86ad0be3d4bdcc5eb4e8fd8e3f2cd51b66523e40ce2c7344cac
+  data.tar.gz: 66cf934624dbf944215ddc98401dc3a6a8c3608014fb62b4de88b9500394d2deabcdd89bd668240fe9cd7f379392d6565b29de3ab2c8f3f8ee0d13547bce2c4a

data/CHANGELOG.md

@@ -1,3 +1,23 @@
+## 0.2.6
+
+- swagger_controller DSL can accept a resource_path which will be used over a generated path #126 @sb8244
+
+## 0.2.5
+
+- Enabled option to set 'items' inside swagger_api method #99 @krakatoa
+
+## 0.2.4
+
+- Parent controller option for register_apis config. #123 @mskubenich
+
+## 0.2.3
+
+- Added property_list to SwaggerModelDSL #108 @dr-impossible
+
+## 0.2.2
+
+- Support multiple route methods #128 @frodrigo
+
 ## 0.2.1
 
 - Add support for Authorizations (OAuth 2.0) - Thanks to @RKushnir #97

data/README.md

@@ -62,6 +62,8 @@ Swagger::Docs::Config.register_apis({
     :base_path => "http://api.somedomain.com",
     # if you want to delete all .json files at each generation
     :clean_directory => false,
+    # Ability to setup base controller for each api version. Api::V1::SomeController for example.
+    :parent_controller => Api::V1::SomeController
     # add custom attributes to api-docs
     :attributes => {
       :info => {
@@ -133,6 +135,12 @@ The following table shows all the current configuration options and their defaul
 <td>true</td>
 </tr>
 
+<tr>
+<td><b>parent_controller</b></td>
+<td>Assign a different controller to use for the configuration</td>
+<td>ClassName</td>
+</tr>
+
 </tbody>
 </table>
 
@@ -198,11 +206,25 @@ class Api::V1::UsersController < ApplicationController
     description "A Tag object."
     property :id, :integer, :required, "User Id"
     property :name, :string, :optional, "Name"
+    property_list :type, :string, :optional, "Tag Type", ["info", "warning", "error"]
   end
-
 end
 ```
 
+#### Support for Enums (PR #108)
+
+```
+property_list :type, :string, :optional, "Type", ["info", "warning", "error"]
+```
+
+#### Custom resource paths`(PR #126)
+
+```ruby
+class Api::V1::UsersController < ApplicationController
+
+  swagger_controller :users, "User Management", resource_path: "/some/where"
+```
+
 ### DRYing up common documentation
 
 Suppose you have a header or a parameter that must be present on several controllers and methods. Instead of duplicating it on all the controllers you can do this on your API base controller:

data/lib/swagger/docs/api_declaration_file.rb

@@ -41,7 +41,7 @@ module Swagger
       end
 
       def resource_path
-        demod
+        metadata.overridden_resource_path || demod
       end
 
       def resource_file_path

data/lib/swagger/docs/api_declaration_file_metadata.rb

@@ -2,8 +2,10 @@ module Swagger
   module Docs
     class ApiDeclarationFileMetadata
       DEFAULT_SWAGGER_VERSION = "1.2"
+      DEFAULT_RESOURCE_PATH = nil
 
-      attr_reader :api_version, :path, :base_path, :controller_base_path, :swagger_version, :camelize_model_properties, :authorizations
+      attr_reader :api_version, :path, :base_path, :controller_base_path, :swagger_version, :camelize_model_properties
+      attr_reader :authorizations, :overridden_resource_path
 
       def initialize(api_version, path, base_path, controller_base_path, options={})
         @api_version = api_version
@@ -13,6 +15,7 @@ module Swagger
         @swagger_version = options.fetch(:swagger_version, DEFAULT_SWAGGER_VERSION)
         @camelize_model_properties = options.fetch(:camelize_model_properties, true)
         @authorizations = options.fetch(:authorizations, {})
+        @overridden_resource_path = options.fetch(:resource_path, DEFAULT_RESOURCE_PATH)
       end
     end
   end

data/lib/swagger/docs/dsl.rb

@@ -29,6 +29,10 @@ module Swagger
         @type = type
       end
 
+      def items(items)
+        @items = items
+      end
+
       def consumes(mime_types)
         @consumes = mime_types
       end
@@ -104,6 +108,12 @@ module Swagger
         }.merge!(hash)
         self.required << name if required == :required
       end
+      
+      # helper method to generate enums
+      def property_list(name, type, required, description = nil, allowed_values = [], hash = {})
+        hash.merge!({allowable_values: {value_type: "LIST", values: allowed_values}})
+        property(name, type, required, description, hash)
+      end
     end
   end
 end

data/lib/swagger/docs/generator.rb

@@ -75,7 +75,7 @@ module Swagger
             ret = process_path(path, root, config, settings)
             results[ret[:action]] << ret
             if ret[:action] == :processed
-              resources << generate_resource(ret[:path], ret[:apis], ret[:models], settings, root, config)
+              resources << generate_resource(ret[:path], ret[:apis], ret[:models], settings, root, config, ret[:klass].swagger_config)
               debased_path = get_debased_path(ret[:path], settings[:controller_base_path])
               resource_api = {
                 path: "/#{Config.transform_path(trim_leading_slash(debased_path), api_version)}.{format}",
@@ -136,6 +136,7 @@ module Swagger
           klass = Config.log_exception { "#{path.to_s.camelize}Controller".constantize } rescue nil
           return {action: :skipped, path: path, reason: :klass_not_present} if !klass
           return {action: :skipped, path: path, reason: :not_swagger_resource} if !klass.methods.include?(:swagger_config) or !klass.swagger_config[:controller]
+          return {action: :skipped, path: path, reason: :not_kind_of_parent_controller} if config[:parent_controller] && !klass < config[:parent_controller]
           apis, models, defined_nicknames = [], {}, []
           routes.select{|i| i.defaults[:controller] == path}.each do |route|
             unless nickname_defined?(defined_nicknames, path, route) # only add once for each route once e.g. PATCH, PUT 
@@ -148,8 +149,8 @@ module Swagger
           {action: :processed, path: path, apis: apis, models: models, klass: klass}
         end
 
-        def route_verb(route)
-          if defined?(route.verb.source) then route.verb.source.to_s.delete('$'+'^') else route.verb end.downcase.to_sym 
+        def route_verbs(route)
+          if defined?(route.verb.source) then route.verb.source.to_s.delete('$'+'^').split('|') else [route.verb] end.collect{|verb| verb.downcase.to_sym}
         end
 
         def path_route_nickname(path, route)
@@ -158,19 +159,19 @@ module Swagger
         end
 
         def nickname_defined?(defined_nicknames, path, route)
-          verb = route_verb(route)
           target_nickname = path_route_nickname(path, route)
           defined_nicknames.each{|nickname| return true if nickname == target_nickname }
           false
         end
 
-        def generate_resource(path, apis, models, settings, root, config)
+        def generate_resource(path, apis, models, settings, root, config, swagger_config)
           metadata = ApiDeclarationFileMetadata.new(
             root["apiVersion"], path, root["basePath"],
             settings[:controller_base_path],
             camelize_model_properties: config.fetch(:camelize_model_properties, true),
             swagger_version: root["swaggerVersion"],
-            authorizations: root[:authorizations]
+            authorizations: root[:authorizations],
+            resource_path: swagger_config[:resource_path]
           )
           declaration = ApiDeclarationFile.new(metadata, apis, models)
           declaration.generate_resource
@@ -183,17 +184,20 @@ module Swagger
         def get_route_path_apis(path, route, klass, settings, config)
           models, apis = {}, []
           action = route.defaults[:action]
-          verb = route_verb(route)
-          return {apis: apis, models: models, nickname: nil} if !operations = klass.swagger_actions[action.to_sym]
-          operations = Hash[operations.map {|k, v| [k.to_s.gsub("@","").to_sym, v.respond_to?(:deep_dup) ? v.deep_dup : v.dup] }] # rename :@instance hash keys
-          operations[:method] = verb
-          nickname = operations[:nickname] = path_route_nickname(path, route)
+          verbs = route_verbs(route)
+          return {apis: apis, models: models, nickname: nil} if !operation = klass.swagger_actions[action.to_sym]
+          operation = Hash[operation.map {|k, v| [k.to_s.gsub("@","").to_sym, v.respond_to?(:deep_dup) ? v.deep_dup : v.dup] }] # rename :@instance hash keys
+          nickname = operation[:nickname] = path_route_nickname(path, route)
 
           route_path = if defined?(route.path.spec) then route.path.spec else route.path end
           api_path = transform_spec_to_api_path(route_path, settings[:controller_base_path], config[:api_extension_type])
-          operations[:parameters] = filter_path_params(api_path, operations[:parameters]) if operations[:parameters]
-
-          apis << {:path => api_path, :operations => [operations]}
+          operation[:parameters] = filter_path_params(api_path, operation[:parameters]) if operation[:parameters]
+          operations = verbs.collect{|verb|
+            op = operation.dup
+            op[:method] = verb
+            op
+          }
+          apis << {:path => api_path, :operations => operations}
           models = get_klass_models(klass)
 
           {apis: apis, models: models, nickname: nickname}

data/lib/swagger/docs/impotent_methods.rb

@@ -15,7 +15,7 @@ module Swagger
         def swagger_model(model_name, &block)
         end
 
-        def swagger_controller(controller, description)
+        def swagger_controller(controller, description, params={})
         end
       end
 

data/lib/swagger/docs/methods.rb

@@ -10,6 +10,7 @@ module Swagger
         def swagger_controller(controller, description, params = {})
           swagger_config[:controller] = controller
           swagger_config[:description] = description
+          swagger_config[:resource_path] = params[:resource_path]
         end
 
         def swagger_actions

data/lib/swagger/docs/version.rb

@@ -1,5 +1,5 @@
 module Swagger
   module Docs
-    VERSION = "0.2.1"
+    VERSION = "0.2.6"
   end
 end

data/spec/fixtures/controllers/custom_resource_path_controller.rb

@@ -0,0 +1,18 @@
+module Api
+  module V1
+    class SuperclassController < ApplicationController
+    end
+    class CustomResourcePathController < SuperclassController
+      swagger_controller :custom_resource_path, "User Management", resource_path: "resource/testing"
+
+      swagger_api :index do
+        summary "Fetches all User items"
+        param :query, :page, :integer, :optional, "Page number"
+        param :path, :nested_id, :integer, :optional, "Team Id"
+        response :unauthorized
+        response :not_acceptable, "The request you made is not acceptable"
+        response :requested_range_not_satisfiable
+      end
+    end
+  end
+end

data/spec/fixtures/controllers/multiple_routes_controller.rb

@@ -0,0 +1,13 @@
+module Api
+  module V1
+    class MultipleRoutesController < ApplicationController
+        swagger_controller :multiple_routes, "Multiple Routes"
+
+        swagger_api :index do
+        summary "Creates a new User"
+        param :form, :first_name, :string, :required, "First name"
+        response :unauthorized
+      end
+    end
+  end
+end

data/spec/fixtures/controllers/sample_controller.rb

@@ -31,6 +31,7 @@ module Api
         param :form, :email, :string, :required, "Email address"
         param_list :form, :role, :string, :required, "Role", [ "admin", "superadmin", "user" ]
         param :body, :body, :json, :required, 'JSON formatted body'
+        items '{$ref" => "setup"}'
         response :unauthorized
         response :not_acceptable
       end
@@ -73,6 +74,7 @@ module Api
         description "A Tag object."
         property :id, :integer, :required, "User Id"
         property :name, :string, :optional, "Name", foo: "test"
+        property_list :type, :string, :optional, "Type", ["info", "warning", "error"]
       end
     end
   end

data/spec/lib/swagger/docs/api_declaration_file_spec.rb

@@ -29,7 +29,6 @@ describe Swagger::Docs::ApiDeclarationFile do
       }
     ]
   end
-
   let(:models) do
     {
       :Tag=>
@@ -46,13 +45,11 @@ describe Swagger::Docs::ApiDeclarationFile do
       }
     }
   end
-
   let(:metadata) do
     Swagger::Docs::ApiDeclarationFileMetadata.new("1.0", "api/v1/sample", "http://api.no.where/", "")
   end
 
   describe "#generate_resource" do
-
     it "generates the appropriate response" do
       declaration = described_class.new(metadata, apis, models)
 
@@ -69,7 +66,6 @@ describe Swagger::Docs::ApiDeclarationFile do
       expect(declaration.generate_resource).to eq(expected_response)
     end
   end
-
   describe "#base_path" do
     it "returns metadata.base_path" do
       metadata = double("metadata", base_path: "/hello")
@@ -77,7 +73,6 @@ describe Swagger::Docs::ApiDeclarationFile do
       expect(declaration.base_path).to eq(metadata.base_path)
     end
   end
-
   describe "#path" do
     it "returns metadata.path" do
       metadata = double("metadata", path: "/hello")
@@ -85,7 +80,6 @@ describe Swagger::Docs::ApiDeclarationFile do
       expect(declaration.path).to eq(metadata.path)
     end
   end
-
   describe "#controller_base_path" do
     it "returns metadata.controller_base_path" do
       metadata = double("metadata", controller_base_path: "/hello")
@@ -93,7 +87,20 @@ describe Swagger::Docs::ApiDeclarationFile do
       expect(declaration.controller_base_path).to eq(metadata.controller_base_path)
     end
   end
-
+  describe "#resource_path" do
+    it "returns the debased controller path" do
+      metadata = double("metadata", overridden_resource_path: nil, controller_base_path: "/hello", path: "/hello/test-endpoint")
+      declaration = described_class.new(metadata, apis, models)
+      expect(declaration.resource_path).to eq("test_endpoint")
+   end
+   context "with an overridden_resource_path" do
+     it "returns the overriden resource path directly" do
+      metadata = double("metadata", overridden_resource_path: "testing-path", controller_base_path: "/hello", path: "/hello/test-endpoint")
+      declaration = described_class.new(metadata, apis, models)
+      expect(declaration.resource_path).to eq("testing-path")
+      end
+    end
+  end
   describe "#swagger_version" do
     it "returns metadata.swagger_version" do
       metadata = double("metadata", swagger_version: "1.2")
@@ -101,7 +108,6 @@ describe Swagger::Docs::ApiDeclarationFile do
       expect(declaration.swagger_version).to eq(metadata.swagger_version)
     end
   end
-
   describe "#api_version" do
     it "returns metadata.api_version" do
       metadata = double("metadata", api_version: "1.0")
@@ -109,7 +115,6 @@ describe Swagger::Docs::ApiDeclarationFile do
       expect(declaration.api_version).to eq(metadata.api_version)
     end
   end
-
   describe "#camelize_model_properties" do
     it "returns metadata.camelize_model_properties" do
       metadata = double("metadata", camelize_model_properties: false)
@@ -117,7 +122,6 @@ describe Swagger::Docs::ApiDeclarationFile do
       expect(declaration.camelize_model_properties).to eq(metadata.camelize_model_properties)
     end
   end
-
   describe "#models" do
     context "with camelize_model_properties set to true" do
       it "returns a models hash that's ready for output" do
@@ -141,7 +145,6 @@ describe Swagger::Docs::ApiDeclarationFile do
         expect(declaration.models).to eq(expected_models_hash)
       end
     end
-
     context "with camelize_model_properties set to false" do
       it "returns a models hash that's ready for output" do
         declaration = described_class.new(metadata, apis, models)
@@ -165,7 +168,6 @@ describe Swagger::Docs::ApiDeclarationFile do
       end
     end
   end
-
   describe "#apis" do
     it "returns a api hash that's ready for output" do
       declaration = described_class.new(metadata, apis, models)

data/spec/lib/swagger/docs/generator_spec.rb

@@ -14,6 +14,7 @@ describe Swagger::Docs::Generator do
     stub_route(            "^GET$",    "index",   "api/v1/ignored", "/api/v1/ignored(.:format)"),
     stub_route(            "^GET$",    "index",   "api/v1/sample",  "/api/v1/sample(.:format)"),
     stub_string_verb_route("GET",      "index",   "api/v1/nested",  "/api/v1/nested/:nested_id/nested_sample(.:format)"),
+    stub_string_verb_route("GET",      "index",   "api/v1/custom_resource_path", "/api/v1/custom_resource_path/:custom_resource_path/custom_resource_path_sample(.:format)"),
     stub_route(            "^PATCH$",  "create",  "api/v1/sample",  "/api/v1/sample(.:format)"),
     stub_route(            "^PUT$",    "create",  "api/v1/sample",  "/api/v1/sample(.:format)"), # intentional duplicate of above route to ensure PATCH is used
     stub_route(            "^GET$",    "show",    "api/v1/sample",  "/api/v1/sample/:id(.:format)"),
@@ -21,13 +22,22 @@ describe Swagger::Docs::Generator do
     stub_route(            "^DELETE$", "destroy", "api/v1/sample",  "/api/v1/sample/:id(.:format)"),
     stub_route(            "^GET$",    "new",     "api/v1/sample",  "/api/v1/sample/new(.:format)"), # no parameters for this method
     stub_route(            "^GET$",    "index",   "",               "/api/v1/empty_path"), # intentional empty path should not cause any errors
-    stub_route(            "^GET$",    "ignored", "api/v1/sample",  "/api/v1/ignored(.:format)") # an action without documentation should not cause any errors
+    stub_route(            "^GET$",    "ignored", "api/v1/sample",  "/api/v1/ignored(.:format)"), # an action without documentation should not cause any errors
+    stub_route(            "^GET|POST$","index",  "api/v1/multiple_routes",  "/api/v1/multiple_routes(.:format)") # multiple route methods
   ]}
 
   let(:tmp_dir) { Pathname.new('/tmp/swagger-docs/') }
   let(:file_resources) { tmp_dir + 'api-docs.json' }
   let(:file_resource) { tmp_dir + 'api/v1/sample.json' }
   let(:file_resource_nested) { tmp_dir + 'nested.json' }
+  let(:file_resource_custom_resource_path) { tmp_dir + 'custom_resource_path.json' }
+
+  let(:controllers) { [
+    "fixtures/controllers/sample_controller",
+    "fixtures/controllers/nested_controller",
+    "fixtures/controllers/custom_resource_path_controller",
+    "fixtures/controllers/multiple_routes_controller"
+  ]}
 
   context "without controller base path" do
     let(:config) {
@@ -89,7 +99,6 @@ describe Swagger::Docs::Generator do
       end
     end
   end
-
   context "with controller base path" do
     let(:config) { Swagger::Docs::Config.register_apis({
        DEFAULT_VER => {:controller_base_path => "api/v1", :api_file_path => "#{tmp_dir}", :base_path => "http://api.no.where/",
@@ -106,13 +115,14 @@ describe Swagger::Docs::Generator do
       }
     })}
     let(:file_resource) { tmp_dir + 'sample.json' }
+    let(:resource) { file_resource.read }
+    let(:response) { JSON.parse(resource) }
+    let(:apis) { response["apis"] }
     before(:each) do
       allow(Rails).to receive_message_chain(:application, :routes, :routes).and_return(routes)
       Swagger::Docs::Generator.set_real_methods
-      require "fixtures/controllers/sample_controller"
-      require "fixtures/controllers/nested_controller"
+      controllers.each{ |path| require path }
     end
-
     context "test suite initialization" do
       it "the resources file does not exist" do
         expect(file_resource).to_not exist
@@ -121,7 +131,6 @@ describe Swagger::Docs::Generator do
         expect(file_resource).to_not exist
       end
     end
-
     describe "#write_docs" do
       context "no apis registered" do
         before(:each) do
@@ -129,7 +138,7 @@ describe Swagger::Docs::Generator do
         end
         it "generates using default config" do
           results = generate({})
-          expect(results[DEFAULT_VER][:processed].count).to eq 2
+          expect(results[DEFAULT_VER][:processed].count).to eq(controllers.count)
         end
       end
       before(:each) do
@@ -174,7 +183,7 @@ describe Swagger::Docs::Generator do
       end
       it "returns results hash" do
         results = generate(config)
-        expect(results[DEFAULT_VER][:processed].count).to eq 2
+        expect(results[DEFAULT_VER][:processed].count).to eq(controllers.count)
         expect(results[DEFAULT_VER][:skipped].count).to eq 1
       end
       it "writes pretty json files when set" do
@@ -196,7 +205,7 @@ describe Swagger::Docs::Generator do
           expect(response["basePath"]).to eq "http://api.no.where/api/v1"
         end
         it "writes apis correctly" do
-          expect(response["apis"].count).to eq 2
+          expect(response["apis"].count).to eq(controllers.count)
         end
         it "writes api path correctly" do
           expect(response["apis"][0]["path"]).to eq "/sample.{format}"
@@ -221,10 +230,18 @@ describe Swagger::Docs::Generator do
           end
         end
       end
+      context "multiple routes resource file" do
+        let(:file_resource) { tmp_dir + 'multiple_routes.json' }
+        it "handles multiple GET path" do
+          resource = get_api_operation(apis, "/multiple_routes", :get)
+          expect(resource["method"]).to eq "get"
+        end
+        it "handles multiple POST path" do
+          resource = get_api_operation(apis, "/multiple_routes", :post)
+          expect(resource["method"]).to eq "post"
+        end
+      end
       context "sample resource file" do
-        let(:resource) { file_resource.read }
-        let(:response) { JSON.parse(resource) }
-        let(:apis) { response["apis"] }
         # {"apiVersion":"1.0","swaggerVersion":"1.2","basePath":"/api/v1","resourcePath":"/sample"
         it "writes version correctly" do
           expect(response["apiVersion"]).to eq DEFAULT_VER
@@ -347,6 +364,7 @@ describe Swagger::Docs::Generator do
               expect(get_api_parameter(api, "role")["allowableValues"]).to eq expected_param
               expect(get_api_parameter(api, "body")).to eq expected_body
               expect(api["consumes"]).to eq ["application/json", "text/xml"]
+              expect(api["items"]).to eq("{$ref\" => \"setup\"}")
             end
             it "doesn't write out route put method" do
               expect(get_api_operation(apis, "sample", :put)).to be_nil
@@ -386,12 +404,33 @@ describe Swagger::Docs::Generator do
                 "id" => {
                   "type" => "integer",
                   "description" => "User Id",
+                },
+                "type" => {
+                  "type" => "string",
+                  "description" => "Type",
+                  "allowableValues" => {
+                    "valueType" => "LIST",
+                    "values" => [
+                      "info",
+                      "warning",
+                      "error"
+                    ]
+                  }
                 }
               }
             }
             expect(models['Tag']).to eq expected_model
           end
         end
+        context "custom resource_path resource file" do
+          let(:resource) { file_resource_custom_resource_path.read }
+          let(:response) { JSON.parse(resource) }
+          let(:apis) { response["apis"] }
+          # {"apiVersion":"1.0","swaggerVersion":"1.2","basePath":"/api/v1","resourcePath":"/sample"
+          it "writes resourcePath correctly" do
+            expect(response["resourcePath"]).to eq "resource/testing"
+          end
+       end
       end
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: swagger-docs
 version: !ruby/object:Gem::Version
-  version: 0.2.1
+  version: 0.2.6
 platform: ruby
 authors:
 - Rich Hollis
@@ -133,7 +133,9 @@ files:
 - lib/swagger/docs/version.rb
 - lib/tasks/swagger.rake
 - spec/fixtures/controllers/application_controller.rb
+- spec/fixtures/controllers/custom_resource_path_controller.rb
 - spec/fixtures/controllers/ignored_controller.rb
+- spec/fixtures/controllers/multiple_routes_controller.rb
 - spec/fixtures/controllers/nested_controller.rb
 - spec/fixtures/controllers/sample_controller.rb
 - spec/lib/swagger/docs/api_declaration_file_metadata_spec.rb
@@ -171,7 +173,9 @@ summary: Generates swagger-ui json files for rails apps with APIs. You add the s
   DSL to your controller classes and then run one rake task to generate the json files.
 test_files:
 - spec/fixtures/controllers/application_controller.rb
+- spec/fixtures/controllers/custom_resource_path_controller.rb
 - spec/fixtures/controllers/ignored_controller.rb
+- spec/fixtures/controllers/multiple_routes_controller.rb
 - spec/fixtures/controllers/nested_controller.rb
 - spec/fixtures/controllers/sample_controller.rb
 - spec/lib/swagger/docs/api_declaration_file_metadata_spec.rb