0.01
No commit activity in last 3 years
No release in over 3 years
Yet another Twitter API wrapper library in Ruby
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

>= 1.1
>= 0.3.4
 Project Readme

Tuiter¶ ↑

Tuiter was design and developed by Manoel Lemos to provide access to the Twitter API. It was developed for the experimental project called Tuitersfera Brasil, an application to monitor the Twitter usage in Brazil.

Both Tuiter and Tuitersfera were adopted, further developed and maintained by Webco Internet.

Instalation¶ ↑

Tuiter is avaliable as a gem on Rubyforge, so you can easily install using rubygems:

gem install tuiter

Although it is recommended to use the gem published on Rubyforge, tuiter is also avaliable at Github. This might be useful if you want to experiment with forks or live on the bleeding edge.

To install the Github version, simply run on a console:

gem install webco-tuiter --source=http://gems.github.com

If you already have Github gem repository on you gem source, you can leave the source part out.

Basic Usage¶ ↑

require 'tuiter'
client = Tuiter::Client.new(:username => '<twitter_login>', :password => '<twitter_pwd>')

client.update('Hey Ho, Twitters!')

There are (or at least we want to add :-) another examples in the examples/ folder.

Using OAuth¶ ↑

require ‘tuiter’ client = Tuiter::Client.new(:authentication => :oauth, :consumer_key => ‘YOUR_KEY’, :consumer_secret => ‘YOUR_SECRET’)

# request token from Twitter rtoken = client.request_token # waits for token # stores token and secret token, secret = rtoken.token, rtoken.secret # you could store this on session, db, etc # redirect to authorize url rtoken.authorize_url # user authenticate in twitter domains # the code below goes in the callback accessed by Twitter access_token = client.authorize(token,secret) # checks if everything’s ok if client.authorized? # have fun 15.times do client.update(‘All work and no play makes Jack a dull boy’) end end If you already have the token and secret of the user (from database, for example), you just have to do the following to authenticate them:

client = Tuiter::Client.new(:authentication => :oauth, :consumer_key => ‘YOUR_KEY’, :consumer_secret => ‘YOUR_SECRET’, :token => token, :secret => secret) if client.authorized? # have fun 15.times do client.update(‘All work and no play makes Jack a dull boy’) end end

Register your Twitter client at twitter.com/oauth_clients

Roadmap and TO-DO list¶ ↑

Check out the library roadmap and to-do list in the project wiki