www-delicious 0.3.0 → 0.4.0

data/CHANGELOG.rdoc

@@ -1,6 +1,17 @@
 = Changelog
 
 
+== Release 0.4.0
+
+* FIXED: A trivial bug causes the test `test_request_waits_necessary_time_between_requests` to fail in case the subsequent request is sent exactly 1 second after the prior one.
+
+* FIXED: Object#blank? is always redefined regardless already defined before.
+
+* CHANGED: Removed dependency from Echoe.
+
+* REMOVED: Removed old setup.rb installation method.
+
+
 == Release 0.3.0
 
 * FIXED: Compatibility fixes for Ruby 1.9. WWW::Delicious is now 100% compatible with 1.9. You should remember to define the proper content encoding with magic comments when working with UTF-8/MultiByte XML or Ruby files, see http://redmine.ruby-lang.org/wiki/ruby-19/ScriptEncoding (closes #142).

data/LICENSE.rdoc

@@ -2,7 +2,7 @@
 
 (The MIT License)
 
-Copyright (c) 2008-2009 Simone Carletti <weppos@weppos.net>
+Copyright (c) 2008-2010 Simone Carletti <weppos@weppos.net>
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.rdoc

@@ -1,19 +1,13 @@
 = WWW::Delicious
 
-WWW::Delicious is a Ruby client for http://del.icio.us XML API.
+WWW::Delicious is a Ruby client for {delicious.com}[http://delicious.com] XML API.
 
 It provides both read and write functionality. You can read user Posts, Tags
 and Bundles but you can create new Posts, Tags and Bundles as well.
 
+WWW::Delicious maps all the original del.icio.us API calls and provides some additional convenient methods to perform common tasks. For a full API overview, visit the official {Delicious API documentation}[http://delicious.com/help/api].
 
-== Overview
-
-WWW::Delicious maps all the original del.icio.us API calls and provides some
-additional convenient methods to perform common tasks.
-Please read the official documentation (http://del.icio.us/help/api/)
-to learn more about del.icio.us API.
-
-WWW::Delicious is 100% compatible with all del.icio.us API constraints,
+WWW::Delicious is compatible with all {delicious.com}[http://delicious.com] API constraints,
 including the requirement to set a valid user agent or wait at least
 one second between queries.
 Basically, the main benefit from using this library is that you don't need
@@ -21,36 +15,28 @@ to take care of all these low level details, if you don't want:
 WWW::Delicious will try to give you the most with less efforts.
 
 
-== Dependencies
-
-* Ruby >= 1.8.6 (not tested with previous versions)
+== Requirements
 
-As of release 0.3.0, WWW::Delicious is compatible with Ruby 1.9.1.
+* Ruby >= 1.8.6 or Ruby 1.9.x
 
 
 == Download and Installation
 
-RubyGems[http://rubyforge.org/projects/rubygems/] is the preferred install method.
-To get the latest version, simply type the following instruction into your command prompt:
+This library is intended to be installed as a Gem.
 
-  $ sudo gem install www-delicious
-  
-Depending on your system, you might need su privileges.
-
-To install the library manually, downlad the latest version from 
-navigate to the root library directory and enter:
+  $ gem install www-delicious
 
-  $ sudo ruby setup.rb
+You might need administrator privileges on your system to install it.
 
-If you need the latest development version you can download the source code
-from one of the GIT repositories listed above.
+If you need the latest development version you can download the
+{source code}[http://github.com/weppos/www-delicious/] from GitHub.
 Beware that the code might not be as stable as the official release.
 
 
 == Getting Started
 
-In order to use this library you need a valid del.icio.us account.
-Go to http://del.icio.us/ and register for a new account if you don't already have one.
+In order to use this library you need a valid Delicious account.
+Go to http://delicious.com and register for a new account if you don't already have one.
 
 Then create a valid instance of WWW::Delicious providing your account credentials.
 
@@ -171,16 +157,16 @@ You can also create new bundles or delete existing ones.
   d.bundles_delete('OldBundle')
 
 
-== Author
+== Credits
 
-{Simone Carletti}[http://www.simonecarletti.com/] <weppos@weppos.net>
+Author:: {Simone Carletti}[http://www.simonecarletti.com/] <weppos@weppos.net>
 
 
 == Resources
 
-* {Homepage}[http://code.simonecarletti.com/www-delicious]
-* {API}[http://www-delicious.rubyforge.org/]
-* {GitHub}[http://github.com/weppos/www-delicious/]
+* {Homepage}[http://www.simonecarletti.com/code/www-delicious]
+* {Repository}[http://github.com/weppos/www-delicious/]
+* {API Documentation}[http://www.simonecarletti.com/code/www-delicious/api/] (RDoc)
 * {RubyForge}[http://rubyforge.org/projects/www-delicious/]
 
 
@@ -188,7 +174,7 @@ You can also create new bundles or delete existing ones.
 
 Feel free to email {Simone Carletti}[mailto:weppos@weppos.net] with any questions or feedback.
 
-Please use the {Ticket System}[http://code.simonecarletti.com/projects/show/www-delicious] to submit bug reports or feature request.
+Please use the {Ticket System}[http://github.com/weppos/www-delicious/issues] to submit bug reports or feature request.
 
 
 == Changelog
@@ -198,5 +184,4 @@ See the CHANGELOG.rdoc file for details.
 
 == License
 
-Copyright (c) 2008-2009 Simone Carletti, WWW::Delicious is released under the MIT license. 
-
+Copyright (c) 2008-2010 Simone Carletti, WWW::Delicious is released under the MIT license. 

data/lib/www/delicious.rb

@@ -1,8 +1,8 @@
-# 
+#
 # = WWW::Delicious
 #
 # Ruby client for del.icio.us API.
-# 
+#
 #
 # Category::    WWW
 # Package::     WWW::Delicious
@@ -10,7 +10,7 @@
 # License::     MIT License
 #
 #--
-# SVN: $Id$
+#
 #++
 
 
@@ -29,68 +29,69 @@ module WWW #:nodoc:
 
   #
   # = WWW::Delicious
-  # 
-  # WWW::Delicious is a Ruby client for http://del.icio.us XML API.
-  # 
-  # It provides both read and write functionalities. 
-  # You can read user Posts, Tags and Bundles 
+  #
+  # WWW::Delicious is a Ruby client for http://delicious.com XML API.
+  #
+  # It provides both read and write functionalities.
+  # You can read user Posts, Tags and Bundles
   # but you can create new Posts, Tags and Bundles as well.
   #
   #
   # == Basic Usage
-  # 
+  #
   # The following is just a basic demonstration of the main features.
   # See the README file for a deeper explanation about how to get the best
   # from WWW::Delicious library.
-  # 
+  #
   # The examples in this page make the following assumptions
   # * you have a valid del.icio.us account
   # * +username+ is your account username
   # * +password+ is your account password
-  # 
+  #
   # In order to make a query you first need to create
   # a new WWW::Delicious instance as follows:
   #
   #   require 'www/delicious'
-  # 
+  #
   #   username = 'my delicious username'
   #   password = 'my delicious password'
   #
   #   d = WWW::Delicious.new(username, password)
-  # 
+  #
   # The constructor accepts some additional options.
   # For instance, if you want to customize the user agent:
-  # 
+  #
   #   d = WWW::Delicious.new(username, password, :user_agent => 'FooAgent')
-  #   
+  #
   # Now you can use any of the API methods available.
-  # 
+  #
   # For example, you may want to know when your account was last updated
   # to check whether someone else made some changes on behalf of you:
-  # 
+  #
   #   datetime = d.update # => Wed Mar 12 08:41:20 UTC 2008
-  #   
+  #
   # Because the answer is a valid +Time+ instance, you can format it with +strftime+.
-  #   
+  #
   #   datetime = d.update # => Wed Mar 12 08:41:20 UTC 2008
   #   datetime.strftime('%Y') # => 2008
   #
   class Delicious
-    
-    NAME            = 'WWW::Delicious'
-    GEM             = 'www-delicious'
-    AUTHOR          = 'Simone Carletti <weppos@weppos.net>'
-    
+
+    NAME            = "WWW::Delicious"
+    GEM             = "www-delicious"
+    AUTHORS         = ["Simone Carletti <weppos@weppos.net>"]
+
+
     # del.icio.us account username
     attr_reader :username
-    
+
     # del.icio.us account password
     attr_reader :password
-    
+
     # base URI for del.icio.us API
     attr_reader :base_uri
 
-    
+
     # API Base URL
     API_BASE_URI    = 'https://api.del.icio.us'
 
@@ -121,306 +122,306 @@ module WWW #:nodoc:
     API_PATH_POSTS_ADD      = '/v1/posts/add';
     # API Path Delete Post
     API_PATH_POSTS_DELETE   = '/v1/posts/delete';
-    
+
     # Time to wait before sending a new request, in seconds
     SECONDS_BEFORE_NEW_REQUEST = 1
-    
+
     # Time converter converts a Time instance into the format
     # requested by Delicious API
-    TIME_CONVERTER = lambda { |time| time.iso8601() }
-    
-    
-    # 
-    # Constructs a new <tt>WWW::Delicious</tt> object 
+    TIME_CONVERTER = lambda { |time| time.iso8601 }
+
+
+    #
+    # Constructs a new <tt>WWW::Delicious</tt> object
     # with given +username+ and +password+.
-    #   
+    #
     #   # create a new object with username 'user' and password 'psw
     #   obj = WWW::Delicious('user', 'psw')
     #   # => self
-    # 
+    #
     # If a block is given, the instance is passed to the block
     # but this method always returns the instance itself.
-    # 
+    #
     #   WWW::Delicious('user', 'psw') do |d|
     #     d.update() # => Fri May 02 18:02:48 UTC 2008
     #   end
     #   # => self
-    # 
+    #
     # You can also specify some additional options, including a custom user agent
-    # or the base URI for del.icio.us API.
-    # 
+    # or the base URI for delicious.com API.
+    #
     #   WWW::Delicious('user', 'psw', :base_uri => 'https://ma.gnolia.com/api/mirrord') do |d|
     #     # the following call is mirrored by ma.gnolia
     #     d.update() # => Fri May 02 18:02:48 UTC 2008
     #   end
     #   # => self
-    #   
+    #
     # === Options
     # This class accepts a Hash with additional options.
     # Here's the list of valid keys:
     #
     # <tt>:user_agent</tt>:: User agent to display in HTTP requests.
     # <tt>:base_uri</tt>:: The base URI to del.icio.us API.
-    # 
+    #
     def initialize(username, password, options = {}, &block) #  :yields: delicious
       @username, @password = username.to_s, password.to_s
-      
+
       # set API base URI
       @base_uri = URI.parse(options[:base_uri] || API_BASE_URI)
-      
+
       init_user_agent(options)
       init_http_client(options)
-      
+
       yield self if block_given?
       self # ensure to always return self even if block is given
     end
-    
-    
-    # 
+
+
+    #
     # Returns the reference to current <tt>@http_client</tt>.
     # The http is always valid unless it has been previously set to +nil+.
-    # 
+    #
     #   # nil client
     #   obj.http_client # => nil
-    #   
+    #
     #   # valid client
     #   obj.http_client # => Net::HTTP
-    # 
+    #
     def http_client()
       return @http_client
     end
 
-    # 
+    #
     # Sets the internal <tt>@http_client</tt> to +client+.
-    # 
+    #
     #   # nil client
     #   obj.http_client = nil
-    # 
+    #
     #   # http client
     #   obj.http_client = Net::HTTP.new()
-    # 
+    #
     #   # invalid client
     #   obj.http_client = 'foo' # => ArgumentError
-    # 
+    #
     def http_client=(client)
       unless client.kind_of?(Net::HTTP) or client.nil?
         raise ArgumentError, "`client` expected to be a kind of `Net::HTTP`, `#{client.class}` given"
       end
       @http_client = client
     end
-    
+
     # Returns current user agent string.
     def user_agent()
       return @headers['User-Agent']
     end
-    
-    
-    # 
+
+
+    #
     # Returns true if given account credentials are valid.
-    # 
+    #
     #   d = WWW::Delicious.new('username', 'password')
     #   d.valid_account? # => true
-    # 
+    #
     #   d = WWW::Delicious.new('username', 'invalid_password')
     #   d.valid_account? # => false
-    # 
+    #
     # This method is not "exception safe".
     # It doesn't return false if an HTTP error or any kind of other error occurs,
     # it raises back the exception to the caller instead.
-    # 
-    # 
+    #
+    #
     # Raises::  WWW::Delicious::Error
     # Raises::  WWW::Delicious::HTTPError
     # Raises::  WWW::Delicious::ResponseError
-    # 
+    #
     def valid_account?
       update()
       return true
     rescue HTTPError => e
       return false if e.message =~ /invalid username or password/i
-      raise 
+      raise
     end
 
-    # 
+    #
     # Checks to see when a user last posted an item
     # and returns the last update +Time+ for the user.
-    # 
+    #
     #   d.update() # => Fri May 02 18:02:48 UTC 2008
-    # 
-    # 
+    #
+    #
     # Raises::  WWW::Delicious::Error
     # Raises::  WWW::Delicious::HTTPError
     # Raises::  WWW::Delicious::ResponseError
-    # 
+    #
     def update()
       response = request(API_PATH_UPDATE)
       return parse_update_response(response.body)
     end
-    
-    # 
+
+    #
     # Retrieves all of a user's bundles
     # and returns an array of <tt>WWW::Delicious::Bundle</tt>.
-    # 
+    #
     #   d.bundles_all() # => [#<WWW::Delicious::Bundle>, #<WWW::Delicious::Bundle>, ...]
     #   d.bundles_all() # => []
-    # 
-    # 
+    #
+    #
     # Raises::  WWW::Delicious::Error
     # Raises::  WWW::Delicious::HTTPError
     # Raises::  WWW::Delicious::ResponseError
-    # 
+    #
     def bundles_all()
       response = request(API_PATH_BUNDLES_ALL)
       return parse_bundle_collection(response.body)
     end
-    
-    # 
-    # Assignes a set of tags to a single bundle, 
+
+    #
+    # Assignes a set of tags to a single bundle,
     # wipes away previous settings for bundle.
-    # 
+    #
     #   # create from a bundle
     #   d.bundles_set(WWW::Delicious::Bundle.new('MyBundle'), %w(foo bar))
-    # 
+    #
     #   # create from a string
     #   d.bundles_set('MyBundle', %w(foo bar))
-    # 
-    # 
+    #
+    #
     # Raises::  WWW::Delicious::Error
     # Raises::  WWW::Delicious::HTTPError
     # Raises::  WWW::Delicious::ResponseError
-    # 
+    #
     def bundles_set(bundle_or_name, tags = [])
       params = prepare_bundles_set_params(bundle_or_name, tags)
       response = request(API_PATH_BUNDLES_SET, params)
       return parse_and_eval_execution_response(response.body)
     end
-    
-    # 
+
+    #
     # Deletes +bundle_or_name+ bundle from del.icio.us.
-    # +bundle_or_name+ can be either a WWW::Delicious::Bundle instance 
+    # +bundle_or_name+ can be either a WWW::Delicious::Bundle instance
     # or a string with the name of the bundle.
-    # 
+    #
     # This method doesn't care whether the exists.
     # If not, the execution will silently return without rising any error.
-    # 
+    #
     #   # delete from a bundle
     #   d.bundles_delete(WWW::Delicious::Bundle.new('MyBundle'))
-    # 
+    #
     #   # delete from a string
     #   d.bundles_delete('MyBundle', %w(foo bar))
-    # 
-    # 
+    #
+    #
     # Raises::  WWW::Delicious::Error
     # Raises::  WWW::Delicious::HTTPError
     # Raises::  WWW::Delicious::ResponseError
-    # 
+    #
     def bundles_delete(bundle_or_name)
       params = prepare_bundles_delete_params(bundle_or_name)
       response = request(API_PATH_BUNDLES_DELETE, params)
       return parse_and_eval_execution_response(response.body)
     end
-    
-    # 
+
+    #
     # Retrieves the list of tags and number of times used by the user
     # and returns an array of <tt>WWW::Delicious::Tag</tt>.
-    # 
+    #
     #   d.tags_get() # => [#<WWW::Delicious::Tag>, #<WWW::Delicious::Tag>, ...]
     #   d.tags_get() # => []
-    # 
-    # 
+    #
+    #
     # Raises::  WWW::Delicious::Error
     # Raises::  WWW::Delicious::HTTPError
     # Raises::  WWW::Delicious::ResponseError
-    # 
+    #
     def tags_get()
       response = request(API_PATH_TAGS_GET)
       return parse_tag_collection(response.body)
     end
-    
-    # 
+
+    #
     # Renames an existing tag with a new tag name.
-    # 
+    #
     #   # rename from a tag
     #   d.bundles_set(WWW::Delicious::Tag.new('old'), WWW::Delicious::Tag.new('new'))
-    # 
+    #
     #   # rename from a string
     #   d.bundles_set('old', 'new')
-    # 
-    # 
+    #
+    #
     # Raises::  WWW::Delicious::Error
     # Raises::  WWW::Delicious::HTTPError
     # Raises::  WWW::Delicious::ResponseError
-    # 
+    #
     def tags_rename(from_name_or_tag, to_name_or_tag)
       params = prepare_tags_rename_params(from_name_or_tag, to_name_or_tag)
       response = request(API_PATH_TAGS_RENAME, params)
       return parse_and_eval_execution_response(response.body)
     end
-    
-    # 
+
+    #
     # Returns an array of <tt>WWW::Delicious::Post</tt> matching +options+.
     # If no option is given, the last post is returned.
     # If no date or url is given, most recent date will be used.
-    # 
+    #
     #   d.posts_get() # => [#<WWW::Delicious::Post>, #<WWW::Delicious::Post>, ...]
     #   d.posts_get() # => []
-    # 
+    #
     #   # get all posts tagged with ruby
     #   d.posts_get(:tag => WWW::Delicious::Tag.new('ruby))
-    # 
+    #
     #   # get all posts matching URL 'http://www.simonecarletti.com'
     #   d.posts_get(:url => URI.parse('http://www.simonecarletti.com'))
-    # 
+    #
     #   # get all posts tagged with ruby and matching URL 'http://www.simonecarletti.com'
     #   d.posts_get(:tag => WWW::Delicious::Tag.new('ruby),
     #               :url => URI.parse('http://www.simonecarletti.com'))
-    # 
-    # 
+    #
+    #
     # === Options
     # <tt>:tag</tt>:: a tag to filter by. It can be either a <tt>WWW::Delicious::Tag</tt> or a +String+.
     # <tt>:dt</tt>::  a +Time+ with a date to filter by.
     # <tt>:url</tt>:: a valid URI to filter by. It can be either an instance of +URI+ or a +String+.
-    # 
+    #
     # Raises::  WWW::Delicious::Error
     # Raises::  WWW::Delicious::HTTPError
     # Raises::  WWW::Delicious::ResponseError
-    # 
+    #
     def posts_get(options = {})
       params = prepare_posts_params(options.clone, [:dt, :tag, :url])
       response = request(API_PATH_POSTS_GET, params)
       return parse_post_collection(response.body)
     end
 
-    # 
+    #
     # Returns a list of the most recent posts, filtered by argument.
-    # 
+    #
     #   # get the most recent posts
     #   d.posts_recent()
-    # 
+    #
     #   # get the 10 most recent posts
     #   d.posts_recent(:count => 10)
-    # 
-    # 
+    #
+    #
     # === Options
     # <tt>:tag</tt>::   a tag to filter by. It can be either a <tt>WWW::Delicious::Tag</tt> or a +String+.
     # <tt>:count</tt>:: number of items to retrieve. (default: 15, maximum: 100).
-    # 
+    #
     def posts_recent(options = {})
       params = prepare_posts_params(options.clone, [:count, :tag])
       response = request(API_PATH_POSTS_RECENT, params)
       return parse_post_collection(response.body)
     end
-    
-    # 
+
+    #
     # Returns a list of all posts, filtered by argument.
-    # 
+    #
     #   # get all (this is a very expensive query)
     #   d.posts_all
-    # 
+    #
     #   # get all posts matching ruby
     #   d.posts_all(:tag => WWW::Delicious::Tag.new('ruby'))
-    # 
-    # 
+    #
+    #
     # === Options
     # <tt>:tag</tt>:: a tag to filter by. It can be either a <tt>WWW::Delicious::Tag</tt> or a +String+.
     #
@@ -432,16 +433,16 @@ module WWW #:nodoc:
 
     #
     # Returns a list of dates with the number of posts at each date.
-    # 
+    #
     #   # get number of posts per date
     #   d.posts_dates
     #   # => { '2008-05-05' => 12, '2008-05-06' => 3, ... }
-    # 
+    #
     #   # get number posts per date tagged as ruby
     #   d.posts_dates(:tag => WWW::Delicious::Tag.new('ruby'))
     #   # => { '2008-05-05' => 10, '2008-05-06' => 3, ... }
-    # 
-    # 
+    #
+    #
     # === Options
     # <tt>:tag</tt>:: a tag to filter by. It can be either a <tt>WWW::Delicious::Tag</tt> or a +String+.
     #
@@ -456,13 +457,13 @@ module WWW #:nodoc:
     # +post_or_values+ can be either a +WWW::Delicious::Post+ instance
     # or a Hash of params. This method accepts all params available
     # to initialize a new +WWW::Delicious::Post+.
-    # 
+    #
     #   # add a post from WWW::Delicious::Post
     #   d.posts_add(WWW::Delicious::Post.new(:url => 'http://www.foobar.com', :title => 'Hello world!'))
-    # 
+    #
     #   # add a post from values
     #   d.posts_add(:url => 'http://www.foobar.com', :title => 'Hello world!')
-    # 
+    #
     #
     def posts_add(post_or_values)
       params = prepare_param_post(post_or_values).to_params
@@ -473,16 +474,16 @@ module WWW #:nodoc:
     #
     # Deletes the post matching given +url+ from del.icio.us.
     # +url+ can be either an URI instance or a string representation of a valid URL.
-    # 
+    #
     # This method doesn't care whether a post with given +url+ exists.
     # If not, the execution will silently return without rising any error.
-    # 
+    #
     #   # delete a post from URI
     #   d.post_delete(URI.parse('http://www.foobar.com/'))
-    # 
+    #
     #   # delete a post from a string
     #   d.post_delete('http://www.foobar.com/')
-    # 
+    #
     #
     def posts_delete(url)
       params = prepare_posts_params({:url => url}, [:url])
@@ -490,9 +491,9 @@ module WWW #:nodoc:
       return parse_and_eval_execution_response(response.body)
     end
 
-    
+
     protected
-    
+
       # Initializes the HTTP client.
       # It automatically enable +use_ssl+ flag according to +@base_uri+ scheme.
       def init_http_client(options)
@@ -501,64 +502,64 @@ module WWW #:nodoc:
         http.verify_mode = OpenSSL::SSL::VERIFY_NONE # FIXME: not 100% supported
         self.http_client = http
       end
-      
+
       # Initializes user agent value for HTTP requests.
       def init_user_agent(options)
         user_agent = options[:user_agent] || default_user_agent()
         @headers ||= {}
         @headers['User-Agent'] = user_agent
       end
-      
-      # 
+
+      #
       # Creates and returns the default user agent string.
-      # 
+      #
       # By default, the user agent is composed by the following schema:
       # <tt>NAME/VERSION (Ruby/RUBY_VERSION)</tt>
-      # 
+      #
       # * +NAME+ is the constant representing this library name
       # * +VERSION+ is the constant representing current library version
       # * +RUBY_VERSION+ is the version of Ruby interpreter the library is interpreted by
-      # 
+      #
       #   default_user_agent
       #   # => WWW::Delicious/0.1.0 (Ruby/1.8.6)
-      # 
+      #
       def default_user_agent
         return "#{NAME}/#{VERSION} (Ruby/#{RUBY_VERSION})"
       end
-      
-      
-      # 
+
+
+      #
       # Composes an HTTP query string from an hash of +options+.
       # The result is URI encoded.
-      # 
+      #
       #   http_build_query(:foo => 'baa', :bar => 'boo')
       #   # => foo=baa&bar=boo
-      # 
+      #
       def http_build_query(params = {})
-        return params.collect do |k,v| 
+        return params.collect do |k,v|
           "#{URI.encode(k.to_s)}=#{URI.encode(v.to_s)}" unless v.nil?
         end.compact.join('&')
       end
-      
-      # 
+
+      #
       # Sends an HTTP GET request to +path+ and appends given +params+.
-      # 
+      #
       # This method is 100% compliant with Delicious API reference.
       # It waits at least 1 second between each HTTP request and
       # provides an identifiable user agent by default,
-      # or the custom user agent set by +user_agent+ option 
-      # when this istance has been created.
-      # 
+      # or the custom user agent set by +user_agent+ option
+      # when this instance has been created.
+      #
       #   request('/v1/api/path', :foo => 1, :bar => 2)
       #   # => sends a GET request to /v1/api/path?foo=1&bar=2
-      # 
+      #
       def request(path, params = {})
         raise Error, 'Invalid HTTP Client' unless http_client
         wait_before_new_request
-      
+
         uri = @base_uri.merge(path)
         uri.query = http_build_query(params) unless params.empty?
-      
+
         begin
           @last_request = Time.now  # see #wait_before_new_request
           @last_request_uri = uri   # useful for debug
@@ -566,7 +567,7 @@ module WWW #:nodoc:
         rescue => e # catch EOFError, SocketError and more
           raise HTTPError, e.message
         end
-      
+
         case response
           when Net::HTTPSuccess
             return response
@@ -579,7 +580,7 @@ module WWW #:nodoc:
             raise HTTPError, "HTTP #{response.code}: #{response.message}"
         end
       end
-      
+
       # Makes the real HTTP request to given +uri+ and returns the +response+.
       # This method exists basically to simplify unit testing with mocha.
       def make_request(uri)
@@ -589,55 +590,55 @@ module WWW #:nodoc:
           http.request(req)
         end
       end
-      
-      # 
-      # Delicious API reference requests to wait AT LEAST ONE SECOND 
+
+      #
+      # Delicious API reference requests to wait AT LEAST ONE SECOND
       # between queries or the client is likely to get automatically throttled.
-      # 
+      #
       # This method calculates the difference between current time
       # and the last request time and wait for the necessary time to meet
       # SECONDS_BEFORE_NEW_REQUEST requirement.
-      # 
+      #
       # The difference is not rounded. If you only have to wait for 0.034 seconds
       # then your don't have to wait 0 or 1 seconds, but 0.034 seconds!
-      # 
+      #
       def wait_before_new_request
         return unless @last_request # this is the first request
         # puts "Last request at #{TIME_CONVERTER.call(@last_request)}" if debug?
         diff = Time.now - @last_request
         if diff < SECONDS_BEFORE_NEW_REQUEST
           # puts "Sleeping for #{diff} before new request..." if debug?
-          sleep(SECONDS_BEFORE_NEW_REQUEST - diff) 
+          sleep(SECONDS_BEFORE_NEW_REQUEST - diff)
         end
       end
-      
-      
-      # 
+
+
+      #
       # Parses the response <tt>body</tt> and runs a common set of validators.
       # Returns <tt>body</tt> as parsed REXML::Document on success.
-      # 
+      #
       # Raises::  WWW::Delicious::ResponseError in case of invalid response.
-      # 
+      #
       def parse_and_validate_response(body, options = {})
         dom = REXML::Document.new(body)
-        
+
         if (value = options[:root_name]) && dom.root.name != value
           raise ResponseError, "Invalid response, root node is not `#{value}`"
         end
         if (value = options[:root_text]) && dom.root.text != value
           raise ResponseError, value
         end
-        
+
         return dom
       end
-      
-      # 
+
+      #
       # Parses and evaluates the response returned by an execution,
       # usually an update/delete/insert operation.
-      # 
+      #
       # Raises::  WWW::Delicious::ResponseError in case of invalid response
       # Raises::  WWW::Delicious::Error in case of execution error
-      # 
+      #
       def parse_and_eval_execution_response(body)
         dom = parse_and_validate_response(body, :root_name => 'result')
         response = dom.root.if_attribute_value(:code)
@@ -645,53 +646,53 @@ module WWW #:nodoc:
         raise Error, "Invalid response, #{response}" unless %w(done ok).include?(response)
         true
       end
-      
+
       # Parses the response of an Update request
       # and returns the update Timestamp.
       def parse_update_response(body)
         dom = parse_and_validate_response(body, :root_name => 'update')
         dom.root.if_attribute_value(:time) { |v| Time.parse(v) }
       end
-      
+
       # Parses a response containing a collection of Bundles
       # and returns an array of <tt>WWW::Delicious::Bundle</tt>.
       def parse_bundle_collection(body)
         dom = parse_and_validate_response(body, :root_name => 'bundles')
         dom.root.elements.collect('bundle') { |xml| Bundle.from_rexml(xml) }
       end
-      
+
       # Parses a response containing a collection of Tags
       # and returns an array of <tt>WWW::Delicious::Tag</tt>.
       def parse_tag_collection(body)
         dom  = parse_and_validate_response(body, :root_name => 'tags')
         dom.root.elements.collect('tag') { |xml| Tag.from_rexml(xml) }
       end
-      
+
       # Parses a response containing a collection of Posts
       # and returns an array of <tt>WWW::Delicious::Post</tt>.
       def parse_post_collection(body)
         dom  = parse_and_validate_response(body, :root_name => 'posts')
         dom.root.elements.collect('post') { |xml| Post.from_rexml(xml) }
       end
-      
+
       # Parses the response of a <tt>posts_dates</tt> request
       # and returns a +Hash+ of date => count.
       def parse_posts_dates_response(body)
         dom  = parse_and_validate_response(body, :root_name => 'dates')
         return dom.root.get_elements('date').inject({}) do |collection, xml|
-          date  = xml.if_attribute_value(:date) 
+          date  = xml.if_attribute_value(:date)
           count = xml.if_attribute_value(:count)
           collection.merge({ date => count })
         end
       end
-      
-      
-      # 
+
+
+      #
       # Prepares the params for a `bundles_set` call
       # and returns a Hash with the params ready for the HTTP request.
-      # 
+      #
       # Raises::  WWW::Delicious::Error
-      # 
+      #
       def prepare_bundles_set_params(name_or_bundle, tags = [])
         bundle = prepare_param_bundle(name_or_bundle, tags) do |b|
           raise Error, "Bundle name is empty" if b.name.empty?
@@ -699,46 +700,46 @@ module WWW #:nodoc:
         end
         return { :bundle => bundle.name, :tags => bundle.tags.join(' ') }
       end
-      
-      # 
+
+      #
       # Prepares the params for a `bundles_set` call
       # and returns a Hash with the params ready for the HTTP request.
-      # 
+      #
       # Raises::  WWW::Delicious::Error
-      # 
+      #
       def prepare_bundles_delete_params(name_or_bundle)
         bundle = prepare_param_bundle(name_or_bundle) do |b|
           raise Error, "Bundle name is empty" if b.name.empty?
         end
         return { :bundle => bundle.name }
       end
-      
-      # 
+
+      #
       # Prepares the params for a `tags_rename` call
       # and returns a Hash with the params ready for the HTTP request.
-      # 
+      #
       # Raises::  WWW::Delicious::Error
-      # 
+      #
       def prepare_tags_rename_params(from_name_or_tag, to_name_or_tag)
         from, to = [from_name_or_tag, to_name_or_tag].collect do |v|
           prepare_param_tag(v)
         end
         return { :old => from, :new => to }
       end
-      
-      # 
+
+      #
       # Prepares the params for a `post_*` call
       # and returns a Hash with the params ready for the HTTP request.
-      # 
+      #
       # Raises::  WWW::Delicious::Error
-      # 
+      #
       def prepare_posts_params(params, allowed_params = [])
         compare_params(params, allowed_params)
-        
+
         # we don't need to check whether the following parameters
         # are valid for this request because compare_params
         # would raise if an invalid param is supplied
-        
+
         params[:tag]    = prepare_param_tag(params[:tag])  if params[:tag]
         params[:dt]     = TIME_CONVERTER.call(params[:dt]) if params[:dt]
         params[:url]    = URI.parse(params[:url])          if params[:url]
@@ -748,18 +749,18 @@ module WWW #:nodoc:
         else
           15 # default value
         end
-        
+
         return params
       end
-      
-      
-      # 
+
+
+      #
       # Prepares the +post+ param for an API request.
-      # 
+      #
       # Creates and returns a <tt>WWW::Delicious::Post</tt> instance from <tt>post_or_values</tt>.
       # <tt>post_or_values</tt> can be either an Hash with post attributes
       # or a <tt>WWW::Delicious::Post</tt> instance.
-      # 
+      #
       def prepare_param_post(post_or_values, &block)
         post = case post_or_values
           when WWW::Delicious::Post
@@ -769,20 +770,20 @@ module WWW #:nodoc:
           else
             raise ArgumentError, 'Expected `args` to be `WWW::Delicious::Post` or `Hash`'
           end
-          
+
         yield(post) if block_given?
         # TODO: validate post with post.validate!
         raise ArgumentError, 'Both `url` and `title` are required' unless post.api_valid?
         post
       end
-      
-      # 
+
+      #
       # Prepares the +bundle+ param for an API request.
-      # 
+      #
       # Creates and returns a <tt>WWW::Delicious::Bundle</tt> instance from <tt>name_or_bundle</tt>.
       # <tt>name_or_bundle</tt> can be either a string holding bundle name
       # or a <tt>WWW::Delicious::Bundle</tt> instance.
-      # 
+      #
       def prepare_param_bundle(name_or_bundle, tags = [], &block) #  :yields: bundle
         bundle = case name_or_bundle
           when WWW::Delicious::Bundle
@@ -790,19 +791,19 @@ module WWW #:nodoc:
           else
             Bundle.new(:name => name_or_bundle, :tags => tags)
           end
-        
+
         yield(bundle) if block_given?
         # TODO: validate bundle with bundle.validate!
         bundle
       end
-      
-      # 
+
+      #
       # Prepares the +tag+ param for an API request.
-      # 
+      #
       # Creates and returns a <tt>WWW::Delicious::Tag</tt> instance from <tt>name_or_tag</tt>.
       # <tt>name_or_tag</tt> can be either a string holding tag name
       # or a <tt>WWW::Delicious::Tag</tt> instance.
-      # 
+      #
       def prepare_param_tag(name_or_tag, &block) #  :yields: tag
         tag = case name_or_tag
           when WWW::Delicious::Tag
@@ -810,62 +811,62 @@ module WWW #:nodoc:
           else
             Tag.new(:name => name_or_tag.to_s)
           end
-        
+
         yield(tag) if block_given?
         # TODO: validate tag with tag.validate!
         raise "Invalid `tag` value supplied" unless tag.api_valid?
         tag
       end
-      
-      # 
+
+      #
       # Checks whether user given +params+ are valid against a defined collection of +valid_params+.
-      # 
+      #
       # === Examples
-      # 
+      #
       #   params = {:foo => 1, :bar => 2}
       #
       #   compare_params(params, [:foo, :bar])
       #   # => valid
-      # 
+      #
       #   compare_params(params, [:foo, :bar, :baz])
       #   # => raises
-      # 
+      #
       #   compare_params(params, [:foo])
       #   # => raises
-      # 
+      #
       # Raises::  WWW::Delicious::Error
-      # 
+      #
       def compare_params(params, valid_params)
         raise ArgumentError, "Expected `params` to be a kind of `Hash`" unless params.kind_of?(Hash)
         raise ArgumentError, "Expected `valid_params` to be a kind of `Array`" unless valid_params.kind_of?(Array)
-      
+
         # compute options difference
         difference = params.keys - valid_params
         raise Error, "Invalid params: `#{difference.join('`, `')}`" unless difference.empty?
       end
-    
-    
+
+
     module XMLUtils #:nodoc:
-      
+
       #
       # Returns the +xmlattr+ attribute value for current <tt>REXML::Element</tt>.
-      # 
+      #
       # If block is given and attribute value is not nil,
       # the content of the block is executed.
-      # 
+      #
       # === Examples
-      # 
+      #
       #   dom = REXML::Document.new('<a name="1"><b>foo</b><b>bar</b></a>')
-      # 
+      #
       #   dom.root.if_attribute_value(:name)
       #   # => "1"
-      # 
+      #
       #   dom.root.if_attribute_value(:name) { |v| v.to_i }
       #   # => 1
-      # 
+      #
       #   dom.root.if_attribute_value(:foo)
       #   # => nil
-      # 
+      #
       #   dom.root.if_attribute_value(:name) { |v| v.to_i }
       #   # => nil
       #
@@ -878,7 +879,7 @@ module WWW #:nodoc:
         value = yield value if !value.nil? and block_given?
         value
       end
-      
+
       #
       # Returns the value of +expression+ child of this element, if it exists.
       # If blog is given, block is called on +expression+ element value
@@ -891,7 +892,7 @@ module WWW #:nodoc:
           value
         end
       end
-      
+
       #
       # Executes the content of +block+ on +expression+
       # child of this element, if it exists.
@@ -905,7 +906,7 @@ module WWW #:nodoc:
           nil
         end
       end
-    
+
     end # XMLUtils
 
   end
@@ -913,24 +914,24 @@ end
 
 
 class Object
-  
+
   # An object is blank if it's false, empty, or a whitespace string.
   # For example, "", "   ", +nil+, [], and {} are blank.
-  # 
+  #
   # This simplifies
-  # 
+  #
   #   if !address.nil? && !address.empty?
-  # 
+  #
   # to
-  # 
+  #
   #   if !address.blank?
   #
   # Object#blank? comes from the GEM ActiveSupport 2.1.
-  # 
-  def blank? 
+  #
+  def blank?
     respond_to?(:empty?) ? empty? : !self
-  end unless Object.method_defined? :blanks?
-  
+  end unless Object.method_defined? :blank?
+
 end