twitter 4.0.0

data/spec/twitter/api/blocks_spec.rb

@@ -0,0 +1,167 @@
+require 'helper'
+
+describe Twitter::API do
+
+  before do
+    @client = Twitter::Client.new
+  end
+
+  describe "#blocking" do
+    before do
+      stub_get("/1.1/blocks/list.json").
+        with(:query => {:cursor => "-1"}).
+        to_return(:body => fixture("users_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "requests the correct resource" do
+      @client.blocking
+      a_get("/1.1/blocks/list.json").
+        with(:query => {:cursor => "-1"}).
+        should have_been_made
+    end
+    it "returns an array of user objects that the authenticating user is blocking" do
+      blocking = @client.blocking
+      blocking.should be_a Twitter::Cursor
+      blocking.users.should be_an Array
+      blocking.users.first.should be_a Twitter::User
+      blocking.users.first.id.should eq 7505382
+    end
+  end
+
+  describe "#blocked_ids" do
+    before do
+      stub_get("/1.1/blocks/ids.json").
+        with(:query => {:cursor => "-1"}).
+        to_return(:body => fixture("ids_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "requests the correct resource" do
+      @client.blocked_ids
+      a_get("/1.1/blocks/ids.json").
+        with(:query => {:cursor => "-1"}).
+        should have_been_made
+    end
+    it "returns an array of numeric user IDs the authenticating user is blocking" do
+      blocked_ids = @client.blocked_ids
+      blocked_ids.should be_a Twitter::Cursor
+      blocked_ids.ids.should be_an Array
+      blocked_ids.ids.first.should eq 14100886
+    end
+  end
+
+  describe "#block?" do
+    context "with a screen name passed" do
+      before do
+        stub_get("/1.1/blocks/ids.json").
+          with(:query => {:cursor => "-1"}).
+          to_return(:body => fixture("ids_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        stub_get("/1.1/blocks/ids.json").
+          with(:query => {:cursor => "1305102810874389703"}).
+          to_return(:body => fixture("ids_list2.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        stub_get("/1.1/users/show.json").
+          with(:query => {:screen_name => "pengwynn"}).
+          to_return(:body => fixture("pengwynn.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        stub_get("/1.1/users/show.json").
+          with(:query => {:screen_name => "sferik"}).
+          to_return(:body => fixture("sferik.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.block?("sferik")
+        a_get("/1.1/blocks/ids.json").
+          with(:query => {:cursor => "-1"}).
+          should have_been_made
+        a_get("/1.1/blocks/ids.json").
+          with(:query => {:cursor => "1305102810874389703"}).
+          should have_been_made
+        a_get("/1.1/users/show.json").
+          with(:query => {:screen_name => "sferik"}).
+          should have_been_made
+      end
+      it "returns true if block exists" do
+        block = @client.block?("pengwynn")
+        block.should be_true
+      end
+      it "returns false if block does not exist" do
+        block = @client.block?("sferik")
+        block.should be_false
+      end
+    end
+    context "with a user ID passed" do
+      before do
+        stub_get("/1.1/blocks/ids.json").
+          with(:query => {:cursor => "-1"}).
+          to_return(:body => fixture("ids_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        stub_get("/1.1/blocks/ids.json").
+          with(:query => {:cursor => "1305102810874389703"}).
+          to_return(:body => fixture("ids_list2.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resources" do
+        @client.block?(7505382)
+        a_get("/1.1/blocks/ids.json").
+          with(:query => {:cursor => "-1"}).
+          should have_been_made
+        a_get("/1.1/blocks/ids.json").
+          with(:query => {:cursor => "1305102810874389703"}).
+          should have_been_made
+      end
+    end
+    context "with a user object passed" do
+      before do
+        stub_get("/1.1/blocks/ids.json").
+          with(:query => {:cursor => "-1"}).
+          to_return(:body => fixture("ids_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        stub_get("/1.1/blocks/ids.json").
+          with(:query => {:cursor => "1305102810874389703"}).
+          to_return(:body => fixture("ids_list2.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resources" do
+        user = Twitter::User.new(:id => '7505382')
+        @client.block?(user)
+        a_get("/1.1/blocks/ids.json").
+          with(:query => {:cursor => "-1"}).
+          should have_been_made
+        a_get("/1.1/blocks/ids.json").
+          with(:query => {:cursor => "1305102810874389703"}).
+          should have_been_made
+      end
+    end
+  end
+
+  describe "#block" do
+    before do
+      stub_post("/1.1/blocks/create.json").
+        with(:body => {:screen_name => "sferik"}).
+        to_return(:body => fixture("sferik.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "requests the correct resource" do
+      @client.block("sferik")
+      a_post("/1.1/blocks/create.json").
+        should have_been_made
+    end
+    it "returns an array of blocked users" do
+      users = @client.block("sferik")
+      users.should be_an Array
+      users.first.should be_a Twitter::User
+      users.first.id.should eq 7505382
+    end
+  end
+
+  describe "#unblock" do
+    before do
+      stub_post("/1.1/blocks/destroy.json").
+        with(:body => {:screen_name => "sferik"}).
+        to_return(:body => fixture("sferik.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "requests the correct resource" do
+      @client.unblock("sferik")
+      a_post("/1.1/blocks/destroy.json").
+        with(:body => {:screen_name => "sferik"}).
+        should have_been_made
+    end
+    it "returns an array of un-blocked users" do
+      users = @client.unblock("sferik")
+      users.should be_an Array
+      users.first.should be_a Twitter::User
+      users.first.id.should eq 7505382
+    end
+  end
+
+end

data/spec/twitter/api/direct_messages_spec.rb

@@ -0,0 +1,142 @@
+require 'helper'
+
+describe Twitter::API do
+
+  before do
+    @client = Twitter::Client.new
+  end
+
+  describe "#direct_messages_received" do
+    before do
+      stub_get("/1.1/direct_messages.json").
+        to_return(:body => fixture("direct_messages.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "requests the correct resource" do
+      @client.direct_messages_received
+      a_get("/1.1/direct_messages.json").
+        should have_been_made
+    end
+    it "returns the 20 most recent direct messages sent to the authenticating user" do
+      direct_messages = @client.direct_messages_received
+      direct_messages.should be_an Array
+      direct_messages.first.should be_a Twitter::DirectMessage
+      direct_messages.first.sender.id.should eq 7505382
+    end
+  end
+
+  describe "#direct_messages_sent" do
+    before do
+      stub_get("/1.1/direct_messages/sent.json").
+        to_return(:body => fixture("direct_messages.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "requests the correct resource" do
+      @client.direct_messages_sent
+      a_get("/1.1/direct_messages/sent.json").
+        should have_been_made
+    end
+    it "returns the 20 most recent direct messages sent by the authenticating user" do
+      direct_messages = @client.direct_messages_sent
+      direct_messages.should be_an Array
+      direct_messages.first.should be_a Twitter::DirectMessage
+      direct_messages.first.sender.id.should eq 7505382
+    end
+  end
+
+  describe "#direct_message_destroy" do
+    before do
+      stub_post("/1.1/direct_messages/destroy.json").
+        with(:body => {:id => "1825785544"}).
+        to_return(:body => fixture("direct_message.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "requests the correct resource" do
+      @client.direct_message_destroy(1825785544)
+      a_post("/1.1/direct_messages/destroy.json").
+        with(:body => {:id => "1825785544"}).
+        should have_been_made
+    end
+    it "returns an array of deleted messages" do
+      direct_messages = @client.direct_message_destroy(1825785544)
+      direct_messages.should be_an Array
+      direct_messages.first.should be_a Twitter::DirectMessage
+      direct_messages.first.sender.id.should eq 7505382
+    end
+  end
+
+  describe "#direct_message_create" do
+    before do
+      stub_post("/1.1/direct_messages/new.json").
+        with(:body => {:screen_name => "pengwynn", :text => "Creating a fixture for the Twitter gem"}).
+        to_return(:body => fixture("direct_message.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "requests the correct resource" do
+      @client.direct_message_create("pengwynn", "Creating a fixture for the Twitter gem")
+      a_post("/1.1/direct_messages/new.json").
+        with(:body => {:screen_name => "pengwynn", :text => "Creating a fixture for the Twitter gem"}).
+        should have_been_made
+    end
+    it "returns the sent message" do
+      direct_message = @client.direct_message_create("pengwynn", "Creating a fixture for the Twitter gem")
+      direct_message.should be_a Twitter::DirectMessage
+      direct_message.text.should eq "Creating a fixture for the Twitter gem"
+    end
+  end
+
+  describe "#direct_message" do
+    before do
+      stub_get("/1.1/direct_messages/show.json").
+        with(:query => {:id => "1825786345"}).
+        to_return(:body => fixture("direct_message.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "requests the correct resource" do
+      @client.direct_message(1825786345)
+      a_get("/1.1/direct_messages/show.json").
+        with(:query => {:id => "1825786345"}).
+        should have_been_made
+    end
+    it "returns the specified direct message" do
+      direct_message = @client.direct_message(1825786345)
+      direct_message.should be_a Twitter::DirectMessage
+      direct_message.sender.id.should eq 7505382
+    end
+  end
+
+  describe "#direct_messages" do
+    context "with ids passed" do
+      before do
+        stub_get("/1.1/direct_messages/show.json").
+          with(:query => {:id => "1825786345"}).
+          to_return(:body => fixture("direct_message.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.direct_messages(1825786345)
+        a_get("/1.1/direct_messages/show.json").
+          with(:query => {:id => "1825786345"}).
+          should have_been_made
+      end
+      it "returns an array of direct messages" do
+        direct_messages = @client.direct_messages(1825786345)
+        direct_messages.should be_an Array
+        direct_messages.first.should be_a Twitter::DirectMessage
+        direct_messages.first.sender.id.should eq 7505382
+      end
+    end
+    context "without ids passed" do
+      before do
+        stub_get("/1.1/direct_messages.json").
+          to_return(:body => fixture("direct_messages.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.direct_messages
+        a_get("/1.1/direct_messages.json").
+          should have_been_made
+      end
+      it "returns the 20 most recent direct messages sent to the authenticating user" do
+        direct_messages = @client.direct_messages
+        direct_messages.should be_an Array
+        direct_messages.first.should be_a Twitter::DirectMessage
+        direct_messages.first.sender.id.should eq 7505382
+      end
+    end
+  end
+
+end

data/spec/twitter/api/friendships_spec.rb

@@ -0,0 +1,567 @@
+require 'helper'
+
+describe Twitter::API do
+
+  before do
+    @client = Twitter::Client.new
+  end
+
+  describe "#follower_ids" do
+    context "with a screen_name passed" do
+      before do
+        stub_get("/1.1/followers/ids.json").
+          with(:query => {:cursor => "-1", :screen_name => "sferik"}).
+          to_return(:body => fixture("ids_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.follower_ids("sferik")
+        a_get("/1.1/followers/ids.json").
+          with(:query => {:cursor => "-1", :screen_name => "sferik"}).
+          should have_been_made
+      end
+      it "returns an array of numeric IDs for every user following the specified user" do
+        follower_ids = @client.follower_ids("sferik")
+        follower_ids.should be_a Twitter::Cursor
+        follower_ids.ids.should be_an Array
+        follower_ids.ids.first.should eq 14100886
+      end
+    end
+    context "without arguments passed" do
+      before do
+        stub_get("/1.1/followers/ids.json").
+          with(:query => {:cursor => "-1"}).
+          to_return(:body => fixture("ids_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.follower_ids
+        a_get("/1.1/followers/ids.json").
+          with(:query => {:cursor => "-1"}).
+          should have_been_made
+      end
+      it "returns an array of numeric IDs for every user following the specified user" do
+        follower_ids = @client.follower_ids
+        follower_ids.should be_a Twitter::Cursor
+        follower_ids.ids.should be_an Array
+        follower_ids.ids.first.should eq 14100886
+      end
+    end
+  end
+
+  describe "#friend_ids" do
+    context "with a screen_name passed" do
+      before do
+        stub_get("/1.1/friends/ids.json").
+          with(:query => {:cursor => "-1", :screen_name => "sferik"}).
+          to_return(:body => fixture("ids_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.friend_ids("sferik")
+        a_get("/1.1/friends/ids.json").
+          with(:query => {:cursor => "-1", :screen_name => "sferik"}).
+          should have_been_made
+      end
+      it "returns an array of numeric IDs for every user the specified user is following" do
+        friend_ids = @client.friend_ids("sferik")
+        friend_ids.should be_a Twitter::Cursor
+        friend_ids.ids.should be_an Array
+        friend_ids.ids.first.should eq 14100886
+      end
+    end
+    context "without arguments passed" do
+      before do
+        stub_get("/1.1/friends/ids.json").
+          with(:query => {:cursor => "-1"}).
+          to_return(:body => fixture("ids_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.friend_ids
+        a_get("/1.1/friends/ids.json").
+          with(:query => {:cursor => "-1"}).
+          should have_been_made
+      end
+      it "returns an array of numeric IDs for every user the specified user is following" do
+        friend_ids = @client.friend_ids
+        friend_ids.should be_a Twitter::Cursor
+        friend_ids.ids.should be_an Array
+        friend_ids.ids.first.should eq 14100886
+      end
+    end
+  end
+
+  describe "#friendship?" do
+    context "with screen names passed" do
+      before do
+        stub_get("/1.1/friendships/show.json").
+          with(:query => {:source_screen_name => "sferik", :target_screen_name => "pengwynn"}).
+          to_return(:body => fixture("following.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        stub_get("/1.1/friendships/show.json").
+          with(:query => {:source_screen_name => "pengwynn", :target_screen_name => "sferik"}).
+          to_return(:body => fixture("not_following.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.friendship?("sferik", "pengwynn")
+        a_get("/1.1/friendships/show.json").
+          with(:query => {:source_screen_name => "sferik", :target_screen_name => "pengwynn"}).
+          should have_been_made
+      end
+      it "returns true if user A follows user B" do
+        friendship = @client.friendship?("sferik", "pengwynn")
+        friendship.should be_true
+      end
+      it "returns false if user A does not follow user B" do
+        friendship = @client.friendship?("pengwynn", "sferik")
+        friendship.should be_false
+      end
+    end
+    context "with user IDs passed" do
+      before do
+        stub_get("/1.1/friendships/show.json").
+          with(:query => {:source_id => "7505382", :target_id => "14100886"}).
+          to_return(:body => fixture("following.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.friendship?(7505382, 14100886)
+        a_get("/1.1/friendships/show.json").
+          with(:query => {:source_id => "7505382", :target_id => "14100886"}).
+          should have_been_made
+      end
+    end
+    context "with user objects passed" do
+      before do
+        stub_get("/1.1/friendships/show.json").
+          with(:query => {:source_id => "7505382", :target_id => "14100886"}).
+          to_return(:body => fixture("following.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        user1 = Twitter::User.new(:id => '7505382')
+        user2 = Twitter::User.new(:id => '14100886')
+        @client.friendship?(user1, user2)
+        a_get("/1.1/friendships/show.json").
+          with(:query => {:source_id => "7505382", :target_id => "14100886"}).
+          should have_been_made
+      end
+    end
+  end
+
+  describe "#friendships_incoming" do
+    before do
+      stub_get("/1.1/friendships/incoming.json").
+        with(:query => {:cursor => "-1"}).
+        to_return(:body => fixture("ids_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "requests the correct resource" do
+      @client.friendships_incoming
+      a_get("/1.1/friendships/incoming.json").
+        with(:query => {:cursor => "-1"}).
+        should have_been_made
+    end
+    it "returns an array of numeric IDs for every user who has a pending request to follow the authenticating user" do
+      friendships_incoming = @client.friendships_incoming
+      friendships_incoming.should be_a Twitter::Cursor
+      friendships_incoming.ids.should be_an Array
+      friendships_incoming.ids.first.should eq 14100886
+    end
+  end
+
+  describe "#friendships_outgoing" do
+    before do
+      stub_get("/1.1/friendships/outgoing.json").
+        with(:query => {:cursor => "-1"}).
+        to_return(:body => fixture("ids_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "requests the correct resource" do
+      @client.friendships_outgoing
+      a_get("/1.1/friendships/outgoing.json").
+        with(:query => {:cursor => "-1"}).
+        should have_been_made
+    end
+    it "returns an array of numeric IDs for every protected user for whom the authenticating user has a pending follow request" do
+      friendships_outgoing = @client.friendships_outgoing
+      friendships_outgoing.should be_a Twitter::Cursor
+      friendships_outgoing.ids.should be_an Array
+      friendships_outgoing.ids.first.should eq 14100886
+    end
+  end
+
+  describe "#friendship" do
+    context "with screen names passed" do
+      before do
+        stub_get("/1.1/friendships/show.json").
+          with(:query => {:source_screen_name => "sferik", :target_screen_name => "pengwynn"}).
+          to_return(:body => fixture("following.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.friendship("sferik", "pengwynn")
+        a_get("/1.1/friendships/show.json").
+          with(:query => {:source_screen_name => "sferik", :target_screen_name => "pengwynn"}).
+          should have_been_made
+      end
+      it "returns detailed information about the relationship between two users" do
+        relationship = @client.friendship("sferik", "pengwynn")
+        relationship.should be_a Twitter::Relationship
+        relationship.source.id.should eq 7505382
+      end
+    end
+    context "with numeric screen names passed" do
+      before do
+        stub_get("/1.1/friendships/show.json").
+          with(:query => {:source_screen_name => "0", :target_screen_name => "311"}).
+          to_return(:body => fixture("following.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.friendship("0", "311")
+        a_get("/1.1/friendships/show.json").
+          with(:query => {:source_screen_name => "0", :target_screen_name => "311"}).
+          should have_been_made
+      end
+    end
+    context "with user IDs passed" do
+      before do
+        stub_get("/1.1/friendships/show.json").
+          with(:query => {:source_id => "7505382", :target_id => "14100886"}).
+          to_return(:body => fixture("following.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.friendship(7505382, 14100886)
+        a_get("/1.1/friendships/show.json").
+          with(:query => {:source_id => "7505382", :target_id => "14100886"}).
+          should have_been_made
+      end
+    end
+    context "with user objects passed" do
+      before do
+        stub_get("/1.1/friendships/show.json").
+          with(:query => {:source_id => "7505382", :target_id => "14100886"}).
+          to_return(:body => fixture("following.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        user1 = Twitter::User.new(:id => '7505382')
+        user2 = Twitter::User.new(:id => '14100886')
+        @client.friendship(user1, user2)
+        a_get("/1.1/friendships/show.json").
+          with(:query => {:source_id => "7505382", :target_id => "14100886"}).
+          should have_been_made
+      end
+    end
+  end
+
+  describe "#follow" do
+    context "with :follow => true passed" do
+      before do
+        stub_get("/1.1/friends/ids.json").
+          with(:query => {:cursor => "-1"}).
+          to_return(:body => fixture("ids_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        stub_post("/1.1/users/lookup.json").
+          with(:body => {:screen_name => "sferik,pengwynn"}).
+          to_return(:body => fixture("friendships.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        stub_post("/1.1/friendships/create.json").
+          with(:body => {:user_id => "7505382", :follow => "true"}).
+          to_return(:body => fixture("sferik.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.follow("sferik", "pengwynn", :follow => true)
+        a_get("/1.1/friends/ids.json").
+          with(:query => {:cursor => "-1"}).
+          should have_been_made
+        a_post("/1.1/users/lookup.json").
+          with(:body => {:screen_name => "sferik,pengwynn"}).
+          should have_been_made
+        a_post("/1.1/friendships/create.json").
+          with(:body => {:user_id => "7505382", :follow => "true"}).
+          should have_been_made
+      end
+      it "returns an array of befriended users" do
+        users = @client.follow("sferik", "pengwynn", :follow => true)
+        users.should be_an Array
+        users.first.should be_a Twitter::User
+        users.first.id.should eq 7505382
+      end
+    end
+    context "with :follow => false passed" do
+      before do
+        stub_get("/1.1/friends/ids.json").
+          with(:query => {:cursor => "-1"}).
+          to_return(:body => fixture("ids_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        stub_post("/1.1/users/lookup.json").
+          with(:body => {:screen_name => "sferik,pengwynn"}).
+          to_return(:body => fixture("friendships.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        stub_post("/1.1/friendships/create.json").
+          with(:body => {:user_id => "7505382"}).
+          to_return(:body => fixture("sferik.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.follow("sferik", "pengwynn", :follow => false)
+        a_get("/1.1/friends/ids.json").
+          with(:query => {:cursor => "-1"}).
+          should have_been_made
+        a_post("/1.1/users/lookup.json").
+          with(:body => {:screen_name => "sferik,pengwynn"}).
+          should have_been_made
+        a_post("/1.1/friendships/create.json").
+          with(:body => {:user_id => "7505382"}).
+          should have_been_made
+      end
+      it "returns an array of befriended users" do
+        users = @client.follow("sferik", "pengwynn", :follow => false)
+        users.should be_an Array
+        users.first.should be_a Twitter::User
+        users.first.id.should eq 7505382
+      end
+    end
+    context "without :follow passed" do
+      before do
+        stub_get("/1.1/friends/ids.json").
+          with(:query => {:cursor => "-1"}).
+          to_return(:body => fixture("ids_list.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        stub_post("/1.1/users/lookup.json").
+          with(:body => {:screen_name => "sferik,pengwynn"}).
+          to_return(:body => fixture("friendships.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+        stub_post("/1.1/friendships/create.json").
+          with(:body => {:user_id => "7505382"}).
+          to_return(:body => fixture("sferik.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.follow("sferik", "pengwynn")
+        a_get("/1.1/friends/ids.json").
+          with(:query => {:cursor => "-1"}).
+          should have_been_made
+        a_post("/1.1/users/lookup.json").
+          with(:body => {:screen_name => "sferik,pengwynn"}).
+          should have_been_made
+        a_post("/1.1/friendships/create.json").
+          with(:body => {:user_id => "7505382"}).
+          should have_been_made
+      end
+      it "returns an array of befriended users" do
+        users = @client.follow("sferik", "pengwynn")
+        users.should be_an Array
+        users.first.should be_a Twitter::User
+        users.first.id.should eq 7505382
+      end
+    end
+  end
+
+  describe "#follow!" do
+    context "with :follow => true passed" do
+      before do
+        stub_post("/1.1/friendships/create.json").
+          with(:body => {:screen_name => "sferik", :follow => "true"}).
+          to_return(:body => fixture("sferik.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.follow!("sferik", :follow => true)
+        a_post("/1.1/friendships/create.json").
+          with(:body => {:screen_name => "sferik", :follow => "true"}).
+          should have_been_made
+      end
+      it "returns an array of befriended users" do
+        users = @client.follow!("sferik", :follow => true)
+        users.should be_an Array
+        users.first.should be_a Twitter::User
+        users.first.id.should eq 7505382
+      end
+    end
+    context "with :follow => false passed" do
+      before do
+        stub_post("/1.1/friendships/create.json").
+          with(:body => {:screen_name => "sferik"}).
+          to_return(:body => fixture("sferik.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.follow!("sferik", :follow => false)
+        a_post("/1.1/friendships/create.json").
+          with(:body => {:screen_name => "sferik"}).
+          should have_been_made
+      end
+      it "returns an array of befriended users" do
+        users = @client.follow!("sferik", :follow => false)
+        users.should be_an Array
+        users.first.should be_a Twitter::User
+        users.first.id.should eq 7505382
+      end
+    end
+    context "without :follow passed" do
+      before do
+        stub_post("/1.1/friendships/create.json").
+          with(:body => {:screen_name => "sferik"}).
+          to_return(:body => fixture("sferik.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.follow!("sferik")
+        a_post("/1.1/friendships/create.json").
+          with(:body => {:screen_name => "sferik"}).
+          should have_been_made
+      end
+      it "returns an array of befriended users" do
+        users = @client.follow!("sferik")
+        users.should be_an Array
+        users.first.should be_a Twitter::User
+        users.first.id.should eq 7505382
+      end
+    end
+  end
+
+  describe "#unfollow" do
+    before do
+      stub_post("/1.1/friendships/destroy.json").
+        with(:body => {:screen_name => "sferik"}).
+        to_return(:body => fixture("sferik.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "requests the correct resource" do
+      @client.unfollow("sferik")
+      a_post("/1.1/friendships/destroy.json").
+        with(:body => {:screen_name => "sferik"}).
+        should have_been_made
+    end
+    it "returns an array of unfollowed users" do
+      users = @client.friendship_destroy("sferik")
+      users.should be_an Array
+      users.first.should be_a Twitter::User
+      users.first.id.should eq 7505382
+    end
+  end
+
+  describe "#friendships" do
+    context "with screen names passed" do
+      before do
+        stub_get("/1.1/friendships/lookup.json").
+          with(:query => {:screen_name => "sferik,pengwynn"}).
+          to_return(:body => fixture("friendships.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.friendships("sferik", "pengwynn")
+        a_get("/1.1/friendships/lookup.json").
+          with(:query => {:screen_name => "sferik,pengwynn"}).
+          should have_been_made
+      end
+      it "returns up to 100 users worth of extended information" do
+        friendships = @client.friendships("sferik", "pengwynn")
+        friendships.should be_an Array
+        friendships.first.should be_a Twitter::User
+        friendships.first.id.should eq 7505382
+        friendships.first.connections.should eq ["none"]
+      end
+    end
+    context "with numeric screen names passed" do
+      before do
+        stub_get("/1.1/friendships/lookup.json").
+          with(:query => {:screen_name => "0,311"}).
+          to_return(:body => fixture("friendships.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.friendships("0", "311")
+        a_get("/1.1/friendships/lookup.json").
+          with(:query => {:screen_name => "0,311"}).
+          should have_been_made
+      end
+    end
+    context "with user IDs passed" do
+      before do
+        stub_get("/1.1/friendships/lookup.json").
+          with(:query => {:user_id => "7505382,14100886"}).
+          to_return(:body => fixture("friendships.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.friendships(7505382, 14100886)
+        a_get("/1.1/friendships/lookup.json").
+          with(:query => {:user_id => "7505382,14100886"}).
+          should have_been_made
+      end
+    end
+    context "with both screen names and user IDs passed" do
+      before do
+        stub_get("/1.1/friendships/lookup.json").
+          with(:query => {:screen_name => "sferik", :user_id => "14100886"}).
+          to_return(:body => fixture("friendships.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.friendships("sferik", 14100886)
+        a_get("/1.1/friendships/lookup.json").
+          with(:query => {:screen_name => "sferik", :user_id => "14100886"}).
+          should have_been_made
+      end
+    end
+  end
+
+  describe "#friendships" do
+    context "with screen names passed" do
+      before do
+        stub_get("/1.1/friendships/lookup.json").
+          with(:query => {:screen_name => "sferik,pengwynn"}).
+          to_return(:body => fixture("friendships.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.friendships("sferik", "pengwynn")
+        a_get("/1.1/friendships/lookup.json").
+          with(:query => {:screen_name => "sferik,pengwynn"}).
+          should have_been_made
+      end
+      it "returns up to 100 users worth of extended information" do
+        friendships = @client.friendships("sferik", "pengwynn")
+        friendships.should be_an Array
+        friendships.first.should be_a Twitter::User
+        friendships.first.id.should eq 7505382
+        friendships.first.connections.should eq ["none"]
+      end
+    end
+    context "with numeric screen names passed" do
+      before do
+        stub_get("/1.1/friendships/lookup.json").
+          with(:query => {:screen_name => "0,311"}).
+          to_return(:body => fixture("friendships.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.friendships("0", "311")
+        a_get("/1.1/friendships/lookup.json").
+          with(:query => {:screen_name => "0,311"}).
+          should have_been_made
+      end
+    end
+    context "with user IDs passed" do
+      before do
+        stub_get("/1.1/friendships/lookup.json").
+          with(:query => {:user_id => "7505382,14100886"}).
+          to_return(:body => fixture("friendships.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.friendships(7505382, 14100886)
+        a_get("/1.1/friendships/lookup.json").
+          with(:query => {:user_id => "7505382,14100886"}).
+          should have_been_made
+      end
+    end
+    context "with both screen names and user IDs passed" do
+      before do
+        stub_get("/1.1/friendships/lookup.json").
+          with(:query => {:screen_name => "sferik", :user_id => "14100886"}).
+          to_return(:body => fixture("friendships.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+      end
+      it "requests the correct resource" do
+        @client.friendships("sferik", 14100886)
+        a_get("/1.1/friendships/lookup.json").
+          with(:query => {:screen_name => "sferik", :user_id => "14100886"}).
+          should have_been_made
+      end
+    end
+  end
+
+  describe "#friendship_update" do
+    before do
+      stub_post("/1.1/friendships/update.json").
+        with(:body => {:screen_name => "sferik", :retweets => "true"}).
+        to_return(:body => fixture("following.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "requests the correct resource" do
+      @client.friendship_update("sferik", :retweets => true)
+      a_post("/1.1/friendships/update.json").
+        with(:body => {:screen_name => "sferik", :retweets => "true"}).
+        should have_been_made
+    end
+    it "returns detailed information about the relationship between two users" do
+      relationship = @client.friendship_update("sferik", :retweets => true)
+      relationship.should be_a Twitter::Relationship
+      relationship.source.id.should eq 7505382
+    end
+  end
+
+end