rets 0.5.1 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 56d0e6818b0033682fe65525f1c73a2eb4ae42bb
-  data.tar.gz: ee6fea4f6d3f028cd6247fb75896e5d70a6abe73
+  metadata.gz: 2ed1e7653c004159b6f9042dc917f9c8a30be926
+  data.tar.gz: 4b2275a656b7240b5d94a4d0f9c0ad5a62a18eeb
 SHA512:
-  metadata.gz: 56b3c73c03e27236c1e99c13de713af4b45472e6853637bbfb77e90189c7e5a438ec13b8ad5cd0b9c2ada381f1d79bae72592cb3daab6067547a949f5fab51c0
-  data.tar.gz: 6b67b8bd34c923e54b49232f161d4daf8662c8fd86899f87b02951d75d6eae9bb5bd19c7f42e0c2667ce41d8dbf949794cd5748762315a3feae8c40052e8afb9
+  metadata.gz: 3853c2929ab43105aba05ceebe185e4c3b86271bdc99b8ec42e9578921ee9d2740c98cfea2b31a13e22de6e3d5e4fa608f61399133593c43dae14f3c63ffc772
+  data.tar.gz: 7d177e112e61b54dc347811bdfa6a44aa2dd472ce45b061dbf180e636b4e5f2c4318e6d8ea08dc5c1013615118eefc4da401fa4b7bd3da629317d7022221f30b

data/CHANGELOG.md

@@ -1,3 +1,24 @@
+### 0.6.0 / 2013-10-30
+
+* fix: fix spelling error that created misleading exceptions
+* feature: track stats for http requests sent
+* feature: raise an exception if the login action doesn't return an http 200 status
+* feature: add better class description and more fields to print tree
+* feature: support http proxies
+* feature: customizable http timeouts
+* feature: add logging http headers when in debug mode
+* feature: strip invalid utf8 from responses before parsing
+* fix: don't raise an exception on a 401 after logout
+* fix: treat no matching records status without a count node as a zero count
+* feature: add an option for loading custom ca_certs
+* feature: remove invalid resource types from metadata
+* feature: special case http 412
+* feature: add max_retries option
+
+### 0.5.1 / 2013-10-30
+
+* fix: 0.5.0 was broken, fix gem Manifest to fix gem
+
 ### 0.5.0 / 2013-09-05
 
 * feature: Allow client.count to get integer count

data/Manifest.txt

@@ -25,3 +25,4 @@ test/test_locking_http_client.rb
 test/test_metadata.rb
 test/test_parser_compact.rb
 test/test_parser_multipart.rb
+test/vcr_cassettes/unauthorized_response.yml

data/README.md

@@ -17,6 +17,10 @@ A pure-ruby library for fetching data from [RETS] servers.
 [net-http-persistent]: http://seattlerb.rubyforge.org/net-http-persistent/
 [nokogiri]: http://nokogiri.org
 
+## EXAMPLE USAGE:
+
+We need work in this area! There are currently a few guideline examples in the `example` folder on connecting, fetching a property's data, and fetching a property's photos.
+ 
 ## LICENSE:
 
 (The MIT License)

data/lib/rets.rb

@@ -3,7 +3,7 @@ require 'digest/md5'
 require 'nokogiri'
 
 module Rets
-  VERSION = '0.5.1'
+  VERSION = '0.6.0'
 
   MalformedResponse    = Class.new(ArgumentError)
   UnknownResponse      = Class.new(ArgumentError)
@@ -31,7 +31,7 @@ module Rets
     attr_reader :capability_name
     def initialize(capability_name)
       @capability_name = capability_name
-      super("unknown capabilitiy #{capability_name}")
+      super("unknown capability #{capability_name}")
     end
   end
 end

data/lib/rets/client.rb

@@ -31,7 +31,20 @@ module Rets
       self.logger      = @options[:logger] || FakeLogger.new
       @client_progress = ClientProgressReporter.new(self.logger, options[:stats_collector], options[:stats_prefix])
       @cached_metadata = @options[:metadata]
-      @http = HTTPClient.new
+      if @options[:http_proxy]
+        @http = HTTPClient.new(options.fetch(:http_proxy))
+
+        if @options[:proxy_username]
+          @http.set_proxy_auth(options.fetch(:proxy_username), options.fetch(:proxy_password))
+        end
+      else
+        @http = HTTPClient.new
+      end
+
+      if @options[:receive_timeout]
+        @http.receive_timeout = @options[:receive_timeout]
+      end
+
       @http.set_cookie_store(options[:cookie_store]) if options[:cookie_store]
 
       @http_client = Rets::HttpClient.new(@http, @options, @logger, @login_url)
