Class: Twitter::Base

Inherits:
Object
  • Object
show all
Extended by:
Forwardable
Defined in:
lib/twitter/base.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(client) ⇒ Base

Returns a new instance of Base.



9
10
11
 
# File 'lib/twitter/base.rb', line 9

def initialize(client)
  @client = client
end

Instance Attribute Details

#client ⇒ Object (readonly)

Returns the value of attribute client.



7
8
9
 
# File 'lib/twitter/base.rb', line 7

def client
  @client
end

Instance Method Details

#block(id) ⇒ Object 



222
223
224
 
# File 'lib/twitter/base.rb', line 222

def block(id)
  perform_post("/#{API_VERSION}/blocks/create/#{id}.json")
end

#blocked_ids ⇒ Object 



305
306
307
 
# File 'lib/twitter/base.rb', line 305

def blocked_ids
  perform_get("/#{API_VERSION}/blocks/blocking/ids.json", :mash => false)
end

#blocking(options = {}) ⇒ Object 



309
310
311
 
# File 'lib/twitter/base.rb', line 309

def blocking(options={})
  perform_get("/#{API_VERSION}/blocks/blocking.json", options)
end

#direct_message_create(user, text) ⇒ Object 



129
130
131
 
# File 'lib/twitter/base.rb', line 129

def direct_message_create(user, text)
  perform_post("/#{API_VERSION}/direct_messages/new.json", :body => {:user => user, :text => text})
end

#direct_message_destroy(id) ⇒ Object 



133
134
135
 
# File 'lib/twitter/base.rb', line 133

def direct_message_destroy(id)
  perform_post("/#{API_VERSION}/direct_messages/destroy/#{id}.json")
end

#direct_messages(query = {}) ⇒ Object

Options: since, since_id, page



120
121
122
 
# File 'lib/twitter/base.rb', line 120

def direct_messages(query={})
  perform_get("/#{API_VERSION}/direct_messages.json", :query => query)
end

#direct_messages_sent(query = {}) ⇒ Object

Options: since, since_id, page



125
126
127
 
# File 'lib/twitter/base.rb', line 125

def direct_messages_sent(query={})
  perform_get("/#{API_VERSION}/direct_messages/sent.json", :query => query)
end

#disable_notifications(id) ⇒ Object 



218
219
220
 
# File 'lib/twitter/base.rb', line 218

def disable_notifications(id)
  perform_post("/#{API_VERSION}/notifications/leave/#{id}.json")
end

#enable_notifications(id) ⇒ Object 



214
215
216
 
# File 'lib/twitter/base.rb', line 214

def enable_notifications(id)
  perform_post("/#{API_VERSION}/notifications/follow/#{id}.json")
end

#favorite_create(id) ⇒ Object 



206
207
208
 
# File 'lib/twitter/base.rb', line 206

def favorite_create(id)
  perform_post("/#{API_VERSION}/favorites/create/#{id}.json")
end

#favorite_destroy(id) ⇒ Object 



210
211
212
 
# File 'lib/twitter/base.rb', line 210

def favorite_destroy(id)
  perform_post("/#{API_VERSION}/favorites/destroy/#{id}.json")
end

#favorites(query = {}) ⇒ Object

Options: id, page



202
203
204
 
# File 'lib/twitter/base.rb', line 202

def favorites(query={})
  perform_get("/#{API_VERSION}/favorites.json", :query => query)
end

#follower_ids(query = {}) ⇒ Object

Options: id, user_id, screen_name



161
162
163
 
# File 'lib/twitter/base.rb', line 161

def follower_ids(query={})
  perform_get("/#{API_VERSION}/followers/ids.json", :query => query)
end

#followers(query = {}) ⇒ Object

Options: id, user_id, screen_name, page



90
91
92
 
# File 'lib/twitter/base.rb', line 90

def followers(query={})
  perform_get("/#{API_VERSION}/statuses/followers.json", :query => query)
end

#friend_ids(query = {}) ⇒ Object

Options: id, user_id, screen_name



156
157
158
 
# File 'lib/twitter/base.rb', line 156

def friend_ids(query={})
  perform_get("/#{API_VERSION}/friends/ids.json", :query => query)
end

#friends(query = {}) ⇒ Object

Options: id, user_id, screen_name, page



85
86
87
 
# File 'lib/twitter/base.rb', line 85

def friends(query={})
  perform_get("/#{API_VERSION}/statuses/friends.json", :query => query)
end

#friends_timeline(query = {}) ⇒ Object

Options: since_id, max_id, count, page, since



