twitter 5.14.0 → 5.15.0

data/lib/twitter/rest/trends.rb

@@ -10,7 +10,7 @@ module Twitter
 
       # Returns the top 10 trending topics for a specific WOEID
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/trends/place
+      # @see https://dev.twitter.com/rest/reference/get/trends/place
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -28,7 +28,7 @@ module Twitter
 
       # Returns the locations that Twitter has trending topic information for
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/trends/available
+      # @see https://dev.twitter.com/rest/reference/get/trends/available
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -41,7 +41,7 @@ module Twitter
 
       # Returns the locations that Twitter has trending topic information for, closest to a specified location.
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/trends/closest
+      # @see https://dev.twitter.com/rest/reference/get/trends/closest
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.

data/lib/twitter/rest/tweets.rb

@@ -15,7 +15,7 @@ module Twitter
 
       # Returns up to 100 of the first retweets of a given tweet
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/statuses/retweets/:id
+      # @see https://dev.twitter.com/rest/reference/get/statuses/retweets/:id
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -30,7 +30,7 @@ module Twitter
 
       # Show up to 100 users who retweeted the Tweet
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/statuses/retweets/:id
+      # @see https://dev.twitter.com/rest/reference/get/statuses/retweets/:id
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -48,7 +48,7 @@ module Twitter
 
       # Returns a Tweet
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/statuses/show/:id
+      # @see https://dev.twitter.com/rest/reference/get/statuses/show/:id
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -63,7 +63,7 @@ module Twitter
 
       # Returns Tweets
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/statuses/lookup
+      # @see https://dev.twitter.com/rest/reference/get/statuses/lookup
       # @rate_limited Yes
       # @authentication Required
       # @return [Array<Twitter::Tweet>] The requested Tweets.
@@ -82,7 +82,7 @@ module Twitter
 
       # Destroys the specified Tweets
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/statuses/destroy/:id
+      # @see https://dev.twitter.com/rest/reference/post/statuses/destroy/:id
       # @note The authenticating user must be the author of the specified Tweets.
       # @rate_limited No
       # @authentication Requires user context
@@ -106,16 +106,16 @@ module Twitter
 
       # Updates the authenticating user's status
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/statuses/update
+      # @see https://dev.twitter.com/rest/reference/post/statuses/update
       # @note A status update with text identical to the authenticating user's current status will be ignored to prevent duplicates.
       # @rate_limited No
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
-      # @return [Twitter::Tweet] The created Tweet.
+      # @return [Twitter::Tweet] The created Tweet. When the tweet is deemed a duplicate by Twitter, returns the last Tweet from the user's timeline.
       # @param status [String] The text of your status update, up to 140 characters.
       # @param options [Hash] A customizable set of options.
       # @option options [Boolean, String, Integer] :possibly_sensitive Set to true for content which may not be suitable for every audience.
-      # @option options [Twitter::Tweet] :in_reply_to_status An existing status that the update is in reply to.
+      # @option options [Twitter::Tweet] :in_reply_to_status An existing status that the update is in reply to. If the status being replied to was not originally posted by the authenticated user, the text of the status must begin with an @-mention, or twitter will reject the update.
       # @option options [Integer] :in_reply_to_status_id The ID of an existing status that the update is in reply to.
       # @option options [Float] :lat The latitude of the location this tweet refers to. This option will be ignored unless it is inside the range -90.0 to +90.0 (North is positive) inclusive. It will also be ignored if there isn't a corresponding :long option.
       # @option options [Float] :long The longitude of the location this tweet refers to. The valid ranges for longitude is -180.0 to +180.0 (East is positive) inclusive. This option will be ignored if outside that range, if it is not a number, if geo_enabled is disabled, or if there not a corresponding :lat option.
@@ -132,7 +132,7 @@ module Twitter
 
       # Updates the authenticating user's status
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/statuses/update
+      # @see https://dev.twitter.com/rest/reference/post/statuses/update
       # @note A status update with text identical to the authenticating user's current status will be ignored to prevent duplicates.
       # @rate_limited No
       # @authentication Requires user context
