twitter 5.14.0 → 5.15.0

data/lib/twitter/rest/help.rb

@@ -10,7 +10,7 @@ module Twitter
 
       # Returns the current configuration used by Twitter
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/help/configuration
+      # @see https://dev.twitter.com/rest/reference/get/help/configuration
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -21,7 +21,7 @@ module Twitter
 
       # Returns the list of languages supported by Twitter
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/help/languages
+      # @see https://dev.twitter.com/rest/reference/get/help/languages
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -32,7 +32,7 @@ module Twitter
 
       # Returns {https://twitter.com/privacy Twitter's Privacy Policy}
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/help/privacy
+      # @see https://dev.twitter.com/rest/reference/get/help/privacy
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -43,7 +43,7 @@ module Twitter
 
       # Returns {https://twitter.com/tos Twitter's Terms of Service}
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/help/tos
+      # @see https://dev.twitter.com/rest/reference/get/help/tos
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.

data/lib/twitter/rest/lists.rb

@@ -18,7 +18,7 @@ module Twitter
 
       # Returns all lists the authenticating or specified user subscribes to, including their own
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/lists/list
+      # @see https://dev.twitter.com/rest/reference/get/lists/list
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -37,7 +37,7 @@ module Twitter
 
       # Show tweet timeline for members of the specified list
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/lists/statuses
+      # @see https://dev.twitter.com/rest/reference/get/lists/statuses
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::NotFound] Error raised when supplied list is not found.
@@ -65,7 +65,7 @@ module Twitter
 
       # Removes the specified member from the list
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/lists/members/destroy
+      # @see https://dev.twitter.com/rest/reference/post/lists/members/destroy
       # @rate_limited No
       # @authentication Requires user context
       # @raise [Twitter::Error::NotFound] Error raised when supplied list is not found.
@@ -87,7 +87,7 @@ module Twitter
 
       # List the lists the specified user has been added to
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/lists/memberships
+      # @see https://dev.twitter.com/rest/reference/get/lists/memberships
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -107,7 +107,7 @@ module Twitter
 
       # Returns the subscribers of the specified list
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/lists/subscribers
+      # @see https://dev.twitter.com/rest/reference/get/lists/subscribers
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::NotFound] Error raised when supplied list is not found.
@@ -126,7 +126,7 @@ module Twitter
 
       # Make the authenticated user follow the specified list
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/lists/subscribers/create
+      # @see https://dev.twitter.com/rest/reference/post/lists/subscribers/create
       # @rate_limited No
       # @authentication Requires user context
       # @raise [Twitter::Error::NotFound] Error raised when supplied list is not found.
@@ -145,7 +145,7 @@ module Twitter
 
       # Check if a user is a subscriber of the specified list
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/lists/subscribers/show
+      # @see https://dev.twitter.com/rest/reference/get/lists/subscribers/show
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::NotFound] Error raised when supplied list is not found.
@@ -167,7 +167,7 @@ module Twitter
 
       # Unsubscribes the authenticated user form the specified list
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/lists/subscribers/destroy
+      # @see https://dev.twitter.com/rest/reference/post/lists/subscribers/destroy
       # @rate_limited No
       # @authentication Requires user context
       # @raise [Twitter::Error::NotFound] Error raised when supplied list is not found.
@@ -186,7 +186,7 @@ module Twitter
 
       # Adds specified members to a list
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/lists/members/create_all
+      # @see https://dev.twitter.com/rest/reference/post/lists/members/create_all
       # @note Lists are limited to having 5,000 members, and you are limited to adding up to 100 members to a list at a time with this method.
       # @rate_limited No
       # @authentication Requires user context
@@ -210,7 +210,7 @@ module Twitter
 
       # Check if a user is a member of the specified list
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/lists/members/show
+      # @see https://dev.twitter.com/rest/reference/get/lists/members/show
       # @authentication Requires user context
       # @rate_limited Yes
       # @raise [Twitter::Error::NotFound] Error raised when supplied list is not found.
