twttr 0.0.3 → 0.0.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2fe60301d1d17eb4a2904de32bbd649364bb864e13cbe9c56c5151d987c34ec4
-  data.tar.gz: c7c28b855390fe720ce157d49e8d6f7525ae14ad797bc1a1fbdda77ed4efabfb
+  metadata.gz: ce5304b9106f2f665c6787d7e3ee22f83076712f8ee96b33f6b7615a85759dae
+  data.tar.gz: bf914ca056645501d2f012900f76286cb9f0a18baa347618d3ef297f04c2c01e
 SHA512:
-  metadata.gz: aa537df933312dea3e75e86dcf6828b7d8ca2cc81138ec46f7b3e867b81dcaa01c542c601306f26f8c8d68590762071bb80d04dd88ef155c5df0798abf568e3d
-  data.tar.gz: fe96a4b38af080331a25a6be5a31d9e5cfc98d0b95b54faabfd1b45dce89bdb1e16e37635eace45bb7a8ef9c63983f295024ebe1fd82c4e7ad15a14c9b823795
+  metadata.gz: 54d2b7ed3ab4bebd4a82fa58965456eee9c5c8896ca8ef29054578f81ce6500dc1906fa8361c85c1300fdf6e2e6631d95f175f17f2ebee60dd5eaab2ac1fba18
+  data.tar.gz: 948a69e7cab9210b857526594131641565e44beeb50932a8967fef0a3c6ca794714ee9dd1f527f4ab277ea6caf3b27a539de817db17fc28fbc3487d45126193a

data/lib/twttr/client/endpoint/v2/users/follows.rb

@@ -8,18 +8,53 @@ module Twttr
           # Twitter API V2 User Follow related endpoints
           # https://developer.twitter.com/en/docs/twitter-api/users/follows/api-reference
           module Follows
+            FOLLOWERS_PATH = "#{Users::USER_PATH}/followers"
             FOLLOWING_PATH = "#{Users::USER_PATH}/following"
 
+            # 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 user_id [String] The user ID whose followers you would like to retrieve.
+            # @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(user_id, max_results: nil, pagination_token: nil, &block) # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
+              response = get(FOLLOWERS_PATH, params: { user_id: user_id },
+                                             query_params: {
+                                               'user.fields': config.user_fields,
+                                               max_results: max_results,
+                                               pagination_token: pagination_token
+                                             }.compact)
+
+              return [] if response['meta']['result_count'].zero?
+
+              users = response['data'].map { |v| Model::User.new(v, self) }
+
+              pagination_token = response['meta']['pagination_token']
+
+              yield users, pagination_token if block_given?
+
+              return users if pagination_token.nil?
+
+              users + followers(user_id, pagination_token: pagination_token, &block)
+            end
+
             # GET /2/users/:id/following
             # https://developer.twitter.com/en/docs/twitter-api/users/follows/api-reference/get-users-id-following
             #
+            # Returns paginated list of users followed by user_id.
+            #
             # @param user_id [String] The user ID whose following you would like to retrieve.
             # @param max_results [Integer] Max number of results per peage.
             # @param pagination_token [String] Initial page pagination token.
             # @yield [Array<Twttr::Model::User>] Users followed by page.
+            # @yield [String,NilClass] Pagination token.
             # @return [Array<Twttr::Model::User>] Users followed.
-            # @return [String,NilClass] Pagination token.
-            def following(user_id, max_results: nil, pagination_token: nil, &block) # rubocop:disable Metrics/MethodLength
+            def following(user_id, max_results: nil, pagination_token: nil, &block) # rubocop:disable Metrics/MethodLength, Metrics/AbcSize
               response = get(FOLLOWING_PATH, params: { user_id: user_id },
                                              query_params: {
                                                'user.fields': config.user_fields,
@@ -27,17 +62,17 @@ module Twttr
                                                pagination_token: pagination_token
                                              }.compact)
 
-              return [], nil if response['meta']['result_count'].zero?
+              return [] if response['meta']['result_count'].zero?
 
               users = response['data'].map { |v| Model::User.new(v, self) }
 
               pagination_token = response['meta']['pagination_token']
 
-              return users, pagination_token unless block_given?
+              yield users, pagination_token if block_given?
 
-              yield users, pagination_token
+              return users if pagination_token.nil?
 
-              following(user_id, pagination_token, &block) unless pagination_token.nil?
+              users + following(user_id, pagination_token: pagination_token, &block)
             end
           end
         end