@@ -142,7 +142,7 @@ module Twitter
       # @param status [String] The text of your status update, up to 140 characters.
       # @param options [Hash] A customizable set of options.
       # @option options [Boolean, String, Integer] :possibly_sensitive Set to true for content which may not be suitable for every audience.
-      # @option options [Twitter::Tweet] :in_reply_to_status An existing status that the update is in reply to.
+      # @option options [Twitter::Tweet] :in_reply_to_status An existing status that the update is in reply to. If the status being replied to was not originally posted by the authenticated user, the text of the status must begin with an @-mention, or twitter will reject the update.
       # @option options [Integer] :in_reply_to_status_id The ID of an existing status that the update is in reply to.
       # @option options [Float] :lat The latitude of the location this tweet refers to. This option will be ignored unless it is inside the range -90.0 to +90.0 (North is positive) inclusive. It will also be ignored if there isn't a corresponding :long option.
       # @option options [Float] :long The longitude of the location this tweet refers to. The valid ranges for longitude is -180.0 to +180.0 (East is positive) inclusive. This option will be ignored if outside that range, if it is not a number, if geo_enabled is disabled, or if there not a corresponding :lat option.
@@ -160,7 +160,7 @@ module Twitter
 
       # Retweets the specified Tweets as the authenticating user
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/statuses/retweet/:id
+      # @see https://dev.twitter.com/rest/reference/post/statuses/retweet/:id
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -184,7 +184,7 @@ module Twitter
 
       # Retweets the specified Tweets as the authenticating user and raises an error if one has already been retweeted
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/statuses/retweet/:id
+      # @see https://dev.twitter.com/rest/reference/post/statuses/retweet/:id
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::AlreadyRetweeted] Error raised when tweet has already been retweeted.
@@ -206,7 +206,7 @@ module Twitter
 
       # Updates the authenticating user's status with media
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/statuses/update_with_media
+      # @see https://dev.twitter.com/rest/reference/post/statuses/update_with_media
       # @note A status update with text/media identical to the authenticating user's current status will NOT be ignored
       # @rate_limited No
       # @authentication Requires user context
@@ -235,7 +235,7 @@ module Twitter
 
       # Returns oEmbed for a Tweet
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/statuses/oembed
+      # @see https://dev.twitter.com/rest/reference/get/statuses/oembed
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -243,12 +243,14 @@ module Twitter
       # @param tweet [Integer, String, URI, Twitter::Tweet] A Tweet ID, URI, or object.
       # @param options [Hash] A customizable set of options.
       # @option options [Integer] :maxwidth The maximum width in pixels that the embed should be rendered at. This value is constrained to be between 250 and 550 pixels.
-      # @option options [Boolean, String, Integer] :hide_media Specifies whether the embedded Tweet should automatically expand images which were uploaded via {https://dev.twitter.com/docs/api/1.1/post/statuses/update_with_media POST statuses/update_with_media}. When set to either true, t or 1 images will not be expanded. Defaults to false.
+      # @option options [Boolean, String, Integer] :hide_media Specifies whether the embedded Tweet should automatically expand images which were uploaded via {https://dev.twitter.com/rest/reference/post/statuses/update_with_media POST statuses/update_with_media}. When set to either true, t or 1 images will not be expanded. Defaults to false.
       # @option options [Boolean, String, Integer] :hide_thread Specifies whether the embedded Tweet should automatically show the original message in the case that the embedded Tweet is a reply. When set to either true, t or 1 the original Tweet will not be shown. Defaults to false.
       # @option options [Boolean, String, Integer] :omit_script Specifies whether the embedded Tweet HTML should include a `<script>` element pointing to widgets.js. In cases where a page already includes widgets.js, setting this value to true will prevent a redundant script element from being included. When set to either true, t or 1 the `<script>` element will not be included in the embed HTML, meaning that pages must include a reference to widgets.js manually. Defaults to false.
       # @option options [String] :align Specifies whether the embedded Tweet should be left aligned, right aligned, or centered in the page. Valid values are left, right, center, and none. Defaults to none, meaning no alignment styles are specified for the Tweet.
