rubycious 0.1.0

data/Manifest

@@ -0,0 +1,6 @@
+Manifest
+README.rdoc
+Rakefile
+config/auth.yml
+lib/client_helper.rb
+lib/rubycious.rb

data/README.rdoc

@@ -0,0 +1,3 @@
+= Rubycious
+
+A Ruby gem wrapper to the del.icio.us API. nuff' said.

data/Rakefile

@@ -0,0 +1,14 @@
+require 'rubygems'  
+require 'rake'  
+require 'echoe'  
+
+Echoe.new('rubycious', '0.1.0') do |p|  
+  p.description     = "Ruby wrapper to the del.icio.us API"  
+  p.url             = "http://github.com/rjsvlajean/rubycious"  
+  p.author          = "Ratan Sebastian"  
+  p.email           = "rjsvaljean@gmail.com"  
+  p.ignore_pattern  = ["tmp/*", "script/*"]  
+  p.development_dependencies = []
+end  
+
+Dir["#{File.dirname(__FILE__)}/tasks/*.rake"].sort.each { |ext| load ext }  

data/config/auth.yml

@@ -0,0 +1,2 @@
+username: arjayes
+password: ./haq764

data/lib/client_helper.rb

@@ -0,0 +1,40 @@
+module ClientHelper
+  def self.included(base)
+    base.class_eval do
+      include HTTParty
+      include Rubycious::Errors
+
+      base_uri "https://api.del.icio.us/v1"
+      basic_auth base.new.username, base.new.password
+      format :xml
+
+      def initialize(auth_options = {:username => nil, :password => nil})
+        @username, @password= auth_options[:username], auth_options[:password]
+      end
+    end
+  end
+
+  def config
+    @config= YAML::load(File.read(File.join(ROOT_DIR,'config','auth.yml')))
+  end
+  
+  def username
+    if username = self.instance_variable_get('@username') || config["username"]
+      instance_variable_set('@username', username)
+      username
+    else
+      raise AuthenticationError, "Couldn't find username"
+    end
+  end
+
+  def password
+    if password = self.instance_variable_get('@username') || config["password"]
+      instance_variable_set('@password', password)
+      password
+    else
+      raise AuthenticationError, "Couldn't find password"
+    end
+  end
+
+end
+

data/lib/rubycious.rb

