kippt 0.0.1

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 @@
+--color
+--order random

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Vesa Vänskä
+
+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,165 @@
+# Kippt
+
+Kippt is a gem that provides a client library for using Kippt.com API.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem "kippt"
+```
+
+And then execute:
+
+```sh
+$ bundle
+```
+
+Or install it yourself as:
+
+```sh
+$ gem install kippt
+```
+
+## Usage
+
+### Authentication
+
+To be able to use the API you need to authenticated. There's two ways to authenticate:
+
+#### With login credentials
+
+```ruby
+client = Kippt::Client.new(username: "vesan", password: "s3cr3t")
+# Methods called on `client` will use the passed credentials
+```
+
+#### With token
+
+```ruby
+client = Kippt::Client.new(username: "vesan", token: "2544d6bfddf5893ec8617")
+# Methods called on `client` will use the passed credentials
+```
+
+### Account
+
+```ruby
+client = Kippt::Client.new(username: "vesan", token: "2544d6bfddf5893ec8617")
+account = client.account
+account.username #=> "vesan"
+account.token    #=> "2544d6bfddf5893ec8617"
+```
+
+### Resources
+
+Currently this client library is read-only! Ability to create and edit
+resources will be added soon.
+
+#### Lists
+
+Get all the lists:
+
+```ruby
+client = Kippt::Client.new(username: "vesan", token: "2544d6bfddf5893ec8617")
+lists = client.lists # Returns Kippt::ListCollection
+```
+
+Get single list:
+
+```ruby
+client = Kippt::Client.new(username: "vesan", token: "2544d6bfddf5893ec8617")
+list_id = 10
+list = client.lists[list_id] # Returns Kippt::ListItem
+```
+
+#### Clips
+
+```ruby
+client = Kippt::Client.new(username: "vesan", token: "2544d6bfddf5893ec8617")
+clips = client.clips # Returns Kippt::ClipCollection
+```
+
+### Pagination
+
+Lists and clips are paginated:
+
+```ruby
+client = Kippt::Client.new(username: "vesan", token: "2544d6bfddf5893ec8617")
+clips = client.clips.all
+
+clips.total_count
+clips.offset
+clips.limit
+```
+
+You can get next and previous set of results:
+
+```ruby
+clips.next_page? #=> true
+clips.next_page # Returns new Kippt::ClipCollection
+clips.prev_page? #=> true
+clips.prev_page # Returns new Kippt::ClipCollection
+```
+
+There's also `#previous\_page?` and `#previous\_page`.
+
+Limit and offset can be controlled manually:
+
+```ruby
+client.clips.all(limit: 25, offset: 50)
+```
+
+### Search
+
+Clips can be searched:
+
+```ruby
+client.clips.search("kippt") #=> Returns Kippt::ClipCollection
+```
+
+Other available options are `is\_starred: true` and `list: [list-id]` like:
+
+```ruby
+client.clips.search(q: "kippt", list: 5, is_starred: true)
+```
+
+### Creating, updating and deleting resources
+
+**NOT IMPLEMENTED YET**
+
+```ruby
+clip = client.clips.build
+clip.url = "http://github.com"
+clip.save #=> Returns boolean
+```
+
+If you are missing required fields `#save` will return `false` and you can use 
+`#errors` to get the error messages returned by the API.
+
+```ruby
+clip = client.clips.build
+clip.save   #=> false
+clip.errors #=> ["No url."]
+```
+
+Deleting clips is done with `#destroy`:
+
+```ruby
+clip_id = 1001
+clip = client.clips[clip_id]
+clip.destroy #=> true
+```
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+## TODO
+
+* Ability to create, update and delete resources
+* Add user agent string

data/Rakefile

@@ -0,0 +1,10 @@
+#!/usr/bin/env rake
+
+require "bundler/gem_tasks"
+
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :test => :spec
+task :default => :spec

data/kippt.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/kippt/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Vesa Vänskä"]
+  gem.email         = ["vesa@vesavanska.com"]
+  gem.description   = %q{Client library for using Kippt.com API}
+  gem.summary       = %q{Client library for using Kippt.com API}
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "kippt"
+  gem.require_paths = ["lib"]
+  gem.version       = Kippt::VERSION
+
+  gem.add_dependency "faraday", "~> 0.7.6"
+  gem.add_dependency "faraday_middleware", "~> 0.8.7"
+  gem.add_dependency "yajl-ruby", "~> 1.1.0"
+
+  gem.add_development_dependency "rspec", "~> 2.9.0"
+  gem.add_development_dependency "webmock", "~> 1.8.6"
+end