@@ -231,7 +231,7 @@ module Twitter
 
       # Returns the members of the specified list
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/lists/members
+      # @see https://dev.twitter.com/rest/reference/get/lists/members
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::NotFound] Error raised when supplied list is not found.
@@ -250,7 +250,7 @@ module Twitter
 
       # Add a member to a list
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/lists/members/create
+      # @see https://dev.twitter.com/rest/reference/post/lists/members/create
       # @note Lists are limited to having 5,000 members.
       # @rate_limited No
       # @authentication Requires user context
@@ -273,7 +273,7 @@ module Twitter
 
       # Deletes the specified list
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/lists/destroy
+      # @see https://dev.twitter.com/rest/reference/post/lists/destroy
       # @note Must be owned by the authenticated user.
       # @rate_limited No
       # @authentication Requires user context
@@ -294,7 +294,7 @@ module Twitter
 
       # Updates the specified list
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/lists/update
+      # @see https://dev.twitter.com/rest/reference/post/lists/update
       # @rate_limited No
       # @authentication Requires user context
       # @raise [Twitter::Error::NotFound] Error raised when supplied list is not found.
@@ -317,7 +317,7 @@ module Twitter
 
       # Creates a new list for the authenticated user
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/lists/create
+      # @see https://dev.twitter.com/rest/reference/post/lists/create
       # @note Accounts are limited to 20 lists.
       # @rate_limited No
       # @authentication Requires user context
@@ -334,7 +334,7 @@ module Twitter
 
       # Show the specified list
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/lists/show
+      # @see https://dev.twitter.com/rest/reference/get/lists/show
       # @note Private lists will only be shown if the authenticated user owns the specified list.
       # @rate_limited Yes
       # @authentication Requires user context
@@ -354,7 +354,7 @@ module Twitter
 
       # List the lists the specified user follows
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/lists/subscriptions
+      # @see https://dev.twitter.com/rest/reference/get/lists/subscriptions
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -370,7 +370,7 @@ module Twitter
 
       # Removes specified members from the list
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/lists/members/destroy_all
+      # @see https://dev.twitter.com/rest/reference/post/lists/members/destroy_all
       # @rate_limited No
       # @authentication Requires user context
       # @raise [Twitter::Error::NotFound] Error raised when supplied list is not found.
@@ -392,7 +392,7 @@ module Twitter
 
       # Returns the lists owned by the specified Twitter user
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/lists/ownerships
+      # @see https://dev.twitter.com/rest/reference/get/lists/ownerships
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.

data/lib/twitter/rest/media.rb

@@ -7,7 +7,7 @@ module Twitter
     module Media
       # Uploads media to attach to a tweet
       #
-      # @see https://dev.twitter.com/docs/api/multiple-media-extended-entities
+      # @see https://dev.twitter.com/rest/public/uploading-media-multiple-photos
       # @rate_limited No
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.

data/lib/twitter/rest/oauth.rb

@@ -14,7 +14,7 @@ module Twitter
       # Only one bearer token may exist outstanding for an application, and repeated requests to this method
       # will yield the same already-existent token until it has been invalidated.
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/oauth2/token
+      # @see https://dev.twitter.com/rest/reference/post/oauth2/token
       # @rate_limited No
       # @authentication Required
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -32,7 +32,7 @@ module Twitter
 
       # Allows a registered application to revoke an issued OAuth 2 Bearer Token by presenting its client credentials.
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/oauth2/invalidate_token
+      # @see https://dev.twitter.com/rest/reference/post/oauth2/invalidate_token
       # @rate_limited No
       # @authentication Required
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -47,7 +47,7 @@ module Twitter
 
       # Allows a registered application to revoke an issued OAuth 2 Bearer Token by presenting its client credentials.
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/oauth2/invalidate_token
+      # @see https://dev.twitter.com/rest/reference/post/oauth2/invalidate_token
       # @rate_limited No
       # @authentication Required
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.

data/lib/twitter/rest/places_and_geo.rb

@@ -9,7 +9,7 @@ module Twitter
 
       # Returns all the information about a known place
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/geo/id/:place_id
+      # @see https://dev.twitter.com/rest/reference/get/geo/id/:place_id
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -22,7 +22,7 @@ module Twitter
 
       # Searches for up to 20 places that can be used as a place_id
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/geo/reverse_geocode
+      # @see https://dev.twitter.com/rest/reference/get/geo/reverse_geocode
       # @note This request is an informative call and will deliver generalized results about geography.
       # @rate_limited Yes
       # @authentication Requires user context
@@ -40,7 +40,7 @@ module Twitter
 
       # Search for places that can be attached to a {Twitter::REST::Tweets#update}
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/geo/search
+      # @see https://dev.twitter.com/rest/reference/get/geo/search
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -62,7 +62,7 @@ module Twitter
 
       # Locates places near the given coordinates which are similar in name
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/geo/similar_places
+      # @see https://dev.twitter.com/rest/reference/get/geo/similar_places
       # @note Conceptually, you would use this method to get a list of known places to choose from first. Then, if the desired place doesn't exist, make a request to {Twitter::REST::PlacesAndGeo#place} to create a new one. The token contained in the response is the token necessary to create a new place.
       # @rate_limited Yes
       # @authentication Requires user context

data/lib/twitter/rest/request/multipart_with_file.rb

@@ -5,9 +5,11 @@ module Twitter
     class Request
       class MultipartWithFile < Faraday::Middleware
         CONTENT_TYPE = 'Content-Type'
+        BMP_REGEX = /\.bmp/i
         GIF_REGEX = /\.gif$/i
         JPEG_REGEX = /\.jpe?g/i
         PNG_REGEX = /\.png$/i
+        WEBP_REGEX = /\.webp/i
 
         def call(request)
           request.body.each do |key, value|
@@ -21,12 +23,16 @@ module Twitter
 
         def mime_type(path)
           case path
+          when BMP_REGEX
+            'image/bmp'
           when GIF_REGEX
             'image/gif'
           when JPEG_REGEX
             'image/jpeg'
           when PNG_REGEX
             'image/png'
+          when WEBP_REGEX
+            'image/webp'
           else
             'application/octet-stream'
           end

data/lib/twitter/rest/saved_searches.rb

@@ -16,17 +16,17 @@ module Twitter
       # @overload saved_search(options = {})
       #   Returns the authenticated user's saved search queries
       #
-      #   @see https://dev.twitter.com/docs/api/1.1/get/saved_searches/list
+      #   @see https://dev.twitter.com/rest/reference/get/saved_searches/list
       #   @param options [Hash] A customizable set of options.
       # @overload saved_search(*ids)
       #   Retrieve the data for saved searches owned by the authenticating user
       #
-      #   @see https://dev.twitter.com/docs/api/1.1/get/saved_searches/show/:id
+      #   @see https://dev.twitter.com/rest/reference/get/saved_searches/show/:id
       #   @param ids [Enumerable<Integer>] A collection of saved search IDs.
       # @overload saved_search(*ids, options)
       #   Retrieve the data for saved searches owned by the authenticating user
       #
-      #   @see https://dev.twitter.com/docs/api/1.1/get/saved_searches/show/:id
+      #   @see https://dev.twitter.com/rest/reference/get/saved_searches/show/:id
       #   @param ids [Enumerable<Integer>] A collection of saved search IDs.
       #   @param options [Hash] A customizable set of options.
       def saved_searches(*args)
@@ -42,7 +42,7 @@ module Twitter
 
       # Retrieve the data for saved searches owned by the authenticating user
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/saved_searches/show/:id
+      # @see https://dev.twitter.com/rest/reference/get/saved_searches/show/:id
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -55,7 +55,7 @@ module Twitter
 
       # Creates a saved search for the authenticated user
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/saved_searches/create
+      # @see https://dev.twitter.com/rest/reference/post/saved_searches/create
       # @rate_limited No
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -69,7 +69,7 @@ module Twitter
 
       # Destroys saved searches for the authenticated user
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/saved_searches/destroy/:id
+      # @see https://dev.twitter.com/rest/reference/post/saved_searches/destroy/:id
       # @note The search specified by ID must be owned by the authenticating user.
       # @rate_limited No
       # @authentication Requires user context

data/lib/twitter/rest/search.rb

@@ -8,8 +8,8 @@ module Twitter
 
       # Returns tweets that match a specified query.
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/search/tweets
-      # @see https://dev.twitter.com/docs/using-search
+      # @see https://dev.twitter.com/rest/reference/get/search/tweets
+      # @see https://dev.twitter.com/rest/public/search
       # @note Please note that Twitter's search service and, by extension, the Search API is not meant to be an exhaustive source of Tweets. Not all Tweets will be indexed or made available via the search interface.
       # @rate_limited Yes
       # @authentication Requires user context

data/lib/twitter/rest/spam_reporting.rb

@@ -8,7 +8,7 @@ module Twitter
 
       # The users specified are blocked by the authenticated user and reported as spammers
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/users/report_spam
+      # @see https://dev.twitter.com/rest/reference/post/users/report_spam
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.

data/lib/twitter/rest/suggested_users.rb

@@ -15,12 +15,12 @@ module Twitter
       # @overload suggestions(options = {})
       #   Returns the list of suggested user categories
       #
-      #   @see https://dev.twitter.com/docs/api/1.1/get/users/suggestions
+      #   @see https://dev.twitter.com/rest/reference/get/users/suggestions
       #   @param options [Hash] A customizable set of options.
       # @overload suggestions(slug, options = {})
       #   Returns the users in a given category
       #
-      #   @see https://dev.twitter.com/docs/api/1.1/get/users/suggestions/:slug
+      #   @see https://dev.twitter.com/rest/reference/get/users/suggestions/:slug
       #   @param slug [String] The short name of list or a category.
       #   @param options [Hash] A customizable set of options.
       def suggestions(*args)
@@ -34,7 +34,7 @@ module Twitter
 
       # Access the users in a given category of the Twitter suggested user list and return their most recent Tweet if they are not a protected user
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/users/suggestions/:slug/members
+      # @see https://dev.twitter.com/rest/reference/get/users/suggestions/:slug/members
       # @rate_limited Yes
       # @authentication Requires user context
       # @param slug [String] The short name of list or a category.

data/lib/twitter/rest/timelines.rb

@@ -11,7 +11,7 @@ module Twitter
 
       # Returns the 20 most recent mentions (statuses containing @username) for the authenticating user
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/statuses/mentions_timeline
+      # @see https://dev.twitter.com/rest/reference/get/statuses/mentions_timeline
       # @note This method can only return up to 800 Tweets.
       # @rate_limited Yes
       # @authentication Requires user context
@@ -29,7 +29,7 @@ module Twitter
 
       # Returns the 20 most recent Tweets posted by the specified user
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/statuses/user_timeline
+      # @see https://dev.twitter.com/rest/reference/get/statuses/user_timeline
       # @note This method can only return up to 3,200 Tweets.
       # @rate_limited Yes
       # @authentication Requires user context
@@ -51,7 +51,7 @@ module Twitter
 
       # Returns the 20 most recent retweets posted by the specified user
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/statuses/user_timeline
+      # @see https://dev.twitter.com/rest/reference/get/statuses/user_timeline
       # @note This method can only return up to 3,200 Tweets.
       # @rate_limited Yes
       # @authentication Requires user context
@@ -74,7 +74,7 @@ module Twitter
 
       # Returns the 20 most recent retweets posted by the authenticating user
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/statuses/user_timeline
+      # @see https://dev.twitter.com/rest/reference/get/statuses/user_timeline
       # @note This method can only return up to 3,200 Tweets.
       # @rate_limited Yes
       # @authentication Requires user context
@@ -95,7 +95,7 @@ module Twitter
 
       # Returns the 20 most recent Tweets, including retweets if they exist, posted by the authenticating user and the users they follow
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/statuses/home_timeline
+      # @see https://dev.twitter.com/rest/reference/get/statuses/home_timeline
       # @note This method can only return up to 800 Tweets, including retweets.
       # @rate_limited Yes
       # @authentication Requires user context
@@ -115,7 +115,7 @@ module Twitter
 
       # Returns the 20 most recent retweets posted by users the authenticating user follow.
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/statuses/home_timeline
+      # @see https://dev.twitter.com/rest/reference/get/statuses/home_timeline
       # @note This method can only return up to 800 Tweets, including retweets.
       # @rate_limited Yes
       # @authentication Requires user context
@@ -136,7 +136,7 @@ module Twitter
 
       # Returns the 20 most recent tweets of the authenticated user that have been retweeted by others
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/statuses/retweets_of_me
+      # @see https://dev.twitter.com/rest/reference/get/statuses/retweets_of_me
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.