twitter 4.4.4 → 4.5.0

data/.yardopts

@@ -1,7 +1,7 @@
 --no-private
 --protected
 --tag rate_limited:"Rate Limited?"
---tag authentication_required:"Authentication Required?"
+--tag authentication:"Authentication"
 --markup markdown
 -
 CHANGELOG.md

data/CHANGELOG.md

@@ -1,3 +1,7 @@
+4.5.0
+-----
+* [Add no_retweet_ids](https://github.com/sferik/twitter/commit/cab8d6ebf3afdbd24463932262798a132d70a6f1)
+
 4.4.4
 -----
 * [Fix documentation bugs](https://github.com/sferik/twitter/commit/45213d16efda0bd78e8c4c3c80892b824393e37c)

data/README.md

@@ -1,9 +1,11 @@
 # The Twitter Ruby Gem
+[![Gem Version](https://badge.fury.io/rb/twitter.png)][gem]
 [![Build Status](https://secure.travis-ci.org/sferik/twitter.png?branch=master)][travis]
 [![Dependency Status](https://gemnasium.com/sferik/twitter.png?travis)][gemnasium]
 [![Code Climate](https://codeclimate.com/badge.png)][codeclimate]
 [![Click here to make a donation](http://www.pledgie.com/campaigns/18388.png)][pledgie]
 
+[gem]: https://rubygems.org/gems/twitter
 [travis]: http://travis-ci.org/sferik/twitter
 [gemnasium]: https://gemnasium.com/sferik/twitter
 [codeclimate]: https://codeclimate.com/github/sferik/twitter
@@ -117,7 +119,6 @@ version 3 are no longer available in version 4:
 * `Twitter::API#disable_notifications`
 * `Twitter::API#enable_notifications`
 * `Twitter::API#end_session`
-* `Twitter::API#no_retweet_ids`
 * `Twitter::API#rate_limit_status`
 * `Twitter::API#rate_limited?`
 * `Twitter::API#recommendations`
@@ -267,7 +268,7 @@ The Faraday middleware stack is fully configurable and is exposed as a
 `Faraday::Builder` object. You can modify the default middleware in-place:
 
 ```ruby
-Twitter.middleware.insert_after Twitter::Response::RaiseClientError, CustomMiddleware
+Twitter.middleware.insert_after Twitter::Response::RaiseError, CustomMiddleware
 ```
 
 A custom adapter may be set as part of a custom middleware stack:
@@ -316,6 +317,13 @@ Twitter.friends("gem")
 Twitter.friends(213747670)
 Twitter.friends
 ```
+
+**Fetch a collection of user_ids that the currently authenticated user does not want to receive retweets from**
+
+```ruby
+Twitter.no_retweet_ids
+````
+
 **Fetch the timeline of Tweets by a user**
 
 ```ruby
@@ -393,6 +401,7 @@ version:
 * Ruby 1.8.7
 * Ruby 1.9.2
 * Ruby 1.9.3
+* Ruby 2.0.0
 
 This library may inadvertently work (or seem to work) on other Ruby
 implementations, however support will only be provided for the versions listed

data/lib/twitter/api/direct_messages.rb

@@ -13,7 +13,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/get/direct_messages
       # @note This method requires an access token with RWD (read, write & direct message) permissions. Consult The Application Permission Model for more information.
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::DirectMessage>] Direct messages sent to the authenticating user.
       # @param options [Hash] A customizable set of options.
@@ -32,7 +32,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/get/direct_messages/sent
       # @note This method requires an access token with RWD (read, write & direct message) permissions. Consult The Application Permission Model for more information.
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::DirectMessage>] Direct messages sent by the authenticating user.
       # @param options [Hash] A customizable set of options.
@@ -51,7 +51,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/get/direct_messages/show
       # @note This method requires an access token with RWD (read, write & direct message) permissions. Consult The Application Permission Model for more information.
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::DirectMessage] The requested messages.
       # @param id [Integer] A Tweet IDs.
@@ -65,7 +65,7 @@ module Twitter
 
       # @note This method requires an access token with RWD (read, write & direct message) permissions. Consult The Application Permission Model for more information.
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::DirectMessage>] The requested messages.
       # @overload direct_messages(options={})
@@ -108,7 +108,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/post/direct_messages/destroy
       # @note This method requires an access token with RWD (read, write & direct message) permissions. Consult The Application Permission Model for more information.
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::DirectMessage>] Deleted direct message.
       # @overload direct_message_destroy(*ids)
@@ -126,7 +126,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/direct_messages/new
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::DirectMessage] The sent message.
       # @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.

data/lib/twitter/api/favorites.rb

@@ -12,7 +12,7 @@ module Twitter
 
       # @see https://dev.twitter.com/docs/api/1.1/get/favorites/list
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::Tweet>] favorite Tweets.
       # @overload favorites(options={})
@@ -45,7 +45,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/favorites/destroy
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::Tweet>] The un-favorited Tweets.
       # @overload unfavorite(*ids)
@@ -66,7 +66,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/favorites/create
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::Tweet>] The favorited Tweets.
       # @overload favorite(*ids)
@@ -95,7 +95,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/favorites/create
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::AlreadyFavorited] Error raised when tweet has already been favorited.
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::Tweet>] The favorited Tweets.

data/lib/twitter/api/friends_and_followers.rb

@@ -12,7 +12,7 @@ module Twitter
 
       # @see https://dev.twitter.com/docs/api/1.1/get/friends/ids
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::Cursor]
       # @overload friend_ids(options={})
@@ -37,7 +37,7 @@ module Twitter
 
       # @see https://dev.twitter.com/docs/api/1.1/get/followers/ids
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::Cursor]
       # @overload follower_ids(options={})
@@ -64,7 +64,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/friendships/lookup
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::User>] The requested users.
       # @overload friendships(*users)
@@ -86,7 +86,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/friendships/incoming
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::Cursor]
       # @param options [Hash] A customizable set of options.
@@ -101,7 +101,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/friendships/outgoing
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::Cursor]
       # @param options [Hash] A customizable set of options.
@@ -116,7 +116,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/friendships/create
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::User>] The followed users.
       # @overload follow(*users)
@@ -146,7 +146,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/friendships/create
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::User>] The followed users.
       # @overload follow!(*users)
@@ -177,7 +177,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/friendships/destroy
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::User>] The unfollowed users.
       # @overload unfollow(*users)
@@ -196,7 +196,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/friendships/update
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::Relationship]
       # @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
@@ -214,7 +214,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/friendships/show
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::Relationship]
       # @param source [Integer, String, Twitter::User] The Twitter user ID, screen name, or object of the source user.
@@ -238,7 +238,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/friendships/show
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Boolean] true if user_a follows user_b, otherwise false.
       # @param source [Integer, String, Twitter::User] The Twitter user ID, screen name, or object of the source user.
@@ -256,7 +256,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/followers/list
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::Cursor]
       # @overload friend_ids(options={})
@@ -287,7 +287,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/friendships/show
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::Cursor]
       # @overload friend_ids(options={})
@@ -315,6 +315,22 @@ module Twitter
       end
       alias following friends
 
+      # Returns a collection of user_ids that the currently authenticated user does not want to receive retweets from.
+      # =>
+      # @see https://dev.twitter.com/docs/api/1.1/get/friendships/no_retweets/ids
+      # @rate_limited Yes
+      # @authentication Requires user context
+      # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
+      # @return [Array<Integer>]
+      # @param options [Hash] A customizable set of options.
+      # @option options [Boolean] :stringify_ids Many programming environments will not consume our ids due to their size. Provide this option to have ids returned as strings instead. Read more about Twitter IDs, JSON and Snowflake.
+      # @example Enable rewteets and devise notifications for @sferik
+      #   Twitter.no_retweet_ids
+      def no_retweet_ids(options={})
+        get("/1.1/friendships/no_retweets/ids.json", options)[:body].map(&:to_i)
+      end
+      alias no_retweets_ids no_retweet_ids
+      
     end
   end
 end

data/lib/twitter/api/help.rb

@@ -11,7 +11,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/help/configuration
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::Configuration] Twitter's configuration.
       # @example Return the current configuration used by Twitter
@@ -24,7 +24,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/help/languages
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::Language>]
       # @example Return the list of languages Twitter supports
@@ -37,7 +37,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/help/privacy
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [String]
       # @example Return {https://twitter.com/privacy Twitter's Privacy Policy}
@@ -50,7 +50,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/help/tos
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [String]
       # @example Return {https://twitter.com/tos Twitter's Terms of Service}

data/lib/twitter/api/lists.rb

@@ -18,17 +18,17 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/lists/list
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::List>]
       # @overload lists(options={})
       #   @param options [Hash] A customizable set of options.
-      #   @example Returns all lists the authenticating user subscribes to
+      #   @example Return all lists the authenticating user subscribes to
       #     Twitter.lists
       # @overload lists(user, options={})
       #   @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
       #   @param options [Hash] A customizable set of options.
-      #   @example Returns all lists that @sferik subscribes to
+      #   @example Return all lists that @sferik subscribes to
       #     Twitter.lists('sferik')
       #     Twitter.lists(7505382)
       def lists(*args)
@@ -40,7 +40,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/lists/statuses
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::Tweet>]
       # @overload list_timeline(list, options={})
@@ -75,7 +75,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/lists/members/destroy
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::List] The list.
       # @overload list_remove_member(list, user_to_remove, options={})
@@ -104,7 +104,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/lists/memberships
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::Cursor]
       # @overload memberships(options={})
@@ -129,7 +129,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/lists/subscribers
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::Cursor] The subscribers of the specified list.
       # @overload list_subscribers(list, options={})
@@ -156,7 +156,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/lists/subscribers/create
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::List] The specified list.
       # @overload list_subscribe(list, options={})
@@ -181,7 +181,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/lists/subscribers/show
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Boolean] true if user is a subscriber of the specified list, otherwise false.
       # @overload list_subscriber?(list, user_to_check, options={})
@@ -211,7 +211,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/lists/subscribers/destroy
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::List] The specified list.
       # @overload list_unsubscribe(list, options={})
@@ -237,7 +237,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/post/lists/members/create_all
       # @note Lists are limited to having 500 members, and you are limited to adding up to 100 members to a list at a time with this method.
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::List] The list.
       # @overload list_add_members(list, users, options={})
@@ -268,7 +268,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
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @rate_limited Yes
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Boolean] true if user is a member of the specified list, otherwise false.
@@ -296,7 +296,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/lists/members
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::Cursor]
       # @overload list_members(list, options={})
@@ -325,7 +325,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/post/lists/members/create
       # @note Lists are limited to having 500 members.
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::List] The list.
       # @overload list_add_member(list, user_to_add, options={})
@@ -354,7 +354,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/post/lists/destroy
       # @note Must be owned by the authenticated user.
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::List] The deleted list.
       # @overload list_destroy(list, options={})
@@ -380,7 +380,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/lists/update
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::List] The created list.
       # @overload list_update(list, options={})
@@ -411,7 +411,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/post/lists/create
       # @note Accounts are limited to 20 lists.
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::List] The created list.
       # @param name [String] The name for the list.
@@ -429,7 +429,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/get/lists/show
       # @note Private lists will only be shown if the authenticated user owns the specified list.
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::List] The specified list.
       # @overload list(list, options={})
@@ -455,7 +455,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/lists/subscriptions
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::Cursor]
       # @overload subscriptions(options={})
@@ -478,7 +478,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/lists/members/destroy_all
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::List] The list.
       # @overload list_remove_members(list, users, options={})

data/lib/twitter/api/places_and_geo.rb

@@ -10,7 +10,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/geo/id/:place_id
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @param place_id [String] A place in the world. These IDs can be retrieved from {Twitter::API::PlacesAndGeo#reverse_geocode}.
       # @param options [Hash] A customizable set of options.
@@ -26,7 +26,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/get/geo/reverse_geocode
       # @note This request is an informative call and will deliver generalized results about geography.
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @param options [Hash] A customizable set of options.
       # @option options [Float] :lat The latitude to search around. 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.
@@ -45,7 +45,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/geo/search
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @param options [Hash] A customizable set of options.
       # @option options [Float] :lat The latitude to search around. 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.
@@ -70,7 +70,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/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::API::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_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @param options [Hash] A customizable set of options.
       # @option options [Float] :lat The latitude to search around. 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.
@@ -90,7 +90,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/geo/place
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @param options [Hash] A customizable set of options.
       # @option options [String] :name The name a place is known as.

data/lib/twitter/api/saved_searches.rb

@@ -8,7 +8,7 @@ module Twitter
       include Twitter::API::Utils
 
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::SavedSearch>] The saved searches.
       # @overload saved_search(options={})
@@ -46,7 +46,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/saved_searches/show/:id
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::SavedSearch] The saved searches.
       # @param id [Integer] A Tweet IDs.
@@ -61,7 +61,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/saved_searches/create
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::SavedSearch] The created saved search.
       # @param query [String] The query of the search the user would like to save.
@@ -77,7 +77,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/post/saved_searches/destroy/:id
       # @note The search specified by ID must be owned by the authenticating user.
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::SavedSearch>] The deleted saved searches.
       # @overload saved_search_destroy(*ids)

data/lib/twitter/api/search.rb

@@ -12,7 +12,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/using-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_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @param q [String] A search term.
       # @param options [Hash] A customizable set of options.
@@ -26,7 +26,7 @@ module Twitter
       # @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, String, Integer] :include_entities The tweet entities node will be disincluded when set to false.
       # @return [Twitter::SearchResults] Return tweets that match a specified query with search metadata
-      # @example Returns tweets related to twitter
+      # @example Return tweets related to twitter
       #   Twitter.search('twitter')
       def search(q, options={})
         object_from_response(Twitter::SearchResults, :get, "/1.1/search/tweets.json", options.merge(:q => q))

data/lib/twitter/api/spam_reporting.rb

@@ -10,7 +10,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/users/report_spam
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::User>] The reported users.
       # @overload report_spam(*users)

data/lib/twitter/api/suggested_users.rb

@@ -10,7 +10,7 @@ module Twitter
 
       # @return [Array<Twitter::Suggestion>]
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @overload suggestions(options={})
       #   Returns the list of suggested user categories
@@ -40,7 +40,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/users/suggestions/:slug/members
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @param slug [String] The short name of list or a category.
       # @param options [Hash] A customizable set of options.
       # @return [Array<Twitter::User>]

data/lib/twitter/api/timelines.rb

@@ -14,7 +14,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/get/statuses/mentions_timeline
       # @note This method can only return up to 800 Tweets.
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::Tweet>]
       # @param options [Hash] A customizable set of options.
@@ -34,7 +34,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/get/statuses/user_timeline
       # @note This method can only return up to 3,200 Tweets.
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::Tweet>]
       # @overload user_timeline(user, options={})
@@ -58,7 +58,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/get/statuses/user_timeline
       # @note This method can only return up to 3,200 Tweets.
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::Tweet>]
       # @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
@@ -83,7 +83,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/get/statuses/user_timeline
       # @note This method can only return up to 3,200 Tweets.
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::Tweet>]
       # @param options [Hash] A customizable set of options.
@@ -106,7 +106,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/get/statuses/home_timeline
       # @note This method can only return up to 800 Tweets, including retweets.
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::Tweet>]
       # @param options [Hash] A customizable set of options.
@@ -129,7 +129,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/get/statuses/home_timeline
       # @note This method can only return up to 800 Tweets, including retweets.
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::Tweet>]
       # @param options [Hash] A customizable set of options.
@@ -152,7 +152,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/statuses/retweets_of_me
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::Tweet>]
       # @param options [Hash] A customizable set of options.

data/lib/twitter/api/trends.rb

@@ -11,7 +11,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/trends/place
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @param id [Integer] The {https://developer.yahoo.com/geo/geoplanet Yahoo! Where On Earth ID} of the location to return trending information for. WOEIDs can be retrieved by calling {Twitter::API::Trends#trend_locations}. Global information is available by using 1 as the WOEID.
       # @param options [Hash] A customizable set of options.
@@ -31,7 +31,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/trends/available
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @param options [Hash] A customizable set of options.
       # @return [Array<Twitter::Place>]
@@ -46,7 +46,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/trends/closest
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @param options [Hash] A customizable set of options.
       # @option options [Float] :lat If provided with a :long option the available trend locations will be sorted by distance, nearest to furthest, to the co-ordinate pair. The valid ranges for latitude are -90.0 to +90.0 (North is positive) inclusive.

data/lib/twitter/api/tweets.rb

@@ -14,7 +14,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/statuses/retweets/:id
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::Tweet>]
       # @param id [Integer] The numerical ID of the desired Tweet.
@@ -31,7 +31,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/statuses/retweets/:id
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array]
       # @param id [Integer] The numerical ID of the desired Tweet.
@@ -55,7 +55,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/statuses/show/:id
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::Tweet] The requested Tweet.
       # @param id [Integer] A Tweet ID.
@@ -71,7 +71,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/statuses/show/:id
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::Tweet>] The requested Tweets.
       # @overload statuses(*ids)
@@ -91,7 +91,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/post/statuses/destroy/:id
       # @note The authenticating user must be the author of the specified Tweets.
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::Tweet>] The deleted Tweets.
       # @overload status_destroy(*ids)
@@ -112,7 +112,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/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_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::Tweet] The created Tweet.
       # @param status [String] The text of your status update, up to 140 characters.
@@ -133,7 +133,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/statuses/retweet/:id
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::Tweet>] The original tweets with retweet details embedded.
       # @overload retweet(*ids)
@@ -159,7 +159,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/statuses/retweet/:id
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::AlreadyRetweeted] Error raised when tweet has already been retweeted.
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::Tweet>] The original tweets with retweet details embedded.
@@ -187,7 +187,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/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_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::Tweet] The created Tweet.
       # @param status [String] The text of your status update, up to 140 characters.
@@ -209,7 +209,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/statuses/oembed
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::OEmbed] OEmbed for the requested Tweet.
       # @param id [Integer, String] A Tweet ID.
@@ -231,7 +231,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/statuses/oembed
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::OEmbed>] OEmbeds for the requested Tweets.
       # @overload oembed(*ids_or_urls)

data/lib/twitter/api/undocumented.rb

@@ -14,7 +14,7 @@ module Twitter
       #
       # @note Undocumented
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array] An array of actions
       # @param options [Hash] A customizable set of options.
@@ -30,7 +30,7 @@ module Twitter
       #
       # @note Undocumented
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid./
       # @return [Array] An array of actions
       # @param options [Hash] A customizable set of options.
@@ -44,7 +44,7 @@ module Twitter
 
       # @note Undocumented
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       #
       # @overload following_followers_of(options={})
@@ -74,7 +74,7 @@ module Twitter
       #
       # @note Undocumented
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::Tweet] The requested Tweet.
       # @param id [Integer] A Tweet ID.
@@ -92,7 +92,7 @@ module Twitter
       #
       # @note Undocumented
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::Tweet>] The requested Tweets.
       # @overload statuses_activity(*ids)

data/lib/twitter/api/users.rb

@@ -18,7 +18,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/post/account/settings
       # @see https://dev.twitter.com/docs/api/1.1/get/account/settings
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @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.
@@ -39,7 +39,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/account/verify_credentials
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::User] The authenticated user.
       # @param options [Hash] A customizable set of options.
@@ -55,7 +55,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/account/update_delivery_device
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::User] The authenticated user.
       # @param device [String] Must be one of: 'sms', 'none'.
@@ -71,7 +71,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/post/account/update_profile
       # @note Only the options specified will be updated.
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::User] The authenticated user.
       # @param options [Hash] A customizable set of options.
@@ -89,7 +89,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/account/update_profile_background_image
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::User] The authenticated user.
       # @param image [File] The background image for the profile, base64-encoded. Must be a valid GIF, JPG, or PNG image of less than 800 kilobytes in size. Images with width larger than 2048 pixels will be forcibly scaled down. The image must be provided as raw multipart data, not a URL.
@@ -105,7 +105,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/account/update_profile_colors
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::User] The authenticated user.
       # @param options [Hash] A customizable set of options.
@@ -126,7 +126,7 @@ module Twitter
       # @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
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::User] The authenticated user.
       # @param image [File] The avatar image for the profile, base64-encoded. Must be a valid GIF, JPG, or PNG image of less than 700 kilobytes in size. Images with width larger than 500 pixels will be scaled down. Animated GIFs will be converted to a static GIF of the first frame, removing the animation.
@@ -141,7 +141,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/blocks/list
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::User>] User objects that the authenticating user is blocking.
       # @param options [Hash] A customizable set of options.
@@ -156,7 +156,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/blocks/ids
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array] Numeric user ids the authenticating user is blocking.
       # @example Return an array of numeric user ids the authenticating user is blocking
@@ -173,7 +173,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/blocks/ids
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Boolean] true if the authenticating user is blocking the target user, otherwise false.
       # @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
@@ -199,7 +199,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/post/blocks/create
       # @note Destroys a friendship to the blocked user if it exists.
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::User>] The blocked users.
       # @overload block(*users)
@@ -218,7 +218,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/blocks/destroy
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::User>] The un-blocked users.
       # @overload unblock(*users)
@@ -237,7 +237,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/users/lookup
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::User>] The requested users.
       # @overload users(*users)
@@ -263,7 +263,7 @@ module Twitter
 
       # @see https://dev.twitter.com/docs/api/1.1/get/users/show
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::User] The requested user.
       # @overload user(options={})
@@ -294,7 +294,7 @@ module Twitter
       # Returns true if the specified user exists
       #
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Boolean] true if the user exists, otherwise false.
       # @param user [Integer, String, Twitter::User] A Twitter user ID, screen name, or object.
@@ -313,7 +313,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/users/search
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::User>]
       # @param query [String] The search query to run against people search.
@@ -330,7 +330,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/users/contributees
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::User>]
       # @overload contributees(options={})
@@ -353,7 +353,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/get/users/contributors
       # @rate_limited Yes
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Array<Twitter::User>]
       # @overload contributors(options={})
@@ -376,7 +376,7 @@ module Twitter
       #
       # @see https://dev.twitter.com/docs/api/1.1/post/account/remove_profile_banner
       # @rate_limited No
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [nil]
       # @param options [Hash] A customizable set of options.
@@ -392,7 +392,7 @@ module Twitter
       # @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
-      # @authentication_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::BadRequest] Error raised when either an image was not provided or the image data could not be processed.
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @raise [Twitter::Error::UnprocessableEntity] Error raised when the image could not be resized or is too large.
@@ -414,7 +414,7 @@ module Twitter
       # @see https://dev.twitter.com/docs/api/1.1/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_required Requires user context
+      # @authentication Requires user context
       # @raise [Twitter::Error::Unauthorized] Error raised when supplied user credentials are not valid.
       # @return [Twitter::ProfileBanner]
       # @overload profile_banner(options={})

data/lib/twitter/version.rb

@@ -1,8 +1,8 @@
 module Twitter
   class Version
     MAJOR = 4 unless defined? Twitter::Version::MAJOR
-    MINOR = 4 unless defined? Twitter::Version::MINOR
-    PATCH = 4 unless defined? Twitter::Version::PATCH
+    MINOR = 5 unless defined? Twitter::Version::MINOR
+    PATCH = 0 unless defined? Twitter::Version::PATCH
     PRE = nil unless defined? Twitter::Version::PRE
 
     class << self

data/spec/twitter/api/friends_and_followers_spec.rb

@@ -668,4 +668,23 @@ describe Twitter::API::FriendsAndFollowers do
     end
   end
 
+  describe "#no_retweet_ids" do
+    before do
+      stub_get("/1.1/friendships/no_retweets/ids.json").to_return(:body => fixture("ids.json"), :headers => {:content_type => "application/json; charset=utf-8"})
+    end
+    it "requests the correct resource" do
+      @client.no_retweet_ids
+      expect(a_get("/1.1/friendships/no_retweets/ids.json")).to have_been_made
+    end
+    it "requests the correct resource when the alias is called" do
+      @client.no_retweets_ids
+      expect(a_get("/1.1/friendships/no_retweets/ids.json")).to have_been_made
+    end
+    it "returns users ids of those that do not wish to be retweeted" do
+      no_retweet_ids = @client.no_retweet_ids
+      expect(no_retweet_ids).to be_an Array
+      expect(no_retweet_ids.first).to be_an Integer
+      expect(no_retweet_ids.first).to eq 47
+    end
+  end
 end

data/twitter.gemspec

@@ -5,9 +5,6 @@ Gem::Specification.new do |spec|
   spec.add_dependency 'faraday',      ['~> 0.8', '< 0.10']
   spec.add_dependency 'multi_json',   ['~> 1.0']
   spec.add_dependency 'simple_oauth', ['~> 0.2']
-  spec.add_development_dependency 'kramdown'
-  spec.add_development_dependency 'pry'
-  spec.add_development_dependency 'simplecov'
   spec.authors = ["John Nunemaker", "Wynn Netherland", "Erik Michaels-Ober", "Steve Richert"]
   spec.description = %q{A Ruby interface to the Twitter API.}
   spec.email = ['nunemaker@gmail.com', 'wynn.netherland@gmail.com', 'sferik@gmail.com', 'steve.richert@gmail.com']

metadata

@@ -2,7 +2,7 @@
 name: twitter
 version: !ruby/object:Gem::Version
   prerelease: 
-  version: 4.4.4
+  version: 4.5.0
 platform: ruby
 authors:
 - John Nunemaker
@@ -12,9 +12,10 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-10 00:00:00.000000000 Z
+date: 2013-01-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
@@ -24,9 +25,8 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '0.10'
     none: false
-  name: faraday
   type: :runtime
-  prerelease: false
+  name: faraday
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
@@ -37,15 +37,15 @@ dependencies:
         version: '0.10'
     none: false
 - !ruby/object:Gem::Dependency
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '1.0'
     none: false
-  name: multi_json
   type: :runtime
-  prerelease: false
+  name: multi_json
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
@@ -53,69 +53,21 @@ dependencies:
         version: '1.0'
     none: false
 - !ruby/object:Gem::Dependency
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '0.2'
     none: false
-  name: simple_oauth
   type: :runtime
-  prerelease: false
+  name: simple_oauth
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '0.2'
     none: false
-- !ruby/object:Gem::Dependency
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-    none: false
-  name: kramdown
-  type: :development
-  prerelease: false
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-    none: false
-- !ruby/object:Gem::Dependency
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-    none: false
-  name: pry
-  type: :development
-  prerelease: false
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-    none: false
-- !ruby/object:Gem::Dependency
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-    none: false
-  name: simplecov
-  type: :development
-  prerelease: false
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-    none: false
 description: A Ruby interface to the Twitter API.
 email:
 - nunemaker@gmail.com
@@ -376,7 +328,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.23
+rubygems_version: 1.8.25
 signing_key: 
 specification_version: 3
 summary: A Ruby interface to the Twitter API.