twitter 6.2.0 → 8.0.0.rc.1

data/lib/twitter/rest/request.rb

@@ -1,18 +1,19 @@
-require 'addressable/uri'
-require 'http'
-require 'http/form_data'
-require 'json'
-require 'openssl'
-require 'twitter/error'
-require 'twitter/headers'
-require 'twitter/rate_limit'
-require 'twitter/utils'
+require "addressable/uri"
+require "http"
+require "http/form_data"
+require "json"
+require "openssl"
+require "twitter/error"
+require "twitter/headers"
+require "twitter/rate_limit"
+require "twitter/utils"
+require "twitter/rest/form_encoder"
 
 module Twitter
   module REST
-    class Request
+    class Request # rubocop:disable Metrics/ClassLength
       include Twitter::Utils
-      BASE_URL = 'https://api.twitter.com'.freeze
+      BASE_URL = "https://api.twitter.com".freeze
       attr_accessor :client, :headers, :options, :path, :rate_limit,
                     :request_method, :uri
       alias verb request_method
@@ -22,63 +23,85 @@ module Twitter
       # @param path [String]
       # @param options [Hash]
       # @return [Twitter::REST::Request]
-      def initialize(client, request_method, path, options = {})
+      def initialize(client, request_method, path, options = {}, params = nil)
         @client = client
-        @uri = Addressable::URI.parse(path.start_with?('http') ? path : BASE_URL + path)
-        set_multipart_options!(request_method, options)
+        @uri = Addressable::URI.parse(path.start_with?("http") ? path : BASE_URL + path)
+        multipart_options = params || options
+        set_multipart_options!(request_method, multipart_options)
         @path = uri.path
         @options = options
+        @options_key = {get: :params, json_post: :json, json_put: :json, delete: :params}[request_method] || :form
+        @params = params
       end
 
       # @return [Array, Hash]
       def perform
-        options_key = @request_method == :get ? :params : :form
-        response = http_client.headers(@headers).public_send(@request_method, @uri.to_s, options_key => @options)
-        response_body = response.body.empty? ? '' : symbolize_keys!(response.parse)
+        response = http_client.headers(@headers).public_send(@request_method, @uri.to_s, request_options)
+        response_body = response.body.empty? ? "" : symbolize_keys!(response.parse)
         response_headers = response.headers
         fail_or_return_response_body(response.code, response_body, response_headers)
       end
 
     private
 
+      def request_options
+        options = if @options_key == :form
+                    {form: HTTP::FormData.create(@options, encoder: Twitter::REST::FormEncoder.method(:encode))}
+                  else
+                    {@options_key => @options}
+                  end
+
+        if @params
+          if options[:params]
+            options[:params].merge(@params)
+          else
+            options[:params] = @params
+          end
+        end
+        options
+      end
+
       def merge_multipart_file!(options)
         key = options.delete(:key)
         file = options.delete(:file)
 
         options[key] = if file.is_a?(StringIO)
-                         HTTP::FormData::File.new(file, mime_type: 'video/mp4')
+                         HTTP::FormData::File.new(file, content_type: "video/mp4")
                        else
-                         HTTP::FormData::File.new(file, filename: File.basename(file), mime_type: mime_type(File.basename(file)))
+                         HTTP::FormData::File.new(file, filename: File.basename(file), content_type: content_type(File.basename(file)))
                        end
       end
 
       def set_multipart_options!(request_method, options)
-        if request_method == :multipart_post
-          merge_multipart_file!(options)
+        if %i[multipart_post json_post].include?(request_method)
+          merge_multipart_file!(options) if request_method == :multipart_post
+          options = {}
           @request_method = :post
-          @headers = Twitter::Headers.new(@client, @request_method, @uri).request_headers
+        elsif request_method == :json_put
+          @request_method = :put
         else
           @request_method = request_method
-          @headers = Twitter::Headers.new(@client, @request_method, @uri, options).request_headers
         end
+        @headers = Twitter::Headers.new(@client, @request_method, @uri, options).request_headers
       end
 
-      def mime_type(basename)
+      def content_type(basename)
         case basename
         when /\.gif$/i
-          'image/gif'
+          "image/gif"
         when /\.jpe?g/i
-          'image/jpeg'
+          "image/jpeg"
         when /\.png$/i
-          'image/png'
+          "image/png"
         else
-          'application/octet-stream'
+          "application/octet-stream"
         end
       end
 
       def fail_or_return_response_body(code, body, headers)
         error = error(code, body, headers)
         raise(error) if error