@@ -0,0 +1,200 @@
+require 'httparty'
+
+ROOT_DIR= File.join(File.dirname(__FILE__),'..')
+# load File.join(ROOT_DIR, 'lib', 'errors.rb')
+load File.join(ROOT_DIR, 'lib', 'client_helper.rb')
+# load File.join(ROOT_DIR, 'lib', 'client.rb')
+
+module Rubycious
+
+
+  module Errors
+
+    class DeliciousError < StandardError
+    end
+
+    class AuthenticationError < StandardError
+    end
+
+    def handle_errors
+      response= yield
+      if response.keys.include?("result")
+        if response["result"].match("done")
+          response
+        else
+          raise DeliciousError, response["result"]["code"]
+        end
+      else
+        response
+      end
+    end
+  end
+
+  module Client
+    def self.last_update
+      response= self.new.handle_errors do
+        get('/posts/update')
+      end
+      Time.parse(response["update"]["time"])
+    end
+
+    class Post
+      include ClientHelper
+
+      base_uri "#{base_uri}/posts"
+
+      # Options
+      # :url => (required) http://somelink.com/somepage
+      # :description => (required) This is a really cool link that I found
+      # :dt => (optional) CCYY-MM-DDThh:mm:ssZ filter by date
+      # :hash => (optional) MD5+MD5+....+MD5  Fetch multiple bookmarks by one or more URL MD5s regardless of date, separated by URL-encoded spaces (ie. '+').
+      # :extended => (optional) This is some further information about the link
+      # :tags => (optional) space seporated list of tags
+      # :replace => (optional) yes/no
+      # :shared => (optional) yes/no
+      def save
+        handle_errors { self.class.get('/add', :query => @options) }
+      end
+
+      # Options:
+      # :tag => "ruby+rails+httparty"
+      # :dt => CCYY-MM-DDThh:mm:ssZ
+      # :url => URL
+      # :hashes => "c0238dc0c44f07daedd9a1fd9bbdeebd+2f9704c729e7ed3b41647b7d0ad649fe+..+2f9704c729e7ed3b41647b7d0ad649fe"
+      # :meta => yes/no to indicate whether or not to retreive the meta hash tag
+      # METHOD DEPRECATED due to uselessness
+      def find_latest(options)
+        response= handle_errors { self.class.get('/get', :query => options)}
+        response["posts"]
+      end
+
+      # Options:
+      # :tag =>(optional)  "ruby"
+      # :start =>(optional)  Integer: Start returning posts this many results into the set
+      # :results =>(optional)  Integer: Return these many results 
+      # :fromdt =>(optional)  {Time#iso8601}: On this date or later
+      # :todt =>(optional)  {Time#iso8601}: On this date or earlier
+      # :meta =>(optional)  yes/no: Include change detection signatures on each item in a 'meta' attribute. Clients wishing to maintain a synchronized local store of bookmarks should retain the value of this attribute - its value will change when any significant field of the bookmark changes.
+      # NOTE: Use Sparingly. Call the update function to see if you need to fetch this at all.
+      def find(options)
+        response= handle_errors { self.class.get('/all', :query => options)}
+        response["posts"]["post"].collect{|i| Rubycious::Post.new(i)}
+      end
+
+      # Options:
+      # :tag => (optional) "httparty"
+      # :count => (optional) Integer // Default: 15 Max: 100 
+      def recent(options = nil)
+        response= handle_errors { self.class.get('/recent', :query => options)}
+        response["posts"]["post"].collect{|i| Rubycious::Post.new(i)}
+      end
+
+      # Options:
+      # :tag => (optional) "tutorial"
+      def dates(options = nil)
+        response= handle_errors{ self.class.get('/dates', :query => options)}
+        response["dates"]["date"].collect{|i| Rubycious::PostDate.new(i)}
+      end
+
+      # Options:
+      # :url => (required) URL
+      def suggest(options)
+        response= handle_errors{ self.class.get('/suggest', :query => options)}
+        response["suggest"]
+      end
+    end
+
+    class Tag
+      include ClientHelper
+
+      base_uri "#{base_uri}/tags"
+
+      def all
+        response= handle_errors{ self.class.get('/get')}
+        response["tags"]["tag"].collect do |tag| 
+          t= Rubycious::Tag.new(tag)
+        end
+      end
+      #Options:
+      # :tag => (required)
+      def delete(options)
+        response= handle_errors{ self.class.get('/delete', :query => options)}
+        true if response["result"] == "done"
+      end
+      
+      #Options:
+      # :old => (required)
+      # :new => (required)
+      def rename(options)
+        response= handle_errors{ self.class.get('/rename', :query => options)}
+        true if response["result"] == "done"
+      end
+    end
+
+    class Bundles
+      include ClientHelper
+
+      base_uri "#{base_uri}/tags/bundles"
+    end
+  end
+
+  class PostDate
+    # Attributes:
+    # date: Date
+    # count: Integer
+
+    attr_accessor :date, :count
+
+    def initialize(options)
+      @date= Date.parse(options["date"])
+      @count= options["count"].to_i
+    end
+  end
+
+  class Post
+    # Attributes
+    # :href => (required) http://somelink.com/somepage
+    # :description => (required) This is a really cool link that I found
+    # :time => (optional) CCYY-MM-DDThh:mm:ssZ filter by date
+    # :hash => (optional) (only for find) MD5+MD5+....+MD5  Fetch multiple bookmarks by one or more URL MD5s regardless of date, separated by URL-encoded spaces (ie. '+').
+    # :extended => (optional) This is some further information about the link
+    # :tag => (optional) space seporated list of tags
+    # :meta => (optional) meta hash
+
+    def initialize(params = nil)
+      @params= params
+      @attributes= [:href, :description, :time, :hash, :extended, :tag, :meta]
+    end
+
+    def method_missing(name, *args, &block)
+      if @attributes.include?(name)
+        if name == :time
+          Time.parse(@params[name.to_s])
+        else
+          @params[name.to_s]
+        end
+      else
+        raise NoMethodError
+      end
+    end
+  end
+
+  class Tag
+    attr_accessor :name, :count
+    
+    def initialize(options = {"tag" => nil})
+      @name=  options["tag"]
+      @count= options["count"]
+    end
+
+    def delete
+      client= Rubycious::Client::Tag.new
+      client.delete(:tag => @name)
+    end
+
+    def rename(new_name)
+      client= Rubycious::Client::Tag.new
+      client.rename(:old => @name, :new => new_name)
+    end
+  end
+end

data/rubycious.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{rubycious}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Ratan Sebastian"]
+  s.date = %q{2010-05-12}
+  s.description = %q{Ruby wrapper to the del.icio.us API}
+  s.email = %q{rjsvaljean@gmail.com}
+  s.extra_rdoc_files = ["README.rdoc", "lib/client_helper.rb", "lib/rubycious.rb"]
+  s.files = ["Manifest", "README.rdoc", "Rakefile", "config/auth.yml", "lib/client_helper.rb", "lib/rubycious.rb", "rubycious.gemspec"]
+  s.homepage = %q{http://github.com/rjsvlajean/rubycious}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Rubycious", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{rubycious}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Ruby wrapper to the del.icio.us API}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification 
+name: rubycious
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Ratan Sebastian
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-05-12 00:00:00 +05:30
+default_executable: 
+dependencies: []
+
+description: Ruby wrapper to the del.icio.us API
+email: rjsvaljean@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- lib/client_helper.rb
+- lib/rubycious.rb
+files: 
+- Manifest
+- README.rdoc
+- Rakefile
+- config/auth.yml
+- lib/client_helper.rb
+- lib/rubycious.rb
+- rubycious.gemspec
+has_rdoc: true
+homepage: http://github.com/rjsvlajean/rubycious
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Rubycious
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: rubycious
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Ruby wrapper to the del.icio.us API
+test_files: []
+