kippt 1.1.0 → 2.0.0

data/lib/kippt/saves.rb

@@ -0,0 +1,25 @@
+require "kippt/user_collection"
+require "kippt/user"
+
+class Kippt::Saves
+  attr_reader :clip
+
+  def initialize(client, clip)
+    @client = client
+    @clip   = clip
+  end
+
+  def collection_class
+    Kippt::UserCollection
+  end
+
+  def all(options = {})
+    collection_class.new({"objects" => @clip.saves_data}, client)
+  end
+
+  private
+
+  def client
+    @client
+  end
+end

data/lib/kippt/user.rb

@@ -0,0 +1,59 @@
+require "kippt/users"
+require "kippt/followers"
+require "kippt/following"
+require "kippt/follow_relationship"
+require "kippt/user_clips"
+require "kippt/user_lists"
+
+class Kippt::User
+  include Kippt::Resource
+
+  attributes :username, :bio, :app_url, :avatar_url, :twitter,
+             :id, :github, :website_url, :full_name, :dribble,
+             :counts, :resource_uri, :api_token
+
+  boolean_attributes :is_pro
+
+  alias_method :token, :api_token
+
+  def collection_resource_class
+    Kippt::Users
+  end
+
+  def lists
+    Kippt::UserLists.new(client, self)
+  end
+
+  def clips
+    Kippt::UserClips.new(client, self)
+  end
+
+  def followers
+    Kippt::Followers.new(client, self)
+  end
+
+  def following
+    Kippt::Following.new(client, self)
+  end
+
+  # Tells if authenticated user is following the user.
+  def following?
+    Kippt::FollowRelationship.new(client, self).following?
+  end
+
+  def follower_count
+    counts["follows"]
+  end
+
+  def following_count
+    counts["followed_by"]
+  end
+
+  def follow
+    Kippt::FollowRelationship.new(client, self).follow
+  end
+
+  def unfollow
+    Kippt::FollowRelationship.new(client, self).unfollow
+  end
+end

data/lib/kippt/user_clips.rb

@@ -0,0 +1,39 @@
+require "kippt/connection"
+require "kippt/collection_resource"
+require "kippt/clip_collection"
+require "kippt/clip"
+
+class Kippt::UserClips
+  include Kippt::CollectionResource
+
+  attr_reader :user
+
+  def self.valid_filter_parameters
+    [:limit, :offset]
+  end
+
+  def initialize(client, user)
+    @client = client
+    @user   = user
+  end
+
+  def object_class
+    Kippt::Clip
+  end
+
+  def collection_class
+    Kippt::ClipCollection
+  end
+
+  def base_uri
+    "users/#{user.id}/clips"
+  end
+
+  def favorites
+    Kippt::ClipCollection.new(client.get("#{base_uri}/favorites").body, client)
+  end
+
+  def likes
+    Kippt::ClipCollection.new(client.get("#{base_uri}/likes").body, client)
+  end
+end

data/lib/kippt/user_collection.rb

@@ -0,0 +1,14 @@
+require "kippt/collection"
+require "kippt/user"
+
+class Kippt::UserCollection
+  include Kippt::Collection
+
+  def object_class
+    Kippt::User
+  end
+
+  def collection_resource_class
+    Kippt::Users
+  end
+end

data/lib/kippt/user_lists.rb

@@ -0,0 +1,32 @@
+require "kippt/connection"
+require "kippt/collection_resource"
+require "kippt/list_collection"
+require "kippt/list"
+
+# Loads public lists for a user.
+class Kippt::UserLists
+  include Kippt::CollectionResource
+
+  attr_reader :user
+
+  def self.valid_filter_parameters
+    [:limit, :offset]
+  end
+
+  def initialize(client, user)
+    @client = client
+    @user   = user
+  end
+
+  def object_class
+    Kippt::List
+  end
+
+  def collection_class
+    Kippt::ListCollection
+  end
+
+  def base_uri
+    "users/#{user.id}/lists"
+  end
+end

data/lib/kippt/users.rb

