Skip to content

Commit

Permalink
Add Users#contributors method
Browse files Browse the repository at this point in the history
  • Loading branch information
sferik committed Sep 5, 2011
1 parent 7aba6b3 commit 1bb9f20
Show file tree
Hide file tree
Showing 5 changed files with 946 additions and 1 deletion.
40 changes: 39 additions & 1 deletion lib/twitter/client/user.rb
Original file line number Diff line number Diff line change
Expand Up @@ -238,7 +238,7 @@ def recommendations(options={})
format.to_s.downcase == 'xml' ? response['userrecommendations'] : response
end

# Returns users the specified user can contribute to.
# Returns an array of users that the specified user can contribute to
#
# @see http://dev.twitter.com/docs/api/1/get/users/contributees
# @rate_limited Yes
Expand Down Expand Up @@ -275,6 +275,44 @@ def contributees(*args)
end
format.to_s.downcase == 'xml' ? response['users'] : response
end

# Returns an array of users who can contribute to the specified account
#
# @see http://dev.twitter.com/docs/api/1/get/users/contributors
# @rate_limited Yes
# @requires_authentication No unless requesting it from a protected user
#
# If getting this data of a protected user, you must authenticate (and be allowed to see that user).
# @response_format `json`
# @response_format `xml`
# @overload contributors(options={})
# @param options [Hash] A customizable set of options.
# @option options [Boolean, String, Integer] :include_entities Include {http://dev.twitter.com/pages/tweet_entities Tweet Entities} when set to true, 't' or 1.
# @option options [Boolean, String, Integer] :skip_status Do not include contributee's statuses when set to true, 't' or 1.
# @return [Array]
# @example Return the authenticated user's contributors
# Twitter.contributors
## @overload contributors(user, options={})
# @param user [Integer, String] A Twitter user ID or screen name.
# @param options [Hash] A customizable set of options.
# @option options [Boolean, String, Integer] :include_entities Include {http://dev.twitter.com/pages/tweet_entities Tweet Entities} when set to true, 't' or 1.
# @option options [Boolean, String, Integer] :skip_status Do not include contributee's statuses when set to true, 't' or 1.
# @return [Array]
# @example Return users who can contribute to @sferik's account
# Twitter.contributors("sferik")
# Twitter.contributors(7505382) # Same as above
def contributors(*args)
options = {}
options.merge!(args.last.is_a?(Hash) ? args.pop : {})
user = args.pop || get_screen_name
if user
merge_user_into_options!(user, options)
response = get('1/users/contributors', options)
else
response = get('1/users/contributors', options)
end
format.to_s.downcase == 'xml' ? response['users'] : response
end
end
end
end
1 change: 1 addition & 0 deletions spec/fixtures/contributors.json

Large diffs are not rendered by default.

Loading

0 comments on commit 1bb9f20

Please sign in to comment.