-      # @option options [String] :related A value for the TWT related parameter, as described in {https://dev.twitter.com/docs/intents Web Intents}. This value will be forwarded to all Web Intents calls.
+      # @option options [String] :related A value for the TWT related parameter, as described in {https://dev.twitter.com/web/intents Web Intents}. This value will be forwarded to all Web Intents calls.
       # @option options [String] :lang Language code for the rendered embed. This will affect the text and localization of the rendered HTML.
+      # @option options [String] :widget_type Set to video to return a Twitter Video embed for the given Tweet.
+      # @option options [Boolean, String] :hide_tweet Applies to video type only. Set to 1 or true to link directly to the Tweet URL instead of displaying a Tweet overlay when a viewer clicks on the Twitter bird logo.
       def oembed(tweet, options = {})
         options[:id] = extract_id(tweet)
         perform_get_with_object('/1.1/statuses/oembed.json', options, Twitter::OEmbed)
@@ -256,7 +258,7 @@ module Twitter
 
       # Returns oEmbeds for Tweets
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/statuses/oembed
+      # @see https://dev.twitter.com/rest/reference/get/statuses/oembed
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -267,11 +269,11 @@ module Twitter
       #   @param tweets [Enumerable<Integer, String, URI, Twitter::Tweet>] A collection of Tweet IDs, URIs, or objects.
       #   @param options [Hash] A customizable set of options.
       #   @option options [Integer] :maxwidth The maximum width in pixels that the embed should be rendered at. This value is constrained to be between 250 and 550 pixels.
-      #   @option options [Boolean, String, Integer] :hide_media Specifies whether the embedded Tweet should automatically expand images which were uploaded via {https://dev.twitter.com/docs/api/1.1/post/statuses/update_with_media POST statuses/update_with_media}. When set to either true, t or 1 images will not be expanded. Defaults to false.
+      #   @option options [Boolean, String, Integer] :hide_media Specifies whether the embedded Tweet should automatically expand images which were uploaded via {https://dev.twitter.com/rest/reference/post/statuses/update_with_media POST statuses/update_with_media}. When set to either true, t or 1 images will not be expanded. Defaults to false.
       #   @option options [Boolean, String, Integer] :hide_thread Specifies whether the embedded Tweet should automatically show the original message in the case that the embedded Tweet is a reply. When set to either true, t or 1 the original Tweet will not be shown. Defaults to false.
       #   @option options [Boolean, String, Integer] :omit_script Specifies whether the embedded Tweet HTML should include a `<script>` element pointing to widgets.js. In cases where a page already includes widgets.js, setting this value to true will prevent a redundant script element from being included. When set to either true, t or 1 the `<script>` element will not be included in the embed HTML, meaning that pages must include a reference to widgets.js manually. Defaults to false.
       #   @option options [String] :align Specifies whether the embedded Tweet should be left aligned, right aligned, or centered in the page. Valid values are left, right, center, and none. Defaults to none, meaning no alignment styles are specified for the Tweet.
-      #   @option options [String] :related A value for the TWT related parameter, as described in {https://dev.twitter.com/docs/intents Web Intents}. This value will be forwarded to all Web Intents calls.
+      #   @option options [String] :related A value for the TWT related parameter, as described in {https://dev.twitter.com/web/intents Web Intents}. This value will be forwarded to all Web Intents calls.
       #   @option options [String] :lang Language code for the rendered embed. This will affect the text and localization of the rendered HTML.
       def oembeds(*args)
         arguments = Twitter::Arguments.new(args)
@@ -282,7 +284,7 @@ module Twitter
 
       # Returns a collection of up to 100 user IDs belonging to users who have retweeted the tweet specified by the id parameter.
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/statuses/retweeters/ids
+      # @see https://dev.twitter.com/rest/reference/get/statuses/retweeters/ids
       # @rate_limited Yes
       # @authentication Required
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.

data/lib/twitter/rest/users.rb

@@ -17,19 +17,19 @@ module Twitter
       # Updates the authenticating user's settings.
       # Or, if no options supplied, returns settings (including current trend, geo and sleep time information) for the authenticating user.
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/account/settings
-      # @see https://dev.twitter.com/docs/api/1.1/get/account/settings
+      # @see https://dev.twitter.com/rest/reference/post/account/settings
+      # @see https://dev.twitter.com/rest/reference/get/account/settings
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::Settings]
       # @param options [Hash] A customizable set of options.
-      # @option options [Integer] :trend_location_woeid The Yahoo! Where On Earth ID to use as the user's default trend location. Global information is available by using 1 as the WOEID. The woeid must be one of the locations returned by {https://dev.twitter.com/docs/api/1.1/get/trends/available GET trends/available}.
+      # @option options [Integer] :trend_location_woeid The Yahoo! Where On Earth ID to use as the user's default trend location. Global information is available by using 1 as the WOEID. The woeid must be one of the locations returned by {https://dev.twitter.com/rest/reference/get/trends/available GET trends/available}.
       # @option options [Boolean, String, Integer] :sleep_time_enabled When set to true, 't' or 1, will enable sleep time for the user. Sleep time is the time when push or SMS notifications should not be sent to the user.
       # @option options [Integer] :start_sleep_time The hour that sleep time should begin if it is enabled. The value for this parameter should be provided in {http://en.wikipedia.org/wiki/ISO_8601 ISO8601} format (i.e. 00-23). The time is considered to be in the same timezone as the user's time_zone setting.
       # @option options [Integer] :end_sleep_time The hour that sleep time should end if it is enabled. The value for this parameter should be provided in {http://en.wikipedia.org/wiki/ISO_8601 ISO8601} format (i.e. 00-23). The time is considered to be in the same timezone as the user's time_zone setting.
       # @option options [String] :time_zone The timezone dates and times should be displayed in for the user. The timezone must be one of the {http://api.rubyonrails.org/classes/ActiveSupport/TimeZone.html Rails TimeZone} names.
-      # @option options [String] :lang The language which Twitter should render in for this user. The language must be specified by the appropriate two letter ISO 639-1 representation. Currently supported languages are provided by {https://dev.twitter.com/docs/api/1.1/get/help/languages GET help/languages}.
+      # @option options [String] :lang The language which Twitter should render in for this user. The language must be specified by the appropriate two letter ISO 639-1 representation. Currently supported languages are provided by {https://dev.twitter.com/rest/reference/get/help/languages GET help/languages}.
       def settings(options = {})
         request_method = options.size.zero? ? :get : :post
         response = perform_request(request_method.to_sym, '/1.1/account/settings.json', options)
@@ -40,7 +40,7 @@ module Twitter
 
       # Returns the requesting user if authentication was successful, otherwise raises {Twitter::Error::Unauthorized}
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/account/verify_credentials
+      # @see https://dev.twitter.com/rest/reference/get/account/verify_credentials
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -54,7 +54,7 @@ module Twitter
 
       # Sets which device Twitter delivers updates to for the authenticating user
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/account/update_delivery_device
+      # @see https://dev.twitter.com/rest/reference/post/account/update_delivery_device
       # @rate_limited No
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -67,7 +67,7 @@ module Twitter
 
       # Sets values that users are able to set under the "Account" tab of their settings page
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/account/update_profile
+      # @see https://dev.twitter.com/rest/reference/post/account/update_profile
       # @note Only the options specified will be updated.
       # @rate_limited No
       # @authentication Requires user context
@@ -84,7 +84,7 @@ module Twitter
 
       # Updates the authenticating user's profile background image
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/account/update_profile_background_image
+      # @see https://dev.twitter.com/rest/reference/post/account/update_profile_background_image
       # @rate_limited No
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -98,7 +98,7 @@ module Twitter
 
       # Sets one or more hex values that control the color scheme of the authenticating user's profile
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/account/update_profile_colors
+      # @see https://dev.twitter.com/rest/reference/post/account/update_profile_colors
       # @rate_limited No
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -115,7 +115,7 @@ module Twitter
 
       # Updates the authenticating user's profile image
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/account/update_profile_image
+      # @see https://dev.twitter.com/rest/reference/post/account/update_profile_image
       # @note Updates the authenticating user's profile image. Note that this method expects raw multipart data, not a URL to an image.
       # @note This method asynchronously processes the uploaded file before updating the user's profile image URL. You can either update your local cache the next time you request the user's information, or, at least 5 seconds after uploading the image, ask for the updated URL using GET users/show.
       # @rate_limited No
@@ -130,7 +130,7 @@ module Twitter
 
       # Returns an array of user objects that the authenticating user is blocking
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/blocks/list
+      # @see https://dev.twitter.com/rest/reference/get/blocks/list
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -144,7 +144,7 @@ module Twitter
 
       # Returns an array of numeric user IDs the authenticating user is blocking
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/blocks/ids
+      # @see https://dev.twitter.com/rest/reference/get/blocks/ids
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -159,7 +159,7 @@ module Twitter
 
       # Returns true if the authenticating user is blocking a target user
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/blocks/ids
+      # @see https://dev.twitter.com/rest/reference/get/blocks/ids
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -183,7 +183,7 @@ module Twitter
 
       # Blocks the users specified by the authenticating user
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/blocks/create
+      # @see https://dev.twitter.com/rest/reference/post/blocks/create
       # @note Destroys a friendship to the blocked user if it exists.
       # @rate_limited Yes
       # @authentication Requires user context
@@ -200,7 +200,7 @@ module Twitter
 
       # Un-blocks the users specified by the authenticating user
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/blocks/destroy
+      # @see https://dev.twitter.com/rest/reference/post/blocks/destroy
       # @rate_limited No
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -216,7 +216,7 @@ module Twitter
 
       # Returns extended information for up to 100 users
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/users/lookup
+      # @see https://dev.twitter.com/rest/reference/get/users/lookup
       # @rate_limited Yes
       # @authentication Required
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -233,7 +233,7 @@ module Twitter
         end
       end
 
-      # @see https://dev.twitter.com/docs/api/1.1/get/users/show
+      # @see https://dev.twitter.com/rest/reference/get/users/show
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -276,7 +276,7 @@ module Twitter
 
       # Returns users that match the given query
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/users/search
+      # @see https://dev.twitter.com/rest/reference/get/users/search
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -291,7 +291,7 @@ module Twitter
 
       # Returns an array of users that the specified user can contribute to
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/users/contributees
+      # @see https://dev.twitter.com/rest/reference/get/users/contributees
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -309,7 +309,7 @@ module Twitter
 
       # Returns an array of users who can contribute to the specified account
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/users/contributors
+      # @see https://dev.twitter.com/rest/reference/get/users/contributors
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -327,7 +327,7 @@ module Twitter
 
       # Removes the authenticating user's profile banner image
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/account/remove_profile_banner
+      # @see https://dev.twitter.com/rest/reference/post/account/remove_profile_banner
       # @rate_limited No
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -341,7 +341,7 @@ module Twitter
 
       # Updates the authenticating user's profile banner image
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/account/update_profile_banner
+      # @see https://dev.twitter.com/rest/reference/post/account/update_profile_banner
       # @note Uploads a profile banner on behalf of the authenticating user. For best results, upload an <5MB image that is exactly 1252px by 626px. Images will be resized for a number of display options. Users with an uploaded profile banner will have a profile_banner_url node in their Users objects. More information about sizing variations can be found in User Profile Images and Banners.
       # @note Profile banner images are processed asynchronously. The profile_banner_url and its variant sizes will not necessary be available directly after upload.
       # @rate_limited No
