hatena-bookmark-restful 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a8263ea79da036e3c5185b5fad03fb57469052a7
+  data.tar.gz: 618a5bb0b065737ef075f884298be82637d33c52
+SHA512:
+  metadata.gz: ff07f9681bbf047ee5cc678e19a6c8a51dff76d486ee62149a9a4f98b978a4d1922772cbcee97a189772fcf7b462f8293517e8f2ba1893a0a508426d702b235b
+  data.tar.gz: a9c7056464cbb3bcb825361f6602517bd67e33aea6627333ddf32f3e909f029eb02748fd7fc5a2cda738e89903a315e57b64df4f78ae038ec95c9e83d7497d3a

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

@@ -0,0 +1,21 @@
+---
+language: ruby
+rvm:
+  - 2.1.0
+  - 2.0.0
+  - 1.9.3
+  - jruby-19mode
+  - ruby-head
+  - jruby-head
+bundler_args: -j4
+before_install:
+  - gem update --system
+  - gem --version
+  - gem install bundler --pre
+script: bundle exec rake spec
+matrix:
+  allow_failures:
+    -
+      rvm:
+        - ruby-head
+        - jruby-head

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in hatena-bookmark-restful.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 aereal
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,49 @@
+ * `master` status: ![master Build Status](https://travis-ci.org/aereal/hatena-bookmark-restful.png?branch=master)
+ * `develop` status: ![develop Build Status](https://travis-ci.org/aereal/hatena-bookmark-restful.png?branch=develop)
+
+# Hatena::Bookmark::Restful
+
+A client library for [Hatena::Bookmark RESTful API](http://developer.hatena.ne.jp/ja/documents/bookmark/apis/rest).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'hatena-bookmark-restful'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install hatena-bookmark-restful
+
+## Usage
+
+**NOTICE**: You must read and agree to [terms of services (in Japanese)](http://developer.hatena.ne.jp/ja/license) before using the API.
+
+```
+require 'hatena/bookmark/restful/v1'
+CONSUMER_KEY        = 'YOUR_CONSUMER_KEY'
+CONSUMER_SECRET     = 'YOUR_CONSUMER_SECRET'
+ACCESS_TOKEN        = 'YOUR_ACCESS_TOKEN'
+ACCESS_TOKEN_SECRET = 'YOUR_ACCESS_TOKEN_SECRET'
+
+client = Hatena::Bookmark::Restful::V1.new(
+  consumer_key:        CONSUMER_KEY,
+  consumer_secret:     CONSUMER_SECRET,
+  access_token:        ACCESS_TOKEN,
+  access_token_secret: ACCESS_TOKEN_SECRET
+)
+
+client.bookmark('http://www.hatena.ne.jp/')
+```
+
+## Contributing
+
+1. Fork it ( http://github.com/aereal/hatena-bookmark-restful/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,64 @@
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require "semantic"
+require "yard"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec
+
+def update_version!(file_path)
+  old_file = File.read(file_path)
+  version_str = old_file[VERSION_PATTERN, 1]
+  old_version = Semantic::Version.new(version_str)
+  new_version = yield old_version
+  modified = old_file.sub(VERSION_PATTERN, new_version.to_s)
+  File.open(file_path, 'w') {|f| f.write(modified) }
+  warn "#{old_version} => #{new_version}"
+end
+
+VERSION_FILE = 'lib/hatena/bookmark/restful/version.rb'
+VERSION_PATTERN = /(\d+\.\d+\.\d+)(-([0-9A-Za-z-]+(\.[0-9A-Za-z-]+)*))?(\+([0-9A-Za-z-]+(\.[0-9A-Za-z-]+)*))?/.freeze # Stolen from Semantic::Version::SemVerRegexp
+namespace :version do
+  namespace :major do
+    desc "bump major version"
+    task :bump => VERSION_FILE do |t|
+      update_version!(t.prerequisites.first) do |new_version|
+        new_version.tap do |version|
+          version.major += 1
+          version.minor = 0
+          version.patch = 0
+        end
+      end
+    end
+  end
+
+  namespace :minor do
+    desc "bump minor version"
+    task :bump => VERSION_FILE do |t|
+      update_version!(t.prerequisites.first) do |new_version|
+        new_version.tap do |version|
+          version.minor += 1
+          version.patch = 0
+        end
+      end
+    end
+  end
+
+  namespace :patch do
+    desc "bump patch version"
+    task :bump => VERSION_FILE do |t|
+      update_version!(t.prerequisites.first) do |new_version|
+        new_version.tap do |version|
+          version.patch += 1
+        end
+      end
+    end
+  end
+end
+
+YARD::Rake::YardocTask.new(:doc) do |t|
+  spec = Gem::Specification.find_by_name('hatena-bookmark-restful')
+  t.files = spec.lib_files
+  t.options = %w( --readme README.md )
+end

data/hatena-bookmark-restful.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'hatena/bookmark/restful/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "hatena-bookmark-restful"
+  spec.version       = Hatena::Bookmark::Restful::VERSION
+  spec.authors       = ["aereal"]
+  spec.email         = ["aereal@aereal.org"]
+  spec.summary       = %q{A client library for Hatena::Bookmark RESTful API}
+  spec.description   = %q{A client library for Hatena::Bookmark RESTful API}
+  spec.homepage      = "https://github.com/aereal/hatena-bookmark-restful"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_runtime_dependency "faraday"
+  spec.add_runtime_dependency "faraday_middleware"
+  spec.add_runtime_dependency "simple_oauth"
+  spec.add_development_dependency "bundler", "~> 1.5"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+  spec.add_development_dependency "semantic"
+  spec.add_development_dependency "yard"
+end

data/lib/hatena-bookmark-restful.rb

@@ -0,0 +1 @@
+require "hatena/bookmark/restful"

data/lib/hatena/bookmark/restful.rb

@@ -0,0 +1,8 @@
+require "hatena/bookmark/restful/version"
+
+module Hatena
+  module Bookmark
+    module Restful
+    end
+  end
+end

data/lib/hatena/bookmark/restful/v1.rb

@@ -0,0 +1,110 @@
+require 'faraday'
+require 'faraday_middleware'
+require 'json'
+require 'hatena/bookmark/restful/v1/user'
+require 'hatena/bookmark/restful/v1/tag'
+require 'hatena/bookmark/restful/v1/entry'
+require 'hatena/bookmark/restful/v1/bookmark'
+
+module Hatena
+  module Bookmark
+    module Restful; end
+  end
+end
+
+class Hatena::Bookmark::Restful::V1
+  BASE_URI = 'http://api.b.hatena.ne.jp'
+  API_VERSION = '1'
+
+  class Credentials
+    # @!attribute [rw] consumer_key
+    #   @return [String]
+    # @!attribute [rw] consumer_secret
+    #   @return [String]
+    # @!attribute [rw] access_token
+    #   @return [String]
+    # @!attribute [rw] access_token_secret
+    #   @return [String]
+    attr_accessor :consumer_key, :consumer_secret, :access_token, :access_token_secret
+
+    # @param [Hash] attributes
+    # @option attributes [String] :consumer_key
+    # @option attributes [String] :consumer_secret
+    # @option attributes [String] :access_token
+    # @option attributes [String] :access_token_secret
+    def initialize(attributes)
+      @consumer_key        = attributes.fetch(:consumer_key)
+      @consumer_secret     = attributes.fetch(:consumer_secret)
+      @access_token        = attributes.fetch(:access_token)
+      @access_token_secret = attributes.fetch(:access_token_secret)
+    end
+  end
+
+  def initialize(credentials)
+    @credentials = credentials
+  end
+
+  # @return [User]
+  def my
+    res = connection.get("/#{api_version}/my")
+    attrs = JSON.parse(res.body)
+    user = User.new_from_response(attrs)
+  end
+
+  # @return [<Tag>]
+  def my_tags
+    res = connection.get("/#{api_version}/my/tags")
+    attrs = JSON.parse(res.body)
+    raw_tags = attrs.fetch('tags')
+    tags = raw_tags.map {|t| Tag.new_from_response(t) }
+  end
+
+  # @return [Entry]
+  def entry(url)
+    res = connection.get("/#{api_version}/entry", url: url)
+    attrs = JSON.parse(res.body)
+    entry = Entry.new_from_response(attrs)
+  end
+
+  # @return [Bookmark]
+  def bookmark(url)
+    res = connection.get("/#{api_version}/my/bookmark", url: url)
+    attrs = JSON.parse(res.body)
+    bookmark = Bookmark.new_from_response(attrs)
+  end
+
+  # @return [Boolean]
+  def delete_bookmark(url)
+    res = connection.delete("/#{api_version}/my/bookmark", url: url)
+    res.success?
+  end
+
+  # @return [Bookmark]
+  def create_bookmark(bookmark_params)
+    res = connection.post("/#{api_version}/my/bookmark", bookmark_params)
+    attrs = JSON.parse(res.body)
+    bookmark = Bookmark.new_from_response(attrs)
+  end
+
+  def api_version
+    API_VERSION
+  end
+
+  def base_uri
+    BASE_URI
+  end
+
+  private
+
+  def connection
+    @connection ||= Faraday.new(url: base_uri) do |faraday|
+      faraday.request :url_encoded
+      faraday.request :oauth,
+        consumer_key:    @credentials.consumer_key,
+        consumer_secret: @credentials.consumer_secret,
+        token:           @credentials.access_token,
+        token_secret:    @credentials.access_token_secret
+      faraday.adapter Faraday.default_adapter
+    end
+  end
+end

data/lib/hatena/bookmark/restful/v1/bookmark.rb

@@ -0,0 +1,30 @@
+require "hatena/bookmark/restful/v1/response_object"
+
+module Hatena
+  module Bookmark
+    module Restful
+      class V1
+        class Bookmark
+          # @!attribute [r] comment
+          #   @return [String]
+          # @!attribute [r] created_datetime
+          #   @return [String]
+          # @!attribute [r] created_epoch
+          #   @return [Integer]
+          # @!attribute [r] user
+          #   @return [String]
+          # @!attribute [r] permalink
+          #   @return [String]
+          # @!attribute [r] private
+          #   @return [Boolean]
+          # @!attribute [r] tags
+          #   @note Return value is a array of **String representation of the tag**
+          #   @return [<String>]
+          PROPERTIES = [:comment, :created_datetime, :created_epoch, :user, :permalink, :private, :tags]
+
+          include Hatena::Bookmark::Restful::V1::ResponseObject
+        end
+      end
+    end
+  end
+end

data/lib/hatena/bookmark/restful/v1/entry.rb

@@ -0,0 +1,27 @@
+require "hatena/bookmark/restful/v1/response_object"
+
+module Hatena
+  module Bookmark
+    module Restful
+      class V1; end
+    end
+  end
+end
+
+class Hatena::Bookmark::Restful::V1::Entry
+  # @!attribute [r] title
+  #   @return [String]
+  # @!attribute [r] url
+  #   @return [String]
+  # @!attribute [r] entry_url
+  #   @return [String]
+  # @!attribute [r] count
+  #   @return [Integer]
+  # @!attribute [r] favicon_url
+  #   @return [String]
+  # @!attribute [r] smartphone_app_entry_url
+  #   @return [String]
+  PROPERTIES = [:title, :url, :entry_url, :count, :favicon_url, :smartphone_app_entry_url]
+
+  include Hatena::Bookmark::Restful::V1::ResponseObject
+end

data/lib/hatena/bookmark/restful/v1/response_object.rb

@@ -0,0 +1,48 @@
+module Hatena
+  module Bookmark
+    module Restful
+      class V1; end
+    end
+  end
+end
+
+module Hatena::Bookmark::Restful::V1::ResponseObject
+  module ClassMethods
+    # Create a new instance from JSON from the API
+    def new_from_response(res)
+      properties = self.const_get(:PROPERTIES)
+      names      = properties.map(&:to_s)
+      values     = res.values_at(*names)
+      attrs      = Hash[ properties.zip(values) ]
+      new(attrs)
+    end
+  end
+
+  def self.included(context)
+    properties = context.const_get(:PROPERTIES)
+    context.send(:extend, ClassMethods)
+    properties.each do |prop|
+      define_method(prop) { @attributes.fetch(prop) }
+    end
+  end
+
+  def initialize(attributes)
+    @attributes = attributes
+  end
+
+  # Fetch raw attribute value
+  # @param [Symbol] name The attribute's name
+  def [](name)
+    @attributes[name]
+  end
+
+  # @return [Boolean]
+  def ==(other)
+    other.is_a?(self.class) && self.class.const_get(:PROPERTIES).all? {|prop| self[prop] == other[prop] }
+  end
+
+  # @return [Hash]
+  def to_hash
+    @attributes
+  end
+end

data/lib/hatena/bookmark/restful/v1/tag.rb

@@ -0,0 +1,33 @@
+require "hatena/bookmark/restful/v1/response_object"
+
+module Hatena
+  module Bookmark
+    module Restful
+      class V1; end
+    end
+  end
+end
+
+class Hatena::Bookmark::Restful::V1::Tag
+  # @!attribute [r] tag
+  #   The name of tag
+  #   @return [String]
+  # @!attribute [r] count
+  #   The number of bookmarks with the tag
+  #   @return [Integer]
+  # @!attribute [r] modified_datetime
+  #   ISO 8601 representation of the last modified time
+  #   @return [String]
+  # @!attribute [r] modified_epoch
+  #   UNIX epoch of the last modified time
+  #   @return [Integer]
+  PROPERTIES = [:tag, :count, :modified_epoch, :modified_datetime]
+
+  include Hatena::Bookmark::Restful::V1::ResponseObject
+
+  # The last modified time
+  # @return [Time]
+  def modified_at
+    Time.at(self.modified_epoch)
+  end
+end

data/lib/hatena/bookmark/restful/v1/user.rb

@@ -0,0 +1,44 @@
+require "hatena/bookmark/restful/v1/response_object"
+
+module Hatena
+  module Bookmark
+    module Restful
+      class V1; end
+    end
+  end
+end
+
+class Hatena::Bookmark::Restful::V1::User
+  # @!attribute [r] name
+  #   User's Hatena ID
+  #   @return [String]
+  STRING_PROPERTIES  = [:name]
+  BOOLEAN_PROPERTIES = [:plususer, :private, :is_oauth_twitter, :is_oauth_evernote, :is_oauth_facebook, :is_oauth_mixi_check]
+  PROPERTIES         = STRING_PROPERTIES + BOOLEAN_PROPERTIES
+
+  include Hatena::Bookmark::Restful::V1::ResponseObject
+
+  # @!method plususer?
+  #   The user subscribed Hatena Bookmark Plus or not
+  #   @return [Boolean]
+  # @!method private?
+  #   The user does not share his/her bookmarks with anyone or not
+  #   @return [Boolean]
+  # @!method oauth_twitter?
+  #   Connected with Twitter using OAuth or not
+  #   @return [Boolean]
+  # @!method oauth_evernote?
+  #   Connected with Evernote using OAuth or not
+  #   @return [Boolean]
+  # @!method oauth_facebook?
+  #   Connected with Facebook using OAuth or not
+  #   @return [Boolean]
+  # @!method oauth_mixi_check?
+  #   Connected with mixi check using OAuth or not
+  #   @return [Boolean]
+  BOOLEAN_PROPERTIES.each do |prop|
+    define_method(prop.to_s.gsub(/^is_/, '')) do
+      @attributes.fetch(prop)
+    end
+  end
+end

data/lib/hatena/bookmark/restful/version.rb

@@ -0,0 +1,7 @@
+module Hatena
+  module Bookmark
+    module Restful
+      VERSION = "0.1.0"
+    end
+  end
+end

data/spec/hatena/bookmark/restful/v1_spec.rb

@@ -0,0 +1,219 @@
+# encoding: utf-8
+
+require 'hatena/bookmark/restful/v1'
+require 'json'
+
+shared_context "send a HTTP request to API" do
+  subject { raise "The example group must give real `subject`" }
+
+  let(:api_path) { raise "The example group must give real `api_path`" }
+
+  let(:stubbed_response) {
+    [
+      200,
+      {},
+      response_body
+    ]
+  }
+
+  let(:test_connection) {
+    Faraday.new do |builder|
+      builder.adapter :test do |stubs|
+        stubs.get(api_path) { stubbed_response }
+      end
+    end
+  }
+
+  before do
+    allow(client).to receive(:connection).and_return(test_connection)
+  end
+end
+
+describe Hatena::Bookmark::Restful::V1 do
+  let(:credentials) { Hatena::Bookmark::Restful::V1::Credentials.new(consumer_key: '', consumer_secret: '', access_token: '', access_token_secret: '') }
+  let(:client) { Hatena::Bookmark::Restful::V1.new(credentials) }
+
+  describe "#create_bookmark" do
+    let(:stubbed_response) {
+      [
+        200,
+        {},
+        JSON.dump(bookmark.to_hash)
+      ]
+    }
+
+    let(:test_connection) {
+      Faraday.new do |builder|
+        builder.adapter :test do |stubs|
+          stubs.post(api_path) { stubbed_response }
+        end
+      end
+    }
+
+    let(:api_path) { "/1/my/bookmark" }
+
+    let(:request_params) {
+      {
+        url: 'http://www.hatena.ne.jp/',
+        comment: 'おもしろホームページです',
+        tags: %w( hatena ),
+        post_twitter: false,
+        post_facebook: false,
+        post_mixi: false,
+        post_evernote: false,
+        send_mail: false,
+        private: false,
+      }
+    }
+
+    let(:bookmark) {
+      Hatena::Bookmark::Restful::V1::Bookmark.new_from_response(
+        'comment' => request_params[:comment],
+        'created_datetime' => '2013-12-17T23:58:54+09:00',
+        'created_epoch' => 1387292334,
+        'user' => 'aereal',
+        'permalink' => 'http://b.hatena.ne.jp/aereal/20131217#bookmark-150288466',
+        'private' => request_params['private'],
+        'tags' => request_params['tags'],
+      )
+    }
+
+    before do
+      allow(client).to receive(:connection).and_return(test_connection)
+    end
+
+    it "successfully create a new bookmark" do
+      expect(client.create_bookmark(request_params)).to eq(bookmark)
+    end
+  end
+
+  describe "#delete_bookmark" do
+    let(:stubbed_response) {
+      [
+        204,
+        {},
+        ''
+      ]
+    }
+
+    let(:test_connection) {
+      Faraday.new do |builder|
+        builder.adapter :test do |stubs|
+          stubs.delete(api_path) { stubbed_response }
+        end
+      end
+    }
+
+    let(:api_path) { "/1/my/bookmark" }
+
+    let(:entry_url) { "http://aereal.org/" }
+
+    before do
+      allow(client).to receive(:connection).and_return(test_connection)
+    end
+
+    it "successfully delete a bookmark" do
+      expect(client.delete_bookmark(entry_url)).to be_true
+    end
+  end
+
+  describe "#bookmark" do
+    include_context "send a HTTP request to API"
+
+    subject { client.bookmark(entry_url) }
+
+    let(:api_path) { "/1/my/bookmark" }
+
+    let(:bookmark) {
+      Hatena::Bookmark::Restful::V1::Bookmark.new_from_response(
+        'comment' => ' Heroku の Deploy Hooks で HipChat がサポートされていた',
+        'created_datetime' => '2013-12-17T23:58:54+09:00',
+        'created_epoch' => 1387292334,
+        'user' => 'aereal',
+        'permalink' => 'http://b.hatena.ne.jp/aereal/20131217#bookmark-150288466',
+        'private' => false,
+        'tags' => [
+          'heroku',
+        ],
+      )
+    }
+
+    let(:response_body) { JSON.dump(bookmark.to_hash) }
+
+    let(:entry_url) { "https://devcenter.heroku.com/articles/deploy-hooks" }
+
+    it "is valid response from API" do
+      expect(client.bookmark(entry_url)).to eq(bookmark)
+    end
+  end
+
+  describe "#entry" do
+    include_context "send a HTTP request to API"
+    let(:api_path) { "/1/entry" }
+
+    let(:entry) {
+      Hatena::Bookmark::Restful::V1::Entry.new_from_response(
+        'title'                    => %|aereal's portfolio - aereal.org|,
+        'url'                      => 'http://aereal.org/',
+        'entry_url'                => 'http://b.hatena.ne.jp/entry/aereal.org/',
+        'count'                    => 3,
+        'favicon_url'              => 'http://cdn-ak.favicon.st-hatena.com/?url=http%3A%2F%2Faereal.org%2F',
+        'smartphone_app_entry_url' => 'http://b.hatena.ne.jp/bookmarklet.touch?mode=comment&iphone_app=1&url=http%3A%2F%2Faereal.org%2F',
+      )
+    }
+
+    let(:response_body) { JSON.generate(entry.to_hash) }
+
+    let(:entry_url) { 'http://aereal.org/' }
+
+    it "is valid response from API" do
+      expect(client.entry(entry_url)).to eq(entry)
+    end
+  end
+
+  describe "#tags" do
+    include_context "send a HTTP request to API"
+    let(:api_path) { "/1/my/tags" }
+
+    let(:tag) {
+      Hatena::Bookmark::Restful::V1::Tag.new_from_response(
+        'modified_datetime' => '2011-06-15T05:41:01',
+        'modified_epoch'    => 1308116461,
+        'count'             => 10,
+        'tag'               => 'ruby',
+      )
+    }
+
+    let(:tags_response) { { 'tags' => [tag.to_hash] } }
+
+    let(:response_body) { JSON.generate(tags_response) }
+
+    it "is valid response from API" do
+      expect(client.my_tags).to eq([ tag ])
+    end
+  end
+
+  describe "#my" do
+    include_context "send a HTTP request to API"
+
+    let(:user) {
+      Hatena::Bookmark::Restful::V1::User.new_from_response(
+        'name'                => 'aereal',
+        'plususer'            => true,
+        'private'             => false,
+        'is_oauth_twitter'    => true,
+        'is_oauth_evernote'   => true,
+        'is_oauth_facebook'   => true,
+        'is_oauth_mixi_check' => false,
+      )
+    }
+
+    let(:response_body) { JSON.dump(user.to_hash) }
+
+    let(:api_path) { "/1/my" }
+
+    it "is valid response from API" do
+      expect(client.my).to eq(user)
+    end
+  end
+end

data/spec/hatena/bookmark/restful_spec.rb

@@ -0,0 +1,7 @@
+require 'spec_helper'
+
+describe Hatena::Bookmark::Restful do
+  it 'should have a version number' do
+    Hatena::Bookmark::Restful::VERSION.should_not be_nil
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+require 'hatena/bookmark/restful'

metadata

@@ -0,0 +1,180 @@
+--- !ruby/object:Gem::Specification
+name: hatena-bookmark-restful
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- aereal
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-04 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: simple_oauth
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: semantic
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A client library for Hatena::Bookmark RESTful API
+email:
+- aereal@aereal.org
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- hatena-bookmark-restful.gemspec
+- lib/hatena-bookmark-restful.rb
+- lib/hatena/bookmark/restful.rb
+- lib/hatena/bookmark/restful/v1.rb
+- lib/hatena/bookmark/restful/v1/bookmark.rb
+- lib/hatena/bookmark/restful/v1/entry.rb
+- lib/hatena/bookmark/restful/v1/response_object.rb
+- lib/hatena/bookmark/restful/v1/tag.rb
+- lib/hatena/bookmark/restful/v1/user.rb
+- lib/hatena/bookmark/restful/version.rb
+- spec/hatena/bookmark/restful/v1_spec.rb
+- spec/hatena/bookmark/restful_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/aereal/hatena-bookmark-restful
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.0
+signing_key: 
+specification_version: 4
+summary: A client library for Hatena::Bookmark RESTful API
+test_files:
+- spec/hatena/bookmark/restful/v1_spec.rb
+- spec/hatena/bookmark/restful_spec.rb
+- spec/spec_helper.rb
+has_rdoc: