philologic-client 0.0.11 → 0.0.13

data/test/test_client.rb

@@ -0,0 +1,861 @@
+# encoding: utf-8
+
+require 'simplecov'
+SimpleCov.start
+
+require 'philologic-client'
+require 'test/unit'
+require 'mocha'
+
+
+class TestClient < Test::Unit::TestCase
+
+  def setup
+    @test_dir = File.expand_path( File.dirname(__FILE__) )
+    @data_dir = File.expand_path( File.join( @test_dir, 'data' ) )
+    @endpoint = @data_dir
+
+    @biblio_path  = 'bibliography.html'                   # XXX
+    @biblio_file  = File.join( @data_dir, @biblio_path )  # XXX
+
+    @con_path     = 'concordance.html'                    # XXX
+    @con_file     = File.join( @data_dir, @con_path )     # XXX
+
+    @nav_path     = 'navigation.html'                     # XXX
+    @nav_file     = File.join( @data_dir, @nav_path )     # XXX
+
+    @obj_path     = 'object.html'                         # XXX
+    @obj_file     = File.join( @data_dir, @obj_path )     # XXX
+  end
+
+
+  def test_initialization
+   blockable = false
+   client = Philologic::Client.new do |client|
+     assert_kind_of  Philologic::Client, client
+     blockable = true
+   end
+   assert         blockable,          'works as block'
+   assert_kind_of Philologic::Client, client
+   assert_kind_of Philologic::Client, Philologic::Client.new
+ end
+
+ def test_initialization_with_endpoint
+   blockable = false
+   client = Philologic::Client.new(@endpoint) do |client|
+     assert_kind_of  Philologic::Client, client
+     blockable = true
+     assert_not_nil  client.endpoint
+     assert_equal    @endpoint, client.endpoint
+   end
+   assert         blockable,          'works as block'
+   assert_kind_of Philologic::Client, client
+   assert_kind_of Philologic::Client, Philologic::Client.new
+   assert_not_nil  client.endpoint
+   assert_equal    @endpoint, client.endpoint
+ end
+
+ def test_encoding_accessor
+   Philologic::Client.new do |client|
+     assert_equal  Philologic::Client::DEFAULT_ENCODING, client.encoding
+     assert_equal  'foo',                                client.encoding = 'foo'
+     assert_equal  'foo',                                client.encoding
+   end
+ end
+
+ def test_endpoint_accessor
+   Philologic::Client.new do |client|
+     assert_nil   client.endpoint,                        'defaults to nil'
+     assert_equal @endpoint, client.endpoint = @endpoint, 'returns value on set'
+     assert_equal @endpoint, client.endpoint,             'returns value on get'
+   end
+ end
+
+  def test_get_bibliography_without_an_endpoint
+    Philologic::Client.new do |client|
+      assert_raise(RuntimeError, 'nil endpoint') {  client.bibliography }
+    end
+  end
+
+  def test_private_methods
+    Philologic::Client.new(@endpoint) do |client|
+      r = client.send( :_get, @biblio_path )
+      assert_not_nil  r
+      assert_kind_of  Philologic::Client::Bibliography, r
+
+      assert_nil client.send( :_parse, Nokogiri::HTML("") )
+    end
+  end
+
+  def test_get_bibliography
+    Philologic::Client.new(@endpoint) do |client|
+      h = Nokogiri::HTML( open(@biblio_file) )
+      r = client.send( :_parse, Nokogiri::HTML( open(@biblio_file) ) )
+
+      client.stubs(:_get).with('?title=').returns(r)
+      assert_not_nil  r
+
+      b = client.bibliography
+      assert_equal    r,                                b
+      assert_kind_of  Philologic::Client::Bibliography, b
+
+      assert_not_nil  b.titles
+      assert_kind_of  Array,  b.titles
+      assert_equal    42,     b.titles.size
+
+      first = b.titles.first
+      assert_not_nil  first
+      assert_kind_of  Philologic::Client::Occurrence,             first
+      assert_equal    'William Shakespeare',                      first['author']
+      assert_equal    './1/0/0/0/0',                              first['href']
+      assert_equal    'The First Part of King Henry the Fourth',  first['title']
+      assert_equal    '',                                         first['who']
+
+      last = b.titles.last
+      assert_not_nil  last
+      assert_kind_of  Philologic::Client::Occurrence,             last 
+      assert_equal    'William Shakespeare',                      last['author']
+      assert_equal    './42/0/0/0/0',                             last['href']
+      assert_equal    "The Winter's Tale",                        last['title']
+      assert_equal    '',                                         last['who']
+    end
+  end
+
+  def test_get_document_without_path
+    Philologic::Client.new do |client|
+      assert_raise(ArgumentError, 'nil endpoint') { client.document }
+    end
+  end
+
+  def test_get_document_without_an_endpoint
+    Philologic::Client.new do |client|
+      assert_raise(RuntimeError, 'nil endpoint') { client.document(1) }
+    end
+  end
+
+  def test_get_document_that_is_navigation
+    Philologic::Client.new do |client|
+      doc = client.send( :_parse, Nokogiri::HTML( open(@nav_file) ) )
+      client.expects(:_get).with(@nav_path).returns(doc)
+      r   = client.document(@nav_path)
+
+      assert_not_nil  doc
+      assert_equal    doc,                          r
+      assert_kind_of  Philologic::Client::Response, r
+      assert_kind_of  Philologic::Client::Document, r
+
+      assert_not_nil  r.keys
+      assert_kind_of  Array,              r.keys
+      assert_equal    2,                  r.keys.size
+      assert_equal    %w( author title ), r.keys
+
+      r.each_with_index do |k, idx|
+        case  idx
+        when  0
+          assert_equal  'author',               k 
+          assert_equal  'William Shakespeare',  r[k]
+        when  1
+          assert_equal  'title',                                    k 
+          assert_equal  'The First Part of King Henry the Fourth',  r[k]
+        end
+      end
+
+      assert_equal    'William Shakespeare',                      r['author']
+      assert_equal    'The First Part of King Henry the Fourth',  r['title']
+
+      assert          r.links?
+      assert_kind_of  Array,                    r.links
+      assert_equal    26,                       r.links.size
+      assert_kind_of  Philologic::Client::Link, r.links.first
+      assert_equal    './1/2',                  r.links.first.url
+      assert_equal    '',                       r.links.first.text
+      assert_kind_of  Philologic::Client::Link, r.links.last
+      assert_equal    './1/7/6',                r.links.last.url
+      assert_equal    'Act 5, Scene 5',         r.links.last.text
+
+      assert      !r.text?
+      assert_nil  r.text
+      assert_nil  r.html
+    end
+  end
+
+  def test_get_document_that_is_text
+
+    Philologic::Client.new do |client|
+      doc = client.send( :_parse, Nokogiri::HTML( open(@obj_file) ) )
+      client.expects(:_get).with(@obj_path).returns(doc)
+      r   = client.document(@obj_path)
+
+      assert_not_nil  doc
+      assert_equal    doc,                          r
+      assert_kind_of  Philologic::Client::Response, r
+      assert_kind_of  Philologic::Client::Document, r
+
+      assert_not_nil  r.keys
+      assert_kind_of  Array,              r.keys
+      assert_equal    2,                  r.keys.size
+      assert_equal    %w( author title ), r.keys
+
+      r.each_with_index do |k, idx|
+        case  idx
+        when  0
+          assert_equal  'author',               k 
+          assert_equal  'William Shakespeare',  r[k]
+        when  1
+          assert_equal  'title',                                    k 
+          assert_equal  'The First Part of King Henry the Fourth',  r[k]
+        end
+      end
+
+      assert_equal    'William Shakespeare',                      r['author']
+      assert_equal    'The First Part of King Henry the Fourth',  r['title']
+
+      assert          !r.links?
+      assert_kind_of  Array,    r.links
+      assert_equal    0,        r.links.size
+
+      assert                                    r.text?
+      assert_match  /^The First Part of King /, r.text.strip
+      assert_match  /assistants\s+\n The/,      r.text.strip
+      assert_match  /and W\. A\. Wright\.$/,    r.text.strip
+      assert_match  /^The First Part of King /, r.html.strip
+      assert_match  /<p><\/p> The WordHoard/,   r.html.strip
+      assert_match  /and W\. A\. Wright\.$/,    r.html.strip
+    end
+  end
+
+  def test_get_concordance_without_endpoint
+    Philologic::Client.new do |client|
+      assert_raise(RuntimeError, 'nil endpoint') { client.concordance('lion') }
+    end
+  end
+
+  def test_get_concordance
+    Philologic::Client.new do |client|
+      doc = client.send( :_parse, Nokogiri::HTML( open(@con_file) ) )
+      client.expects(:_get).with('?q=lion').returns(doc)
+      r   = client.concordance('lion')
+
+      assert_not_nil  doc
+      assert_equal    doc,                              r
+      assert_kind_of  Philologic::Client::Response,     r
+      assert_kind_of  Philologic::Client::Concordance,  r
+
+      assert          r.results?
+      assert_kind_of  Array,      r.results
+      assert_equal    50,         r.results.size
+
+      first = r.results.first
+      assert_not_nil  first
+      assert_kind_of  Philologic::Client::Occurrence,             first
+      assert_equal    1,                                          first['hit_n']
+      assert_equal    'William Shakespeare',                      first['author']
+      assert_equal    'The First Part of King Henry the Fourth',  first['title']
+      assert_equal    'Prince',                                   first['who']
+      assert          first.text?
+      assert_not_nil  first.text
+      assert_match    /^ cat or a lugged bear/,                   first.text
+      assert_match    /Yea$/,                                     first.text
+      assert_not_nil  first.html
+      assert_match    /^ cat or a lugged bear/,                   first.html
+      assert_match    /Yea$/,                                     first.html
+
+      last = r.results.last
+      assert_not_nil  last
+      assert_kind_of  Philologic::Client::Occurrence, last
+      assert_equal    50,                             last['hit_n']
+      assert_equal    'William Shakespeare',          last['author']
+      assert_equal    "A Midsummer Night's Dream",    last['title']
+      assert_equal    'Bottom',                       last['who']
+
+      assert          last.text?
+      assert_not_nil  last.text
+      assert_match    /^Masters, you ought to /,      last.text.strip
+      assert_match    /for there is not a more$/,     last.text.strip
+      assert_not_nil  last.html
+      assert_match    /^Masters, you ought to /,      last.html.strip
+      assert_match    /for there is not a more$/,     last.html.strip
+    end
+  end
+
+  def test_get_concordance_with_query_parameters
+    Philologic::Client.new do |client|
+      doc = client.send( :_parse, Nokogiri::HTML( open(@con_file) ) )
+      client.expects(:_get).with('?foo=bar&q=lion').returns(doc)
+      r   = client.concordance( :foo => 'bar', :q => 'lion' )
+
+      assert_not_nil  doc
+      assert_equal    doc,                              r
+      assert_kind_of  Philologic::Client::Response,     r
+      assert_kind_of  Philologic::Client::Concordance,  r
+
+      assert          r.results?
+      assert_kind_of  Array,      r.results
+      assert_equal    50,         r.results.size
+
+      first = r.results.first
+      assert_not_nil  first
+      assert_kind_of  Philologic::Client::Occurrence,             first
+      assert_equal    1,                                          first['hit_n']
+      assert_equal    'William Shakespeare',                      first['author']
+      assert_equal    'The First Part of King Henry the Fourth',  first['title']
+      assert_equal    'Prince',                                   first['who']
+      assert          first.text?
+      assert_not_nil  first.text
+      assert_match    /^ cat or a lugged bear/,                   first.text
+      assert_match    /Yea$/,                                     first.text
+      assert_not_nil  first.html
+      assert_match    /^ cat or a lugged bear/,                   first.html
+      assert_match    /Yea$/,                                     first.html
+
+      last = r.results.last
+      assert_not_nil  last
+      assert_kind_of  Philologic::Client::Occurrence, last
+      assert_equal    50,                             last['hit_n']
+      assert_equal    'William Shakespeare',          last['author']
+      assert_equal    "A Midsummer Night's Dream",    last['title']
+      assert_equal    'Bottom',                       last['who']
+
+      assert          last.text?
+      assert_not_nil  last.text
+      assert_match    /^Masters, you ought to /,      last.text.strip
+      assert_match    /for there is not a more$/,     last.text.strip
+      assert_not_nil  last.html
+      assert_match    /^Masters, you ought to /,      last.html.strip
+      assert_match    /for there is not a more$/,     last.html.strip
+    end
+  end
+  def test_underscore_build_query_with_invalid_queries
+    Philologic::Client.new(@endpoint) do |client|
+      assert_raise(RuntimeError, 'no query specified') { client.send(:_build_query, nil)   }
+      assert_raise(RuntimeError, 'no query specified') { client.send(:_build_query, {})    }
+      assert_raise(RuntimeError, 'no query specified') { client.send(:_build_query, [])    }
+      assert_raise(RuntimeError, 'no query specified') { client.send(:_build_query, '')    }
+      assert_raise(RuntimeError, 'no query specified') { client.send(:_build_query, 'foo') }
+    end
+  end
+
+  def test_get_frequency_without_endpoint
+    Philologic::Client.new do |client|
+      assert_raise(RuntimeError, 'nil endpoint') { client.frequency('lion') }
+    end
+  end
+
+  def test_get_frequency
+    Philologic::Client.new do |client|
+      doc = client.send( :_parse, Nokogiri::HTML( open( File.join( @data_dir, 'frequency.html' ) ) ) )
+      client.expects(:_get).with('?q=lion&report=frequency').returns(doc)
+      r   = client.frequency('lion')
+
+      assert_not_nil  doc
+      assert_equal    doc,                            r
+      assert_kind_of  Philologic::Client::Response,   r
+      assert_kind_of  Philologic::Client::Frequency,  r
+
+      assert          r.results?
+      assert_not_nil  r.results
+      assert_kind_of  Array,                          r.results
+      assert_equal    29,                             r.results.size
+
+      first = r.results.first
+      assert_not_nil  first
+      assert_kind_of  Philologic::Client::FrequencyRow,               first
+      assert_equal    "A Midsummer Night's Dream",                    first.label
+      assert_equal    './?q=lion&title=A+Midsummer+Night%27s+Dream',  first.link
+      assert_equal    '30',                                           first.value
+
+      last = r.results.last
+      assert_not_nil  last
+      assert_kind_of  Philologic::Client::FrequencyRow,               last
+      assert_equal    'As You Like It',                               last.label
+      assert_equal    './?q=lion&title=As+You+Like+It',               last.link
+      assert_equal    '1',                                            last.value
+      end
+  end
+
+  def test_get_frequency_with_query_parameters
+    Philologic::Client.new do |client|
+      doc = client.send( :_parse, Nokogiri::HTML( open( File.join( @data_dir, 'frequency.html' ) ) ) )
+      client.expects(:_get).with('?foo=bar&q=lion&report=frequency').returns(doc)
+      r   = client.frequency( :q => 'lion', :foo => 'bar' )
+
+      assert_not_nil  doc
+      assert_equal    doc,                            r
+      assert_kind_of  Philologic::Client::Response,   r
+      assert_kind_of  Philologic::Client::Frequency,  r
+
+      assert          r.results?
+      assert_not_nil  r.results
+      assert_kind_of  Array,                          r.results
+      assert_equal    29,                             r.results.size
+
+      first = r.results.first
+      assert_not_nil  first
+      assert_kind_of  Philologic::Client::FrequencyRow,               first
+      assert_equal    "A Midsummer Night's Dream",                    first.label
+      assert_equal    './?q=lion&title=A+Midsummer+Night%27s+Dream',  first.link
+      assert_equal    '30',                                           first.value
+
+      last = r.results.last
+      assert_not_nil  last
+      assert_kind_of  Philologic::Client::FrequencyRow,               last
+      assert_equal    'As You Like It',                               last.label
+      assert_equal    './?q=lion&title=As+You+Like+It',               last.link
+      assert_equal    '1',                                            last.value
+      end
+  end
+# def test_get_children_without_an_endpoint
+#   Philologic::Client.new do |client|
+#     assert_raises(RuntimeError) { client.children }
+#   end
+# end
+
+
+# # TODO What are we actually testing here?
+#  def test_get_children
+#    Philologic::Client.new do |client|
+#      h = Nokogiri::HTML( open(@root_file) )
+#      children = client.send( :_parse, Nokogiri::HTML( open(@root_file) ) )
+#      client.stubs(:_get).with('/?title=').returns(children)
+#      assert_not_nil  children
+#      assert_equal    children, client.children
+#    end
+#  end
+
+#  def test_parse_children
+#    Philologic::Client.new do |client|
+#      client.endpoint = @endpoint
+#      children        = client.children(@root_path)  
+#      assert_not_nil  children
+#      assert_kind_of  Array,  children
+#      assert_equal    1845,   children.size
+#      children.each do |child|
+#        assert_kind_of  Philologic::Link,   child
+#        assert_equal    'philologic_cite',  child['class']
+#        assert_not_nil  child['href']
+#        assert_nil      child['some random attribute']
+#        assert_not_nil  child['author']
+#        assert_not_nil  child['filename']
+#        assert_not_nil  child['title']
+#        assert_not_nil  child.text
+#      end
+#
+#      assert_equal  './1/0/0/0/0/0/0',                          children.first['href']
+#      assert_equal  'Conon, de Béthune, ca. 1160-1219 or 20.',  children.first['author']
+#      assert_equal  'Les Chansons',                             children.first['title']
+#      assert_equal  'TLF.0.tei',                                children.first['filename']
+#      assert_match  /^Conon, de Béthune, ca. 1160-1219 or 20./, children.first.text
+#      assert_equal  './1/0/0/0/0/0/0',                          children.first.to_s
+#
+#      assert_equal  './1845/0/0/0/0/0/0',                   children.last['href']
+#      assert_equal  'Sartre J.-P.',                         children.last['author']
+#      assert_equal  'Les Mots',                             children.last['title']
+#      assert_equal  'TLF.1879.tei',                         children.last['filename']
+#      assert_equal  "Sartre J.-P., Les Mots: TLF.1879.tei", children.last.text
+#      assert_equal  './1845/0/0/0/0/0/0',                   children.last.to_s
+#
+#    end
+#  end
+
+#  def test_parse_document
+#    Philologic::Client.new do |client|
+#      client.endpoint = @endpoint
+#      doc             = client.document(@doc_path)  
+#      assert_not_nil  doc
+#
+#      assert_kind_of  Philologic::Document,                       doc
+#      assert_equal    'philologic_object',                        doc['class']
+#      assert_nil      doc['some random attribute']
+#      assert_kind_of  String,                                     doc.html
+#      assert_match    /^<div class="context_container" id="1">/,  doc.html
+#      assert_match    %r{par tans la verité."      </div>},       doc.html
+#      assert_kind_of  String,                                     doc.text
+#      assert_match    /^Conon, de Béthune/,                       doc.text
+#      assert_match    /verité."      $/,                          doc.text
+#    end
+#  end
+
+#  def test_get_document_from_cite_through_client
+#    Philologic::Client.new do |client|
+#      client.endpoint = @endpoint
+#      child           = client.children(@root_path).first
+#      assert_not_nil  child
+#      assert_kind_of  Philologic::Link, child
+#      doc = client.send( :_parse, Nokogiri::HTML( open(@doc_file) ) )
+#      client.stubs(:_get).with('./1/0/0/0/0/0/0').returns(doc) # TODO Improve
+#      assert_equal    doc, client.document( child['href'] )
+#    end
+#  end
+
+#  def test_get_document_from_cite
+#    Philologic::Client.new do |client|
+#      client.endpoint = @endpoint
+#      child           = client.children(@root_path).first
+#      assert_not_nil  child
+#      assert_kind_of  Philologic::Link, child
+#      doc = client.send( :_parse, Nokogiri::HTML( open(@doc_file) ) )
+#      client.stubs(:_get).with('./1/0/0/0/0/0/0').returns(doc) # TODO Improve
+#      assert_equal    doc, child.document
+#    end
+#  end
+
+# def test_underscore_query
+#   Philologic::Client.new(@endpoint) do |client|
+#     doc = client.send( :_parse, Nokogiri::HTML( open(@query_file) ) )
+#     client.stubs(:_get).with('?q=lion').returns(doc)
+#     assert_equal  doc, client.send( :_query, :q => 'lion' )
+#   end
+# end
+
+#   Philologic::Client.new(@endpoint) do |client|
+#     assert_equal '?q=lion',         client.send( :_build_query, :q => 'lion' )
+#     assert_equal '?foo=bar&q=lion', client.send( :_build_query, :q => 'lion', :foo => 'bar' )
+#   end
+# end
+
+# def test_search_with_invalid_queries
+#   Philologic::Client.new(@endpoint) do |client|
+#     [ nil, [], {}, '', [ '' ], [ nil ], Object.new ].each do |q|
+#       assert_raise(RuntimeError, 'invalid query') { client.search(q) }
+#     end
+#   end
+# end
+
+# def test_search
+#   Philologic::Client.new(@endpoint) do |client|
+#     doc = client.send( :_parse, Nokogiri::HTML( open(@query_file) ) )
+#     client.stubs(:_get).with('?q=lion').returns(doc)
+
+#     results = client.search('lion')
+
+#     assert_not_nil  results
+#     assert_kind_of  Array, results
+#     assert_equal    50,    results.size
+#     results.each do |result|
+#       assert_kind_of  Philologic::Link,       result
+#       assert_equal   'philologic_occurrence', result['class']
+#       assert_not_nil  result['href']
+#       assert_nil      result['some random attribute']
+#       assert_not_nil  result['author']
+#       assert_not_nil  result['hit_n']
+#       assert_nil      result['filename']
+#       assert_not_nil  result['title']
+#       assert_not_nil  result.text
+#    end
+
+#     assert_equal  './1/3/3/1/25/?byte=33845',                 results.first['href']
+#     assert_equal  'William Shakespeare',                      results.first['author']
+#     assert_equal  'The First Part of King Henry the Fourth',  results.first['title']
+#     assert_equal  '1',                                        results.first['hit_n']
+#     assert_match  /^1\. William Shakespeare, The First Part/, results.first.text
+#     assert_match  './1/3/3/1/25/?byte=33845',                 results.first.to_s
+
+#     assert_equal  './24/5/2/1/14/?byte=124024', results.last['href']
+#     assert_equal  'William Shakespeare',        results.last['author']
+#     assert_equal  "A Midsummer Night's Dream",  results.last['title']
+#     assert_equal  '50',                         results.last['hit_n']
+#     assert_match  /^50\. William Shakespeare,/, results.last.text
+#     assert_equal  './24/5/2/1/14/?byte=124024', results.last.to_s
+
+#   end
+# end
+
+# def test_search_with_key_value_pairs
+#   Philologic::Client.new(@endpoint) do |client|
+#     doc = client.send( :_parse, Nokogiri::HTML( open(@query_file) ) )
+#     client.stubs(:_get).with('?q=lion').returns(doc)
+
+#     results = client.search( :q => 'lion' )
+
+#     assert_not_nil  results
+#     assert_kind_of  Array, results
+#     assert_equal    50,    results.size
+#     results.each do |result|
+#       assert_kind_of  Philologic::Link,       result
+#       assert_equal   'philologic_occurrence', result['class']
+#       assert_not_nil  result['href']
+#       assert_nil      result['some random attribute']
+#       assert_not_nil  result['author']
+#       assert_nil      result['filename']
+#       assert_not_nil  result['hit_n']
+#       assert_not_nil  result['title']
+#       assert_not_nil  result.text
+#     end
+
+#     assert_equal  './1/3/3/1/25/?byte=33845',                 results.first['href']
+#     assert_equal  'William Shakespeare',                      results.first['author']
+#     assert_equal  'The First Part of King Henry the Fourth',  results.first['title']
+#     assert_equal  '1',                                        results.first['hit_n']
+#     assert_match  /^1\. William Shakespeare, The First Part/, results.first.text
+#     assert_match  './1/3/3/1/25/?byte=33845',                 results.first.to_s
+
+#     assert_equal  './24/5/2/1/14/?byte=124024', results.last['href']
+#     assert_equal  'William Shakespeare',        results.last['author']
+#     assert_equal  '50',                         results.last['hit_n']
+#     assert_equal  "A Midsummer Night's Dream",  results.last['title']
+#     assert_match  /^50\. William Shakespeare,/, results.last.text
+#     assert_equal  './24/5/2/1/14/?byte=124024', results.last.to_s
+
+#   end
+# end
+
+# def test_frequency_search_with_invalid_queries
+#   Philologic::Client.new(@endpoint) do |client|
+#     [ nil, [], {}, '', [ '' ], [ nil ], Object.new ].each do |q|
+#       assert_raise(RuntimeError, 'invalid query') { client.frequency(q) }
+#     end
+#   end
+# end
+
+#  def test_frequency_search
+#    Philologic::Client.new(@endpoint) do |client|
+#      doc = client.send( :_parse, Nokogiri::HTML( open(@freq_file) ) )
+#      client.stubs(:_get).with('?q=lion&report=frequency').returns(doc)
+#
+#      results = client.frequency('lion')
+#
+#      assert_not_nil  results
+#      assert_kind_of  Array, results
+#      assert_equal    15,    results.size
+#      results.each do |result|
+#        assert_kind_of  Philologic::TableRow, result
+#        assert_equal    'philologic_frequency_row', result['class']
+#        assert_nil      result['href']
+#        assert_nil      result['some random attribute']
+#        assert_nil      result['author']
+#        assert_nil      result['filename']
+#        assert_nil      result['title']
+#        assert_not_nil  result.count
+#        assert_not_nil  result.field
+#        assert_not_nil  result.href
+#        assert_not_nil  result.text
+#      end
+#
+#      assert_equal  'author',                                       results.first.field
+#      assert_equal  48,                                             results.first.count
+#      assert_equal  './?q=lion&author=Beauvoir+S.+de&title=', results.first.href
+#      assert_equal  'Beauvoir S. de',                               results.first.text
+#      assert_equal  'author | 48 | Beauvoir S. de',                 results.first.to_s
+#
+#      assert_equal  'author',                                     results.last.field
+#      assert_equal  1,                                            results.last.count
+#      assert_equal  './?q=lion&author=Schaeffer+P.&title=', results.last.href
+#      assert_equal  'Schaeffer P.',                               results.last.text
+#      assert_equal  'author | 1 | Schaeffer P.',                  results.last.to_s
+#    end
+#  end
+
+#  def test_frequency_search_with_key_value_pairs
+#    Philologic::Client.new(@endpoint) do |client|
+#      doc = client.send( :_parse, Nokogiri::HTML( open(@freq_file) ) )
+#      client.stubs(:_get).with('?q=lion&report=frequency').returns(doc)
+#
+#      results = client.frequency( :q => 'lion' )
+#
+#      assert_not_nil  results
+#      assert_kind_of  Array, results
+#      assert_equal    15,    results.size
+#      results.each do |result|
+#        assert_kind_of  Philologic::TableRow, result
+#        assert_equal    'philologic_frequency_row', result['class']
+#        assert_nil      result['href']
+#        assert_nil      result['some random attribute']
+#        assert_nil      result['author']
+#        assert_nil      result['filename']
+#        assert_nil      result['title']
+#        assert_not_nil  result.count
+#        assert_not_nil  result.field
+#        assert_not_nil  result.href
+#        assert_not_nil  result.text
+#      end
+#
+#      assert_equal  'author',                                       results.first.field
+#      assert_equal  48,                                             results.first.count
+#      assert_equal  './?q=lion&author=Beauvoir+S.+de&title=', results.first.href
+#      assert_equal  'Beauvoir S. de',                               results.first.text
+#      assert_equal  'author | 48 | Beauvoir S. de',                 results.first.to_s
+#
+#      assert_equal  'author',                                     results.last.field
+#      assert_equal  1,                                            results.last.count
+#      assert_equal  './?q=lion&author=Schaeffer+P.&title=', results.last.href
+#      assert_equal  'Schaeffer P.',                               results.last.text
+#      assert_equal  'author | 1 | Schaeffer P.',                  results.last.to_s
+#
+#    end
+#  end
+
+#  def test_philologic_frequency_tablerow_links
+#    Philologic::Client.new(@endpoint) do |client|
+#      freq_doc       = client.send( :_parse, Nokogiri::HTML( open(@freq_file) ) )
+#      freq_links_doc = client.send( :_parse, Nokogiri::HTML( open(@freq_links_file) ) )
+#      client.stubs(:_get).with('?q=lion&report=frequency').returns(freq_doc)
+#      client.stubs(:_get).with('?author=Beauvoir+S.+de&q=lion&title=').returns(freq_links_doc)
+#
+#      results = client.frequency( :q => 'lion' )
+#      assert_not_nil results
+#
+#      links = results.first.links
+#
+#      assert_not_nil  links
+#      assert_kind_of  Array, links
+#      assert_equal    48,    links.size
+#
+#      links.each do |link|
+#        assert_kind_of  Philologic::Link, link
+#        assert_equal    'philologic_occurence', link['class']
+#        assert_not_nil  link['href']
+#        assert_nil      link['some random attribute']
+#        assert_not_nil  link['author']
+#        assert_nil      link['filename']
+#        assert_not_nil  link['title']
+#        assert_not_nil  link.text
+#      end
+#
+#      assert_equal  './1839/3/0/0',                 links.first['href']
+#      assert_equal  'Beauvoir S. de',               links.first['author']
+#      assert_equal  'Memoires Jeune Fille Rangee',  links.first['title']
+#      assert_nil    links.first['filename']
+#      assert_match  /^Beauvoir S. de/,              links.first.text
+#      assert_equal  './1839/3/0/0 | Memoires Jeune Fille Rangee | Beauvoir S. de', links.first.to_s
+#
+#      assert_equal  './1839/4/0/0',                 links.last['href']
+#      assert_equal  'Beauvoir S. de',               links.last['author']
+#      assert_equal  'Memoires Jeune Fille Rangee',  links.last['title']
+#      assert_nil    links.last['filename']
+#      assert_match  /^Beauvoir S. de,/,             links.last.text
+#      assert_equal  './1839/4/0/0 | Memoires Jeune Fille Rangee | Beauvoir S. de', links.last.to_s
+#
+#    end
+#  end
+
+# def test_collocation_search_with_invalid_queries
+#   Philologic::Client.new(@endpoint) do |client|
+#     [ nil, [], {}, '', [ '' ], [ nil ], Object.new ].each do |q|
+#       assert_raise(RuntimeError, 'invalid query') { client.collocation(q) }
+#     end
+#   end
+# end
+
+#  def test_collocation_search
+#    Philologic::Client.new(@endpoint) do |client|
+#      doc = client.send( :_parse, Nokogiri::HTML( open(@coll_file) ) )
+#      client.stubs(:_get).with('?field=collocates&q=lion&report=frequency').returns(doc)
+#
+#      results = client.collocation('lion')
+#
+#      assert_not_nil  results
+#      assert_kind_of  Array, results
+#      assert_equal    15,    results.size
+#      results.each do |result|
+#        assert_kind_of  Philologic::TableRow, result
+#        assert_equal    'philologic_frequency_row', result['class']
+#        assert_nil      result['href']
+#        assert_nil      result['some random attribute']
+#        assert_nil      result['author']
+#        assert_nil      result['filename']
+#        assert_nil      result['title']
+#        assert_not_nil  result.count
+#        assert_not_nil  result.field
+#        assert_not_nil  result.href
+#        assert_not_nil  result.text
+#      end
+#
+#      assert_equal  'author',                                       results.first.field
+#      assert_equal  48,                                             results.first.count
+#      assert_equal  './?q=lion&author=Beauvoir+S.+de&title=', results.first.href
+#      assert_equal  'Beauvoir S. de',                               results.first.text
+#      assert_equal  'author | 48 | Beauvoir S. de',                 results.first.to_s
+#
+#      assert_equal  'author',                                     results.last.field
+#      assert_equal  1,                                            results.last.count
+#      assert_equal  './?q=lion&author=Schaeffer+P.&title=', results.last.href
+#      assert_equal  'Schaeffer P.',                               results.last.text
+#      assert_equal  'author | 1 | Schaeffer P.',                  results.last.to_s
+#    end
+#  end
+
+#  def test_collocation_search_with_key_value_pairs
+#    Philologic::Client.new(@endpoint) do |client|
+#      doc = client.send( :_parse, Nokogiri::HTML( open(@coll_file) ) )
+#      client.stubs(:_get).with('?field=collocates&q=lion&report=frequency').returns(doc)
+#
+#      results = client.collocation( :q => 'lion' )
+#
+#      assert_not_nil  results
+#      assert_kind_of  Array, results
+#      assert_equal    15,    results.size
+#      results.each do |result|
+#        assert_kind_of  Philologic::TableRow, result
+#        assert_equal    'philologic_frequency_row', result['class']
+#        assert_nil      result['href']
+#        assert_nil      result['some random attribute']
+#        assert_nil      result['author']
+#        assert_nil      result['filename']
+#        assert_nil      result['title']
+#        assert_not_nil  result.count
+#        assert_not_nil  result.field
+#        assert_not_nil  result.href
+#        assert_not_nil  result.text
+#      end
+#
+#      assert_equal  'author',                                       results.first.field
+#      assert_equal  48,                                             results.first.count
+#      assert_equal  './?q=lion&author=Beauvoir+S.+de&title=', results.first.href
+#      assert_equal  'Beauvoir S. de',                               results.first.text
+#      assert_equal  'author | 48 | Beauvoir S. de',                 results.first.to_s
+#
+#      assert_equal  'author',                                     results.last.field
+#      assert_equal  1,                                            results.last.count
+#      assert_equal  './?q=lion&author=Schaeffer+P.&title=', results.last.href
+#      assert_equal  'Schaeffer P.',                               results.last.text
+#      assert_equal  'author | 1 | Schaeffer P.',                  results.last.to_s
+#
+#    end
+#  end
+
+#  def test_philologic_collocation_tablerow_links
+#    Philologic::Client.new(@endpoint) do |client|
+#      coll_doc       = client.send( :_parse, Nokogiri::HTML( open(@coll_file) ) )
+#      coll_links_doc = client.send( :_parse, Nokogiri::HTML( open(@coll_links_file) ) )
+#      client.stubs(:_get).with('?field=collocates&q=lion&report=frequency').returns(coll_doc)
+#      client.stubs(:_get).with('?author=Beauvoir+S.+de&q=lion&title=').returns(coll_links_doc)
+#
+#      results = client.collocation( :q => 'lion' )
+#      assert_not_nil results
+#
+#      links = results.first.links
+#
+#      assert_not_nil  links
+#      assert_kind_of  Array, links
+#      assert_equal    48,    links.size
+#
+#      links.each do |link|
+#        assert_kind_of  Philologic::Link, link
+#        assert_equal    'philologic_occurence', link['class']
+#        assert_not_nil  link['href']
+#        assert_nil      link['some random attribute']
+#        assert_not_nil  link['author']
+#        assert_nil      link['filename']
+#        assert_not_nil  link['title']
+#        assert_not_nil  link.text
+#      end
+#
+#      assert_equal  './1839/3/0/0',                 links.first['href']
+#      assert_equal  'Beauvoir S. de',               links.first['author']
+#      assert_equal  'Memoires Jeune Fille Rangee',  links.first['title']
+#      assert_nil    links.first['filename']
+#      assert_match  /^Beauvoir S. de/,              links.first.text
+#      assert_equal  './1839/3/0/0 | Memoires Jeune Fille Rangee | Beauvoir S. de', links.first.to_s
+#
+#      assert_equal  './1839/4/0/0',                 links.last['href']
+#      assert_equal  'Beauvoir S. de',               links.last['author']
+#      assert_equal  'Memoires Jeune Fille Rangee',  links.last['title']
+#      assert_nil    links.last['filename']
+#      assert_match  /^Beauvoir S. de/,              links.last.text
+#      assert_equal  './1839/4/0/0 | Memoires Jeune Fille Rangee | Beauvoir S. de', links.last.to_s
+#
+#    end
+#  end
+
+end
+