Project

rack-smoke

0.0
No commit activity in last 3 years
No release in over 3 years
Expose Smoke sources and transcode them into JSON, XML or YAML
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

>= 0
>= 0.5.19
 Project Readme

rack-smoke

Rack::Smoke allows you to expose Smoke sources and transcode them into JSON, XML or YAML.

What are the benefits?

  • Pluggable caching, cache remote web services and rely on your own infrastructure
  • Join Smoke sources together, reinterpret them, then offer them as a simple web service

Rack::Smoke gives you a bunch of HTML screens (found at /smoke) that outline the Smoke sources that are found within your current environment. Rack::Smoke home screen

From there, you'll be able to see the formats that you can get the stream in, or if they require any additional query strings. Twitter source details

Smoke?

Smoke allows you to take single serve sources from around the web. Then it does a bunch of smart stuff like automagically transferring as gzip, request caching and understands the content that it gets back. YQL, Atom / RSS feeds, json and xml are all converted to ruby arrays.

Smoke-rack allows you to transcode that information and provide an API like layer of your own.

How do I include it in my project?

# config.ru
require 'rubygems'

# Ensure your app has some Smoke sources
require 'your-app'

require 'rack-smoke'
use Rack::Smoke

run Sinatra::Application

Then navigate to localhost:PORT/smoke to get a list of available sources

Installation

gem install rack-smoke

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

Copyright (c) 2010 Ben Schwarz. See LICENSE for details.