+
         @rate_limit = Twitter::RateLimit.new(headers)
         body
       end
@@ -89,6 +112,8 @@ module Twitter
           forbidden_error(body, headers)
         elsif !klass.nil?
           klass.from_response(body, headers)
+        elsif body.is_a?(Hash) && (err = body.dig(:processing_info, :error))
+          Twitter::Error::MediaError.from_processing_response(err, headers)
         end
       end
 
@@ -103,11 +128,12 @@ module Twitter
       end
 
       def symbolize_keys!(object)
-        if object.is_a?(Array)
+        case object
+        when Array
           object.each_with_index do |val, index|
             object[index] = symbolize_keys!(val)
           end
-        elsif object.is_a?(Hash)
+        when Hash
           object.dup.each_key do |key|
             object[key.to_sym] = symbolize_keys!(object.delete(key))
           end
@@ -115,10 +141,17 @@ module Twitter
         object
       end
 
+      # Returns boolean indicating if all the keys required by HTTP::Client are present in Twitter::Client#timeouts
+      #
+      # @return [Boolean]
+      def timeout_keys_defined
+        (%i[write connect read] - (@client.timeouts&.keys || [])).empty?
+      end
+
       # @return [HTTP::Client, HTTP]
       def http_client
         client = @client.proxy ? HTTP.via(*proxy) : HTTP
-        client = client.timeout(:per_operation, connect: @client.timeouts[:connect], read: @client.timeouts[:read], write: @client.timeouts[:write]) if @client.timeouts
+        client = client.timeout(connect: @client.timeouts[:connect], read: @client.timeouts[:read], write: @client.timeouts[:write]) if timeout_keys_defined
         client
       end
 

data/lib/twitter/rest/saved_searches.rb

@@ -1,7 +1,7 @@
-require 'twitter/arguments'
-require 'twitter/rest/utils'
-require 'twitter/saved_search'
-require 'twitter/utils'
+require "twitter/arguments"
+require "twitter/rest/utils"
+require "twitter/saved_search"
+require "twitter/utils"
 
 module Twitter
   module REST
@@ -32,7 +32,7 @@ module Twitter
       def saved_searches(*args)
         arguments = Twitter::Arguments.new(args)
         if arguments.empty?
-          perform_get_with_objects('/1.1/saved_searches/list.json', arguments.options, Twitter::SavedSearch)
+          perform_get_with_objects("/1.1/saved_searches/list.json", arguments.options, Twitter::SavedSearch)
         else
           pmap(arguments) do |id|
             saved_search(id, arguments.options)
@@ -63,7 +63,7 @@ module Twitter
       # @param query [String] The query of the search the user would like to save.
       # @param options [Hash] A customizable set of options.
       def create_saved_search(query, options = {})
-        perform_post_with_object('/1.1/saved_searches/create.json', options.merge(query: query), Twitter::SavedSearch)
+        perform_post_with_object("/1.1/saved_searches/create.json", options.merge(query: query), Twitter::SavedSearch)
       end
 
       # Destroys saved searches for the authenticated user

data/lib/twitter/rest/search.rb

@@ -1,5 +1,5 @@
-require 'twitter/rest/request'
-require 'twitter/search_results'
+require "twitter/rest/request"
+require "twitter/search_results"
 
 module Twitter
   module REST
@@ -14,7 +14,7 @@ module Twitter
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-      # @param q [String] A search term.
+      # @param query [String] A search term.
       # @param options [Hash] A customizable set of options.
       # @option options [String] :geocode Returns tweets by users located within a given radius of the given latitude/longitude. The location is preferentially taking from the Geotagging API, but will fall back to their Twitter profile. The parameter value is specified by "latitude,longitude,radius", where radius units must be specified as either "mi" (miles) or "km" (kilometers). Note that you cannot use the near operator via the API to geocode arbitrary locations; however you can use this geocode parameter to search near geocodes directly.
       # @option options [String] :lang Restricts tweets to the given language, given by an ISO 639-1 code.
@@ -25,11 +25,12 @@ module Twitter
       # @option options [Integer] :since_id Returns results with an ID greater than (that is, more recent than) the specified ID. There are limits to the number of Tweets which can be accessed through the API. If the limit of Tweets has occured since the since_id, the since_id will be forced to the oldest ID available.
       # @option options [Integer] :max_id Returns results with an ID less than (that is, older than) or equal to the specified ID.
       # @option options [Boolean] :include_entities The entities node will be disincluded when set to false.
