twttr 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 0e5bcf2caf8b35685648f7ea2f2e3ded03f29a2d645c3fefd0dd201c40a29063
+  data.tar.gz: e4abe1c561235477fa18e53a99712f6c81dff499a084597f05c076a7db47bdc1
+SHA512:
+  metadata.gz: ba330361302ab0f8cb28ab17235baae529674fd02b766a6e55c5e48b10fd960d682b4efcb05d594216cf40288606fb87f77b50fbe8f2ef66cfde75d2a075165a
+  data.tar.gz: '04890ed05e20b2e710d3a3f7697b21823542da9e8e88e35e9361a73251d89b1a18a12a0dddd3dbf031cf390a3d344894b775cb80daf1b37978993c8e2d3ad6f5'

data/lib/twttr/client/config.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Twttr
+  class Client
+    # Client Configuration
+    class Config
+      attr_accessor :consumer_key, :consumer_secret, :access_token, :access_token_secret
+      attr_reader :user_fields
+
+      def user_fields=(fields)
+        @user_fields = fields.join(',')
+      end
+    end
+  end
+end

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

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Twttr
+  class Client
+    module Endpoint
+      module V2
+        module Users
+          # Twitter API V2 User Follow related endpoints
+          # https://developer.twitter.com/en/docs/twitter-api/users/follows/api-reference
+          module Follows
+            FOLLOWING_PATH = "#{Users::USER_PATH}/following"
+
+            # GET /2/users/:id/following
+            # https://developer.twitter.com/en/docs/twitter-api/users/follows/api-reference/get-users-id-following
+            #
+            # @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.
+            # @return [Array<Twttr::Model::User>] Users followed.
+            # @return [String,NilClass] Pagination token.
+            def following(user_id, max_results: nil, pagination_token: nil) # rubocop:disable Metrics/MethodLength
+              loop do
+                response = get(FOLLOWING_PATH, params: { user_id: user_id },
+                                               query_params: {
+                                                 'user.fields': config.user_fields,
+                                                 max_results: max_results,
+                                                 pagination_token: pagination_token
+                                               }.compact)
+
+                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
+
+                break if pagination_token.nil?
+              end
+            end
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module Twttr
+  class Client
+    module Endpoint
+      module V2
+        #  Twitter API V2 Users related endpoints
+        #  https://developer.twitter.com/en/docs/twitter-api/users/lookup/api-reference
+        module Users
+          ME_PATH = "#{V2::V2_PATH}/users/me"
+          USERS_PATH = "#{V2::V2_PATH}/users"
+          USER_BY_USERNAME_PATH = "#{V2::V2_PATH}/users/by/username/%<username>s"
+          USER_PATH = "#{V2::V2_PATH}/users/%<user_id>s"
+
+          def me
+            response = get(ME_PATH, query_params: { 'user.fields': config.user_fields })
+            Model::User.new(response['data'], self)
+          end
+
+          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
+
+          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
+
+          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
+        end
+      end
+    end
+  end
+end
+
+require_relative 'users/follows'

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

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Twttr
+  class Client
+    module Endpoint
+      module V2
+        V2_PATH = '/2'
+      end
+    end
+  end
+end
+
+require_relative 'v2/users'

data/lib/twttr/client/endpoint.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+require 'twttr/client/endpoint/v2'
+
+module Twttr
+  class Client
+    #  Namespace to keep endpoints organized by version and domain.
+    module Endpoint
+    end
+  end
+end

data/lib/twttr/client/error.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Twttr
+  class Client
+    #  Client rrrors namesace
+    module Error
+      #  HTTP related errors
+      class HTTPError < StandardError
+        def initialize(msg = 'HTTP Error')
+          super
+        end
+      end
+    end
+  end
+end