@@ -363,7 +363,7 @@ module Twitter
 
       # Returns the available size variations of the specified user's profile banner.
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/users/profile_banner
+      # @see https://dev.twitter.com/rest/reference/get/users/profile_banner
       # @note If the user has not uploaded a profile banner, a HTTP 404 will be served instead.
       # @rate_limited Yes
       # @authentication Requires user context
@@ -380,7 +380,7 @@ module Twitter
 
       # Mutes the users specified by the authenticating user
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/mutes/users/create
+      # @see https://dev.twitter.com/rest/reference/post/mutes/users/create
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -396,7 +396,7 @@ module Twitter
 
       # Un-mutes the user specified by the authenticating user.
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/mutes/users/destroy
+      # @see https://dev.twitter.com/rest/reference/post/mutes/users/destroy
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -412,7 +412,7 @@ module Twitter
 
       # Returns an array of user objects that the authenticating user is muting
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/mutes/users/list
+      # @see https://dev.twitter.com/rest/reference/get/mutes/users/list
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
@@ -426,7 +426,7 @@ module Twitter
 
       # Returns an array of numeric user IDs the authenticating user is muting
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/mutes/users/ids
+      # @see https://dev.twitter.com/rest/reference/get/mutes/users/ids
       # @rate_limited Yes
       # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.

data/lib/twitter/rest/utils.rb

@@ -39,7 +39,6 @@ module Twitter
 
       # @param path [String]
       # @param options [Hash]
-      # @param klass [Class]
       def perform_post(path, options = {})
         perform_request(:post, path, options)
       end
@@ -100,7 +99,7 @@ module Twitter
 
       # @param path [String]
       # @param options [Hash]
-      # @collection_name [Symbol]
+      # @param collection_name [Symbol]
       # @param klass [Class]
       def perform_get_with_cursor(path, options, collection_name, klass = nil)
         merge_default_cursor!(options)
@@ -157,7 +156,7 @@ module Twitter
       # @param path [String]
       # @param args [Array]
       # @return [Twitter::Cursor]
-      def cursor_from_response_with_user(collection_name, klass, path, args) # rubocop:disable ParameterLists
+      def cursor_from_response_with_user(collection_name, klass, path, args)
         arguments = Twitter::Arguments.new(args)
         merge_user!(arguments.options, arguments.pop || user_id) unless arguments.options[:user_id] || arguments.options[:screen_name]
         perform_get_with_cursor(path, arguments.options, collection_name, klass)
@@ -234,7 +233,8 @@ module Twitter
       end
 
       def collect_user_ids_and_screen_names(users) # rubocop:disable MethodLength
-        user_ids, screen_names = [], []
+        user_ids = []
+        screen_names = []
         users.flatten.each do |user|
           case user
           when Integer

data/lib/twitter/streaming/client.rb

@@ -25,8 +25,8 @@ module Twitter
 
       # Returns public statuses that match one or more filter predicates
       #
-      # @see https://dev.twitter.com/docs/api/1.1/post/statuses/filter
-      # @see https://dev.twitter.com/docs/streaming-apis/parameters
+      # @see https://dev.twitter.com/streaming/reference/post/statuses/filter
+      # @see https://dev.twitter.com/streaming/overview/request-parameters
       # @note At least one predicate parameter (follow, locations, or track) must be specified.
       # @param options [Hash] A customizable set of options.
       # @option options [String] :follow A comma separated list of user IDs, indicating the users to return statuses for in the stream.
@@ -39,8 +39,8 @@ module Twitter
 
       # Returns all public statuses
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/statuses/firehose
-      # @see https://dev.twitter.com/docs/streaming-apis/parameters
+      # @see https://dev.twitter.com/streaming/reference/get/statuses/firehose
+      # @see https://dev.twitter.com/streaming/overview/request-parameters
       # @note This endpoint requires special permission to access.
       # @param options [Hash] A customizable set of options.
       # @option options [Integer] :count The number of messages to backfill.
@@ -51,24 +51,25 @@ module Twitter
 
       # Returns a small random sample of all public statuses
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/statuses/sample
-      # @see https://dev.twitter.com/docs/streaming-apis/parameters
+      # @see https://dev.twitter.com/streaming/reference/get/statuses/sample
+      # @see https://dev.twitter.com/streaming/overview/request-parameters
       # @yield [Twitter::Tweet, Twitter::Streaming::Event, Twitter::DirectMessage, Twitter::Streaming::FriendList, Twitter::Streaming::DeletedTweet, Twitter::Streaming::StallWarning] A stream of Twitter objects.
       def sample(options = {}, &block)
         request(:get, 'https://stream.twitter.com:443/1.1/statuses/sample.json', options, &block)
       end
 
-      # Streams messages for a set of user
+      # Streams messages for a set of users
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/site
-      # @see https://dev.twitter.com/docs/streaming-apis/streams/site
-      # @see https://dev.twitter.com/docs/streaming-apis/parameters
+      # @see https://dev.twitter.com/streaming/reference/get/site
+      # @see https://dev.twitter.com/streaming/sitestreams
+      # @see https://dev.twitter.com/streaming/overview/request-parameters
       # @note Site Streams is currently in a limited beta. Access is restricted to whitelisted accounts.
-      # @param follow [Enumerable<Integer, String, Twitter::User>] A list of user IDs, indicating the users to return statuses for in the stream.
-      # @param options [Hash] A customizable set of options.
-      # @option options [String] :with Specifies whether to return information for just the users specified in the follow parameter, or include messages from accounts they follow.
-      # @option options [String] :replies Specifies whether stall warnings should be delivered.
-      # @yield [Twitter::Tweet, Twitter::Streaming::Event, Twitter::DirectMessage, Twitter::Streaming::FriendList, Twitter::Streaming::DeletedTweet, Twitter::Streaming::StallWarning] A stream of Twitter objects.
+      # @overload site(*follow, options = {}, &block)
+      #   @param follow [Enumerable<Integer, String, Twitter::User>] A list of user IDs, indicating the users to return statuses for in the stream.
+      #   @param options [Hash] A customizable set of options.
+      #   @option options [String] :with Specifies whether to return information for just the users specified in the follow parameter, or include messages from accounts they follow.
+      #   @option options [String] :replies Specifies whether stall warnings should be delivered.
+      #   @yield [Twitter::Tweet, Twitter::Streaming::Event, Twitter::DirectMessage, Twitter::Streaming::FriendList, Twitter::Streaming::DeletedTweet, Twitter::Streaming::StallWarning] A stream of Twitter objects.
       def site(*args, &block)
         arguments = Arguments.new(args)
         user_ids = collect_user_ids(arguments)
@@ -77,9 +78,9 @@ module Twitter
 
       # Streams messages for a single user
       #
-      # @see https://dev.twitter.com/docs/api/1.1/get/user
-      # @see https://dev.twitter.com/docs/streaming-apis/streams/user
-      # @see https://dev.twitter.com/docs/streaming-apis/parameters
+      # @see https://dev.twitter.com/streaming/reference/get/user
+      # @see https://dev.twitter.com/streaming/userstreams
+      # @see https://dev.twitter.com/streaming/overview/request-parameters
       # @param options [Hash] A customizable set of options.
       # @option options [String] :with Specifies whether to return information for just the users specified in the follow parameter, or include messages from accounts they follow.
       # @option options [String] :replies Specifies whether to return additional @replies.
@@ -111,7 +112,7 @@ module Twitter
         headers = default_headers.merge(:authorization => authorization)
         request = HTTP::Request.new(method, uri + '?' + to_url_params(params), headers)
         response = Streaming::Response.new do |data|
-          if item = Streaming::MessageParser.parse(data) # rubocop:disable AssignmentInCondition, IfUnlessModifier
+          if item = Streaming::MessageParser.parse(data) # rubocop:disable AssignmentInCondition
             yield(item)
           end
         end