+      # @option options [String] :tweet_mode The entities node will truncate or not tweet text. Options are "compat" and "extended". The current default is "compat" (truncate).
       # @return [Twitter::SearchResults] Return tweets that match a specified query with search metadata
-      def search(q, options = {})
+      def search(query, options = {})
         options = options.dup
         options[:count] ||= MAX_TWEETS_PER_REQUEST
-        request = Twitter::REST::Request.new(self, :get, '/1.1/search/tweets.json', options.merge(q: q))
+        request = Twitter::REST::Request.new(self, :get, "/1.1/search/tweets.json", options.merge(q: query))
         Twitter::SearchResults.new(request)
       end
     end

data/lib/twitter/rest/spam_reporting.rb

@@ -1,5 +1,5 @@
-require 'twitter/rest/utils'
-require 'twitter/user'
+require "twitter/rest/utils"
+require "twitter/user"
 
 module Twitter
   module REST
@@ -19,7 +19,7 @@ module Twitter
       #   @param users [Enumerable<Integer, String, Twitter::User>] A collection of Twitter user IDs, screen names, or objects.
       #   @param options [Hash] A customizable set of options.
       def report_spam(*args)
-        parallel_users_from_response(:post, '/1.1/users/report_spam.json', args)
+        parallel_users_from_response(:post, "/1.1/users/report_spam.json", args)
       end
     end
   end

data/lib/twitter/rest/suggested_users.rb

@@ -1,7 +1,7 @@
-require 'twitter/arguments'
-require 'twitter/rest/utils'
-require 'twitter/suggestion'
-require 'twitter/user'
+require "twitter/arguments"
+require "twitter/rest/utils"
+require "twitter/suggestion"
+require "twitter/user"
 
 module Twitter
   module REST
@@ -28,7 +28,7 @@ module Twitter
         if arguments.last
           perform_get_with_object("/1.1/users/suggestions/#{arguments.pop}.json", arguments.options, Twitter::Suggestion)
         else
-          perform_get_with_objects('/1.1/users/suggestions.json', arguments.options, Twitter::Suggestion)
+          perform_get_with_objects("/1.1/users/suggestions.json", arguments.options, Twitter::Suggestion)
         end
       end
 

data/lib/twitter/rest/timelines.rb

@@ -1,6 +1,6 @@
-require 'twitter/rest/utils'
-require 'twitter/tweet'
-require 'twitter/user'
+require "twitter/rest/utils"
+require "twitter/tweet"
+require "twitter/user"
 
 module Twitter
   module REST
@@ -23,7 +23,7 @@ module Twitter
       # @option options [Integer] :count Specifies the number of records to retrieve. Must be less than or equal to 200.
       # @option options [Boolean, String, Integer] :trim_user Each tweet returned in a timeline will include a user object with only the author's numerical ID when set to true, 't' or 1.
       def mentions_timeline(options = {})
-        perform_get_with_objects('/1.1/statuses/mentions_timeline.json', options, Twitter::Tweet)
+        perform_get_with_objects("/1.1/statuses/mentions_timeline.json", options, Twitter::Tweet)
       end
       alias mentions mentions_timeline
 
@@ -46,7 +46,7 @@ module Twitter
       #   @option options [Boolean, String, Integer] :contributor_details Specifies that the contributors element should be enhanced to include the screen_name of the contributor.
       #   @option options [Boolean, String, Integer] :include_rts Specifies that the timeline should include native retweets in addition to regular tweets. Note: If you're using the trim_user parameter in conjunction with include_rts, the retweets will no longer contain a full user object.
       def user_timeline(*args)
-        objects_from_response_with_user(Twitter::Tweet, :get, '/1.1/statuses/user_timeline.json', args)
+        objects_from_response_with_user(Twitter::Tweet, :get, "/1.1/statuses/user_timeline.json", args)
       end
 
       # Returns the 20 most recent retweets posted by the specified user
@@ -110,7 +110,7 @@ module Twitter
       # @option options [Boolean, String, Integer] :include_rts Specifies that the timeline should include native retweets in addition to regular tweets. Note: If you're using the trim_user parameter in conjunction with include_rts, the retweets will no longer contain a full user object.
       # @option options [Boolean, String, Integer] :contributor_details Specifies that the contributors element should be enhanced to include the screen_name of the contributor.
       def home_timeline(options = {})
-        perform_get_with_objects('/1.1/statuses/home_timeline.json', options, Twitter::Tweet)
+        perform_get_with_objects("/1.1/statuses/home_timeline.json", options, Twitter::Tweet)
       end
 
       # Returns the 20 most recent retweets posted by users the authenticating user follow.