@@ -0,0 +1,51 @@
+require "kippt/connection"
+require "kippt/collection_resource"
+require "kippt/user_collection"
+require "kippt/user"
+
+class Kippt::Users
+  include Kippt::CollectionResource
+  VALID_SEARCH_PARAMETERS = [:q]
+
+  def initialize(client)
+    @client = client
+  end
+
+  def self.valid_filter_parameters
+    [:limit, :offset]
+  end
+
+  def object_class
+    Kippt::User
+  end
+
+  def collection_class
+    Kippt::UserCollection
+  end
+
+  def base_uri
+    "users"
+  end
+
+  def search(parameters)
+    if parameters.is_a?(String)
+      Kippt::UserCollection.new(
+        client.get("#{base_uri}/search", {:q => parameters}).body,
+        client)
+    else
+      validate_search_parameters(parameters)
+
+      Kippt::UserCollection.new(
+        client.get("#{base_uri}/search", parameters).body,
+        client)
+    end
+  end
+
+  private
+
+  def validate_search_parameters(parameters)
+    parameters.each do |key, value|
+      raise ArgumentError.new("'#{key}' is not a valid search parameter") unless VALID_SEARCH_PARAMETERS.include?(key)
+    end
+  end
+end

data/lib/kippt/version.rb

@@ -1,3 +1,3 @@
 module Kippt
-  VERSION = "1.1.0"
+  VERSION = "2.0.0"
 end

data/spec/fixtures/clip.json

