laco-www-delicious 0.3.2

data/test/bundle_test.rb

@@ -0,0 +1,63 @@
+# 
+# = WWW::Delicious
+#
+# Ruby client for del.icio.us API.
+# 
+#
+# Category::    WWW
+# Package::     WWW::Delicious
+# Author::      Simone Carletti <weppos@weppos.net>
+# License::     MIT License
+#
+#--
+#
+#++
+
+
+require 'test_helper'
+require 'www/delicious/bundle'
+
+
+class BundleTest < Test::Unit::TestCase
+  
+  def test_bundle
+    expected = { :name => 'MyTag', :tags => %w(foo bar) }
+    assert_attributes(instance(expected), expected)
+  end
+  
+  def test_tag_from_rexml
+    dom = REXML::Document.new(File.read(TESTCASES_PATH + '/element/bundle.xml'))
+    expected = { :name => 'music', :tags => %w(ipod mp3 music) }
+    
+    element = WWW::Delicious::Bundle.from_rexml(dom.root)
+    assert_attributes(element, expected)
+  end
+  
+  
+  def test_bundle_name_strips_whitespaces
+    [' foo   ', 'foo  ', ' foo ', '  foo'].each do |v|
+      assert_equal('foo', instance(:name => v).name) # => 'foo'
+    end
+  end
+  
+  def test_to_s_returns_name_as_string
+    assert_equal('foobar', instance(:name => 'foobar', :tags => %w(foo bar)).to_s)
+  end
+  
+  def test_to_s_returns_empty_string_with_name_nil
+    assert_equal('', instance(:name => nil).to_s)
+  end
+  
+  
+  # def test_valid
+  # end
+  
+  
+  protected
+  
+    # returns a stub instance
+    def instance(values = {}, &block)
+      WWW::Delicious::Bundle.new(values)
+    end
+
+end

data/test/delicious_test.rb