@@ -148,7 +148,7 @@ module Twitter
       # @option options [Boolean, String, Integer] :trim_user Each tweet returned in a timeline will include a user object with only the author's numerical ID when set to true, 't' or 1.
       # @option options [Boolean, String, Integer] :include_user_entities The user entities node will be disincluded when set to false.
       def retweets_of_me(options = {})
-        perform_get_with_objects('/1.1/statuses/retweets_of_me.json', options, Twitter::Tweet)
+        perform_get_with_objects("/1.1/statuses/retweets_of_me.json", options, Twitter::Tweet)
       end
 
     private
@@ -188,6 +188,7 @@ module Twitter
       def collect_with_max_id(collection = [], max_id = nil, &block)
         tweets = yield(max_id)
         return collection if tweets.nil?
+
         collection += tweets
         tweets.empty? ? collection.flatten : collect_with_max_id(collection, tweets.last.id - 1, &block)
       end

data/lib/twitter/rest/trends.rb

@@ -1,7 +1,7 @@
-require 'twitter/place'
-require 'twitter/rest/request'
-require 'twitter/rest/utils'
-require 'twitter/trend_results'
+require "twitter/place"
+require "twitter/rest/request"
+require "twitter/rest/utils"
+require "twitter/trend_results"
 
 module Twitter
   module REST
@@ -21,7 +21,7 @@ module Twitter
       def trends(id = 1, options = {})
         options = options.dup
         options[:id] = id
-        response = perform_get('/1.1/trends/place.json', options).first
+        response = perform_get("/1.1/trends/place.json", options).first
         Twitter::TrendResults.new(response)
       end
       alias local_trends trends
@@ -36,7 +36,7 @@ module Twitter
       # @param options [Hash] A customizable set of options.
       # @return [Array<Twitter::Place>]
       def trends_available(options = {})
-        perform_get_with_objects('/1.1/trends/available.json', options, Twitter::Place)
+        perform_get_with_objects("/1.1/trends/available.json", options, Twitter::Place)
       end
       alias trend_locations trends_available
 
@@ -51,7 +51,7 @@ module Twitter
       # @option options [Float] :long If provided with a :lat option the available trend locations will be sorted by distance, nearest to furthest, to the co-ordinate pair. The valid ranges for longitude are -180.0 to +180.0 (East is positive) inclusive.
       # @return [Array<Twitter::Place>]
       def trends_closest(options = {})
-        perform_get_with_objects('/1.1/trends/closest.json', options, Twitter::Place)
+        perform_get_with_objects("/1.1/trends/closest.json", options, Twitter::Place)
       end
     end
   end

data/lib/twitter/rest/tweets.rb

@@ -1,14 +1,16 @@
-require 'twitter/arguments'
-require 'twitter/error'
-require 'twitter/oembed'
-require 'twitter/rest/request'
-require 'twitter/rest/utils'
-require 'twitter/tweet'
-require 'twitter/utils'
+require "twitter/arguments"
+require "twitter/error"
+require "twitter/oembed"
+require "twitter/rest/request"
+require "twitter/rest/upload_utils"
+require "twitter/rest/utils"
+require "twitter/tweet"
+require "twitter/utils"
 
 module Twitter
   module REST
     module Tweets
+      include Twitter::REST::UploadUtils
       include Twitter::REST::Utils
       include Twitter::Utils
       MAX_TWEETS_PER_REQUEST = 100
@@ -77,7 +79,7 @@ module Twitter
       def statuses(*args)
         arguments = Twitter::Arguments.new(args)
         flat_pmap(arguments.each_slice(MAX_TWEETS_PER_REQUEST)) do |tweets|
-          perform_post_with_objects('/1.1/statuses/lookup.json', arguments.options.merge(id: tweets.collect { |u| extract_id(u) }.join(',')), Twitter::Tweet)
+          perform_post_with_objects("/1.1/statuses/lookup.json", arguments.options.merge(id: tweets.collect { |u| extract_id(u) }.join(",")), Twitter::Tweet)
         end
       end
 
@@ -152,7 +154,7 @@ module Twitter
         hash = options.dup
         hash[:in_reply_to_status_id] = hash.delete(:in_reply_to_status).id unless hash[:in_reply_to_status].nil?
         hash[:place_id] = hash.delete(:place).woeid unless hash[:place].nil?