@@ -1 +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": 10, "resource_uri": "/api/clips/10/"}
+{"via": null, "saves": {"count": 0, "data": []}, "favicon_url": "https://www.google.com/s2/u/0/favicons?domain=karrisaarinen.com", "is_favorite": false, "likes": {"count": 0, "data": []}, "app_url": "/vesan/inspiration/clips/10", "title": "Karri Saarinen", "media": {"description": "We had a talk recently at Slush 2012 startup conference about how we're building Kippt with hacking design and generally being nice guys. Zen and the Art of Motorcycle Maintenance is one of my favorite books. It's a bestseller, but I think it's a great journey into the philosophy of science and art, and the metaphysics of quality.", "title": "Karri Saarinen", "provider": {"url": "https://kippt.com", "name": "Kippt"}, "images": {"tile": {"url": "https://d19weqihs4yh5u.cloudfront.net/links/3bcb19bd1912598f244b289c42647e2eba790636/350x200", "width": 350, "height": 200}, "original": {"url": "https://d19weqihs4yh5u.cloudfront.net/links/3bcb19bd1912598f244b289c42647e2eba790636/original", "width": 600, "height": 257}}, "article": {"html": "", "author_url": null, "author": null}, "type": "article"}, "is_read_later": false, "comments": {"count": 0, "data": []}, "id": 10, "type": "link", "updated": 1361128164, "user": {"username": "vesan", "bio": "Ruby developer at Kisko Labs. Dangerous, but not foolish.", "app_url": "/vesan", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/3b2958fd-db1d-4b80-acd1-d7e344fe5124/160x160", "twitter": "vesan", "id": 33, "github": "vesan", "website_url": "http://vesavanska.com/", "full_name": "Vesa V\u00e4nsk\u00e4", "dribbble": "vesan", "counts": {"follows": 21, "followed_by": 26}, "is_pro": true, "resource_uri": "/api/users/33/"}, "article": null, "is_starred": false, "url_domain": "karrisaarinen.com", "created": 1335097767, "url": "http://karrisaarinen.com/", "notes": "Cool site, bro #karri", "list": {"app_url": "/vesan/inspiration", "rss_url": "https://kippt.com/vesan/inspiration/feed/ef6bc29ac10dce9ccfbc30c94b613d5f", "updated": 1355490811, "description": "", "title": "Inspiration!", "created": 1335072037, "collaborators": {"count": 0, "data": []}, "slug": "inspiration", "user": {"username": "vesan", "bio": "Ruby developer at Kisko Labs. Dangerous, but not foolish.", "app_url": "/vesan", "twitter": "vesan", "counts": {"follows": 21, "followed_by": 26}, "github": "vesan", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/3b2958fd-db1d-4b80-acd1-d7e344fe5124/160x160", "is_pro": true, "full_name": "Vesa V\u00e4nsk\u00e4", "dribbble": "vesan", "id": 33, "website_url": "http://vesavanska.com/", "resource_uri": "/api/users/33/"}, "id": 44525, "is_private": true, "resource_uri": "/api/lists/44525/"}, "resource_uri": "/api/clips/10/"}

data/spec/fixtures/comment.json

@@ -0,0 +1 @@
+{"body": "Test comment!", "created": 1364752365, "id": 10, "resource_uri": "/api/clips/10400202/comments/10/", "user": {"username": "vesan", "bio": "Ruby developer at Kisko Labs. Dangerous, but not foolish.", "app_url": "/vesan", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/3b2958fd-db1d-4b80-acd1-d7e344fe5124/160x160", "bio": "Ruby developer at Kisko Labs. Dangerous, but not foolish.", "counts": {"follows": 21, "followed_by": 26}, "dribbble": "vesan", "full_name": "Vesa Vänskä", "github": "vesan", "id": 33, "is_pro": true, "resource_uri": "/api/users/33/", "twitter": "vesan", "username": "vesan", "website_url": "http://vesavanska.com/"}}

data/spec/fixtures/comments.json

@@ -0,0 +1 @@
+{ "meta": { "next": null, "total_count": 1, "previous": null, "limit": 20, "offset": 0 }, "objects": [ {"body": "Test comment!", "created": 1364752365, "id": 10, "resource_uri": "/api/clips/10400202/comments/10/", "user": {"username": "vesan", "bio": "Ruby developer at Kisko Labs. Dangerous, but not foolish.", "app_url": "/vesan", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/3b2958fd-db1d-4b80-acd1-d7e344fe5124/160x160", "bio": "Ruby developer at Kisko Labs. Dangerous, but not foolish.", "counts": {"follows": 21, "followed_by": 26}, "dribbble": "vesan", "full_name": "Vesa Vänskä", "github": "vesan", "id": 33, "is_pro": true, "resource_uri": "/api/users/33/", "twitter": "vesan", "username": "vesan", "website_url": "http://vesavanska.com/"}}]}

data/spec/fixtures/feed.json

@@ -0,0 +1 @@
+{"meta": {"next": null, "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

@@ -1 +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/"}
+{"app_url": "/vesan/rails-girls", "rss_url": "https://kippt.com/vesan/rails-girls/feed", "updated": 1363728355, "description": null, "title": "Rails Girls", "created": 1363728355, "collaborators": {"count": 0, "data": []}, "slug": "rails-girls", "user": {"username": "vesan", "bio": "Ruby developer at Kisko Labs. Dangerous, but not foolish.", "app_url": "/vesan", "twitter": "vesan", "counts": {"follows": 21, "followed_by": 26}, "github": "vesan", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/3b2958fd-db1d-4b80-acd1-d7e344fe5124/160x160", "is_pro": true, "full_name": "Vesa V\u00e4nsk\u00e4", "dribbble": "vesan", "id": 33, "website_url": "http://vesavanska.com/", "resource_uri": "/api/users/33/"}, "id": 10, "is_private": false, "resource_uri": "/api/lists/10/"}

data/spec/fixtures/user.json

@@ -0,0 +1 @@
+{"username": "vesan", "bio": "Ruby developer at Kisko Labs. Dangerous, but not foolish.", "app_url": "/vesan", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/3b2958fd-db1d-4b80-acd1-d7e344fe5124/160x160", "twitter": "vesan", "id": 10, "github": "vesan", "website_url": "http://vesavanska.com/", "full_name": "Vesa V\u00e4nsk\u00e4", "dribbble": "vesan", "counts": {"follows": 21, "followed_by": 26}, "is_pro": true, "resource_uri": "/api/users/10/"}

data/spec/fixtures/users.json

@@ -0,0 +1,2 @@
+
+{"meta": {"total_count": 1277, "next": null, "limit": 20, "offset": 0, "query": "developer", "previous": null}, "objects": [{"username": "qzapaia", "bio": "developer", "app_url": "/qzapaia", "avatar_url": "https://d17f28g3dsa4vh.cloudfront.net/img/default-avatar.png", "twitter": "qzapaia", "id": 4143, "github": "", "website_url": "", "full_name": "", "dribbble": "", "counts": {"follows": 0, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/4143/"}, {"username": "erik_", "bio": "developer", "app_url": "/erik_", "avatar_url": "https://d17f28g3dsa4vh.cloudfront.net/img/default-avatar.png", "twitter": "eriklieben", "id": 23427, "github": "", "website_url": "http://www.eriklieben.com", "full_name": "", "dribbble": "", "counts": {"follows": 10, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/23427/"}, {"username": "szahn", "bio": "Developer", "app_url": "/szahn", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/66fd7dfe-22b6-45a3-8fde-fe1ccb9fedcd/160x160", "twitter": "szahn", "id": 51839, "github": "", "website_url": "Stuart Zahn", "full_name": "", "dribbble": "", "counts": {"follows": 40, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/51839/"}, {"username": "aminudin", "bio": "Web Development, Hosting, IT Learning, Aplication Development", "app_url": "/aminudin", "avatar_url": "https://d17f28g3dsa4vh.cloudfront.net/img/default-avatar.png", "twitter": "", "id": 35567, "github": "", "website_url": "http://www.aicsi.com/", "full_name": "", "dribbble": "", "counts": {"follows": 9, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/35567/"}, {"username": "risico", "bio": "w3 Software Developer. Hobbyist game developer.", "app_url": "/risico", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/575922f4-2cba-4587-b9a2-ec84b3786172/160x160", "twitter": "risico", "id": 25897, "github": "", "website_url": "http://robert.zimtea.com", "full_name": "", "dribbble": "", "counts": {"follows": 15, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/25897/"}, {"username": "chitsaou", "bio": "Web Developer / Rails Developer", "app_url": "/chitsaou", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/f7d35db9-948f-4e57-9447-15bba539f27e/160x160", "twitter": "yorkxin", "id": 21531, "github": "chitsaou", "website_url": "http://blog.yorkxin.org/", "full_name": "", "dribbble": "", "counts": {"follows": 7, "followed_by": 10}, "is_pro": false, "resource_uri": "/api/users/21531/"}, {"username": "thedev", "bio": "Web developer, Software developer, Freelancer", "app_url": "/thedev", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/46ef210c-44f1-4dce-a0bd-8f5949016861/160x160", "twitter": "the_dev", "id": 23494, "github": "", "website_url": "http://www.thedev.ro", "full_name": "", "dribbble": "", "counts": {"follows": 1, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/23494/"}, {"username": "koopajah", "bio": "Linux embedded C developer starting web development", "app_url": "/koopajah", "avatar_url": "https://d17f28g3dsa4vh.cloudfront.net/img/default-avatar.png", "twitter": "koopajah", "id": 44740, "github": "", "website_url": "", "full_name": "", "dribbble": "", "counts": {"follows": 2, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/44740/"}, {"username": "ahmednadar", "bio": "Web developer", "app_url": "/ahmednadar", "avatar_url": "https://d17f28g3dsa4vh.cloudfront.net/img/default-avatar.png", "twitter": "ahmednadar", "id": 14286, "github": "", "website_url": "", "full_name": "", "dribbble": "", "counts": {"follows": 3, "followed_by": 1}, "is_pro": false, "resource_uri": "/api/users/14286/"}, {"username": "yaandil", "bio": "Developer", "app_url": "/yaandil", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/fcd9078b-823f-49ba-8f0f-e56000eabf98/160x160", "twitter": "mkanski", "id": 10467, "github": "realez", "website_url": "", "full_name": "", "dribbble": "", "counts": {"follows": 7, "followed_by": 2}, "is_pro": false, "resource_uri": "/api/users/10467/"}, {"username": "julianosaless", "bio": "Software Developer", "app_url": "/julianosaless", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/cd2f2575-f4b5-4430-a941-eab804a0e303/160x160", "twitter": "JulianoSaless", "id": 40872, "github": "", "website_url": "http://www.devjulianosales.wordpress.com", "full_name": "", "dribbble": "", "counts": {"follows": 9, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/40872/"}, {"username": "dynamik", "bio": "under development!!!", "app_url": "/dynamik", "avatar_url": "https://d17f28g3dsa4vh.cloudfront.net/img/default-avatar.png", "twitter": "dynamikus", "id": 33627, "github": "", "website_url": "http://www.dynamik.us", "full_name": "", "dribbble": "", "counts": {"follows": 12, "followed_by": 1}, "is_pro": false, "resource_uri": "/api/users/33627/"}, {"username": "danielveneg", "bio": "Web Developer", "app_url": "/danielveneg", "avatar_url": "https://d17f28g3dsa4vh.cloudfront.net/img/default-avatar.png", "twitter": "danielveneg", "id": 32525, "github": "", "website_url": "", "full_name": "", "dribbble": "", "counts": {"follows": 0, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/32525/"}, {"username": "mphome", "bio": "Software Developer", "app_url": "/mphome", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/5de37e1a-f190-4cc4-b579-70284be8582a/160x160", "twitter": "mphome", "id": 38248, "github": "", "website_url": "http://mphome.dp.ua", "full_name": "", "dribbble": "", "counts": {"follows": 9, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/38248/"}, {"username": "nevron", "bio": "Designer / Developer", "app_url": "/nevron", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/237cb878-fcc9-4b97-af60-86e795630634/160x160", "twitter": "nevron", "id": 26380, "github": "", "website_url": "http://www.erhantunali.com/blog", "full_name": "", "dribbble": "", "counts": {"follows": 13, "followed_by": 1}, "is_pro": false, "resource_uri": "/api/users/26380/"}, {"username": "garciademarina", "bio": "OSClass developer", "app_url": "/garciademarina", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/f73d31e5-8a97-4b50-adf8-b967e4331bc7/160x160", "twitter": "garciademarina", "id": 26878, "github": "", "website_url": "", "full_name": "", "dribbble": "", "counts": {"follows": 14, "followed_by": 2}, "is_pro": false, "resource_uri": "/api/users/26878/"}, {"username": "sgcet", "bio": "web developer", "app_url": "/sgcet", "avatar_url": "https://d17f28g3dsa4vh.cloudfront.net/img/default-avatar.png", "twitter": "sgcet", "id": 21324, "github": "", "website_url": "", "full_name": "", "dribbble": "", "counts": {"follows": 0, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/21324/"}, {"username": "tzumby", "bio": "Rails developer", "app_url": "/tzumby", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/17d650d7-8874-416f-a1d7-27e85a42e3be/160x160", "twitter": "tzumby", "id": 28621, "github": "", "website_url": "http://www.razlab.com", "full_name": "", "dribbble": "", "counts": {"follows": 5, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/28621/"}, {"username": "arjoonkanth", "bio": "Web Developer", "app_url": "/arjoonkanth", "avatar_url": "https://d17f28g3dsa4vh.cloudfront.net/img/default-avatar.png", "twitter": "", "id": 54311, "github": "", "website_url": "", "full_name": "", "dribbble": "", "counts": {"follows": 11, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/54311/"}, {"username": "janerist", "bio": "Software developer", "app_url": "/janerist", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/ed084049-4d12-45c0-b2f1-d3d2d4a2f346/160x160", "twitter": "janerist", "id": 22629, "github": "", "website_url": "", "full_name": "", "dribbble": "", "counts": {"follows": 0, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/22629/"}]}

data/spec/fixtures/users_with_multiple_pages.json

@@ -0,0 +1 @@
+{"meta": {"total_count": 1277, "next": "/api/users/search/?q=developer&limit=20&offset=20", "limit": 20, "offset": 20, "query": "developer", "previous":  "/api/users/search/?q=developer&limit=20&offset=0"}, "objects": [{"username": "qzapaia", "bio": "developer", "app_url": "/qzapaia", "avatar_url": "https://d17f28g3dsa4vh.cloudfront.net/img/default-avatar.png", "twitter": "qzapaia", "id": 4143, "github": "", "website_url": "", "full_name": "", "dribbble": "", "counts": {"follows": 0, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/4143/"}, {"username": "erik_", "bio": "developer", "app_url": "/erik_", "avatar_url": "https://d17f28g3dsa4vh.cloudfront.net/img/default-avatar.png", "twitter": "eriklieben", "id": 23427, "github": "", "website_url": "http://www.eriklieben.com", "full_name": "", "dribbble": "", "counts": {"follows": 10, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/23427/"}, {"username": "szahn", "bio": "Developer", "app_url": "/szahn", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/66fd7dfe-22b6-45a3-8fde-fe1ccb9fedcd/160x160", "twitter": "szahn", "id": 51839, "github": "", "website_url": "Stuart Zahn", "full_name": "", "dribbble": "", "counts": {"follows": 40, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/51839/"}, {"username": "aminudin", "bio": "Web Development, Hosting, IT Learning, Aplication Development", "app_url": "/aminudin", "avatar_url": "https://d17f28g3dsa4vh.cloudfront.net/img/default-avatar.png", "twitter": "", "id": 35567, "github": "", "website_url": "http://www.aicsi.com/", "full_name": "", "dribbble": "", "counts": {"follows": 9, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/35567/"}, {"username": "risico", "bio": "w3 Software Developer. Hobbyist game developer.", "app_url": "/risico", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/575922f4-2cba-4587-b9a2-ec84b3786172/160x160", "twitter": "risico", "id": 25897, "github": "", "website_url": "http://robert.zimtea.com", "full_name": "", "dribbble": "", "counts": {"follows": 15, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/25897/"}, {"username": "chitsaou", "bio": "Web Developer / Rails Developer", "app_url": "/chitsaou", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/f7d35db9-948f-4e57-9447-15bba539f27e/160x160", "twitter": "yorkxin", "id": 21531, "github": "chitsaou", "website_url": "http://blog.yorkxin.org/", "full_name": "", "dribbble": "", "counts": {"follows": 7, "followed_by": 10}, "is_pro": false, "resource_uri": "/api/users/21531/"}, {"username": "thedev", "bio": "Web developer, Software developer, Freelancer", "app_url": "/thedev", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/46ef210c-44f1-4dce-a0bd-8f5949016861/160x160", "twitter": "the_dev", "id": 23494, "github": "", "website_url": "http://www.thedev.ro", "full_name": "", "dribbble": "", "counts": {"follows": 1, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/23494/"}, {"username": "koopajah", "bio": "Linux embedded C developer starting web development", "app_url": "/koopajah", "avatar_url": "https://d17f28g3dsa4vh.cloudfront.net/img/default-avatar.png", "twitter": "koopajah", "id": 44740, "github": "", "website_url": "", "full_name": "", "dribbble": "", "counts": {"follows": 2, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/44740/"}, {"username": "ahmednadar", "bio": "Web developer", "app_url": "/ahmednadar", "avatar_url": "https://d17f28g3dsa4vh.cloudfront.net/img/default-avatar.png", "twitter": "ahmednadar", "id": 14286, "github": "", "website_url": "", "full_name": "", "dribbble": "", "counts": {"follows": 3, "followed_by": 1}, "is_pro": false, "resource_uri": "/api/users/14286/"}, {"username": "yaandil", "bio": "Developer", "app_url": "/yaandil", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/fcd9078b-823f-49ba-8f0f-e56000eabf98/160x160", "twitter": "mkanski", "id": 10467, "github": "realez", "website_url": "", "full_name": "", "dribbble": "", "counts": {"follows": 7, "followed_by": 2}, "is_pro": false, "resource_uri": "/api/users/10467/"}, {"username": "julianosaless", "bio": "Software Developer", "app_url": "/julianosaless", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/cd2f2575-f4b5-4430-a941-eab804a0e303/160x160", "twitter": "JulianoSaless", "id": 40872, "github": "", "website_url": "http://www.devjulianosales.wordpress.com", "full_name": "", "dribbble": "", "counts": {"follows": 9, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/40872/"}, {"username": "dynamik", "bio": "under development!!!", "app_url": "/dynamik", "avatar_url": "https://d17f28g3dsa4vh.cloudfront.net/img/default-avatar.png", "twitter": "dynamikus", "id": 33627, "github": "", "website_url": "http://www.dynamik.us", "full_name": "", "dribbble": "", "counts": {"follows": 12, "followed_by": 1}, "is_pro": false, "resource_uri": "/api/users/33627/"}, {"username": "danielveneg", "bio": "Web Developer", "app_url": "/danielveneg", "avatar_url": "https://d17f28g3dsa4vh.cloudfront.net/img/default-avatar.png", "twitter": "danielveneg", "id": 32525, "github": "", "website_url": "", "full_name": "", "dribbble": "", "counts": {"follows": 0, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/32525/"}, {"username": "mphome", "bio": "Software Developer", "app_url": "/mphome", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/5de37e1a-f190-4cc4-b579-70284be8582a/160x160", "twitter": "mphome", "id": 38248, "github": "", "website_url": "http://mphome.dp.ua", "full_name": "", "dribbble": "", "counts": {"follows": 9, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/38248/"}, {"username": "nevron", "bio": "Designer / Developer", "app_url": "/nevron", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/237cb878-fcc9-4b97-af60-86e795630634/160x160", "twitter": "nevron", "id": 26380, "github": "", "website_url": "http://www.erhantunali.com/blog", "full_name": "", "dribbble": "", "counts": {"follows": 13, "followed_by": 1}, "is_pro": false, "resource_uri": "/api/users/26380/"}, {"username": "garciademarina", "bio": "OSClass developer", "app_url": "/garciademarina", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/f73d31e5-8a97-4b50-adf8-b967e4331bc7/160x160", "twitter": "garciademarina", "id": 26878, "github": "", "website_url": "", "full_name": "", "dribbble": "", "counts": {"follows": 14, "followed_by": 2}, "is_pro": false, "resource_uri": "/api/users/26878/"}, {"username": "sgcet", "bio": "web developer", "app_url": "/sgcet", "avatar_url": "https://d17f28g3dsa4vh.cloudfront.net/img/default-avatar.png", "twitter": "sgcet", "id": 21324, "github": "", "website_url": "", "full_name": "", "dribbble": "", "counts": {"follows": 0, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/21324/"}, {"username": "tzumby", "bio": "Rails developer", "app_url": "/tzumby", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/17d650d7-8874-416f-a1d7-27e85a42e3be/160x160", "twitter": "tzumby", "id": 28621, "github": "", "website_url": "http://www.razlab.com", "full_name": "", "dribbble": "", "counts": {"follows": 5, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/28621/"}, {"username": "arjoonkanth", "bio": "Web Developer", "app_url": "/arjoonkanth", "avatar_url": "https://d17f28g3dsa4vh.cloudfront.net/img/default-avatar.png", "twitter": "", "id": 54311, "github": "", "website_url": "", "full_name": "", "dribbble": "", "counts": {"follows": 11, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/54311/"}, {"username": "janerist", "bio": "Software developer", "app_url": "/janerist", "avatar_url": "https://d19weqihs4yh5u.cloudfront.net/avatars/ed084049-4d12-45c0-b2f1-d3d2d4a2f346/160x160", "twitter": "janerist", "id": 22629, "github": "", "website_url": "", "full_name": "", "dribbble": "", "counts": {"follows": 0, "followed_by": 0}, "is_pro": false, "resource_uri": "/api/users/22629/"}]}

data/spec/kippt/client_spec.rb

@@ -5,21 +5,45 @@ describe Kippt::Client do
   describe "#initialize" do
     context "when there is no username" do
       it "raises error" do
-        lambda {
+        expect {
           Kippt::Client.new(:password => "secret")
-        }.should raise_error(ArgumentError, "username is required")
+        }.to raise_error(ArgumentError, "username is required")
       end
     end
 
     context "when there is no password or token" do
       it "raises error" do
-        lambda {
+        expect {
           Kippt::Client.new(:username => "vesan")
-        }.should raise_error(ArgumentError, "password or token is required")
+        }.to raise_error(ArgumentError, "password or token is required")
+      end
+    end
+
+    context "when there is unauthenticated parameter" do
+      it "doesn't raise error" do
+        expect {
+          Kippt::Client.new(:unauthenticated => true)
+        }.to_not raise_error
+      end
+    end
+
+    context "when debug is set to true" do
+      it "sets client to debug mode" do
+        client = Kippt::Client.new(:unauthenticated => true, :debug => true)
+        client.debug?.should be_true
       end
     end
   end
 
+  context "#debug" do
+    it "can be set and read" do
+      client = Kippt::Client.new(:unauthenticated => true)
+      client.debug?.should be_false
+      client.debug = true
+      client.debug?.should be_true
+    end
+  end
+
   describe "connection" do
     subject { Kippt::Client.new(:username => "bob", :password => "secret") }
 
@@ -37,9 +61,9 @@ describe Kippt::Client do
           stub_request(:get, "https://bob:secret@kippt.com/error_path").
             to_return(:status => 401, :body => "{\"message\": \"Something horrible.\"}")
 
-          lambda {
+          expect {
             subject.get("/error_path")
-          }.should raise_error(Kippt::APIError, "Something horrible.")
+          }.to raise_error(Kippt::APIError, "Something horrible.")
         end
       end
     end
@@ -48,12 +72,12 @@ describe Kippt::Client do
   describe "#account" do
     subject { Kippt::Client.new(:username => "bob", :password => "secret") }
 
-    it "returns a Kippt::Account instance" do
+    it "returns a Kippt::User instance" do
       subject.should_receive(:get).with("account").and_return(
         stub :body => {}
       )
       account = subject.account
-      account.should be_a(Kippt::Account)
+      account.should be_a(Kippt::User)
     end
   end
 
@@ -74,4 +98,35 @@ describe Kippt::Client do
       clips.should be_a(Kippt::Clips)
     end
   end
+
+  describe "#users" do
+    subject { Kippt::Client.new(:username => "bob", :password => "secret") }
+
+    it "returns a Kippt::Users instance" do
+      users = subject.users
+      users.should be_a(Kippt::Users)
+    end
+  end
+
+  describe "#resource_from_url" do
+    subject { Kippt::Client.new(valid_user_credentials) }
+
+    it "returns correct resource" do
+      stub_get("/users/10").
+        to_return(:status => 200, :body => fixture("user.json"))
+      resource = subject.resource_from_url(Kippt::User, "/api/users/10")
+      resource.should be_a(Kippt::User)
+    end
+
+    context "when passed URL is blank" do
+      it "raises ArgumentError" do
+        expect {
+          subject.resource_from_url(stub, "")
+        }.to raise_error(ArgumentError, "The parameter URL can't be blank")
+        expect {
+          subject.resource_from_url(stub, nil)
+        }.to raise_error(ArgumentError, "The parameter URL can't be blank")
+      end
+    end
+  end
 end

data/spec/kippt/clip_collection_spec.rb

@@ -6,9 +6,9 @@ describe Kippt::ClipCollection do
   let(:data_with_multiple_pages) {
     MultiJson.load(fixture("clips_with_multiple_pages.json").read)
   }
-  subject { Kippt::ClipCollection.new(data) }
-  let(:subject_with_multiple_pages) { Kippt::ClipCollection.new(data_with_multiple_pages, collection_resource) }
-  let(:collection_resource) { nil }
+  let(:client) { stub }
+  subject { Kippt::ClipCollection.new(data, client) }
+  let(:subject_with_multiple_pages) { Kippt::ClipCollection.new(data_with_multiple_pages, client) }
 
   it_behaves_like "collection"
 end

data/spec/kippt/clip_spec.rb

@@ -2,14 +2,119 @@ require "spec_helper"
 require "kippt/clip"
 
 describe Kippt::Clip do
-  subject { Kippt::Clip.new(data, collection_resource) }
-  let(:collection_resource) { Kippt::Client.new(valid_user_credentials).clips }
+  subject { Kippt::Clip.new(data, client) }
+  let(:client) { Kippt::Client.new(valid_user_credentials) }
+  let(:collection_resource_class) { Kippt::Clips }
 
   let(:data) { MultiJson.load(fixture("clip.json").read) }
   let(:attributes) {
-    [:url_domain, :updated, :is_starred, :title,
-     :url, :notes, :created, :list, :id, :resource_uri]
+    [:url_domain, :is_starred, :title,
+     :url, :notes, :id, :resource_uri]
+   }
+   let(:mapped_attributes) {
+     {:updated => "Time", :created => "Time",
+      :user => "Kippt::User", :via => "Kippt::Clip"}
    }
 
   it_behaves_like "resource"
+
+  describe "#list_uri" do
+    context "when API data has an list URI" do
+      let(:data) { {"list" => "/api/lists/44525/"} }
+
+      it "returns the URI" do
+        subject.list_uri.should eq "/api/lists/44525/"
+      end
+    end
+
+    context "when API data has embedded list attributes" do
+      let(:data) { {"list" => {"resource_uri" => "/api/lists/44525/"}} }
+
+      it "returns the uri of the embedded list" do
+        subject.list_uri.should eq "/api/lists/44525/"
+      end
+    end
+  end
+
+  describe "#list" do
+    context "when API data has an list URI" do
+      let(:data) { {"list" => "/api/lists/44525/"} }
+
+      it "fetches the data and creates an instance out of it" do
+        stub_get("/lists/44525/").
+          to_return(:status => 200, :body => fixture("list.json"))
+
+        subject.list.should be_a Kippt::List
+      end
+    end
+
+    context "when API data has embedded list attributes" do
+      let(:data) { {"list" => {"resource_uri" => "/api/lists/44525/"}} }
+
+      it "returns an instance using the embedded list" do
+        subject.list.should be_a Kippt::List
+      end
+    end
+
+    context "when a Kippt::List is passed" do
+      let(:list) { Kippt::List.new }
+      let(:data) { {"list" => list} }
+
+      it "returns the passed list" do
+        subject.list.should eq list
+      end
+    end
+  end
+
+  describe "#comments" do
+    it "returns Kippt::Comments" do
+      subject.comments.should be_a Kippt::Comments
+    end
+
+    it "returns object where clip is set" do
+      subject.comments.clip.should eq subject
+    end
+  end
+
+  describe "#all_comments_embedded?" do
+    context "when comment count and number of comment objects matches" do
+      let(:data) { {"comments" => {
+        "count" => 2, "data" => [{}, {}]
+      }} }
+
+      it "returns true" do
+        subject.all_comments_embedded?.should be_true
+      end
+    end
+
+    context "when comment count and number of comment objects doesn't match" do
+      let(:data) { {"comments" => {
+        "count" => 2, "data" => [{}]
+      }} }
+
+      it "returns true" do
+        subject.all_comments_embedded?.should be_false
+      end
+    end
+  end
+
+  describe "#like" do
+    let(:like) { stub :like }
+
+    it "instantiates a Kippt::Like and saves it" do
+      Kippt::Like.should_receive(:new).with(client, subject).and_return(like)
+      like.should_receive(:save)
+      subject.like
+    end
+  end
+
+  describe "#unlike" do
+    let(:like) { stub :like }
+
+    it "instantiates a Kippt::Like and destroys it" do
+      Kippt::Like.should_receive(:new).with(client, subject).and_return(like)
+      like.should_receive(:destroy)
+      subject.unlike
+    end
+  end
 end