code style for Adapter::Rack

lib/faraday/adapter/rack.rb

@@ -1,37 +1,34 @@
 require 'timeout'
+
 module Faraday
   class Adapter
-    # This adapter wraps around a rack app, similar to how Rack::Test
+    # Sends requests to a Rack app.
-    # allows you to test rack apps.
     #
-    # @example
+    # Examples
-    #    class RackApp
-    #      def call(env)
-    #        [200, {'Content-Type' => 'text/html'}, ["hello world"]]
-    #      end
-    #    end
     #
-    #    Faraday.new do |builder|
+    #   class MyRackApp
-    #      builder.adapter :rack, RackApp
+    #     def call(env)
-    #    end
+    #       [200, {'Content-Type' => 'text/html'}, ["hello world"]]
+    #     end
+    #   end
+    #
+    #   Faraday.new do |conn|
+    #     conn.adapter :rack, MyRackApp
+    #   end
     class Rack < Faraday::Adapter
       dependency 'rack/test'
 
       begin
-        if RUBY_VERSION < '1.9'
+        require 'system_timer' if RUBY_VERSION < '1.9'
-          require 'system_timer'
-        end
       rescue LoadError
-        $stderr.puts "Faraday: you may want to install system_timer for reliable timeouts"
+        warn "Faraday: you may want to install system_timer for reliable timeouts"
       ensure
         SystemTimer = Timeout unless defined? ::SystemTimer
       end
 
-      # @param app [Faraday::Middleware]
+      def initialize(faraday_app, rack_app)
-      # @param rack rack application to wrap
+        super(faraday_app)
-      def initialize(app, rack)
+        mock_session = ::Rack::MockSession.new(rack_app)
-        super(app)
-        mock_session = ::Rack::MockSession.new(rack)
         @session     = ::Rack::Test::Session.new(mock_session)
       end
 
@@ -56,14 +53,14 @@ module Faraday
         else
           execute_request(env, rack_env)
         end
+
         save_response(env, response.status, response.body, response.headers)
         @app.call env
       end
 
-      # @private
       def execute_request(env, rack_env)
         @session.request(env[:url].to_s, rack_env)
       end
     end
   end
-end
+end