19
20
21
 
# File 'lib/twitter/base.rb', line 19

def friends_timeline(query={})
  perform_get("/#{API_VERSION}/statuses/friends_timeline.json", :query => query)
end

#friendship_create(id, follow = false) ⇒ Object 



137
138
139
140
141
 
# File 'lib/twitter/base.rb', line 137

def friendship_create(id, follow=false)
  body = {}
  body.merge!(:follow => follow) if follow
  perform_post("/#{API_VERSION}/friendships/create/#{id}.json", :body => body)
end

#friendship_destroy(id) ⇒ Object 



143
144
145
 
# File 'lib/twitter/base.rb', line 143

def friendship_destroy(id)
  perform_post("/#{API_VERSION}/friendships/destroy/#{id}.json")
end

#friendship_exists?(a, b) ⇒ Boolean

Returns:

  • (Boolean) 


147
148
149
 
# File 'lib/twitter/base.rb', line 147

def friendship_exists?(a, b)
  perform_get("/#{API_VERSION}/friendships/exists.json", :query => {:user_a => a, :user_b => b})
end

#friendship_show(query) ⇒ Object 



151
152
153
 
# File 'lib/twitter/base.rb', line 151

def friendship_show(query)
  perform_get("/#{API_VERSION}/friendships/show.json", :query => query)
end

#help ⇒ Object 



230
231
232
 
# File 'lib/twitter/base.rb', line 230

def help
  perform_get("/#{API_VERSION}/help/test.json")
end

#home_timeline(query = {}) ⇒ Object

Options: since_id, max_id, count, page



14
15
16
 
# File 'lib/twitter/base.rb', line 14

def home_timeline(query={})
  perform_get("/#{API_VERSION}/statuses/home_timeline.json", :query => query)
end

#is_list_member?(list_owner_username, slug, id) ⇒ Boolean

Returns:

  • (Boolean) 


285
286
287
 
# File 'lib/twitter/base.rb', line 285

def is_list_member?(list_owner_username, slug, id)
  perform_get("/#{API_VERSION}/#{list_owner_username}/#{slug}/members/#{id}.json").error.nil?
end

#list(list_owner_username, slug) ⇒ Object 



257
258
259
 
# File 'lib/twitter/base.rb', line 257

def list(list_owner_username, slug)
  perform_get("/#{API_VERSION}/#{list_owner_username}/lists/#{slug}.json")
end

#list_add_member(list_owner_username, slug, new_id) ⇒ Object 



277
278
279
 
# File 'lib/twitter/base.rb', line 277

def list_add_member(list_owner_username, slug, new_id)
  perform_post("/#{API_VERSION}/#{list_owner_username}/#{slug}/members.json", :body => {:id => new_id})
end

#list_create(list_owner_username, options) ⇒ Object 



234
235
236
 
# File 'lib/twitter/base.rb', line 234

def list_create(list_owner_username, options)
  perform_post("/#{API_VERSION}/#{list_owner_username}/lists.json", :body => {:user => list_owner_username}.merge(options))
end

#list_delete(list_owner_username, slug) ⇒ Object 



242
243
244
 
# File 'lib/twitter/base.rb', line 242

def list_delete(list_owner_username, slug)
  perform_delete("/#{API_VERSION}/#{list_owner_username}/lists/#{slug}.json")
end

#list_members(list_owner_username, slug, cursor = nil) ⇒ Object 



271
272
273
274
275
 
# File 'lib/twitter/base.rb', line 271

def list_members(list_owner_username, slug, cursor = nil)
  query = {}
  query[:cursor] = cursor if cursor
  perform_get("/#{API_VERSION}/#{list_owner_username}/#{slug}/members.json", :query => query)
end

#list_remove_member(list_owner_username, slug, id) ⇒ Object 



281
282
283
 
# File 'lib/twitter/base.rb', line 281

def list_remove_member(list_owner_username, slug, id)
  perform_delete("/#{API_VERSION}/#{list_owner_username}/#{slug}/members.json", :query => {:id => id})
end

#list_subscribe(list_owner_username, slug) ⇒ Object 



293
294
295
 
# File 'lib/twitter/base.rb', line 293

def list_subscribe(list_owner_username, slug)
  perform_post("/#{API_VERSION}/#{list_owner_username}/#{slug}/subscribers.json")
end

#list_subscribers(list_owner_username, slug) ⇒ Object 



289
290
291
 
# File 'lib/twitter/base.rb', line 289

def list_subscribers(list_owner_username, slug)
  perform_get("/#{API_VERSION}/#{list_owner_username}/#{slug}/subscribers.json")
end

#list_subscriptions(list_owner_username) ⇒ Object 



301
302
303
 
# File 'lib/twitter/base.rb', line 301

def list_subscriptions(list_owner_username)
  perform_get("/#{API_VERSION}/#{list_owner_username}/lists/subscriptions.json")
end

#list_timeline(list_owner_username, slug, query = {}) ⇒ Object

:per_page = max number of statues to get at once :page = which page of tweets you wish to get



263
264
265
 
# File 'lib/twitter/base.rb', line 263

def list_timeline(list_owner_username, slug, query = {})
  perform_get("/#{API_VERSION}/#{list_owner_username}/lists/#{slug}/statuses.json", :query => query)
end

#list_unsubscribe(list_owner_username, slug) ⇒ Object 



297
298
299
 
# File 'lib/twitter/base.rb', line 297

def list_unsubscribe(list_owner_username, slug)
  perform_delete("/#{API_VERSION}/#{list_owner_username}/#{slug}/subscribers.json")
end

#list_update(list_owner_username, slug, options) ⇒ Object 



238
239
240
 
# File 'lib/twitter/base.rb', line 238

def list_update(list_owner_username, slug, options)
  perform_put("/#{API_VERSION}/#{list_owner_username}/lists/#{slug}.json", :body => options)
end

#lists(list_owner_username = nil, cursor = nil) ⇒ Object 



246
247
248
249
250
251
252
253
254
255
 
# File 'lib/twitter/base.rb', line 246

def lists(list_owner_username = nil, cursor = nil)
  if list_owner_username
    path = "/#{API_VERSION}/#{list_owner_username}/lists.json"
  else
    path = "/#{API_VERSION}/lists.json"
  end
  query = {}
  query[:cursor] = cursor if cursor
  perform_get(path, :query => query)
end

#memberships(list_owner_username, query = {}) ⇒ Object 



267
268
269
 
# File 'lib/twitter/base.rb', line 267

def memberships(list_owner_username, query={})
  perform_get("/#{API_VERSION}/#{list_owner_username}/lists/memberships.json", :query => query)
end

#mentions(query = {}) ⇒ Object

Options: since_id, max_id, count, page



51
52
53
 
# File 'lib/twitter/base.rb', line 51

def mentions(query={})
  perform_get("/#{API_VERSION}/statuses/mentions.json", :query => query)
end

#rate_limit_status ⇒ Object 



191
192
193
 
# File 'lib/twitter/base.rb', line 191

def rate_limit_status
  perform_get("/#{API_VERSION}/account/rate_limit_status.json")
end

#replies(query = {}) ⇒ Object

DEPRECATED: Use #mentions instead

Options: since_id, max_id, since, page



45
46
47
48
 
# File 'lib/twitter/base.rb', line 45

def replies(query={})
  warn("DEPRECATED: #replies is deprecated by Twitter; use #mentions instead")
  perform_get("/#{API_VERSION}/statuses/replies.json", :query => query)
end

#retweet(id) ⇒ Object 



80
81
82
 
# File 'lib/twitter/base.rb', line 80

def retweet(id)
  perform_post("/#{API_VERSION}/statuses/retweet/#{id}.json")
end

#retweeted_by_me(query = {}) ⇒ Object

Options: since_id, max_id, count, page



56
57
58
 
# File 'lib/twitter/base.rb', line 56

def retweeted_by_me(query={})
  perform_get("/#{API_VERSION}/statuses/retweeted_by_me.json", :query => query)
end

#retweeted_to_me(query = {}) ⇒ Object

Options: since_id, max_id, count, page



61
62
63
 
# File 'lib/twitter/base.rb', line 61

def retweeted_to_me(query={})
  perform_get("/#{API_VERSION}/statuses/retweeted_to_me.json", :query => query)
end

#retweeters_of(id, options = {}) ⇒ Object

options: count, page, ids_only



71
72
73
74
 
# File 'lib/twitter/base.rb', line 71

def retweeters_of(id, options={})
  ids_only = !!(options.delete(:ids_only))
  perform_get("/#{API_VERSION}/statuses/#{id}/retweeted_by#{"/ids" if ids_only}.json", :query => options)
end

#retweets(id, query = {}) ⇒ Object

Options: count



33
34
35
 
# File 'lib/twitter/base.rb', line 33

def retweets(id, query={})
  perform_get("/#{API_VERSION}/statuses/retweets/#{id}.json", :query => query)
end

#retweets_of_me(query = {}) ⇒ Object