@@ -0,0 +1,370 @@
+# 
+# = WWW::Delicious
+#
+# Ruby client for del.icio.us API.
+# 
+#
+# Category::    WWW
+# Package::     WWW::Delicious
+# Author::      Simone Carletti <weppos@weppos.net>
+# License::     MIT License
+#
+#--
+#
+#++
+
+
+require 'test_helper'
+
+
+class DeliciousTest < Test::Unit::TestCase
+  
+  TEST_USERNAME = 'username'
+  TEST_PASSWORD = 'password'
+  
+  def setup
+    @delicious = instance
+  end
+  
+  def test_initialize_should_raise_without_account
+    assert_raise(ArgumentError) { WWW::Delicious.new() }
+    assert_raise(ArgumentError) { WWW::Delicious.new(TEST_USERNAME) }
+  end
+  
+  def test_initialize_should_set_account_credentials
+    assert_equal(TEST_USERNAME, @delicious.username)
+    assert_equal(TEST_PASSWORD, @delicious.password)
+  end
+  
+  def test_initialize_should_allow_option_user_agent
+    useragent = 'MyClass/1.0 (Foo/Bar +http://foo.com/)'
+    delicious = instance(:user_agent => useragent)
+    assert_equal(useragent, delicious.user_agent)
+  end
+  
+  def test_initialize_should_default_option_user_agent_unless_option
+    useragent = instance.user_agent
+    assert_match("Ruby/#{RUBY_VERSION}", useragent)
+    assert_match("#{WWW::Delicious::NAME}/#{WWW::Delicious::VERSION}", useragent)
+  end
+  
+  def test_initialize_should_allow_option_base_uri
+    base_uri = 'https://ma.gnolia.com/api/mirrord'
+    delicious = instance(:base_uri => base_uri)
+    assert_equal(URI.parse(base_uri), delicious.base_uri)
+  end
+  
+  def test_initialize_should_default_option_base_uri_unless_option
+    base_uri = instance.base_uri
+    assert_equal(URI.parse('https://api.del.icio.us'), base_uri)
+  end
+  
+  
+  # =========================================================================
+  # HTTP Request common checks
+  # =========================================================================
+  
+  def test_request_raises_without_http_client
+    @delicious.http_client = nil
+    assert_raise(WWW::Delicious::Error) { @delicious.update }
+  end
+
+  def test_request_waits_necessary_time_between_requests
+    @delicious.expects(:make_request).times(4).returns(load_fixture('/net_response_success.yml'))
+    @delicious.valid_account?   # 1st request
+    3.times do |time|
+      lr = @delicious.instance_variable_get(:@last_request)
+      @delicious.valid_account? # N request
+      nr = @delicious.instance_variable_get(:@last_request)
+      time_diff = (nr - lr)
+      assert !(time_diff < WWW::Delicious::SECONDS_BEFORE_NEW_REQUEST), 
+            "Request ##{time} run after `#{time_diff}' seconds " +
+            "but it should wait at least `#{WWW::Delicious::SECONDS_BEFORE_NEW_REQUEST}' seconds"
+    end
+  end
+  
+  
+  def test_valid_account
+    @delicious.expects(:make_request).once.returns(load_fixture('/net_response_success.yml'))
+    assert(@delicious.valid_account?)
+  end
+  
+  def test_invalid_account
+    @delicious.expects(:make_request).once.returns(load_fixture('/net_response_invalid_account.yml'))
+    assert(!@delicious.valid_account?)
+  end
+  
+  
+  # =========================================================================
+  # Update
+  # =========================================================================
+  
+  def test_update
+    @delicious.expects(:request).once.returns(mock_response('/response/update.xml'))
+    assert_equal(@delicious.update, Time.parse("2008-08-02T11:55:35Z"))
+  end
+  
+  def test_update_raises_without_update_root_node
+    @delicious.expects(:request).once.returns(mock_response('/response/bundles_all.xml'))
+    error = assert_raise(WWW::Delicious::ResponseError) do
+      @delicious.update
+    end
+    assert_match(/`update`/, error.message)
+  end  
+  
+  def test_update_delicious1
+    @delicious.expects(:request).once.returns(mock_response('/response/update.delicious1.xml'))
+    assert_equal(@delicious.update, Time.parse("2008-03-12T08:41:20Z"))
+  end
+  
+  
+  # =========================================================================
+  # Bundles
+  # =========================================================================
+  
+  def test_bundles_all
+    @delicious.expects(:request).once.returns(mock_response('/response/bundles_all.xml'))
+    expected = [ ['music', %w(ipod mp3 music)], ['pc', %w(computer software hardware)] ]
+    
+    results = @delicious.bundles_all
+    assert_instance_of(Array, results)
+    assert_equal(2, results.length)
+    
+    results.each_with_index do |bundle, index|
+      assert_instance_of(WWW::Delicious::Bundle, bundle)
+      name, tags = expected[index]
+      assert_equal(name, bundle.name)
+      assert_equal(tags, bundle.tags)
+    end
+  end
+  
+  def test_bundles_all_empty
+    @delicious.expects(:request).once.returns(mock_response('/response/bundles_all_empty.xml'))
+    results = @delicious.bundles_all
+    assert_instance_of(Array, results)
+    assert_equal(0, results.length)
+  end
+  
+  def test_bundles_all_raises_without_bundles_root_node
+    @delicious.expects(:request).once.returns(mock_response('/response/update.xml'))
+    error = assert_raise(WWW::Delicious::ResponseError) do
+      @delicious.bundles_all
+    end
+    assert_match(/`bundles`/, error.message)
+  end
+  
+  
+  def test_bundles_set
+    @delicious.expects(:request).once.returns(mock_response('/response/bundles_set.xml'))
+    assert(@delicious.bundles_set('name', %w(foo bar)))
+  end
+  
+  def test_bundles_set_raises_with_response_error
+    @delicious.expects(:request).once.returns(mock_response('/response/bundles_set_error.xml'))
+    error = assert_raise(WWW::Delicious::Error) do
+      @delicious.bundles_set('name', %w(foo bar))
+    end
+    assert_match(/you must supply a bundle name/, error.message)
+  end
+  
+  def test_bundles_set_raises_without_result_root_node
+    @delicious.expects(:request).once.returns(mock_response('/response/update.xml'))
+    error = assert_raise(WWW::Delicious::ResponseError) do
+      @delicious.bundles_set('name', %w(foo bar))
+    end
+    assert_match(/`result`/, error.message)
+  end
+  
+  
+  def test_bundles_delete
+    @delicious.expects(:request).once.returns(mock_response('/response/bundles_delete.xml'))
+    assert(@delicious.bundles_delete('name'))
+  end
+  
+  def test_bundles_delete_raises_without_result_root_node
+    @delicious.expects(:request).once.returns(mock_response('/response/update.xml'))
+    error = assert_raise(WWW::Delicious::ResponseError) do
+      @delicious.bundles_delete('name')
+    end
+    assert_match(/`result`/, error.message)
+  end
+  
+  
+  # =========================================================================
+  # Tags
+  # =========================================================================
+
+  def test_tags_get
+    @delicious.expects(:request).once.returns(mock_response('/response/tags_get.xml'))
+    expected = [ ['activedesktop', 1], ['business', 14] ]
+    
+    results = @delicious.tags_get
+    assert_instance_of(Array, results)
+    assert_equal(2, results.length)
+    
+    results.each_with_index do |tag, index|
+      assert_instance_of(WWW::Delicious::Tag, tag)
+      name, count = expected[index]
+      assert_equal(name, tag.name)
+      assert_equal(count, tag.count)
+    end
+  end
+
+  def test_tags_get_empty
+    @delicious.expects(:request).once.returns(mock_response('/response/tags_get_empty.xml'))
+    results = @delicious.tags_get
+    assert_instance_of(Array, results)
+    assert_equal(0, results.length)
+  end
+  
+  def test_tags_get_raises_without_bundles_root_node
+    @delicious.expects(:request).once.returns(mock_response('/response/update.xml'))
+    error = assert_raise(WWW::Delicious::ResponseError) do
+      @delicious.tags_get
+    end
+    assert_match(/`tags`/, error.message)
+  end
+  
+  
+  def test_tags_rename
+    @delicious.expects(:request).once.returns(mock_response('/response/tags_rename.xml'))
+    assert(@delicious.tags_rename('old', 'new'))
+  end
+  
+  def test_tags_rename_raises_without_result_root_node
+    @delicious.expects(:request).once.returns(mock_response('/response/update.xml'))
+    error = assert_raise(WWW::Delicious::ResponseError) do
+      @delicious.tags_rename('foo', 'bar')
+    end
+    assert_match(/`result`/, error.message)
+  end
+  
+  
+  # =========================================================================
+  # Posts
+  # =========================================================================
+  
+  def test_posts_get
+    @delicious.expects(:request).once.returns(mock_response('/response/posts_get.xml'))
+    results = @delicious.posts_get
+    assert_instance_of(Array, results)
+    assert_equal(3, results.length)
+    assert_equal('New to Git? - GitHub', results.first.title)
+    assert_equal('.c( whytheluckystiff )o. -- The Fully Upturned Bin', results.last.title)
+  end
+  
+  def test_posts_get_raises_without_posts_root_node
+    @delicious.expects(:request).once.returns(mock_response('/response/update.xml'))
+    error = assert_raise(WWW::Delicious::ResponseError) do
+      @delicious.posts_get
+    end
+    assert_match(/`posts`/, error.message)
+  end
+  
+  
+  def test_posts_recent
+    @delicious.expects(:request).once.returns(mock_response('/response/posts_recent.xml'))
+    results = @delicious.posts_recent
+    assert_instance_of(Array, results)
+    assert_equal(15, results.length)
+    assert_equal('New to Git? - GitHub', results.first.title)
+    assert_equal('RichText | Lightview for modal dialogs on Rails', results.last.title)
+  end
+  
+  def test_posts_recent_raises_without_posts_root_node
+    @delicious.expects(:request).once.returns(mock_response('/response/update.xml'))
+    error = assert_raise(WWW::Delicious::ResponseError) do
+      @delicious.posts_recent
+    end
+    assert_match(/`posts`/, error.message)
+  end
+  
+  
+  def test_posts_all
+    @delicious.expects(:request).once.returns(mock_response('/response/posts_all.xml'))
+    results = @delicious.posts_all
+    assert_instance_of(Array, results)
+    assert_equal(8, results.length)
+    assert_equal('New to Git? - GitHub', results.first.title)
+    assert_equal('ASP 101 - Object Oriented ASP: Using Classes in Classic ASP', results.last.title)
+  end
+  
+  def test_posts_all_raises_without_posts_root_node
+    @delicious.expects(:request).once.returns(mock_response('/response/update.xml'))
+    error = assert_raise(WWW::Delicious::ResponseError) do
+      @delicious.posts_all
+    end
+    assert_match(/`posts`/, error.message)
+  end
+  
+  
+  def test_posts_dates
+    @delicious.expects(:request).once.returns(mock_response('/response/posts_dates.xml'))
+    results = @delicious.posts_dates
+    assert_instance_of(Hash, results)
+    assert_equal(10, results.length)
+  end
+  
+  def test_posts_dates_raises_without_dates_root_node
+    @delicious.expects(:request).once.returns(mock_response('/response/update.xml'))
+    error = assert_raise(WWW::Delicious::ResponseError) do
+      @delicious.posts_dates
+    end
+    assert_match(/`dates`/, error.message)
+  end
+  
+  
+  def test_posts_add
+    params = {:url => 'http://localhost', :title => 'Just a test'}
+    @delicious.expects(:request).times(2).returns(mock_response('/response/posts_add.xml'))
+    assert(@delicious.posts_add(WWW::Delicious::Post.new(params)))
+    assert(@delicious.posts_add(params))
+  end
+  
+  
+  def test_posts_delete
+    @delicious.expects(:request).once.returns(mock_response('/response/posts_delete.xml'))
+    assert(@delicious.posts_delete('test'))
+  end
+  
+  def test_posts_delete_raises_without_result_root_node
+    @delicious.expects(:request).once.returns(mock_response('/response/update.xml'))
+    error = assert_raise(WWW::Delicious::ResponseError) do
+      @delicious.posts_delete('test')
+    end
+    assert_match(/`result`/, error.message)
+  end
+  
+  
+  
+  protected
+  
+    # returns a stub instance
+    def instance(options = {}, &block)
+      WWW::Delicious.new(TEST_USERNAME, TEST_PASSWORD, options, &block)
+    end
+
+    def load_testcase(file)
+      File.read(TESTCASES_PATH + file)
+    end
+
+    def load_fixture(file)
+      YAML.load(File.read(FIXTURES_PATH + file))
+    end
+    
+    def mock_response(file_or_content)
+      content = case 
+        when file_or_content =~ /\.xml$/
+          load_testcase(file_or_content)
+        when file_or_content =~ /\.yml$/
+          load_fixture(file_or_content)
+        else
+          file_or_content.to_s
+      end
+      
+      response = mock()
+      response.expects(:body).at_least(1).returns(content)
+      response
+    end
+  
+end

