Hide endpoint from the swagger documentation. Resolves #24

Use hidden symbol in the description block:
desc 'Hide an endpoint', {
  :hidden => true
}

Author: arturoherrero

lib/grape-swagger.rb

@@ -66,8 +66,9 @@ def self.setup(options)
               end
 
               routes_array = routes.keys.map do |local_route|
+                  next if routes[local_route].any? { |route| route.route_hidden }
                   { :path => "#{parse_path(route.route_path.gsub('(.:format)', ''),route.route_version)}/#{local_route}#{@@hide_format ? '' : '.{format}'}" }
-              end
+              end.compact
 
               {
                 apiVersion: api_version,

spec/hide_api_spec.rb

@@ -0,0 +1,40 @@
+require 'spec_helper'
+
+describe "a hide mounted api" do
+  before :all do
+    class HideMountedApi < Grape::API
+      desc 'Show this endpoint'
+      get '/simple' do
+        { :bla => 'something' }
+      end
+
+      desc 'Hide this endpoint', {
+        :hidden => true
+      }
+      get '/hide' do
+        { :bla => 'something_else' }
+      end
+    end
+
+    class HideApi < Grape::API
+      mount HideMountedApi
+      add_swagger_documentation
+    end
+  end
+
+  def app; HideApi end
+
+  it "retrieves swagger-documentation on /swagger_doc" do
+    get '/swagger_doc.json'
+    JSON.parse(last_response.body).should == {
+      "apiVersion" => "0.1",
+      "swaggerVersion" => "1.1",
+      "basePath" => "http://example.org",
+      "operations" => [],
+      "apis" => [
+        { "path" => "/swagger_doc/simple.{format}" },
+        { "path" => "/swagger_doc/swagger_doc.{format}" }
+      ]
+    }
+  end
+end