laco-www-delicious 0.3.2

data/lib/www/delicious/post.rb

@@ -0,0 +1,123 @@
+# 
+# = WWW::Delicious
+#
+# Ruby client for del.icio.us API.
+# 
+#
+# Category::    WWW
+# Package::     WWW::Delicious
+# Author::      Simone Carletti <weppos@weppos.net>
+# License::     MIT License
+#
+#--
+#
+#++
+
+
+require 'www/delicious/element'
+
+
+module WWW
+  class Delicious
+    
+    class Post < Element
+      
+      # The Post URL
+      attr_accessor :url
+      
+      # The title of the Post
+      attr_accessor :title
+      
+      # The extended description for the Post
+      attr_accessor :notes
+      
+      # The number of other users who saved this Post
+      attr_accessor :others
+      
+      # The unique Id for this Post
+      attr_accessor :uid
+      
+      # Tags for this Post
+      attr_accessor :tags
+      
+      # Timestamp this Post was last saved at
+      attr_accessor :time
+      
+      # Whether this Post must replace previous version of the same Post.
+      attr_accessor :replace
+      
+      # Whether this Post is private
+      attr_accessor :shared
+      
+      
+      # Returns the value for <tt>shared</tt> attribute.
+      def shared
+        !(@shared == false)
+      end
+      
+      # Returns the value for <tt>replace</tt> attribute.
+      def replace
+        !(@replace == false)
+      end
+      
+      # Returns a params-style representation suitable for API calls.
+      def to_params()
+        params = {}
+        params[:url]          = url
+        params[:description]  = title
+        params[:extended]     = notes if notes
+        params[:shared]       = shared
+        params[:tags]         = tags
+        params[:replace]      = replace
+        params[:dt]           = WWW::Delicious::TIME_CONVERTER.call(time) if time
+        params
+      end
+      
+      
+      #
+      # Returns whether this object is valid for an API request.
+      # 
+      # To be valid +url+ and +title+ must not be empty.
+      # 
+      # === Examples
+      # 
+      #   post = WWW::Delicious::Post.new(:url => 'http://localhost', :title => 'foo')
+      #   post.api_valid?
+      #   # => true
+      #
+      #   post = WWW::Delicious::Post.new(:url => 'http://localhost')
+      #   post.api_valid?
+      #   # => false
+      #
+      def api_valid?
+        return !(url.nil? or url.empty? or title.nil? or title.empty?)
+      end
+      
+      
+      class << self
+        
+        # 
+        # Creates and returns new instance from a REXML +element+.
+        # 
+        # Implements Element#from_rexml.
+        # 
+        def from_rexml(element)
+          raise ArgumentError, "`element` expected to be a `REXML::Element`" unless element.kind_of? REXML::Element
+          self.new do |instance|
+            instance.url    = element.if_attribute_value(:href) { |v| URI.parse(v) }
+            instance.title  = element.if_attribute_value(:description)
+            instance.notes  = element.if_attribute_value(:extended)
+            instance.others = element.if_attribute_value(:others).to_i # cast nil to 0
+            instance.uid    = element.if_attribute_value(:hash)
+            instance.tags   = element.if_attribute_value(:tag)  { |v| v.split(' ') }.to_a
+            instance.time   = element.if_attribute_value(:time) { |v| Time.parse(v) }
+            instance.shared = element.if_attribute_value(:shared) { |v| v == 'no' ? false : true }
+          end
+        end
+        
+      end
+      
+    end
+    
+  end
+end

data/lib/www/delicious/tag.rb

@@ -0,0 +1,101 @@
+# 
+# = WWW::Delicious
+#
+# Ruby client for del.icio.us API.
+# 
+#
+# Category::    WWW
+# Package::     WWW::Delicious
+# Author::      Simone Carletti <weppos@weppos.net>
+# License::     MIT License
+#
+#--
+#
+#++
+
+
+require 'www/delicious/element'
+
+
+module WWW
+  class Delicious
+
+    #
+    # = Delicious Tag
+    # 
+    # Represents a single Tag element.
+    #
+    class Tag < Element
+      
+      # The name of the tag.
+      attr_accessor :name
+      
+      # The number of links tagged with this tag.
+      # It should be set only from an API response.
+      attr_accessor :count
+      
+      
+      # Returns value for <tt>name</tt> attribute.
+      # Value is always normalized as lower string.
+      def name
+        @name.to_s.strip unless @name.nil?
+      end
+      
+      # Returns value for <tt>count</tt> attribute.
+      # Value is always normalized to Fixnum.
+      def count
+        @count.to_i
+      end
+      
+      #
+      # Returns a string representation of this Tag.
+      # In case name is nil this method will return an empty string.
+      #
+      def to_s
+        name.to_s
+      end
+      
+      
+      public
+      #
+      # Returns wheter this object is valid for an API request.
+      # 
+      # To be valid +name+ must not be empty.
+      # +count+ can be 0.
+      # 
+      # === Examples
+      # 
+      #   tag = WWW::Delicious::Tag.new(:name => 'foo')
+      #   tag.api_api_valid?
+      #   # => true
+      #
+      #   tag = WWW::Delicious::Tag.new(:name => '  ')
+      #   tag.api_api_valid?
+      #   # => false
+      #
+      def api_valid?
+        return !name.empty?
+      end
+      
+      
+      class << self
+        
+        # 
+        # Creates and returns new instance from a REXML +element+.
+        # 
+        # Implements Element#from_rexml.
+        # 
+        def from_rexml(element)
+          raise ArgumentError, "`element` expected to be a `REXML::Element`" unless element.kind_of? REXML::Element
+          self.new do |instance|
+            instance.name  = element.if_attribute_value(:tag)
+            instance.count = element.if_attribute_value(:count) { |value| value.to_i }
+          end
+        end
+        
+      end
+      
+    end
+    
+  end
+end

data/lib/www/delicious/version.rb

@@ -0,0 +1,33 @@
+# 
+# = WWW::Delicious
+#
+# Ruby client for del.icio.us API.
+# 
+#
+# Category::    WWW
+# Package::     WWW::Delicious
+# Author::      Simone Carletti <weppos@weppos.net>
+# License::     MIT License
+#
+#--
+#
+#++
+
+
+module WWW
+  class Delicious
+
+    module Version
+      MAJOR = 0
+      MINOR = 3
+      TINY  = 2
+
+      STRING = [MAJOR, MINOR, TINY].join('.')
+    end
+
+    VERSION         = Version::STRING
+    STATUS          = 'beta'
+    BUILD           = ''.match(/(\d+)/).to_a.first
+
+  end
+end