data/lib/kippt.rb

@@ -0,0 +1,8 @@
+require "kippt/version"
+require "faraday"
+require "faraday_middleware"
+require "kippt/client"
+
+module Kippt
+  class APIError < StandardError; end
+end

data/lib/kippt/account.rb

@@ -0,0 +1,10 @@
+class Kippt::Account
+  attr_reader :username, :token
+
+  alias_method :api_token, :token
+
+  def initialize(options = {})
+    @username = options.fetch("username") { nil }
+    @token = options.fetch("api_token") { nil }
+  end
+end

data/lib/kippt/client.rb

@@ -0,0 +1,33 @@
+require "kippt/connection"
+require "kippt/account"
+require "kippt/clips"
+require "kippt/lists"
+
+class Kippt::Client
+  include Kippt::Connection
+
+  attr_reader :username, :token, :password
+
+  def initialize(options = {})
+    @username = options.fetch(:username) { raise ArgumentError.new("username is required") }
+
+    @password = options.fetch(:password) { nil }
+    @token    = options.fetch(:token) { nil }
+
+    if @password.nil? && @token.nil?
+      raise ArgumentError.new("password or token is required")
+    end
+  end
+
+  def account
+    Kippt::Account.new(get("account").body)
+  end
+
+  def lists
+    Kippt::Lists.new(self)
+  end
+
+  def clips
+    Kippt::Clips.new(self)
+  end
+end

data/lib/kippt/clip.rb

@@ -0,0 +1,29 @@
+require "ostruct"
+
+class Kippt::Clip
+  extend Forwardable
+
+  attr_reader :attributes, :errors
+
+  def_delegators :attributes, :url_domain, :updated, :is_starred, :title,
+                :url, :notes, :created, :list, :id, :resource_uri, 
+                :is_starred=, :title=, :url=, :notes=, :list=
+
+  def initialize(attributes = {}, collection_resource = nil)
+    @attributes = OpenStruct.new(attributes)
+    @errors     = []
+    @collection_resource   = collection_resource
+  end
+
+  def destroy
+    @collection_resource.destroy_resource(self)
+  end
+
+  def save
+    response = @collection_resource.save_object(self)
+    if response[:error_message]
+      errors << response[:error_message]
+    end
+    response[:success]
+  end
+end

data/lib/kippt/clip_collection.rb

@@ -0,0 +1,10 @@
+require "kippt/collection"
+require "kippt/clip"
+
+class Kippt::ClipCollection
+  include Kippt::Collection
+
+  def object_class
+    Kippt::Clip
+  end
+end

data/lib/kippt/clips.rb

@@ -0,0 +1,63 @@
+require "kippt/connection"
+require "kippt/collection_resource"
+require "kippt/clip_collection"
+require "kippt/clip"
+
+class Kippt::Clips
+  include Kippt::CollectionResource
+
+  def initialize(client)
+    @client = client
+  end
+
+  def object_class
+    Kippt::Clip
+  end
+
+  def collection_class
+    Kippt::ClipCollection
+  end
+
+  def base_uri
+    "clips"
+  end
+
+  def search(parameters)
+    # TODO: Validate parameters
+    if parameters.is_a?(String)
+      Kippt::ClipCollection.new(
+        @client.get("search/clips", {:q => parameters}).body,
+        self)
+    else
+      Kippt::ClipCollection.new(
+        @client.get("search/clips", parameters).body,
+        self)
+    end
+  end
+
+  def save_object(object)
+    if object.id
+      response = @client.put("clips/#{object.id}", writable_parameters_from(object))
+    else
+      response = @client.post("clips", writable_parameters_from(object))
+    end
+
+    save_response = {success: response.success?}
+    if response.body["message"]
+      save_response[:error_message] = response.body["message"]
+    end
+    save_response
+  end
+
+  private
+
+  def writable_parameters_from(clip)
+    [:url, :title, :list, :notes, :is_starred].
+      inject({}) do |parameters, attribute_name|
+        unless clip.send(attribute_name).nil?
+          parameters[attribute_name] = clip.send(attribute_name)
+        end
+        parameters
+    end
+  end
+end