data/test/fixtures/net_response_invalid_account.yml

@@ -0,0 +1,25 @@
+--- !ruby/object:Net::HTTPUnauthorized 
+body: |
+  <?xml version="1.0" standalone="yes"?>
+  <result code="access denied" />
+  <!-- fe02.api.del.ac4.yahoo.net uncompressed/chunked Tue Jul 29 13:53:52 PDT 2008 -->
+
+body_exist: true
+code: "401"
+header: 
+  connection: 
+  - close
+  p3p: 
+  - policyref="http://p3p.yahoo.com/w3c/p3p.xml", CP="CAO DSP COR CUR ADM DEV TAI PSA PSD IVAi IVDi CONi TELo OTPi OUR DELi SAMi OTRi UNRi PUBi IND PHY ONL UNI PUR FIN COM NAV INT DEM CNT STA POL HEA PRE GOV"
+  content-type: 
+  - text/xml; charset=utf-8
+  date: 
+  - Tue, 29 Jul 2008 20:53:52 GMT
+  www-authenticate: 
+  - Basic realm="del.icio.us API"
+  transfer-encoding: 
+  - chunked
+http_version: "1.1"
+message: Unauthorized
+read: true
+socket: 

data/test/fixtures/net_response_success.yml

@@ -0,0 +1,23 @@
+--- !ruby/object:Net::HTTPOK 
+body: |
+  <?xml version="1.0" encoding="UTF-8"?>
+  <update time="2008-07-29T19:29:39Z" inboxnew="0"/>
+  <!-- fe01.api.del.ac4.yahoo.net uncompressed/chunked Tue Jul 29 13:51:05 PDT 2008 -->
+
+body_exist: true
+code: "200"
+header: 
+  connection: 
+  - close
+  p3p: 
+  - policyref="http://p3p.yahoo.com/w3c/p3p.xml", CP="CAO DSP COR CUR ADM DEV TAI PSA PSD IVAi IVDi CONi TELo OTPi OUR DELi SAMi OTRi UNRi PUBi IND PHY ONL UNI PUR FIN COM NAV INT DEM CNT STA POL HEA PRE GOV"
+  content-type: 
+  - text/xml; charset=utf-8
+  date: 
+  - Tue, 29 Jul 2008 20:51:05 GMT
+  transfer-encoding: 
+  - chunked
+http_version: "1.1"
+message: OK
+read: true
+socket: 

