require 'active_resource/connection' module ActiveResource class InvalidRequestError < StandardError; end #:nodoc: # One thing that has always been a pain with remote web services is testing. The HttpMock # class makes it easy to test your Active Resource models by creating a set of mock responses to specific # requests. # # To test your Active Resource model, you simply call the ActiveResource::HttpMock.respond_to # method with an attached block. The block declares a set of URIs with expected input, and the output # each request should return. The passed in block has any number of entries in the following generalized # format: # # mock.http_method(path, request_headers = {}, body = nil, status = 200, response_headers = {}) # # * http_method - The HTTP method to listen for. This can be +get+, +post+, +put+, +delete+ or # +head+. # * path - A string, starting with a "/", defining the URI that is expected to be # called. # * request_headers - Headers that are expected along with the request. This argument uses a # hash format, such as { "Content-Type" => "application/xml" }. This mock will only trigger # if your tests sends a request with identical headers. # * body - The data to be returned. This should be a string of Active Resource parseable content, # such as XML. # * status - The HTTP response code, as an integer, to return with the response. # * response_headers - Headers to be returned with the response. Uses the same hash format as # request_headers listed above. # # In order for a mock to deliver its content, the incoming request must match by the http_method, # +path+ and request_headers. If no match is found an InvalidRequestError exception # will be raised showing you what request it could not find a response for and also what requests and response # pairs have been recorded so you can create a new mock for that request. # # ==== Example # def setup # @matz = { :id => 1, :name => "Matz" }.to_xml(:root => "person") # ActiveResource::HttpMock.respond_to do |mock| # mock.post "/people.xml", {}, @matz, 201, "Location" => "/people/1.xml" # mock.get "/people/1.xml", {}, @matz # mock.put "/people/1.xml", {}, nil, 204 # mock.delete "/people/1.xml", {}, nil, 200 # end # end # # def test_get_matz # person = Person.find(1) # assert_equal "Matz", person.name # end # class HttpMock class Responder #:nodoc: def initialize(responses) @responses = responses end for method in [ :post, :put, :get, :delete, :head ] # def post(path, request_headers = {}, body = nil, status = 200, response_headers = {}) # @responses[Request.new(:post, path, nil, request_headers)] = Response.new(body || "", status, response_headers) # end module_eval <<-EOE, __FILE__, __LINE__ + 1 def #{method}(path, request_headers = {}, body = nil, status = 200, response_headers = {}) @responses << [Request.new(:#{method}, path, nil, request_headers), Response.new(body || "", status, response_headers)] end EOE end end class << self # Returns an array of all request objects that have been sent to the mock. You can use this to check # if your model actually sent an HTTP request. # # ==== Example # def setup # @matz = { :id => 1, :name => "Matz" }.to_xml(:root => "person") # ActiveResource::HttpMock.respond_to do |mock| # mock.get "/people/1.xml", {}, @matz # end # end # # def test_should_request_remote_service # person = Person.find(1) # Call the remote service # # # This request object has the same HTTP method and path as declared by the mock # expected_request = ActiveResource::Request.new(:get, "/people/1.xml") # # # Assert that the mock received, and responded to, the expected request from the model # assert ActiveResource::HttpMock.requests.include?(expected_request) # end def requests @@requests ||= [] end # Returns the list of requests and their mocked responses. Look up a # response for a request using responses.assoc(request). def responses @@responses ||= [] end # Accepts a block which declares a set of requests and responses for the HttpMock to respond to in # the following format: # # mock.http_method(path, request_headers = {}, body = nil, status = 200, response_headers = {}) # # === Example # # @matz = { :id => 1, :name => "Matz" }.to_xml(:root => "person") # ActiveResource::HttpMock.respond_to do |mock| # mock.post "/people.xml", {}, @matz, 201, "Location" => "/people/1.xml" # mock.get "/people/1.xml", {}, @matz # mock.put "/people/1.xml", {}, nil, 204 # mock.delete "/people/1.xml", {}, nil, 200 # end # # Alternatively, accepts a hash of {Request => Response} pairs allowing you to generate # these the following format: # # ActiveResource::Request.new(method, path, body, request_headers) # ActiveResource::Response.new(body, status, response_headers) # # === Example # # Request.new(:#{method}, path, nil, request_headers) # # @matz = { :id => 1, :name => "Matz" }.to_xml(:root => "person") # # create_matz = ActiveResource::Request.new(:post, '/people.xml', @matz, {}) # created_response = ActiveResource::Response.new("", 201, {"Location" => "/people/1.xml"}) # get_matz = ActiveResource::Request.new(:get, '/people/1.xml', nil) # ok_response = ActiveResource::Response.new("", 200, {}) # # pairs = {create_matz => created_response, get_matz => ok_response} # # ActiveResource::HttpMock.respond_to(pairs) # # Note, by default, every time you call +respond_to+, any previous request and response pairs stored # in HttpMock will be deleted giving you a clean slate to work on. # # If you want to override this behaviour, pass in +false+ as the last argument to +respond_to+ # # === Example # # ActiveResource::HttpMock.respond_to do |mock| # mock.send(:get, "/people/1", {}, "XML1") # end # ActiveResource::HttpMock.responses.length #=> 1 # # ActiveResource::HttpMock.respond_to(false) do |mock| # mock.send(:get, "/people/2", {}, "XML2") # end # ActiveResource::HttpMock.responses.length #=> 2 # # This also works with passing in generated pairs of requests and responses, again, just pass in false # as the last argument: # # === Example # # ActiveResource::HttpMock.respond_to do |mock| # mock.send(:get, "/people/1", {}, "XML1") # end # ActiveResource::HttpMock.responses.length #=> 1 # # get_matz = ActiveResource::Request.new(:get, '/people/1.xml', nil) # ok_response = ActiveResource::Response.new("", 200, {}) # # pairs = {get_matz => ok_response} # # ActiveResource::HttpMock.respond_to(pairs, false) # ActiveResource::HttpMock.responses.length #=> 2 def respond_to(*args) #:yields: mock pairs = args.first || {} reset! if args.last.class != FalseClass responses.concat pairs.to_a if block_given? yield Responder.new(responses) else Responder.new(responses) end end # Deletes all logged requests and responses. def reset! requests.clear responses.clear end end # body? methods { true => %w(post put), false => %w(get delete head) }.each do |has_body, methods| methods.each do |method| # def post(path, body, headers) # request = ActiveResource::Request.new(:post, path, body, headers) # self.class.requests << request # if response = self.class.responses.assoc(request) # response[1] # else # raise InvalidRequestError.new("Could not find a response recorded for #{request.to_s} - Responses recorded are: - #{inspect_responses}") # end # end module_eval <<-EOE, __FILE__, __LINE__ + 1 def #{method}(path, #{'body, ' if has_body}headers) request = ActiveResource::Request.new(:#{method}, path, #{has_body ? 'body, ' : 'nil, '}headers) self.class.requests << request if response = self.class.responses.assoc(request) response[1] else raise InvalidRequestError.new("Could not find a response recorded for \#{request.to_s} - Responses recorded are: \#{inspect_responses}") end end EOE end end def initialize(site) #:nodoc: @site = site end def inspect_responses #:nodoc: self.class.responses.map { |r| r[0].to_s }.inspect end end class Request attr_accessor :path, :method, :body, :headers def initialize(method, path, body = nil, headers = {}) @method, @path, @body, @headers = method, path, body, headers end def ==(req) path == req.path && method == req.method && headers_match?(req) end def to_s "<#{method.to_s.upcase}: #{path} [#{headers}] (#{body})>" end private def headers_match?(req) # Ignore format header on equality if it's not defined format_header = ActiveResource::Connection::HTTP_FORMAT_HEADER_NAMES[method] if headers[format_header].present? || req.headers[format_header].blank? headers == req.headers else headers.dup.merge(format_header => req.headers[format_header]) == req.headers end end end class Response attr_accessor :body, :message, :code, :headers def initialize(body, message = 200, headers = {}) @body, @message, @headers = body, message.to_s, headers @code = @message[0,3].to_i resp_cls = Net::HTTPResponse::CODE_TO_OBJ[@code.to_s] if resp_cls && !resp_cls.body_permitted? @body = nil end if @body.nil? self['Content-Length'] = "0" else self['Content-Length'] = body.size.to_s end end def success? (200..299).include?(code) end def [](key) headers[key] end def []=(key, value) headers[key] = value end def ==(other) if (other.is_a?(Response)) other.body == body && other.message == message && other.headers == headers else false end end end class Connection private silence_warnings do def http @http ||= HttpMock.new(@site) end end end end