hatenabm 0.1.0

data/ChangeLog

@@ -0,0 +1,6 @@
+= HatenaBM  Changelog
+
+== Version 0.1.0
+initial release
+
+* initial release

data/README

@@ -0,0 +1,53 @@
+= HatenaBM
+
+HatenaBM is Hatena Bookmark (Japanese Social Bookmark Service) binding for Ruby.
+
+Hatena Bookmark : http://b.hatena.ne.jp
+Hatena Bookmark API Reference (Japanese) : http://d.hatena.ne.jp/keyword/%A4%CF%A4%C6%A4%CA%A5%D6%A5%C3%A5%AF%A5%DE%A1%BC%A5%AFAtomAPI
+
+== Installation
+
+ $ sudo gem install hatenabm
+
+== Usage
+
+ require 'rubygems'
+ require 'hatenabm'
+ require 'pp'
+
+ # initialize
+ hbm = HatenaBM.new(
+   :user => "username",
+   :pass => "password"
+ )
+ 
+ # post new bookmark
+ hbm.post(
+   :title => "bookmark's title",  # title
+   :link => "http://www.example.com", # url
+   :tags => "foo bar", # tags (separate space)
+   :summary => "this is example post." # description of this bookmark
+ )
+ 
+ # show recent bookmarks (Atom Format)
+ pp hbm.recent
+ 
+ # show specified bookmark
+ pp hbm.get(:eid => "4211817")  # eid - bookmark's id
+ 
+ # modify posted bookmark
+ hbm.modify(
+   :eid => "421817",  # eid
+   :tags => "bar com",  # tags (separate space)
+   :summary => "modify bookmark's description"
+ )
+ 
+ # delete specified bookmark
+ hbm.delete(:eid => "421817")  # eid
+
+== Author 
+-  drawnboy ( http://d.hatena.ne.jp/drawnboy ) <drawn.boy@gmail.com.nospam> 
+-  s-tanaka ( http://d.hatena.ne.jp/ha-tan )is written by get_wsse method
+-  gorou ( http://rails2u.com )
+
+License::  2-clause BSD Lisence 

data/lib/hatenabm.rb

@@ -0,0 +1,160 @@
+require 'net/http'
+require 'time'
+require 'digest/sha1'
+require 'base64'
+
+# if using ruby 1.9.0 earlier, define HTTP DELETE Method
+if RUBY_VERSION < '1.9.0'
+  module Net
+    class HTTP
+      class Delete < HTTPRequest
+        METHOD = 'DELETE'
+        REQUEST_HAS_BODY  = false
+        RESPONSE_HAS_BODY = true
+      end
+      def delete(path,initheader = nil)
+        res = request(Delete.new(path,initheader))
+        res.value unless @newimpl
+        res
+      end 
+    end
+  end 
+end
+
+class HatenaBM
+
+  VERSION = "0.0.3"
+
+  HATENA_URL = "b.hatena.ne.jp"
+  FEED_PATH = "/atom/feed"
+  POST_PATH = "/atom/post"
+  EDIT_PATH = "/atom/edit/"
+
+  def initialize(options)
+    user = options[:user]
+    pass = options[:pass]
+    @wsse = get_wsse(user, pass)
+  end
+
+  # Post new bookmark
+  # args: title, link, summary, tags
+  def post(options)
+    title = options[:title]
+    link = options[:link]
+    summary = options[:summary] || nil 
+    tags = options[:tags] || nil
+    header = {
+      "Content-Type" => 'application/x.atom+xml; charset="utf-8"', 
+      "X-WSSE" => @wsse
+    }
+    tags = "[#{tags.split(/\s/).join('][')}]" unless tags.nil?
+
+    data =<<-EOF
+<?xml version="1.0"?>
+<entry xmlns="http://purl.org/atom/ns#">
+  <title>#{title}</title>
+  <link rel="related" type="text/html" href="#{link}" />
+  <summary type="text/plain">#{tags}#{summary}</summary>
+</entry>
+    EOF
+
+    Net::HTTP.version_1_2
+    Net::HTTP.start(HATENA_URL){|http|
+      response = http.post(POST_PATH, toutf8(data), header)
+      raise "Post Error : #{response.code} - #{response.message}" unless response.code == "201"
+      return true
+    }
+  end
+
+  # Get recent bookmarks
+  def recent
+    header = { "X-WSSE" => @wsse }
+    Net::HTTP.version_1_2
+    Net::HTTP.start(HATENA_URL){|http|
+      response = http.get(FEED_PATH, header)
+      return response.body
+    }
+  end
+
+  # Get specified bookmark
+  # args : eid
+  def get(options)
+    eid = options[:eid] || nil
+    raise "Get Error : Invalid eid" if eid.nil?
+    api_path = EDIT_PATH + eid
+    header = { "X-WSSE"=> @wsse }
+
+    Net::HTTP.version_1_2
+    Net::HTTP.start(HATENA_URL){|http|
+      response = http.get(api_path, header)
+      return response.body
+    }
+  end
+
+  # Modify specified bookmark
+  # args: eid, title, tags
+  def modify(options)
+    eid = options[:eid] || nil
+    title = options[:title] || nil
+    tags = options[:tags] || nil
+    summary = options[:summary] || nil
+
+    raise "Edit Error : need eid" if eid.nil?
+
+    api_path = EDIT_PATH + eid
+    header = { "X-WSSE" => @wsse }
+    tags = "[#{tags.split(/\s/).join('][')}]" unless tags.nil?
+
+    data  = "<?xml version=\"1.0\"?>"
+    data << "<entry xmlns=\"http://purl.org/atom/ns#\">"
+    data << "<title>#{title}</title>" unless title.nil?
+    data << "<summary type=\"text/plain\">#{tags}#{summary}</summary>" unless summary.nil?
+    data << "</entry>"
+
+    Net::HTTP.version_1_2
+    Net::HTTP.start(HATENA_URL){|http|
+      response = http.put(api_path, toutf8(data), header)
+      raise "Edit Error : #{response.code} - #{response.message}" unless response.code == "200"
+      return true
+    }
+
+  end
+
+  # Delete specified bookmark
+  # args: eid
+  def delete(options)
+    eid = options[:eid] || nil
+    raise "Delete Error : Invalid eid" if eid.nil?
+    api_path = EDIT_PATH + eid
+    header = { "X-WSSE" => @wsse }
+
+    Net::HTTP.version_1_2
+    Net::HTTP.start(HATENA_URL){|http|
+      response = http.delete(api_path, header)
+      raise "Delete Error : #{response.code} - #{response.message}" unless response.code == "200"
+      return true
+    }
+  end
+
+  # Calculate WSSE Header method
+  private
+  def get_wsse(user, pass)
+    created = Time.now.iso8601
+  
+    nonce = ''
+    20.times do 
+      nonce << rand(256).chr
+    end
+    
+    passdigest = Digest::SHA1.digest(nonce + created + pass)
+  
+    return "UsernameToken Username=\"#{user}\", " +
+      "PasswordDigest=\"#{Base64.encode64(passdigest).chomp}\", " + 
+      "Nonce=\"#{Base64.encode64(nonce).chomp}\", " +
+      "Created=\"#{created}\""
+  end
+
+  def toutf8(str)
+    Kconv.toutf8(str)
+  end
+end

data/test/test_hatenabm.rb

@@ -0,0 +1,75 @@
+require 'test/unit'
+require 'hatenabm'
+
+class TestHatenaBM < Test::Unit::TestCase
+
+  def setup
+    @hatenabm = HatenaBM.new(:user => "username", :pass => "password")
+  end
+
+  def test_recent
+    assert_match(
+      /^<\?xml version=\"1\.0\" encoding=\"utf\-8\"\?>/,
+      @hatenabm.recent
+    )
+  end
+  
+  def test_post
+    assert_equal(
+      true,
+      @hatenabm.post(
+        :title => "bookmark's title", 
+        :link => "http://www.example.com",
+        :tags => "foo bar",
+        :summary => "this is example post."
+      )
+    )
+  end
+
+  def test_get 
+    assert_match(
+      /^<\?xml version=\"1\.0\" encoding=\"utf\-8\"\?>/,
+      @hatenabm.get(:eid => "4211817")
+    )
+  end
+
+  def test_modify
+    assert(
+      true,
+      @hatenabm.modify(
+        :eid => "421817", 
+        :tags => "bar com",
+        :summary => "modify bookmark's description"
+      )
+    )
+  end
+
+  def test_delete
+    assert(
+      true,
+      @hatenabm.delete(:eid => "421817")
+    )
+  end
+  
+  def test_invalid_access
+    assert_raises(RuntimeError) do
+      @hatenabm.post(:title => "invalid", :summary => "summary")
+    end
+
+    assert_raises(RuntimeError) do
+      @hatenabm.get(:invalide => "421817")
+    end
+
+    assert_raises(RuntimeError) do
+      @hatenabm.modify(:summary => "summary")
+    end
+
+    assert_raises(RuntimeError) do
+      @hatenabm.delete(:invalid => "421817")
+    end
+
+    assert_raises(RuntimeError) do
+      @hatenabm.delete(:eid => "invalid")
+    end
+  end
+end

metadata

@@ -0,0 +1,44 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.8.10
+specification_version: 1
+name: hatenabm
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+date: 2005-10-14
+summary: Hatena Bookmark AtomAPI binding for Ruby
+require_paths: 
+  - lib
+email: drawn.boy@gmail.com.nospam
+homepage: http://hatenabm.rubyforge.org
+rubyforge_project: 
+description: 
+autorequire: cool
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+    - 
+      - ">"
+      - !ruby/object:Gem::Version 
+        version: 0.0.0
+  version: 
+platform: ruby
+authors: 
+  - drawnboy
+files: 
+  - test/test_hatenabm.rb
+  - lib/hatenabm.rb
+  - README
+  - ChangeLog
+test_files: 
+  - test/test_hatenabm.rb
+rdoc_options: 
+  - "--main"
+  - README
+extra_rdoc_files: 
+  - README
+executables: []
+extensions: []
+requirements: []
+dependencies: []