gnip-stream is a ruby library to connect and stream data from GNIP. It utilizes EventMachine and threads under the hood to provide a true streaming experience without you having to worry about writing non blocking code.
Installing gnip-stream is easy. Simply run
gem install gnip-stream or add the following line to your
gem 'gnip-stream', :git => "https://github.com/eriwen/gnip-stream"
require 'gnip-stream' ### To connect to the special twitter powertrack api twitter_stream = GnipStream::PowertrackClient.new("http://yourstreamingurl.gnip.com", "someuser", "password") twitter_stream.consume do |message| #process the message however you want puts message end ### To Connect to the Facebook API facebook_stream = GnipStream::FacebookClient.new("http://yourstreamingurl.gnip.com", "someuser", "password") facebook_stream.consume do |message| puts message end
This gem is tested to be compatible with:
- MRI 1.8.7, 1.9.x, 2.0.0
- JRuby 1.7.0
- Rubinius 2.0.0dev
When submitting pull requests, please do the following to make it easier to incorporate your changes:
- Include unit and/or functional specs that validate changes you're making.
- Rebase your changes onto the HEAD of my fork if you can do so cleanly.
- If submitting additional functionality, provide an example of how to use it.
- Please keep code style consistent with surrounding code.
You can run all tests by simply running
bundle exec rake test from your favorite shell.
##License MIT. See LICENSE file for more details.
Special thanks to Sharethrough