data/lib/kippt/collection.rb

@@ -0,0 +1,46 @@
+module Kippt::Collection
+  attr_reader :total_count, :limit, :offset
+
+  def initialize(data, collection_resource = nil)
+    meta         = data.fetch("meta")
+    @limit       = meta.fetch("limit")
+    @offset      = meta.fetch("offset")
+    @next        = meta.fetch("next") { nil }
+    @prev        = meta.fetch("prev") { nil }
+    @total_count = meta.fetch("total_count")
+
+    @collection_resource  = collection_resource
+
+    @object_data = data.fetch("objects")
+  end
+
+  def objects
+    @objects ||= @object_data.map {|data| object_class.new(data, @collection_resource) }
+  end
+
+  def [](index)
+    objects[index]
+  end
+
+  def each(&block)
+    objects.each(&block)
+  end
+
+  def next_page?
+    @next
+  end
+
+  def next_page
+    # TODO: Raise error if there is no page
+    @collection_resource.collection_from_url(@next)
+  end
+
+  def prev_page?
+    @prev
+  end
+
+  def prev_page
+    # TODO: Raise error if there is no page
+    @collection_resource.collection_from_url(@prev)
+  end
+end

data/lib/kippt/collection_resource.rb

@@ -0,0 +1,35 @@
+module Kippt::CollectionResource
+  def all(options = {})
+    validate_collection_options(options)
+
+    collection_class.new(@client.get(base_uri, options).body, self)
+  end
+
+  def build
+    object_class.new({}, self)
+  end
+
+  def [](resource_id)
+    object_class.new(@client.get("#{base_uri}/#{resource_id}").body)
+  end
+
+  def collection_from_url(url)
+    collection_class.new(@client.get(url).body, self)
+  end
+
+  def destroy_resource(resource)
+    if resource.id
+      @client.delete("#{base_uri}/#{resource.id}").success?
+    end
+  end
+
+  private
+
+  def validate_collection_options(options)
+    options.each do |key, _|
+      unless [:limit, :offset].include?(key)
+        raise ArgumentError.new("Unrecognized argument: #{key}")
+      end
+    end
+  end
+end

data/lib/kippt/connection.rb

@@ -0,0 +1,52 @@
+module Kippt::Connection
+  def get(url, options = {})
+    request(:get, url, options)
+  end
+
+  def post(url, options = {})
+    request(:post, url, options)
+  end
+
+  def put(url, options = {})
+    request(:put, url, options)
+  end
+
+  def delete(url, options = {})
+    request(:delete, url, options)
+  end
+
+  private
+
+  def connection
+    @connection ||= Faraday.new("https://kippt.com/api") do |builder|
+      builder.use Faraday::Request::JSON
+      builder.use FaradayMiddleware::ParseJson
+      # builder.use Faraday::Response::Logger
+      builder.adapter Faraday.default_adapter
+    end
+  end
+
+  def request(method, url, options)
+    response = connection.send(method) do |req|
+      if @password
+        connection.basic_auth(@username, @password)
+      else
+        req.headers["X-Kippt-Username"]  = @username
+        req.headers["X-Kippt-API-Token"] = @token
+      end
+
+      if method == :get
+        req.url url, options
+      else
+        req.url  url
+        req.body = options
+      end
+    end
+    
+    if response.status == 401
+      raise Kippt::APIError.new(response.body["message"])
+    end
+
+    response
+  end
+end

data/lib/kippt/list.rb

@@ -0,0 +1,14 @@
+require "ostruct"
+
+class Kippt::List
+  extend Forwardable
+
+  attr_reader :attributes
+
+  def_delegators :attributes, :rss_url, :updated, :title,
+                 :created, :slug, :id, :resource_uri
+
+  def initialize(attributes)
+    @attributes = OpenStruct.new(attributes)
+  end
+end

data/lib/kippt/list_collection.rb

@@ -0,0 +1,10 @@
+require "kippt/collection"
+require "kippt/list"
+
+class Kippt::ListCollection
+  include Kippt::Collection
+
+  def object_class
+    Kippt::List
+  end
+end