-        perform_post_with_object('/1.1/statuses/update.json', hash.merge(status: status), Twitter::Tweet)
+        perform_post_with_object("/1.1/statuses/update.json", hash.merge(status: status), Twitter::Tweet)
       end
 
       # Retweets the specified Tweets as the authenticating user
@@ -171,11 +173,9 @@ module Twitter
       def retweet(*args)
         arguments = Twitter::Arguments.new(args)
         pmap(arguments) do |tweet|
-          begin
-            post_retweet(extract_id(tweet), arguments.options)
-          rescue Twitter::Error::AlreadyRetweeted, Twitter::Error::NotFound
-            next
-          end
+          post_retweet(extract_id(tweet), arguments.options)
+        rescue Twitter::Error::AlreadyRetweeted, Twitter::Error::NotFound
+          next
         end.compact
       end
 
@@ -226,7 +226,7 @@ module Twitter
         media_ids = pmap(array_wrap(media)) do |medium|
           upload(medium)[:media_id]
         end
-        update!(status, options.merge(media_ids: media_ids.join(',')))
+        update!(status, options.merge(media_ids: media_ids.join(",")))
       end
 
       # Returns oEmbed for a Tweet
@@ -250,7 +250,7 @@ module Twitter
       def oembed(tweet, options = {})
         options = options.dup
         options[:id] = extract_id(tweet)
-        perform_get_with_object('/1.1/statuses/oembed.json', options, Twitter::OEmbed)
+        perform_get_with_object("/1.1/statuses/oembed.json", options, Twitter::OEmbed)
       end
 
       # Returns oEmbeds for Tweets
@@ -294,7 +294,7 @@ module Twitter
       def retweeters_ids(*args)
         arguments = Twitter::Arguments.new(args)
         arguments.options[:id] ||= extract_id(arguments.first)
-        perform_get_with_cursor('/1.1/statuses/retweeters/ids.json', arguments.options, :ids)
+        perform_get_with_cursor("/1.1/statuses/retweeters/ids.json", arguments.options, :ids)
       end
 
       # Untweets a retweeted status as the authenticating user
@@ -313,47 +313,14 @@ module Twitter
       def unretweet(*args)
         arguments = Twitter::Arguments.new(args)
         pmap(arguments) do |tweet|
-          begin
-            post_unretweet(extract_id(tweet), arguments.options)
-          rescue Twitter::Error::NotFound
-            next
-          end
+          post_unretweet(extract_id(tweet), arguments.options)
+        rescue Twitter::Error::NotFound
+          next
         end.compact
       end
 
     private
 
-      # Uploads images and videos. Videos require multiple requests and uploads in chunks of 5 Megabytes.
-      # The only supported video format is mp4.
-      #
-      # @see https://dev.twitter.com/rest/public/uploading-media
-      def upload(media) # rubocop:disable MethodLength, AbcSize
-        if File.basename(media) !~ /\.mp4$/
-          Twitter::REST::Request.new(self, :multipart_post, 'https://upload.twitter.com/1.1/media/upload.json', key: :media, file: media).perform
-        else
-          init = Twitter::REST::Request.new(self, :post, 'https://upload.twitter.com/1.1/media/upload.json',
-                                            command: 'INIT',
-                                            media_type: 'video/mp4',
-                                            total_bytes: media.size).perform
-
-          until media.eof?
-            chunk = media.read(5_000_000)
-            seg ||= -1
-            Twitter::REST::Request.new(self, :multipart_post, 'https://upload.twitter.com/1.1/media/upload.json',
-                                       command: 'APPEND',
-                                       media_id: init[:media_id],
-                                       segment_index: seg += 1,
-                                       key: :media,
-                                       file: StringIO.new(chunk)).perform
-          end
-
-          media.close
-
-          Twitter::REST::Request.new(self, :post, 'https://upload.twitter.com/1.1/media/upload.json',
-                                     command: 'FINALIZE', media_id: init[:media_id]).perform
-        end
-      end
-
       def array_wrap(object)
         if object.respond_to?(:to_ary)
           object.to_ary || [object]

data/lib/twitter/rest/undocumented.rb

@@ -1,8 +1,8 @@
-require 'twitter/arguments'
-require 'twitter/cursor'
-require 'twitter/rest/utils'
-require 'twitter/tweet'
-require 'twitter/user'
+require "twitter/arguments"
+require "twitter/cursor"
+require "twitter/rest/utils"
+require "twitter/tweet"
+require "twitter/user"
 
 module Twitter
   module REST