data/test/online_test.rb

@@ -0,0 +1,147 @@
+# 
+# = WWW::Delicious
+#
+# Ruby client for del.icio.us API.
+# 
+#
+# Category::    WWW
+# Package::     WWW::Delicious
+# Author::      Simone Carletti <weppos@weppos.net>
+# License::     MIT License
+#
+#--
+#
+#++
+
+
+require 'test_helper'
+
+
+RUN_ONLINE_TESTS = ($0 == __FILE__) unless defined?(RUN_ONLINE_TESTS)
+
+puts "Online test #{__FILE__} skipped.\n" +
+     "Use `ONLINE=1` to run online tests.\n" unless RUN_ONLINE_TESTS
+
+
+class OnlineTest < Test::Unit::TestCase
+  
+  def setup
+    init_account
+  end
+  
+  
+  def test_update
+    response = @delicious.update
+    assert_instance_of(Time, response)
+  end
+  
+  
+  def test_bundles_all
+    response = @delicious.bundles_all
+    assert_kind_of(Array, response)
+
+    response.each do |bundle|
+      assert_instance_of(WWW::Delicious::Bundle, bundle)
+      assert_instance_of(Array, bundle.tags)
+      assert_not_nil(bundle.name)
+    end
+  end
+  
+  def test_bundles_set
+    bundle = WWW::Delicious::Bundle.new(:name => 'test_bundle', :tags => %w(ruby python).sort)
+    assert_nothing_raised() { @delicious.bundles_set(bundle) }
+  end
+  
+  def test_bundles_delete
+    bundle = WWW::Delicious::Bundle.new(:name => 'test_bundle')
+    assert_nothing_raised() { @delicious.bundles_delete(bundle) }
+  end
+  
+  
+  def test_tags_get
+    response = @delicious.tags_get
+    assert_kind_of(Array, response)
+
+    response.each do |tag|
+      assert_instance_of(WWW::Delicious::Tag, tag)
+      assert_not_nil(tag.name)
+      assert_not_nil(tag.count)
+    end
+  end
+  
+  def test_tags_rename
+    ftag = WWW::Delicious::Tag.new(:name => 'old_tag')
+    otag = WWW::Delicious::Tag.new(:name => 'new_tag')
+    assert_nothing_raised() { @delicious.tags_rename(ftag, otag) }
+  end
+  
+  
+  def test_post_add
+    # TODO
+  end
+  
+  def test_post_all
+    response = @delicious.posts_get
+    assert_kind_of(Array, response)
+
+    response.each do |post|
+      assert_kind_of(WWW::Delicious::Post, post)
+    end
+  end
+  
+  def test_post_dates
+    response = @delicious.posts_dates
+    assert_kind_of(Hash, response)
+
+    response.each do |item, value|
+      assert_match(/[\d]{4}-[\d]{2}-[\d]{2}/, item)
+      assert_match(/[\d]+/, value.to_s)
+    end
+  end
+  
+  def test_post_delete
+    # TODO
+  end
+  
+  def test_posts_get
+    response = @delicious.posts_get
+    assert_kind_of(Array, response)
+
+    response.each do |post|
+      assert_kind_of(WWW::Delicious::Post, post)
+    end
+  end
+  
+  def test_posts_recent
+    response = @delicious.posts_recent
+    assert_kind_of(Array, response)
+
+    response.each do |post|
+      assert_kind_of(WWW::Delicious::Post, post)
+    end
+  end
+  
+  
+  protected
+  
+    def init_account(options = {}, &block)
+      @delicious_username ||= ENV['DELICIOUS_USERNAME'] || self.class.prompt('Delicious Username') { |value| abort('Value cannot be blank') if value.blank?; value }
+      @delicious_password ||= ENV['DELICIOUS_PASSWORD'] || self.class.prompt('Delicious Password') { |value| abort('Value cannot be blank') if value.blank?; value }
+      @delicious = WWW::Delicious.new(@delicious_username, @delicious_password, options, &block)
+    end
+    
+    # Convenient method for collecting user input
+    def self.prompt(text, options = {}, &block)
+      default = options[:default] || ''
+      value   = nil
+      while value.blank?
+        print "#{text} [#{default}]: "
+        value = STDIN.gets.chomp!
+        value = default if value.blank?
+        value = yield value if block_given?
+        value
+      end
+      value
+    end
+
+end if RUN_ONLINE_TESTS

data/test/post_test.rb

@@ -0,0 +1,68 @@
+# 
+# = WWW::Delicious
+#
+# Ruby client for del.icio.us API.
+# 
+#
+# Category::    WWW
+# Package::     WWW::Delicious
+# Author::      Simone Carletti <weppos@weppos.net>
+# License::     MIT License
+#
+#--
+#
+#++
+
+
+require 'test_helper'
+require 'www/delicious/post'
+
+
+class PostTest < Test::Unit::TestCase
+  
+  def test_post
+    expected = { :title => 'JavaScript DOM reference', :url => URI.parse('http://www.howtocreate.co.uk/tutorials/texterise.php?dom=1') }
+    assert_attributes(instance(expected), expected)
+  end
+  
+  def test_post_shared_defaults_to_true
+    assert(instance(:title => 'Foo').shared)
+  end
+  
+  def test_post_shared_is_false
+    assert(!instance(:title => 'Foo', :shared => false).shared)
+  end
+  
+  def test_post_from_rexml
+    dom = REXML::Document.new(File.read(TESTCASES_PATH + '/element/post.xml'))
+    element = WWW::Delicious::Post.from_rexml(dom.root)
+
+    assert_equal(URI.parse('http://www.howtocreate.co.uk/tutorials/texterise.php?dom=1'), element.url)
+    assert_equal("JavaScript DOM reference", element.title)
+    assert_equal("dom reference", element.notes)
+    assert_equal("c0238dc0c44f07daedd9a1fd9bbdeebd", element.uid)
+    assert_equal(55, element.others)
+    assert_equal(%w(dom javascript webdev), element.tags)
+    assert_equal(Time.parse("2005-11-28T05:26:09Z"), element.time)
+  end
+  
+  def test_post_from_rexml_not_shared
+    dom = REXML::Document.new(File.read(TESTCASES_PATH + '/element/post_unshared.xml'))
+    element = WWW::Delicious::Post.from_rexml(dom.root)
+
+    assert(!element.shared)
+  end
+  
+  
+  # def test_valid
+  # end
+  
+  
+  protected
+  
+    # returns a stub instance
+    def instance(values = {}, &block)
+      WWW::Delicious::Post.new(values)
+    end
+  
+end