Options: since_id, max_id, count, page



66
67
68
 
# File 'lib/twitter/base.rb', line 66

def retweets_of_me(query={})
  perform_get("/#{API_VERSION}/statuses/retweets_of_me.json", :query => query)
end

#status(id) ⇒ Object 



28
29
30
 
# File 'lib/twitter/base.rb', line 28

def status(id)
  perform_get("/#{API_VERSION}/statuses/show/#{id}.json")
end

#status_destroy(id) ⇒ Object 



76
77
78
 
# File 'lib/twitter/base.rb', line 76

def status_destroy(id)
  perform_post("/#{API_VERSION}/statuses/destroy/#{id}.json")
end

#unblock(id) ⇒ Object 



226
227
228
 
# File 'lib/twitter/base.rb', line 226

def unblock(id)
  perform_post("/#{API_VERSION}/blocks/destroy/#{id}.json")
end

#update(status, query = {}) ⇒ Object

Options: in_reply_to_status_id



38
39
40
 
# File 'lib/twitter/base.rb', line 38

def update(status, query={})
  perform_post("/#{API_VERSION}/statuses/update.json", :body => {:status => status}.merge(query))
end

#update_delivery_device(device) ⇒ Object

Device must be sms, im or none



170
171
172
 
# File 'lib/twitter/base.rb', line 170

def update_delivery_device(device)
  perform_post("/#{API_VERSION}/account/update_delivery_device.json", :body => {:device => device})
end

#update_profile(body = {}) ⇒ Object

One or more of the following must be present:

name, email, url, location, description



197
198
199
 
# File 'lib/twitter/base.rb', line 197

def update_profile(body={})
  perform_post("/#{API_VERSION}/account/update_profile.json", :body => body)
end

#update_profile_background(file, tile = false) ⇒ Object

file should respond to #read and #path



187
188
189
 
# File 'lib/twitter/base.rb', line 187

def update_profile_background(file, tile = false)
  perform_post("/#{API_VERSION}/account/update_profile_background_image.json", build_multipart_bodies(:image => file).merge(:tile => tile))
end

#update_profile_colors(colors = {}) ⇒ Object

One or more of the following must be present:

profile_background_color, profile_text_color, profile_link_color,
profile_sidebar_fill_color, profile_sidebar_border_color



177
178
179
 
# File 'lib/twitter/base.rb', line 177

def update_profile_colors(colors={})
  perform_post("/#{API_VERSION}/account/update_profile_colors.json", :body => colors)
end

#update_profile_image(file) ⇒ Object

file should respond to #read and #path



182
183
184
 
# File 'lib/twitter/base.rb', line 182

def update_profile_image(file)
  perform_post("/#{API_VERSION}/account/update_profile_image.json", build_multipart_bodies(:image => file))
end

#user(id, query = {}) ⇒ Object 



94
95
96
 
# File 'lib/twitter/base.rb', line 94

def user(id, query={})
  perform_get("/#{API_VERSION}/users/show/#{id}.json", :query => query)
end

#user_search(q, query = {}) ⇒ Object

Options: page, per_page



114
115
116
117
 
# File 'lib/twitter/base.rb', line 114

def user_search(q, query={})
  q = URI.escape(q)
  perform_get("/#{API_VERSION}/users/search.json", :query => ({:q => q}.merge(query)))
end

#user_timeline(query = {}) ⇒ Object

Options: id, user_id, screen_name, since_id, max_id, page, since, count



24
25
26
 
# File 'lib/twitter/base.rb', line 24

def user_timeline(query={})
  perform_get("/#{API_VERSION}/statuses/user_timeline.json", :query => query)
end

#users(*ids_or_usernames) ⇒ Object 



98
99
100
101
102
103
104
105
106
107
108
109
110
111
 
# File 'lib/twitter/base.rb', line 98

def users(*ids_or_usernames)
  ids, usernames = [], []
  ids_or_usernames.each do |id_or_username|
    if id_or_username.is_a?(Integer)
      ids << id_or_username
    elsif id_or_username.is_a?(String)
      usernames << id_or_username
    end
  end
  query = {}
  query[:user_id] = ids.join(",") unless ids.empty?
  query[:screen_name] = usernames.join(",") unless usernames.empty?
  perform_get("/#{API_VERSION}/users/lookup.json", :query => query)
end

#verify_credentials ⇒ Object 



165
166
167
 
# File 'lib/twitter/base.rb', line 165

def verify_credentials
  perform_get("/#{API_VERSION}/account/verify_credentials.json")
end