data/lib/twttr/client/oauth_request.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module Twttr
+  class Client
+    #  OAuth helper methods
+    class OAuthRequest
+      attr_reader :response
+
+      def initialize(uri, config)
+        @uri = uri
+        @config = config
+        @request = Net::HTTP::Get.new(uri)
+        @request['Authorization'] = authorization_header
+        @response = nil
+      end
+
+      def self.get(uri, config)
+        new(uri, config).perform
+      end
+
+      def perform
+        Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
+          # :nocov:
+          self.response = http.request request
+          # :nocov:
+        end
+
+        raise Error::HTTPError, response.message unless response.instance_of?(Net::HTTPOK)
+
+        response
+      end
+
+      private
+
+      attr_reader :config, :request, :uri
+      attr_writer :response
+
+      def oauth_params
+        @oauth_params ||= {
+          'oauth_consumer_key' => CGI.escape(config.consumer_key),
+          'oauth_nonce' => CGI.escape(SecureRandom.urlsafe_base64(32)),
+          'oauth_signature_method' => CGI.escape('HMAC-SHA1'),
+          'oauth_timestamp' => CGI.escape(Time.now.to_i.to_s),
+          'oauth_token' => CGI.escape(config.access_token),
+          'oauth_version' => CGI.escape('1.0')
+        }
+      end
+
+      def request_params
+        @request_params if defined?(@request_params)
+
+        query_params = {}
+        uri.query_params.each_pair do |key, value|
+          query_params[CGI.escape(key)] = CGI.escape(value)
+        end
+
+        @request_params = oauth_params.merge(query_params)
+      end
+
+      def authorization_header
+        oauth_params['oauth_signature'] = oauth_signature
+
+        serialized_params = oauth_params.keys.sort.map { |k| "#{k}=\"#{oauth_params[k]}\"" }.join(',')
+
+        "OAuth #{serialized_params}"
+      end
+
+      def oauth_signature
+        signature_params = request_params.keys.sort.map { |k| "#{k}=#{request_params[k]}" }.join('&')
+
+        base_string = "#{request.method}&#{CGI.escape(request.uri.to_s.sub(/\?.*$/,
+                                                                           ''))}&#{CGI.escape(signature_params)}"
+
+        auth_code(base_string)
+      end
+
+      def auth_code(base_string)
+        signin_key = "#{CGI.escape(config.consumer_secret)}&#{CGI.escape(config.access_token_secret)}"
+
+        CGI.escape(Base64.encode64(OpenSSL::HMAC.digest('sha1', signin_key, base_string).to_s).chomp)
+      end
+    end
+  end
+end

data/lib/twttr/client.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require 'forwardable'
+require 'json'
+require 'net/http'
+require 'oauth'
+require 'oauth/request_proxy/net_http'
+require 'ostruct'
+require 'securerandom'
+require 'uri/query_params'
+
+require 'twttr/client/config'
+require 'twttr/client/endpoint'
+require 'twttr/client/error'
+require 'twttr/client/oauth_request'
+
+require 'uri/generic'
+
+module Twttr
+  #  Twitter API Client
+  class Client
+    include Twttr::Client::Endpoint::V2::Users
+    include Twttr::Client::Endpoint::V2::Users::Follows
+
+    attr_reader :config
+
+    BASE_URL = 'https://api.twitter.com'
+
+    def initialize
+      @config = Config.new
+      yield config if block_given?
+    end
+
+    def get(path, params: {}, query_params: {})
+      uri = uri_for(path, params)
+      uri.query = URI.encode_www_form(query_params.compact) unless query_params.compact.empty?
+
+      response = OAuthRequest.get(uri, config)
+
+      JSON.parse(response.body)
+    end
+
+    private
+
+    def uri_for(path, params = {})
+      return URI.parse("#{BASE_URL}#{path}") if params.empty?
+
+      URI.parse("#{BASE_URL}#{path}" % params) # rubocop:disable Style/FormatString
+    end
+  end
+end

data/lib/twttr/model/user.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Twttr
+  module Model
+    # Twitter User representation
+    # https://developer.twitter.com/en/docs/twitter-api/data-dictionary/object-model/user
+    class User
+      extend Forwardable
+
+      def_delegators :@data, :created_at, :description, :entities, :id, :location, :name, :pinned_tweet_id,
+                     :profile_image_url, :protected, :public_metrics, :url, :username, :verified, :withheld
+
+      def initialize(data, client = nil)
+        @data = JSON.parse(data.to_json, object_class: OpenStruct)
+        @client = client
+      end
+
+      def following(pagination_token: nil, &block)
+        client.following(id, pagination_token: pagination_token, &block)
+      end
+
+      private
+
+      attr_reader :client
+    end
+  end
+end

data/lib/twttr/model.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require 'twttr/model/user'
+
+module Twttr
+  # Ruby representations of Twitter entities
+  module Model
+  end
+end

data/lib/twttr.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require 'twttr/client'
+require 'twttr/model'
+
+#  Library namespace
+module Twttr
+end

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification
+name: twttr
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Roberto Decurnex
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2021-12-29 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: oauth
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.8
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.5.8
+- !ruby/object:Gem::Dependency
+  name: uri-query_params
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.7.2
+description: Modular Twitter API interface, initially targeting Twitter API v2
+email: roberto@decurnex.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/twttr.rb
+- lib/twttr/client.rb
+- lib/twttr/client/config.rb
+- lib/twttr/client/endpoint.rb
+- lib/twttr/client/endpoint/v2.rb
+- lib/twttr/client/endpoint/v2/users.rb
+- lib/twttr/client/endpoint/v2/users/follows.rb
+- lib/twttr/client/error.rb
+- lib/twttr/client/oauth_request.rb
+- lib/twttr/model.rb
+- lib/twttr/model/user.rb
+homepage: https://rubygems.org/gems/twttr
+licenses:
+- MIT
+metadata:
+  rubygems_mfa_required: 'true'
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.7'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.2.33
+signing_key: 
+specification_version: 4
+summary: Twitter API v2 Interface
+test_files: []