data/lib/kippt/lists.rb

@@ -0,0 +1,24 @@
+require "kippt/connection"
+require "kippt/collection_resource"
+require "kippt/list_collection"
+require "kippt/list"
+
+class Kippt::Lists
+  include Kippt::CollectionResource
+
+  def initialize(client)
+    @client = client
+  end
+
+  def object_class
+    Kippt::List
+  end
+
+  def collection_class
+    Kippt::ListCollection
+  end
+
+  def base_uri
+    "lists"
+  end
+end

data/lib/kippt/version.rb

@@ -0,0 +1,3 @@
+module Kippt
+  VERSION = "0.0.1"
+end

data/spec/fixtures/clip.json

@@ -0,0 +1 @@
+{"url_domain": "karrisaarinen.com", "updated": "1335090586", "is_starred": false, "title": "Karri Saarinen", "url": "http://karrisaarinen.com/", "notes": "My favorite designer-bro.", "created": "1335090567", "list": "/api/lists/44525/", "id": 1589450, "resource_uri": "/api/clips/1589450/"}

data/spec/fixtures/clips.json

@@ -0,0 +1 @@
+{"meta": {"next": null, "total_count": 1, "previous": null, "limit": 20, "offset": 0}, "objects": [{"url_domain": "karrisaarinen.com", "updated": "1335090586", "is_starred": false, "title": "Karri Saarinen", "url": "http://karrisaarinen.com/", "notes": "Cool site, bro", "created": "1335090567", "list": "/api/lists/44525/", "id": 1589450, "resource_uri": "/api/clips/1589450/"}]}

data/spec/fixtures/list.json

@@ -0,0 +1 @@
+{"rss_url": "https://kippt.com/feed/vesan/0VLW0SSjVBRJ1oQEpe9OmSf1q2Q6lvq/inspiration", "updated": "1335090586", "title": "Inspiration", "created": "1335090037", "slug": "inspiration", "id": 10, "resource_uri": "/api/lists/10/"}

data/spec/fixtures/lists.json

@@ -0,0 +1 @@
+{"meta": {"next": null, "total_count": 4, "previous": null, "limit": 20, "offset": 0}, "objects": [{"rss_url": "https://kippt.com/feed/vesan/0VLW0SSjVBRJ1oQEpe9OmSf1q2Q6lvq/inspiration", "updated": "1335090586", "title": "Inspiration", "created": "1335090037", "slug": "inspiration", "id": 10, "resource_uri": "/api/lists/10/"}, {"rss_url": "https://kippt.com/feed/vesan/0VLW0SSjVBRJ1oQEpe9OmSf1q2Q6lvq/moikka-vesa", "updated": "1319441679", "title": "Moikka Vesa!", "created": "1319435972", "slug": "moikka-vesa", "id": 134, "resource_uri": "/api/lists/134/"}, {"rss_url": "https://kippt.com/feed/vesan/0VLW0SSjVBRJ1oQEpe9OmSf1q2Q6lvq/read-later", "updated": "1319434196", "title": "Read Later", "created": "1319434196", "slug": "read-later", "id": 133, "resource_uri": "/api/lists/133/"}, {"rss_url": "https://kippt.com/feed/vesan/0VLW0SSjVBRJ1oQEpe9OmSf1q2Q6lvq/inbox", "updated": "1319434196", "title": "Inbox", "created": "1319434196", "slug": "inbox", "id": 132, "resource_uri": "/api/lists/132/"}]}

data/spec/kippt/account_spec.rb

@@ -0,0 +1,28 @@
+require "spec_helper"
+require "kippt/account"
+
+describe Kippt::Account do
+  describe "#token" do
+    subject { Kippt::Account.new("api_token" => "12345") }
+
+    it "gets set" do
+      subject.token.should eq "12345"
+    end
+  end
+
+  describe "#api_token" do
+    subject { Kippt::Account.new("api_token" => "12345") }
+
+    it "is aliased to token" do
+      subject.api_token.should eq "12345"
+    end
+  end
+
+  describe "#username" do
+    subject { Kippt::Account.new("username" => "bob") }
+
+    it "gets set" do
+      subject.username.should eq "bob"
+    end
+  end
+end

data/spec/kippt/client_spec.rb