@@ -61,6 +74,10 @@ module Rets
         raise NoLogout.new('No logout method found for rets client')
       end
       http_get(capability_url("Logout"))
+    rescue UnknownResponse => e
+      unless e.message.match(/expected a 200, but got 401/)
+        raise e
+      end
     end
 
     # Finds records.
@@ -98,7 +115,7 @@ module Rets
       begin
         find_every(opts, resolve)
       rescue AuthorizationFailure, InvalidRequest => e
-        if retries < 3
+        if retries < opts.fetch(:max_retries, 3)
           retries += 1
           @client_progress.find_with_retries_failed_a_retry(e, retries)
           clean_setup
@@ -117,7 +134,7 @@ module Rets
       if opts[:count] == COUNT.only
         Parser::Compact.get_count(res.body)
       else
-        results = Parser::Compact.parse_document(res.body)
+        results = Parser::Compact.parse_document(res.body.encode("UTF-8", "binary", :invalid => :replace, :undef => :replace))
         if resolve
           rets_class = find_rets_class(opts[:search_type], opts[:class])
           decorate_results(results, rets_class)
@@ -239,11 +256,18 @@ module Rets
         self.metadata = @cached_metadata
       else
         @client_progress.bad_cached_metadata(@cached_metadata)
-        metadata_fetcher = lambda { |type| retrieve_metadata_type(type) }
-        self.metadata = Metadata::Root.new(&metadata_fetcher)
+        self.metadata = Metadata::Root.new(logger, retrieve_metadata)
       end
     end
 
+    def retrieve_metadata
+      raw_metadata = {}
+      Metadata::METADATA_TYPES.each {|type|
+        raw_metadata[type] = retrieve_metadata_type(type)
+      }
+      raw_metadata
+    end
+
     def retrieve_metadata_type(type)
       res = http_post(capability_url("GetMetadata"),
                       { "Format" => "COMPACT",
@@ -322,6 +346,13 @@ module Rets
 
     class ErrorChecker
       def self.check(response)
+        # some RETS servers returns HTTP code 412 when session cookie expired, yet the response body
+        # passes XML check. We need to special case for this situation.
+        # This method is also called from multipart.rb where there are headers and body but no status_code
+        if response.respond_to?(:status_code) && response.status_code == 412
+          raise HttpError, "HTTP status: #{response.status_code}, body: #{response.body}"
+        end
+
         # some RETS servers return success code in XML body but failure code 4xx in http status
         # If xml body is present we ignore http status
 

data/lib/rets/http_client.rb

@@ -7,13 +7,16 @@ module Rets
       @options = options
       @logger = logger
       @login_url = login_url
+      @options.fetch(:ca_certs, []).each {|c| @http.ssl_config.add_trust_ca(c) }
     end
 
     def http_get(url, params=nil, extra_headers={})
       http.set_auth(url, options[:username], options[:password])
       headers = extra_headers.merge(rets_extra_headers)
-      res = http.get(url, params, headers)
-      log_http_traffic("POST", url, params, headers, res)
+      res = nil
+      log_http_traffic("POST", url, params, headers) do
+        res = http.get(url, params, headers)
+      end
       Client::ErrorChecker.check(res)
       res
     end
@@ -21,12 +24,34 @@ module Rets
     def http_post(url, params, extra_headers = {})
       http.set_auth(url, options[:username], options[:password])
       headers = extra_headers.merge(rets_extra_headers)
-      res = http.post(url, params, headers)
-      log_http_traffic("POST", url, params, headers, res)
+      res = nil
+      log_http_traffic("POST", url, params, headers) do
+        res = http.post(url, params, headers)
+      end
       Client::ErrorChecker.check(res)
       res
     end
 
+    def log_http_traffic(method, url, params, headers, &block)
+      # optimization, we don't want to compute log params
+      # if logging is off
+      if logger.debug?
+        logger.debug "Rets::Client >> #{method} #{url}"
+        logger.debug "Rets::Client >> params = #{params.inspect}"
+        logger.debug "Rets::Client >> headers = #{headers.inspect}"
+      end
+
+      res = block.call
+
+      # optimization, we don't want to compute log params
+      # if logging is off, especially when there is a loop just
+      # for logging
+      if logger.debug?
+        logger.debug "Rets::Client << Status #{res.status_code}"
+        res.headers.each { |k, v| logger.debug "Rets::Client << #{k}: #{v}" }
+      end
+    end
+
     def save_cookie_store(force=nil)
       if options[:cookie_store]
         if force
@@ -37,15 +62,6 @@ module Rets
       end
     end
 
-    def log_http_traffic(method, url, params, headers, res)
-      return unless logger.debug?
-      logger.debug "Rets::Client >> #{method} #{url}"
-      logger.debug "Rets::Client >> params = #{params.inspect}"
-      logger.debug "Rets::Client >> headers = #{headers.inspect}"
-      logger.debug "Rets::Client << Status #{res.status_code}"
-      res.headers.each { |k, v| logger.debug "Rets::Client << #{k}: #{v}" }
-    end
-
     def rets_extra_headers
       user_agent = options[:agent] || "Client/1.0"
       rets_version = options[:version] || "RETS/1.7.2"

data/lib/rets/metadata/lookup_type.rb

@@ -10,7 +10,7 @@ module Rets
       end
 
       def print_tree
-        puts "      #{long_value} -> #{value}"
+        puts "        #{long_value} -> #{value}"
       end
     end
   end

data/lib/rets/metadata/resource.rb

@@ -1,6 +1,7 @@
 module Rets
   module Metadata
     class Resource
+      class MissingRetsClass < RuntimeError; end
       attr_accessor :rets_classes
       attr_accessor :lookup_types
       attr_accessor :key_field
@@ -24,7 +25,12 @@ module Rets
       end
 
       def self.find_rets_classes(metadata, resource)
-        metadata[:class].detect { |c| c.resource == resource.id }.classes
+        class_container = metadata[:class].detect { |c| c.resource == resource.id }
+        if class_container.nil?
+          raise MissingRetsClass.new("No Metadata classes for #{resource.id}")
+        else
+          class_container.classes
+        end
       end
 
       def self.build_lookup_tree(resource, metadata)
@@ -52,12 +58,15 @@ module Rets
         end
       end
 
-      def self.build(resource_fragment, metadata)
+      def self.build(resource_fragment, metadata, logger)
         resource = new(resource_fragment)
 
         resource.lookup_types = build_lookup_tree(resource, metadata)
         resource.rets_classes = build_classes(resource, metadata)
         resource
+      rescue MissingRetsClass => e
+        logger.warn(e.message)
+        nil
       end
 
       def print_tree

data/lib/rets/metadata/rets_class.rb

@@ -3,12 +3,16 @@ module Rets
     class RetsClass
       attr_accessor :tables
       attr_accessor :name
+      attr_accessor :visible_name
+      attr_accessor :description
       attr_accessor :resource
 
       def initialize(rets_class_fragment, resource)
         self.resource = resource
         self.tables = []
         self.name = rets_class_fragment["ClassName"]
+        self.visible_name = rets_class_fragment["VisibleName"]
+        self.description = rets_class_fragment["Description"]
       end
 
       def self.find_table_container(metadata, resource, rets_class)
@@ -31,6 +35,8 @@ module Rets
 
       def print_tree
         puts "  Class: #{name}"
+        puts "    Visible Name: #{visible_name}"
+        puts "    Description : #{description}"
         tables.each(&:print_tree)
       end
 

data/lib/rets/metadata/root.rb

@@ -47,33 +47,25 @@ module Rets
       # Sources are the raw xml documents fetched for each metadata type
       # they are stored as a hash with the type names as their keys
       # and the raw xml as the values
-      attr_accessor :sources
+      attr_reader :sources
+
+      # Metadata can be unmarshalled from cache. @logger is not set during that process, constructor is not called.
+      # Client code must set it after unmarshalling.
+      attr_reader :logger
 
       # fetcher is a proc that inverts control to the client to retrieve metadata
       # types
-      def initialize(&fetcher)
+      def initialize(logger, sources)
+        @logger = logger
         @tree = nil
         @metadata_types = nil # TODO think up a better name ... containers?
-        @sources = {}
-
-        # allow Root's to be built with no fetcher. Makes for easy testing
-        return unless block_given?
-
-        fetch_sources(&fetcher)
-      end
-
-      def fetch_sources(&fetcher)
-        self.sources = Hash[*METADATA_TYPES.map {|type| [type, fetcher.call(type)] }.flatten]
+        @sources = sources
       end
 
       def marshal_dump
         sources
       end
 
-      def marshal_load(sources)
-        self.sources = sources
-      end
-
       def version
         metadata_types[:system].first.version
       end
@@ -87,11 +79,11 @@ module Rets
       # version was published, or a version number. These values may or may
       # not exist on any given rets server.
       def current?(current_timestamp, current_version)
-	if !current_version.to_s.empty? && !version.to_s.empty?
-	  current_version == version 
-	else
+        if !current_version.to_s.empty? && !version.to_s.empty?
+          current_version == version
+        else
           current_timestamp ? current_timestamp == date : true
-	end
+        end
       end
 
       def build_tree
@@ -101,8 +93,9 @@ module Rets
 
         resource_containers.each do |resource_container|
           resource_container.rows.each do |resource_fragment|
-            resource = Resource.build(resource_fragment, metadata_types)
-            tree[resource.id.downcase] = resource
+            resource = Resource.build(resource_fragment, metadata_types, @logger)
+            #some mlses list resource types without an associated data, throw those away
+            tree[resource.id.downcase] = resource if resource
           end
         end
 

data/lib/rets/metadata/table.rb

@@ -33,6 +33,7 @@ module Rets
         puts "      StandardName: #{ table_fragment["StandardName"] }"
         puts "      Units: #{ table_fragment["Units"] }"
         puts "      Searchable: #{ table_fragment["Searchable"] }"
+        puts "      Required: #{table_fragment['Required']}"
       end
 
       def resolve(value)
@@ -67,6 +68,13 @@ module Rets
 
       def print_tree
         puts "    LookupTable: #{name}"
+        puts "      Required: #{table_fragment['Required']}"
+        puts "      Searchable: #{ table_fragment["Searchable"] }"
+        puts "      Units: #{ table_fragment["Units"] }"
+        puts "      ShortName: #{ table_fragment["ShortName"] }"
+        puts "      LongName: #{ table_fragment["LongName"] }"
+        puts "      StandardName: #{ table_fragment["StandardName"] }"
+        puts "      Types:"
 
         lookup_types.each(&:print_tree)
       end

data/lib/rets/parser/compact.rb

@@ -49,8 +49,14 @@ module Rets
 
       def self.get_count(xml)
         doc = Nokogiri.parse(xml.to_s)
-        doc.at("//COUNT").attr('Records').to_i
+        if node = doc.at("//COUNT")
+          return node.attr('Records').to_i
+        elsif node = doc.at("//RETS-STATUS")
+          # Handle <RETS-STATUS ReplyCode="20201" ReplyText="No matching records were found" />
+          return 0 if node.attr('ReplyCode') == '20201'
+        end
       end
+
     end
   end
 end

data/test/fixtures.rb

@@ -27,6 +27,13 @@ COUNT_ONLY = <<XML
 </RETS>
 XML
 
+RETS_STATUS_NO_MATCHING_RECORDS = <<XML
+<?xml version="1.0"?>
+<RETS ReplyCode="0" ReplyText="Operation Successful">
+<RETS-STATUS ReplyCode="20201" ReplyText="No matching records were found" />
+</RETS>
+XML
+
 CAPABILITIES_WITH_WHITESPACE = <<XML
 <RETS ReplyCode="0" ReplyText="Operation Successful">
 <RETS-RESPONSE>

data/test/test_client.rb

@@ -37,21 +37,23 @@ class TestClient < MiniTest::Test
   end
 
   def test_metadata_when_not_initialized_with_metadata
+    new_raw_metadata = stub(:new_raw_metadata)
+
     client = Rets::Client.new(:login_url => "http://example.com")
-    Rets::Metadata::Root.expects(:new)
-    client.metadata
+    client.stubs(:retrieve_metadata).returns(new_raw_metadata)
+
+    assert_same new_raw_metadata, client.metadata.marshal_dump
   end
 
-  def test_initialize_with_old_metadata_cached_gets_new_metadata
+  def test_initialize_with_old_metadata_cached_contstructs_new_metadata_from_request
     metadata = stub(:current? => false)
-    new_metadata = stub(:current? => false)
+    new_raw_metadata = stub(:new_raw_metadata)
+
     client = Rets::Client.new(:login_url => "http://example.com", :metadata => metadata)
-    client.stubs(:capabilities => {})
-    Rets::Metadata::Root.expects(:new => new_metadata).once
+    client.stubs(:capabilities).returns({})
+    client.stubs(:retrieve_metadata).returns(new_raw_metadata)
 
-    assert_same new_metadata, client.metadata
-    # This second call ensures the expectations on Root are met
-    client.metadata
+    assert_same new_raw_metadata, client.metadata.marshal_dump
   end
 
   def test_initialize_with_current_metadata_cached_return_cached_metadata
@@ -210,4 +212,27 @@ class TestClient < MiniTest::Test
     assert_equal response, result
   end
 
+  def test_clean_setup_with_receive_timeout
+   HTTPClient.any_instance.expects(:receive_timeout=).with(1234)
+   @client = Rets::Client.new(
+       login_url: 'http://example.com/login',
+       receive_timeout: 1234
+   )
+  end
+
+  def test_clean_setup_with_proxy_auth
+    @login_url = 'http://example.com/login'
+    @proxy_url = 'http://example.com/proxy'
+    @proxy_username = 'username'
+    @proxy_password = 'password'
+    HTTPClient.any_instance.expects(:set_proxy_auth).with(@proxy_username, @proxy_password)
+
+    @client = Rets::Client.new(
+        login_url: @login_url,
+        http_proxy: @proxy_url,
+        proxy_username: @proxy_username,
+        proxy_password: @proxy_password
+    )
+  end
+
 end

data/test/test_metadata.rb

@@ -1,8 +1,9 @@
 require_relative "helper"
+require 'logger'
 
 class TestMetadata < MiniTest::Test
   def setup
-    @root = Rets::Metadata::Root.new
+    @root = Rets::Metadata::Root.new(Logger.new(STDOUT), {})
     $VERBOSE = true
   end
 
@@ -10,23 +11,6 @@ class TestMetadata < MiniTest::Test
     $VERBOSE = false
   end
 
-  def test_metadata_root_fetch_sources_returns_hash_of_metadata_types
-    types = []
-    fake_fetcher = lambda do |type|
-      types << type
-    end
-
-    @root.fetch_sources(&fake_fetcher)
-
-    assert_equal(Rets::Metadata::METADATA_TYPES, types)
-  end
-
-  def test_metadata_root_intialized_with_block
-    external = false
-    Rets::Metadata::Root.new { |source| external = true }
-    assert external
-  end
-
   def test_metadata_root_build_tree
     resource = stub(:id => "X")
     Rets::Metadata::Resource.stubs(:build => resource)
@@ -111,10 +95,11 @@ class TestMetadata < MiniTest::Test
 
   def test_metadata_root_metadata_types_constructs_a_hash_of_metadata_types_from_sources
     test_sources = { "X" => "Y", "Z" => "W" }
-    @root.stubs(:sources => test_sources, :build_containers => "Y--")
-    @root.metadata_types = nil
+    root = Rets::Metadata::Root.new(stub(:logger), test_sources)
+    root.stubs(:build_containers => "Y--")
     Nokogiri.stubs(:parse => "Y-")
-    assert_equal({:x => "Y--", :z => "Y--"}, @root.metadata_types)
+
+    assert_equal({:x => "Y--", :z => "Y--"}, root.metadata_types)
   end
 
   def test_metadata_root_build_containers_selects_correct_tags
@@ -211,12 +196,30 @@ class TestMetadata < MiniTest::Test
     Rets::Metadata::Resource.stubs(:build_lookup_tree => lookup_types)
     Rets::Metadata::Resource.stubs(:build_classes => classes)
 
-    resource = Rets::Metadata::Resource.build(fragment, metadata)
+    resource = Rets::Metadata::Resource.build(fragment, metadata, Logger.new(STDOUT))
 
     assert_equal(lookup_types, resource.lookup_types)
     assert_equal(classes, resource.rets_classes)
   end
 
+  def test_resource_build_with_incomplete_classes
+    fragment = { "ResourceID" => "test" }
+
+    lookup_types = stub(:lookup_types)
+    metadata = stub(:metadata)
+
+    Rets::Metadata::Resource.stubs(:build_lookup_tree => lookup_types)
+    Rets::Metadata::Resource.stubs(:build_classes).raises(Rets::Metadata::Resource::MissingRetsClass)
+
+    error_log = StringIO.new
+    resource = Rets::Metadata::Resource.build(fragment, metadata, Logger.new(error_log))
+
+    error_log.rewind
+    error_msg = error_log.read
+    assert error_msg.include?('MissingRetsClass')
+    assert_equal(nil, resource)
+  end
+
   def test_resource_find_lookup_containers
     resource = stub(:id => "id")
     metadata = { :lookup => [stub(:resource => "id"), stub(:resource => "id"), stub(:resource => "a")] }
@@ -440,18 +443,17 @@ class TestMetadata < MiniTest::Test
 
   def test_root_can_be_serialized
     sources = { :x => "a" }
-
-    @root.sources = sources
-
-    assert_equal sources, @root.marshal_dump
+    root = Rets::Metadata::Root.new(stub(:logger), sources)
+    assert_equal sources, root.marshal_dump
   end
 
   def test_root_can_be_unserialized
+    logger = stub(:logger)
     sources = { :x => "a" }
 
-    @root.marshal_load(sources)
+    root_to_serialize = Rets::Metadata::Root.new(logger, sources)
+    new_root = Rets::Metadata::Root.new(logger, root_to_serialize.marshal_dump)
 
-    assert_equal sources, @root.sources
+    assert_equal root_to_serialize.marshal_dump, new_root.marshal_dump
   end
-
 end

data/test/test_parser_compact.rb

@@ -66,6 +66,11 @@ class TestParserCompact < MiniTest::Test
     assert_equal 1234, count
   end
 
+  def test_get_count_with_no_matching_records
+    count = Rets::Parser::Compact.get_count(RETS_STATUS_NO_MATCHING_RECORDS)
+    assert_equal 0, count
+  end
+
   def test_parse_example
     rows = Rets::Parser::Compact.parse_document(Nokogiri.parse(SAMPLE_COMPACT))
 

data/test/vcr_cassettes/unauthorized_response.yml

@@ -0,0 +1,262 @@
+---
+http_interactions:
+- request:
+    method: post
+    uri: http://rets.example.com/GetObject.asmx/GetObject
+    body:
+      encoding: US-ASCII
+      string: Resource=Property&Type=Photo&ID=2661580%3A1&Location=0
+    headers:
+      User-Agent:
+      - Estately/1.0
+      Host:
+      - rets.example.com:80
+      Rets-Version:
+      - RETS/1.7.2
+      Authorization:
+      - Digest username="login", realm="fake_realm", qop="auth",
+        uri="/Login.asmx/Login", nonce="a8f4bc805062602c8ba7a87b2109f808", nc=00000001,
+        cnonce="6e2dd038eea6cbacf0b956fd11f914b6", response="fake_digest",
+        opaque="96eda461-41d0-4624-b7fe-b59e966035f3"
+      Cookie:
+      - ASP.NET_SessionId=mapij045k3bphj3gqqgpmmrx
+      Accept:
+      - image/jpeg, image/png;q=0.5, image/gif;q=0.1
+      Content-Type:
+      - application/x-www-form-urlencoded
+      Content-Length:
+      - '54'
+  response:
+    status:
+      code: 401
+      message: Unauthorized
+    headers:
+      Connection:
+      - close
+      Date:
+      - Thu, 26 Jul 2012 00:11:02 GMT
+      Server:
+      - Microsoft-IIS/6.0
+      Cache-Control:
+      - private
+      - private
+      X-Aspnet-Version:
+      - 2.0.50727
+      Www-Authenticate:
+      - Digest realm="fake_realm",nonce="dfd74deac03147e1a4fff598679f1a80",opaque="8e5029c6-bb9c-4562-b440-e7c2b8960743",qop="auth"
+      Content-Type:
+      - text/plain
+    body:
+      encoding: US-ASCII
+      string: ! "Unauthorized Request. Digest Session Invalid Reauthenticate\r\nReference:
+        e0ff89c0-2d64-4287-a6b7-6be27c7d3ade"
+    http_version: 
+  recorded_at: Thu, 26 Jul 2012 00:11:13 GMT
+- request:
+    method: post
+    uri: http://rets.example.com/Login.asmx/Login
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Estately/1.0
+      Host:
+      - rets.example.com:80
+      Rets-Version:
+      - RETS/1.7.2
+      Accept:
+      - ! '*/*'
+  response:
+    status:
+      code: 401
+      message: Unauthorized
+    headers:
+      Connection:
+      - close
+      Date:
+      - Thu, 26 Jul 2012 00:11:03 GMT
+      Server:
+      - Microsoft-IIS/6.0
+      Cache-Control:
+      - private
+      - private
+      X-Aspnet-Version:
+      - 2.0.50727
+      Www-Authenticate:
+      - Digest realm="fake_realm",nonce="17fdfe2c6125296bd93bb81bd88dc4be",opaque="aee1e7da-60eb-41b3-b704-8eb3969645fd",qop="auth"
+      Content-Type:
+      - text/plain
+    body:
+      encoding: US-ASCII
+      string: ! "Unauthorized Request. Authentication needed\r\nReference: c2c5ab9f-8c12-42bb-94ce-5b6ebf156da4"
+    http_version: 
+  recorded_at: Thu, 26 Jul 2012 00:11:13 GMT
+- request:
+    method: post
+    uri: http://rets.example.com/Login.asmx/Login
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Estately/1.0
+      Host:
+      - rets.example.com:80
+      Rets-Version:
+      - RETS/1.7.2
+      Authorization:
+      - Digest username="login", realm="fake_realm", qop="auth",
+        uri="/Login.asmx/Login", nonce="17fdfe2c6125296bd93bb81bd88dc4be", nc=00000001,
+        cnonce="ad805b9e2d6f08ad82175085e5febd8d", response="7402076f53663602f052e1aa343d3dab",
+        opaque="aee1e7da-60eb-41b3-b704-8eb3969645fd"
+      Accept:
+      - ! '*/*'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Thu, 26 Jul 2012 00:11:03 GMT
+      Server:
+      - Microsoft-IIS/6.0
+      Cache-Control:
+      - private
+      - private, max-age=0
+      X-Aspnet-Version:
+      - 2.0.50727
+      Rets-Version:
+      - RETS/1.7.2
+      Rets-Server:
+      - Interealty-RETS/1.5.247.0
+      Transfer-Encoding:
+      - chunked
+      Set-Cookie:
+      - ASP.NET_SessionId=vuesmq55l0cpjy45zyn0e555; path=/; HttpOnly
+      - RETS-Session-ID=vuesmq55l0cpjy45zyn0e555; path=/
+      Content-Type:
+      - text/xml
+    body:
+      encoding: US-ASCII
+      string: ! "<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<RETS ReplyCode=\"0\"
+        ReplyText=\"Success. Reference ID: a3073726-a011-4391-b22e-900adae5184b\">\r\n
+        \ <RETS-RESPONSE>\r\nMemberName=John Wolff\r\nUser=23756,60,RH,login\r\nBroker=BRDA,BRDA01\r\nMetadataVersion=31.76.69587\r\nMetadataTimeStamp=2012-07-24T17:33:07Z\r\nMinMetadataTimeStamp=2012-07-24T17:33:07Z\r\nTimeoutSeconds=7200\r\nChangePassword=/ChangePassword.asmx/ChangePassword\r\nGetObject=/GetObject.asmx/GetObject\r\nLogin=/Login.asmx/Login\r\nLogout=/Logout.asmx/Logout\r\nSearch=/Search.asmx/Search\r\nGetMetadata=/GetMetadata.asmx/GetMetadata\r\n</RETS-RESPONSE>\r\n</RETS>"
+    http_version: 
+  recorded_at: Thu, 26 Jul 2012 00:11:14 GMT
+- request:
+    method: post
+    uri: http://rets.example.com/Login.asmx/Login
+    body:
+      encoding: US-ASCII
+      string: ''
+    headers:
+      User-Agent:
+      - Estately/1.0
+      Host:
+      - rets.example.com:80
+      Rets-Version:
+      - RETS/1.7.2
+      Authorization:
+      - Digest username="login", realm="fake_realm", qop="auth",
+        uri="/Login.asmx/Login", nonce="17fdfe2c6125296bd93bb81bd88dc4be", nc=00000001,
+        cnonce="ad805b9e2d6f08ad82175085e5febd8d", response="7402076f53663602f052e1aa343d3dab",
+        opaque="aee1e7da-60eb-41b3-b704-8eb3969645fd"
+      Cookie:
+      - ASP.NET_SessionId=vuesmq55l0cpjy45zyn0e555; RETS-Session-ID=vuesmq55l0cpjy45zyn0e555
+      Accept:
+      - ! '*/*'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Thu, 26 Jul 2012 00:11:03 GMT
+      Server:
+      - Microsoft-IIS/6.0
+      Cache-Control:
+      - private
+      - private, max-age=0
+      X-Aspnet-Version:
+      - 2.0.50727
+      Rets-Version:
+      - RETS/1.7.2
+      Rets-Server:
+      - Interealty-RETS/1.5.247.0
+      Transfer-Encoding:
+      - chunked
+      Set-Cookie:
+      - RETS-Session-ID=vuesmq55l0cpjy45zyn0e555; path=/
+      Content-Type:
+      - text/xml
+    body:
+      encoding: US-ASCII
+      string: ! "<?xml version=\"1.0\" encoding=\"utf-8\"?>\r\n<RETS ReplyCode=\"0\"
+        ReplyText=\"Success. Reference ID: a48b4f59-cb22-41be-8e7b-1cee28fb8644\">\r\n
+        \ <RETS-RESPONSE>\r\nMemberName=John Wolff\r\nUser=23756,60,RH,login\r\nBroker=BRDA,BRDA01\r\nMetadataVersion=31.76.69587\r\nMetadataTimeStamp=2012-07-24T17:33:07Z\r\nMinMetadataTimeStamp=2012-07-24T17:33:07Z\r\nTimeoutSeconds=7200\r\nChangePassword=/ChangePassword.asmx/ChangePassword\r\nGetObject=/GetObject.asmx/GetObject\r\nLogin=/Login.asmx/Login\r\nLogout=/Logout.asmx/Logout\r\nSearch=/Search.asmx/Search\r\nGetMetadata=/GetMetadata.asmx/GetMetadata\r\n</RETS-RESPONSE>\r\n</RETS>"
+    http_version: 
+  recorded_at: Thu, 26 Jul 2012 00:11:14 GMT
+- request:
+    method: post
+    uri: http://rets.example.com/GetObject.asmx/GetObject
+    body:
+      encoding: US-ASCII
+      string: Resource=Property&Type=Photo&ID=2661580%3A1&Location=0
+    headers:
+      User-Agent:
+      - Estately/1.0
+      Host:
+      - rets.example.com:80
+      Rets-Version:
+      - RETS/1.7.2
+      Authorization:
+      - Digest username="login", realm="fake_realm", qop="auth",
+        uri="/Login.asmx/Login", nonce="17fdfe2c6125296bd93bb81bd88dc4be", nc=00000001,
+        cnonce="ad805b9e2d6f08ad82175085e5febd8d", response="7402076f53663602f052e1aa343d3dab",
+        opaque="aee1e7da-60eb-41b3-b704-8eb3969645fd"
+      Cookie:
+      - ASP.NET_SessionId=vuesmq55l0cpjy45zyn0e555; RETS-Session-ID=vuesmq55l0cpjy45zyn0e555
+      Accept:
+      - image/jpeg, image/png;q=0.5, image/gif;q=0.1
+      Content-Type:
+      - application/x-www-form-urlencoded
+      Content-Length:
+      - '54'
+  response:
+    status:
+      code: 200
+      message: OK
+    headers:
+      Date:
+      - Thu, 26 Jul 2012 00:11:04 GMT
+      Server:
+      - Microsoft-IIS/6.0
+      Cache-Control:
+      - private
+      - private, max-age=0
+      X-Aspnet-Version:
+      - 2.0.50727
+      Mime-Version:
+      - '1.0'
+      Rets-Version:
+      - RETS/1.7.2
+      Rets-Server:
+      - Interealty-RETS/1.5.247.0
+      Content-Id:
+      - '2661580'
+      Object-Id:
+      - '1'
+      Transfer-Encoding:
+      - chunked
+      Set-Cookie:
+      - RETS-Session-ID=vuesmq55l0cpjy45zyn0e555; path=/
+      Content-Type:
+      - image/jpeg
+    body:
+      encoding: ASCII-8BIT
+      string: !binary |-
+        /9j/4AAQSkZJRgABAQEAYABgAAD///2Q==
+    http_version: 
+  recorded_at: Thu, 26 Jul 2012 00:11:14 GMT
+recorded_with: VCR 2.2.2

metadata

@@ -1,119 +1,118 @@
 --- !ruby/object:Gem::Specification
 name: rets
 version: !ruby/object:Gem::Version
-  version: 0.5.1
+  version: 0.6.0
 platform: ruby
 authors:
 - Estately, Inc. Open Source
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-10-30 00:00:00.000000000 Z
+date: 2014-11-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: httpclient
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 2.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 2.3.0
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 1.5.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 1.5.2
 - !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '4.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '4.0'
 - !ruby/object:Gem::Dependency
   name: mocha
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 0.11.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 0.11.0
 - !ruby/object:Gem::Dependency
   name: vcr
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 2.2.2
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 2.2.2
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 1.8.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: 1.8.0
 - !ruby/object:Gem::Dependency
   name: hoe
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.7'
+        version: '3.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.7'
-description: ! '[![Build Status](https://secure.travis-ci.org/estately/rets.png?branch=master)](http://travis-ci.org/estately/rets)
-
+        version: '3.6'
+description: |-
+  [![Build Status](https://secure.travis-ci.org/estately/rets.png?branch=master)](http://travis-ci.org/estately/rets)
   A pure-ruby library for fetching data from [RETS] servers.
 
-
-  [RETS]: http://www.rets.org'
+  [RETS]: http://www.rets.org
 email:
 - opensource@estately.com
 executables:
@@ -124,6 +123,7 @@ extra_rdoc_files:
 - Manifest.txt
 - README.md
 files:
+- ".gemtest"
 - CHANGELOG.md
 - Manifest.txt
 - README.md
@@ -151,34 +151,33 @@ files:
 - test/test_metadata.rb
 - test/test_parser_compact.rb
 - test/test_parser_multipart.rb
-- .gemtest
+- test/vcr_cassettes/unauthorized_response.yml
 homepage: http://github.com/estately/rets
-licenses:
-- MIT
+licenses: []
 metadata: {}
 post_install_message: 
 rdoc_options:
-- --main
+- "--main"
 - README.md
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: rets
-rubygems_version: 2.1.10
+rubygems_version: 2.2.0
 signing_key: 
 specification_version: 4
-summary: ! '[![Build Status](https://secure.travis-ci.org/estately/rets.png?branch=master)](http://travis-ci.org/estately/rets)
-  A pure-ruby library for fetching data from [RETS] servers'
+summary: "[![Build Status](https://secure.travis-ci.org/estately/rets.png?branch=master)](http://travis-ci.org/estately/rets)
+  A pure-ruby library for fetching data from [RETS] servers"
 test_files:
 - test/test_client.rb
 - test/test_locking_http_client.rb