Bump version v0.0.7

User#followers

README.md

@@ -44,6 +44,9 @@ client.user_by_username("username") #=> #<Twttr::Model::User>
 #Twttr::Client#users(:user_ids)
 client.users(["user_id_1", "user_id_2"]) #=> [#<Twttr::Model::User>]
 
+# Twttr::Client#Followers
+client.followers("user_id") == client.user("user_id").followers
+
 # Twttr::Client#Following
 client.following("user_id") == client.user("user_id").following
 ```

lib/twttr/model/user.rb

@@ -15,6 +15,20 @@ def initialize(data, client = nil)
         @client = client
       end
 
+      # GET /2/users/:id/followers
+      # https://developer.twitter.com/en/docs/twitter-api/users/follows/api-reference/get-users-id-followers
+      #
+      # Returns paginated list of users following user_id.
+      #
+      # @param max_results [Integer] Max number of results per peage.
+      # @param pagination_token [String] Initial page pagination token.
+      # @yield [Array<Twttr::Model::User>] User followers page.
+      # @yield [String,NilClass] Pagination token.
+      # @return [Array<Twttr::Model::User>] Follower Users.
+      def followers(max_results: nil, pagination_token: nil, &block)
+        client.followers(id, max_results: max_results, pagination_token: pagination_token, &block)
+      end
+
       # Forwards to Follows#following setting user_id to current user's id.
       #
       # GET /2/users/:id/following

test/lib/twttr/model/test_user.rb

@@ -4,7 +4,7 @@
 
 module Twttr
   class Client
-    class TestUser < Minitest::Test
+    class TestUser < Minitest::Test # rubocop:disable Metrics/ClassLength
       def setup
         @client = Twttr::Client.new do |config|
           config.consumer_key        = 'consumer_key'
@@ -30,6 +30,8 @@ def setup
           "meta": {"result_count": 2}
         }'
         @mock_oauth_responses = {
+          'https://api.twitter.com/2/users/user_id/followers' => OpenStruct.new(body: first_mock_body),
+          'https://api.twitter.com/2/users/user_id/followers?pagination_token=next-token' => OpenStruct.new(body: second_mock_body),
           'https://api.twitter.com/2/users/user_id/following' => OpenStruct.new(body: first_mock_body),
           'https://api.twitter.com/2/users/user_id/following?pagination_token=next-token' => OpenStruct.new(body: second_mock_body)
         }
@@ -64,6 +66,33 @@ def test_initialize
         end
       end
 
+      def test_followers
+        mock = lambda do |uri, _config|
+          @mock_oauth_responses[uri.to_s]
+        end
+        Twttr::Client::OAuthRequest.stub :get, mock do
+          users = @user.followers
+          assert_equal(4, users.length)
+          users.each { |user| assert_instance_of(Twttr::Model::User, user) }
+        end
+      end
+
+      def test_followers_with_block # rubocop:disable Metrics/AbcSize
+        mock = lambda do |uri, _config|
+          puts uri.to_s
+          @mock_oauth_responses[uri.to_s]
+        end
+        Twttr::Client::OAuthRequest.stub :get, mock do
+          all_users = @user.followers do |users, token|
+            assert_equal(2, users.length)
+            users.each { |user| assert_instance_of(Twttr::Model::User, user) }
+            assert_nil(nil, token)
+          end
+          assert_equal(4, all_users.length)
+          all_users.each { |user| assert_instance_of(Twttr::Model::User, user) }
+        end
+      end
+
       def test_following
         mock = lambda do |uri, _config|
           @mock_oauth_responses[uri.to_s]

twttr.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name        = 'twttr'
-  s.version     = '0.0.6'
+  s.version     = '0.0.7'
   s.summary     = 'Twitter API v2 Interface'
   s.description = 'Modular Twitter API interface, initially targeting Twitter API v2'
   s.authors     = ['Roberto Decurnex']