Add some configurability to the generated documentation.

Author: tim-vandecasteele

README.markdown

@@ -35,6 +35,12 @@ end
 
 To explore your API, either download [Swagger UI](https://github.com/wordnik/swagger-ui) and set it up yourself or go to the [online swagger demo](http://petstore.swagger.wordnik.com/) and enter your localhost url documentation root in the url field (probably something in the line of http://localhost:3000/swagger_doc.json)
 
+## Configure
+You can pass a hash with some configuration possibilities to ```add_swagger_documentation```, all of these are optional:
+* ```:mount_path``` The path were the API documentation is loaded, default '/swagger_doc'
+* ```:api_version``` Version of the API that's being exposed
+* ```:base_path``` Basepath of the API that's being exposed
+
 ## Contributing to grape-swagger
 
 * Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.

lib/grape-swagger.rb

@@ -14,22 +14,82 @@ def mount(mounts)
       def add_swagger_documentation(options={})
         documentation_class = create_documentation_class
 
-        documentation_class.setup(self)
+        documentation_class.setup({:target_class => self}.merge(options))
         mount(documentation_class)
       end
 
       private
 
-      def create_documentation_class(options={})
+      def create_documentation_class
         Class.new(Grape::API) do
           class << self
             def name
-              'swagger_doc'
+              @@class_name
             end
           end
 
-          def self.setup(target_class)
-            @@target_class = target_class
+          def self.setup(options)
+            defaults = {
+              :target_class => nil,
+              :mount_path => '/swagger_doc',
+              :base_path => nil,
+              :api_version => '0.1',
+            }
+            options = defaults.merge(options)
+
+            @@target_class = options[:target_class]
+            @@mount_path = options[:mount_path]
+            @@class_name = options[:class_name] || options[:mount_path].gsub('/','')
+            @@api_version = options[:api_version]
+            @@base_path = options[:base_path]
+
+            desc 'Swagger compatible API description'
+            get @@mount_path do
+              header['Access-Control-Allow-Origin'] = '*'
+              header['Access-Control-Request-Method'] = '*'
+              routes = @@target_class::combined_routes
+
+              routes_array = routes.keys.map do |route|
+                  { :path => "#{@@mount_path}/#{route}.{format}" }
+              end
+              {
+                apiVersion: @@api_version,
+                swaggerVersion: "1.1",
+                basePath: @@base_path || "http://#{env['HTTP_HOST']}",
+                operations:[],
+                apis: routes_array
+              }
+            end
+
+            desc 'Swagger compatible API description for specific API', :params =>
+              {
+                "name" => { :desc => "Class name of mounted API", :type => "string", :required => true },
+              }
+            get "#{@@mount_path}/:name" do
+              header['Access-Control-Allow-Origin'] = '*'
+              header['Access-Control-Request-Method'] = '*'
+              routes = @@target_class::combined_routes[params[:name]]
+              routes_array = routes.map do |route|
+                {
+                  :path => parse_path(route.route_path),
+                  :operations => [{
+                    :notes => route.route_notes,
+                    :summary => route.route_description || '',
+                    :nickname   => Random.rand(1000000),
+                    :httpMethod => route.route_method,
+                    :parameters => parse_params(route.route_params)
+                  }]
+                }
+              end
+
+              {
+                apiVersion: @@api_version,
+                swaggerVersion: "1.1",
+                basePath: @@base_path || "http://#{env['HTTP_HOST']}",
+                resourcePath: "",
+                apis: routes_array
+              }
+            end
           end
 
 
@@ -57,54 +117,6 @@ def parse_path(path)
               parsed_path.gsub(/:([a-z]+)/, '{\1}')
             end
           end
-
-          desc 'Swagger compatible API description'
-          get '/swagger_doc' do
-            header['Access-Control-Allow-Origin'] = '*'
-            header['Access-Control-Request-Method'] = '*'
-            routes = @@target_class::combined_routes
-
-            routes_array = routes.keys.map do |route|
-                { :path => "/swagger_doc/#{route}.{format}" }
-            end
-            {
-              apiVersion: "0.2",
-              swaggerVersion: "1.1",
-              basePath: "http://#{env['HTTP_HOST']}",
-              operations:[],
-              apis: routes_array
-            }
-          end
-
-          desc 'Swagger compatible API description for specific API', :params =>
-            {
-              "name" => { :desc => "Class name of mounted API", :type => "string", :required => true },
-            }
-          get '/swagger_doc/:name' do
-            header['Access-Control-Allow-Origin'] = '*'
-            header['Access-Control-Request-Method'] = '*'
-            routes = @@target_class::combined_routes[params[:name]]
-            routes_array = routes.map do |route|
-              {
-                :path => parse_path(route.route_path),
-                :operations => [{
-                  :notes => route.route_notes,
-                  :summary => route.route_description || '',
-                  :nickname   => Random.rand(1000000),
-                  :httpMethod => route.route_method,
-                  :parameters => parse_params(route.route_params)
-                }]
-              }
-            end
-
-            {
-              apiVersion: "0.2",
-              swaggerVersion: "1.1",
-              basePath: "http://#{env['HTTP_HOST']}",
-              resourcePath: "",
-              apis: routes_array
-            }
-          end
         end
       end
     end