data/lib/twttr/client/endpoint/v2/users.rb

@@ -9,31 +9,84 @@ module Twttr
         module Users
           ME_PATH = "#{V2::V2_PATH}/users/me"
           USERS_PATH = "#{V2::V2_PATH}/users"
+          USERS_BY_PATH = "#{V2::V2_PATH}/users/by"
           USER_BY_USERNAME_PATH = "#{V2::V2_PATH}/users/by/username/%<username>s"
           USER_PATH = "#{V2::V2_PATH}/users/%<user_id>s"
 
+          # GET /2/users/:id/following
+          # https://developer.twitter.com/en/docs/twitter-api/users/follows/api-reference/get-users-id-following
+          #
+          # Returns paginated list of users followed by user_id.
+          #
+          # @param user_id [String] The user ID whose following you would like to retrieve.
+          # @param max_results [Integer] Max number of results per peage.
+          # @param pagination_token [String] Initial page pagination token.
+          # @yield [Array<Twttr::Model::User>] Users followed by page.
+          # @yield [String,NilClass] Pagination token.
+          # @return [Array<Twttr::Model::User>] Users followed.
+
+          # GET /2/users/me
+          # https://developer.twitter.com/en/docs/twitter-api/users/lookup/api-reference/get-users-me
+          #
+          # Returns current authenticated user
+          #
+          # @return [Twttr::Model::User] Current user.
           def me
             response = get(ME_PATH, query_params: { 'user.fields': config.user_fields })
             Model::User.new(response['data'], self)
           end
 
+          # GET /2/users/:id
+          # https://developer.twitter.com/en/docs/twitter-api/users/lookup/api-reference/get-users-id
+          #
+          # Returns target user by id
+          #
+          # @param user_id [String] Traget user id.
+          # @return [Twttr::Model::User] Target user.
           def user(user_id)
             response = get(USER_PATH, params: { user_id: user_id },
                                       query_params: { 'user.fields': config.user_fields })
             Model::User.new(response['data'], self)
           end
 
+          # GET /2/users/by/username/:username
+          # https://developer.twitter.com/en/docs/twitter-api/users/lookup/api-reference/get-users-by-username-username
+          #
+          # Returns target user by username
+          #
+          # @param username [String] Traget username.
+          # @return [Twttr::Model::User] Target user.
           def user_by_username(username)
             response = get(USER_BY_USERNAME_PATH, params: { username: username },
                                                   query_params: { 'user.fields': config.user_fields })
             Model::User.new(response['data'], self)
           end
 
+          # GET /2/users
+          # https://developer.twitter.com/en/docs/twitter-api/users/lookup/api-reference/get-users
+          #
+          # Returns target users by id
+          #
+          # @param user_ids [Array<String>] Traget user ids.
+          # @return [Array<Twttr::Model::User>] Target users.
           def users(user_ids)
             response = get(USERS_PATH,
                            query_params: { ids: user_ids.join(','), 'user.fields': config.user_fields })
             response['data'].map { |v| Model::User.new(v, self) }
           end
+
+          # GET /2/users/by
+          # https://developer.twitter.com/en/docs/twitter-api/users/lookup/api-reference/get-users-by
+          #
+          # Returns target users by username
+          #
+          # @param usernames [Array<String>] Traget usernames.
+          # @return [Array<Twttr::Model::User>] Target users.
+          def users_by(usernames)
+            response = get(USERS_BY_PATH,
+                           query_params: { usernames: usernames.join(','), 'user.fields': config.user_fields })
+            response['data'].map { |v| Model::User.new(v, self) }
+          end
         end
       end
     end

data/lib/twttr/model/user.rb

@@ -15,6 +15,18 @@ module Twttr
         @client = client
       end
 
+      # Forwards to Follows#following setting user_id to current user's id.
+      #
+      # GET /2/users/:id/following
+      # https://developer.twitter.com/en/docs/twitter-api/users/follows/api-reference/get-users-id-following
+      #
+      # Returns paginated list of users followed by 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>] Users followed by page.
+      # @yield [String,NilClass] Pagination token.
+      # @return [Array<Twttr::Model::User>] Users followed.
       def following(max_results: nil, pagination_token: nil, &block)
         client.following(id, max_results: max_results, pagination_token: pagination_token, &block)
       end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: twttr
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.6
 platform: ruby
 authors:
 - Roberto Decurnex
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-01-08 00:00:00.000000000 Z
+date: 2022-07-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: oauth