Add possibility to hide the documentation paths in the generated swagger documentation.

Author: Tim Vandecasteele

README.markdown

@@ -41,6 +41,7 @@ You can pass a hash with some configuration possibilities to ```add_swagger_docu
 * ```:api_version``` Version of the API that's being exposed
 * ```:base_path``` Basepath of the API that's being exposed
 * ```:markdown``` Allow markdown in `notes`, default `false`
+* ```:hide_documentation_path``` Don't show the '/swagger_doc' path in the generated swagger documentation
 
 ## Swagger Header Parameters
 

lib/grape-swagger.rb

@@ -41,14 +41,16 @@ def self.setup(options)
               :mount_path => '/swagger_doc',
               :base_path => nil,
               :api_version => '0.1',
-              :markdown => false
+              :markdown => false,
+              :hide_documentation_path => false
             }
             options = defaults.merge(options)
 
             @@target_class = options[:target_class]
             @@mount_path = options[:mount_path]
             @@class_name = options[:class_name] || options[:mount_path].gsub('/','')
             @@markdown = options[:markdown]
+            @@hide_documentation_path = options[:hide_documentation_path]
             api_version = options[:api_version]
             base_path = options[:base_path]
 
@@ -58,6 +60,10 @@ def self.setup(options)
               header['Access-Control-Request-Method'] = '*'
               routes = @@target_class::combined_routes
 
+              if @@hide_documentation_path
+                routes.reject!{ |route, value| "/#{route}/".index(parse_path(@@mount_path, nil) << '/') == 0 }
+              end
+
               routes_array = routes.keys.map do |route|
                   { :path => "#{@@mount_path}/#{route}.{format}" }
               end

spec/non_default_api_spec.rb

@@ -61,6 +61,29 @@ def app; SimpleApiWithApiVersion end
     end
   end
 
+  context "overruling hiding the documentation paths" do
+    before(:all) do
+      class HideDocumentationPathMountedApi < Grape::API
+        desc 'this gets something'
+        get '/something' do
+          {:bla => 'something'}
+        end
+      end
+
+      class SimpleApiWithHiddenDocumentation < Grape::API
+        mount HideDocumentationPathMountedApi
+        add_swagger_documentation :hide_documentation_path => true
+      end
+    end
+
+    def app; SimpleApiWithHiddenDocumentation end
+
+    it "it doesn't show the documentation path on /swagger_doc" do
+      get '/swagger_doc'
+      last_response.body.should == "{:apiVersion=>\"0.1\", :swaggerVersion=>\"1.1\", :basePath=>\"http://example.org\", :operations=>[], :apis=>[{:path=>\"/swagger_doc/something.{format}\"}]}" 
+    end
+  end
+
   context "overruling the mount-path" do
     before(:all) do
       class DifferentMountMountedApi < Grape::API