Switch branches/tags
Nothing to show
Find file
Fetching contributors…
Cannot retrieve contributors at this time
77 lines (55 sloc) 1.9 KB


This is an attempt at a Twitter API implementation on top of Sinatra. This is for all the people that experience Twitter purely through one or more of the great clients on top of it.

SUPER alpha, ruby API will probably change!


The public API that you should be concerned with is the Sinatra API. Similar to how Sinatra lets you respond to HTTP requests, this lets you respond to Twitter requests

require 'sinatra'
require 'twitter_server'

get '/' do
  'hello world'

twitter_statuses_home_timeline do |params|

The Sinatra Extension API is used, so you can also create separate Sinatra classes and mount them separately.

require 'sinatra/base'
require 'twitter_server'

class MyTwitterApp < Sinatra::Base
  register Sinatra::TwitterServer

  get '/' do
    'hello world'

  twitter_statuses_home_timeline do |params|


  • Wrap a blogging service (see Wordpress, Tumblr)

  • Get up-to-date event notifications on internal systems

  • Uh yes, clone Twitter. You can probably rewrite it in a weekend :)

See demo/faker_server.rb for an in-memory, randomly generated, read-only twitter server.


not implemented

  • XML/JSON parsing

  • Better XML/JSON/ATOM/RSS rendering

  • handle basic auth and oauth

  • cleanup pluggable renderers

  • gem packaging

Note on Patches/Pull Requests

  • Fork the project.

  • Make your feature addition or bug fix.

  • Add tests for it. This is important so I don't break it in a future version unintentionally.

  • Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)

  • Send me a pull request. Bonus points for topic branches.


Copyright © 2009 rick. See LICENSE for details.