@@ -24,7 +24,7 @@ module Twitter
       #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, URI, or object.
       #   @param options [Hash] A customizable set of options.
       def following_followers_of(*args)
-        cursor_from_response_with_user(:users, Twitter::User, '/users/following_followers_of.json', args)
+        cursor_from_response_with_user(:users, Twitter::User, "/users/following_followers_of.json", args)
       end
 
       # Returns Tweets count for a URI
@@ -36,7 +36,7 @@ module Twitter
       # @param url [String, URI] A URL.
       # @param options [Hash] A customizable set of options.
       def tweet_count(url, options = {})
-        HTTP.get('https://cdn.api.twitter.com/1/urls/count.json', params: options.merge(url: url.to_s)).parse['count']
+        HTTP.get("https://cdn.api.twitter.com/1/urls/count.json", params: options.merge(url: url.to_s)).parse["count"]
       end
     end
   end

data/lib/twitter/rest/upload_utils.rb

@@ -0,0 +1,68 @@
+require "twitter/rest/request"
+
+module Twitter
+  module REST
+    module UploadUtils
+    private
+
+      # Uploads images and videos. Videos require multiple requests and uploads in chunks of 5 Megabytes.
+      # The only supported video format is mp4.
+      #
+      # @see https://developer.twitter.com/en/docs/media/upload-media/uploading-media/media-best-practices
+      def upload(media, media_category_prefix: "tweet")
+        return chunk_upload(media, "video/mp4", "#{media_category_prefix}_video") if File.extname(media) == ".mp4"
+        return chunk_upload(media, "image/gif", "#{media_category_prefix}_gif") if File.extname(media) == ".gif" && File.size(media) > 5_000_000
+
+        Twitter::REST::Request.new(self, :multipart_post, "https://upload.twitter.com/1.1/media/upload.json", key: :media, file: media).perform
+      end
+
+      # @raise [Twitter::Error::TimeoutError] Error raised when the upload is longer than the value specified in Twitter::Client#timeouts[:upload].
+      # @raise [Twitter::Error::MediaError] Error raised when Twitter return an error about a media which is not mapped by the gem.
+      # @raise [Twitter::Error::MediaInternalError] Error raised when Twitter returns an InternalError error.
+      # @raise [Twitter::Error::InvalidMedia] Error raised when Twitter returns an InvalidMedia error.
+      # @raise [Twitter::Error::UnsupportedMedia] Error raised when Twitter returns an UnsupportedMedia error.
+      # @see https://developer.twitter.com/en/docs/media/upload-media/uploading-media/chunked-media-upload
+      def chunk_upload(media, media_type, media_category)
+        Timeout.timeout(timeouts&.fetch(:upload, nil), Twitter::Error::TimeoutError) do
+          init = Twitter::REST::Request.new(self, :post, "https://upload.twitter.com/1.1/media/upload.json",
+                                            command: "INIT",
+                                            media_type: media_type,
+                                            media_category: media_category,
+                                            total_bytes: media.size).perform
+          append_media(media, init[:media_id])
+          media.close
+          finalize_media(init[:media_id])
+        end
+      end
+
+      # @see https://developer.twitter.com/en/docs/media/upload-media/api-reference/post-media-upload-append
+      def append_media(media, media_id)
+        until media.eof?
+          chunk = media.read(5_000_000)
+          seg ||= -1
+          Twitter::REST::Request.new(self, :multipart_post, "https://upload.twitter.com/1.1/media/upload.json",
+                                     command: "APPEND",
+                                     media_id: media_id,
+                                     segment_index: seg += 1,
+                                     key: :media,
+                                     file: StringIO.new(chunk)).perform
+        end
+      end
+
+      # @see https://developer.twitter.com/en/docs/media/upload-media/api-reference/post-media-upload-finalize
+      # @see https://developer.twitter.com/en/docs/media/upload-media/api-reference/get-media-upload-status
+      def finalize_media(media_id)
+        response = Twitter::REST::Request.new(self, :post, "https://upload.twitter.com/1.1/media/upload.json",
+                                              command: "FINALIZE", media_id: media_id).perform
+        loop do
+          return response if !response[:processing_info] || %w[failed succeeded].include?(response[:processing_info][:state])
+
+          sleep(response[:processing_info][:check_after_secs])
+          response = Twitter::REST::Request.new(self, :get, "https://upload.twitter.com/1.1/media/upload.json",
+                                                command: "STATUS", media_id: media_id).perform
+        end
+        response
+      end
+    end
+  end
+end