@@ -0,0 +1,17 @@
+require "spec_helper"
+require "kippt/client"
+
+describe Kippt::Client do
+  describe "#initialize" do
+    context "when there is no username" do
+      it "raises error"
+    end
+
+    context "when there is no password or token" do
+      it "raises error"
+    end
+  end
+
+  describe "#lists" do
+  end
+end

data/spec/kippt/clip_collection_spec.rb

@@ -0,0 +1,10 @@
+require "spec_helper"
+require "crack/json"
+require "kippt/clip_collection"
+
+describe Kippt::ClipCollection do
+  let(:data) { Crack::JSON.parse(fixture("clips.json").read) }
+  subject { Kippt::ClipCollection.new(data) }
+
+  it_behaves_like "collection"
+end

data/spec/kippt/clip_spec.rb

@@ -0,0 +1,52 @@
+require "spec_helper"
+require "crack/json"
+require "kippt/clip_collection"
+
+describe Kippt::ClipCollection do
+  let(:data) { Crack::JSON.parse(fixture("clip.json").read) }
+  subject { Kippt::Clip.new(data) }
+
+  describe "attribute accessors" do
+    it "delegates to attributes" do
+      [:url_domain, :updated, :is_starred,
+       :title, :url, :notes, :created, :list, :id,
+       :resource_uri].each do |attribute_name|
+          subject.send(attribute_name).should eq data[attribute_name.to_s]
+       end
+    end
+  end
+
+  describe "#save" do
+    let(:collection_resource) { Kippt::Client.new(valid_user_credentials).clips }
+    subject { Kippt::Clip.new({}, collection_resource) }
+
+    context "with valid parameters" do
+      it "sends POST request to server" do
+        collection_resource.should_receive(:save_object).with(subject).and_return({})
+        subject.url = "http://kiskolabs.com"
+        subject.save
+      end
+
+      it "returns true" do
+        collection_resource.stub(:save_object).and_return(
+          {success: true})
+        subject.save.should be_true
+      end
+    end
+
+    context "with invalid parameters" do
+      before do
+        collection_resource.stub(:save_object).and_return({success: false, error_message: "No url."})
+      end
+
+      it "sets an error messages" do
+        subject.save
+        subject.errors.should eq ["No url."]
+      end
+
+      it "returns false" do
+        subject.save.should be_false
+      end
+    end
+  end
+end

data/spec/kippt/clips_spec.rb

