ideaoforder-www-delicious 0.2.0

data/test/unit/delicious_test.rb

@@ -0,0 +1,369 @@
+# 
+# = WWW::Delicious
+#
+# Ruby client for del.icio.us API.
+# 
+#
+# Category::    WWW
+# Package::     WWW::Delicious
+# Author::      Simone Carletti <weppos@weppos.net>
+# License::     MIT License
+#
+#--
+# SVN: $Id$
+#++
+
+
+require File.dirname(__FILE__) + '/../helper'
+
+
+class DeliciousTest < Test::Unit::TestCase
+  
+  TEST_USERNAME = 'username'
+  TEST_PASSWORD = 'password'
+  
+  
+  def setup
+    @delicious = instance
+  end
+  
+  
+  def test_initialize_raises_without_account
+    assert_raise(ArgumentError) { WWW::Delicious.new() }
+    assert_raise(ArgumentError) { WWW::Delicious.new(TEST_USERNAME) }
+  end
+  
+  def test_initialize_account
+    assert_equal(TEST_USERNAME, @delicious.username)
+    assert_equal(TEST_PASSWORD, @delicious.password)
+  end
+  
+  def test_initialize_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_option_user_agent_default
+    useragent = instance.user_agent
+    assert_match("Ruby/#{RUBY_VERSION}", useragent)
+    assert_match("#{WWW::Delicious::NAME}/#{WWW::Delicious::VERSION}", useragent)
+  end
+  
+  def test_initialize_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_option_base_uri_default
+    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)
+      assert((nr - lr) > WWW::Delicious::SECONDS_BEFORE_NEW_REQUEST)
+    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/unit/online/online_test.rb

@@ -0,0 +1,148 @@
+# 
+# = WWW::Delicious
+#
+# Ruby client for del.icio.us API.
+# 
+#
+# Category::    WWW
+# Package::     WWW::Delicious
+# Author::      Simone Carletti <weppos@weppos.net>
+# License::     MIT License
+#
+#--
+# SVN: $Id$
+#++
+
+
+require File.dirname(__FILE__) + '/../../helper'
+
+
+# overwrite if file is called alone
+RUN_ONLINE_TESTS = ($0 == __FILE__) unless defined? RUN_ONLINE_TESTS and 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/unit/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
+#
+#--
+# SVN: $Id$
+#++
+
+
+require File.dirname(__FILE__) + '/../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

data/test/unit/tag_test.rb

@@ -0,0 +1,69 @@
+# 
+# = WWW::Delicious
+#
+# Ruby client for del.icio.us API.
+# 
+#
+# Category::    WWW
+# Package::     WWW::Delicious
+# Author::      Simone Carletti <weppos@weppos.net>
+# License::     MIT License
+#
+#--
+# SVN: $Id$
+#++
+
+
+require File.dirname(__FILE__) + '/../helper'
+require 'www/delicious/tag'
+
+
+class TagTest < Test::Unit::TestCase
+  
+  def test_tag
+    expected = { :name => 'MyTag', :count => 2 }
+    assert_attributes(instance(expected), expected)
+  end
+  
+  def test_tag_from_rexml
+    dom = REXML::Document.new(File.read(TESTCASES_PATH + '/element/tag.xml'))
+    expected = { :count => 1, :name => 'activedesktop' }
+    
+    element = WWW::Delicious::Tag.from_rexml(dom.root)
+    assert_attributes(element, expected)
+  end
+  
+  
+  def test_tag_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', :count => 4).to_s)
+  end
+  
+  def test_to_s_returns_empty_string_with_name_nil
+    assert_equal('', instance(:name => nil).to_s)
+  end
+  
+  
+  # def test_api_valid
+  #   ['foo', ' foo '].each do |v|
+  #     assert(instance(v).api_valid?)
+  #   end
+  #   ['', '  '].each do |v|
+  #     assert(!instance(v).api_valid?)
+  #   end
+  # end
+  
+  
+  protected
+  
+    # returns a stub instance
+    def instance(values = {}, &block)
+      WWW::Delicious::Tag.new(values)
+    end
+
+end