@@ -0,0 +1,144 @@
+require "spec_helper"
+require "kippt/clips"
+
+describe Kippt::Clips do
+  describe "#all" do
+    subject { Kippt::Client.new(valid_user_credentials).clips }
+
+    it "returns ClipCollection" do
+      stub_get("/clips").
+        to_return(:status => 200, :body => fixture("clips.json"))
+      clips = subject.all
+      clips.is_a? Kippt::ClipCollection
+    end
+
+    it "accepts limit and offset options" do
+      stub_get("/clips?limit=10&offset=100").
+        to_return(:status => 200, :body => fixture("clips.json"))
+      clips = subject.all(:limit => 10, :offset => 100)
+    end
+
+    context "when passed unrecognized arguments" do
+      it "raises error" do
+        lambda {
+          subject.all(:foobar => true)
+        }.should raise_error(
+          ArgumentError, "Unrecognized argument: foobar")
+      end
+    end
+  end
+
+  describe "#[]" do
+    subject { Kippt::Client.new(valid_user_credentials).clips }
+
+    it "fetches single list" do
+      stub_get("/clips/10").
+        to_return(:status => 200, :body => fixture("list.json"))
+      subject[10].id.should eq 10
+    end
+
+    it "returns Kippt::Clip" do
+      stub_get("/clips/10").
+        to_return(:status => 200, :body => fixture("list.json"))
+      subject[10].should be_a(Kippt::Clip)
+    end
+  end
+
+  describe "#build" do
+    subject { Kippt::Client.new(valid_user_credentials).clips }
+
+    it "returns Kippt::Clip" do
+      subject.build.should be_a(Kippt::Clip)
+    end
+  end
+
+  describe "#search" do
+    subject { Kippt::Client.new(valid_user_credentials).clips }
+
+    describe "parameters" do
+      it "accepts String" do
+        stub_get("/search/clips?q=bunny").
+          to_return(:status => 200, :body => fixture("clips.json"))
+        subject.search("bunny")
+      end
+
+      it "accepts Hash" do
+        stub_get("/search/clips?q=bunny&list=4&is_starred=true").
+          to_return(:status => 200, :body => fixture("clips.json"))
+        subject.search(:q => "bunny", :list => 4, :is_starred => true)
+      end
+    end
+
+    it "returns ClipCollection" do
+      stub_get("/search/clips?q=bunny").
+        to_return(:status => 200, :body => fixture("clips.json"))
+      clips = subject.search("bunny")
+      clips.is_a? Kippt::ClipCollection
+    end
+  end
+
+  describe "#save_object" do
+    subject { Kippt::Client.new(valid_user_credentials).clips }
+
+    context "successful request" do
+      it "returns hash with success boolean" do
+       stub_request(:post, "https://kippt.com/api/clips").
+         with(:body => "{\"url\":\"http://kiskolabs.com\"}").
+         to_return(:status => 200, :body => "{}", :headers => {})
+
+        clip = Kippt::Clip.new(:url => "http://kiskolabs.com")
+        response = subject.save_object(clip)
+        response[:success].should be_true
+      end
+    end
+
+    context "unsuccessful request" do
+      it "returns hash with success boolean and error message" do
+       stub_request(:post, "https://kippt.com/api/clips").
+         with(:body => "{\"url\":\"http://kiskolabs.com\"}").
+         to_return(:status => 400, :body => "{\"message\": \"No good.\"}", :headers => {})
+
+        clip = Kippt::Clip.new(:url => "http://kiskolabs.com")
+        response = subject.save_object(clip)
+        response[:success].should be_false
+        response[:error_message].should eq "No good."
+      end
+    end
+
+    context "when object doesn't have an id" do
+      it "POSTs new resource to the API" do
+       stub_request(:post, "https://kippt.com/api/clips").
+         with(:body => "{\"url\":\"http://kiskolabs.com\"}").
+         to_return(:status => 200, :body => "{}", :headers => {})
+
+        clip = Kippt::Clip.new(:url => "http://kiskolabs.com")
+        subject.save_object(clip)
+      end
+    end
+    
+    context "when object has an id" do
+      it "PUTs new version of the resource to the API" do
+       stub_request(:put, "https://kippt.com/api/clips/22").
+         with(:body => "{\"url\":\"http://kiskolabs.com\"}").
+         to_return(:status => 200, :body => "{}", :headers => {})
+
+        clip = Kippt::Clip.new(:id => 22, :url => "http://kiskolabs.com")
+        subject.save_object(clip)
+      end 
+    end
+  end
+
+  describe "#destroy_resource" do
+    subject { Kippt::Client.new(valid_user_credentials).clips }
+
+    context "successful request" do
+      it "returns boolean" do
+       stub_request(:delete, "https://kippt.com/api/clips/100").
+         to_return(:status => 200, :headers => {})
+
+        clip = Kippt::Clip.new(id: 100)
+        subject.destroy_resource(clip).should be_true
+      end
+    end
+  end
+end

data/spec/kippt/list_collection_spec.rb

@@ -0,0 +1,9 @@
+require "spec_helper"
+require "crack/json"
+
+describe Kippt::ListCollection do
+  let(:data) { Crack::JSON.parse(fixture("lists.json").read) }
+  subject { Kippt::ListCollection.new(data) }
+
+  it_behaves_like "collection"
+end

data/spec/kippt/lists_spec.rb

@@ -0,0 +1,57 @@
+require "spec_helper"
+require "kippt/lists"
+
+describe Kippt::Lists do
+  describe "#all" do
+    subject { Kippt::Client.new(valid_user_credentials).lists }
+
+    it "returns ListCollection" do
+      stub_get("/lists").
+        to_return(:status => 200, :body => fixture("lists.json"))
+      lists = subject.all
+      lists.is_a? Kippt::ListCollection
+    end
+
+    it "accepts limit and offset options" do
+      stub_get("/lists?limit=10&offset=100").
+        to_return(:status => 200, :body => fixture("lists.json"))
+      lists = subject.all(:limit => 10, :offset => 100)
+    end
+
+    context "when passed unrecognized arguments" do
+      it "raises error" do
+        lambda {
+          subject.all(:foobar => true)
+        }.should raise_error(
+          ArgumentError, "Unrecognized argument: foobar")
+      end
+    end
+  end
+
+  describe "#[]" do
+    subject { Kippt::Client.new(valid_user_credentials).lists }
+
+    it "fetches single list" do
+      stub_get("/lists/10").
+        to_return(:status => 200, :body => fixture("list.json"))
+      subject[10].id.should eq 10
+    end
+
+    it "returns Kippt::List" do
+      stub_get("/lists/10").
+        to_return(:status => 200, :body => fixture("list.json"))
+      subject[10].should be_a(Kippt::List)
+    end
+  end
+
+  describe "#collection_from_url" do
+    subject { Kippt::Client.new(valid_user_credentials).lists }
+
+    it "returns a new ListCollection" do
+      stub_get("/lists/?limit=20&offset=20").
+        to_return(:status => 200, :body => fixture("lists.json"))
+      list = subject.collection_from_url("/api/lists/?limit=20&offset=20")
+      list.should be_a(Kippt::ListCollection)
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,40 @@
+require "kippt"
+require "rspec"
+require "webmock/rspec"
+
+def stub_get(url)
+  stub_request(:get, kippt_url(url))
+end
+
+def kippt_url(url)
+  "https://kippt.com/api#{url}"
+end
+
+def valid_user_credentials
+  {:username => "bob", :token => "bobstoken"}
+end
+
+def fixture(file)
+  fixture_path = File.expand_path("../fixtures", __FILE__)
+  File.new(fixture_path + '/' + file)
+end
+
+shared_examples_for "collection" do
+  describe "#total_count" do
+    it "returns total count of lists" do
+      subject.total_count.should eq data["meta"]["total_count"]
+    end
+  end
+
+  describe "#offset" do
+    it "returns offset of the results" do
+      subject.offset.should eq 0
+    end
+  end
+
+  describe "#limit" do
+    it "returns limit of the results" do
+      subject.limit.should eq 20
+    end
+  end
+end

metadata

@@ -0,0 +1,170 @@
+--- !ruby/object:Gem::Specification
+name: kippt
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Vesa Vänskä
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-04-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faraday
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.6
+- !ruby/object:Gem::Dependency
+  name: faraday_middleware
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.7
+- !ruby/object:Gem::Dependency
+  name: yajl-ruby
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.1.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.9.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.9.0
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.6
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.6
+description: Client library for using Kippt.com API
+email:
+- vesa@vesavanska.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- kippt.gemspec
+- lib/kippt.rb
+- lib/kippt/account.rb
+- lib/kippt/client.rb
+- lib/kippt/clip.rb
+- lib/kippt/clip_collection.rb
+- lib/kippt/clips.rb
+- lib/kippt/collection.rb
+- lib/kippt/collection_resource.rb
+- lib/kippt/connection.rb
+- lib/kippt/list.rb
+- lib/kippt/list_collection.rb
+- lib/kippt/lists.rb
+- lib/kippt/version.rb
+- spec/fixtures/clip.json
+- spec/fixtures/clips.json
+- spec/fixtures/list.json
+- spec/fixtures/lists.json
+- spec/kippt/account_spec.rb
+- spec/kippt/client_spec.rb
+- spec/kippt/clip_collection_spec.rb
+- spec/kippt/clip_spec.rb
+- spec/kippt/clips_spec.rb
+- spec/kippt/list_collection_spec.rb
+- spec/kippt/lists_spec.rb
+- spec/spec_helper.rb
+homepage: ''
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.21
+signing_key: 
+specification_version: 3
+summary: Client library for using Kippt.com API
+test_files:
+- spec/fixtures/clip.json
+- spec/fixtures/clips.json
+- spec/fixtures/list.json
+- spec/fixtures/lists.json
+- spec/kippt/account_spec.rb
+- spec/kippt/client_spec.rb
+- spec/kippt/clip_collection_spec.rb
+- spec/kippt/clip_spec.rb
+- spec/kippt/clips_spec.rb
+- spec/kippt/list_collection_spec.rb
+- spec/kippt/lists_spec.rb
+- spec/spec_helper.rb
+has_rdoc: