fauna / scribe

A Ruby client for Scribe.

This URL has Read+Write access

scribe /
name age
history
message
file CHANGELOG Wed Oct 28 12:12:55 -0700 2009 Set strict_read to false. [Evan Weaver]
file LICENSE Wed Sep 30 11:59:59 -0700 2009 Boilerplate. [Evan Weaver]
file Manifest Tue Oct 13 21:36:05 -0700 2009 New API etc. [Evan Weaver]
file README Wed Sep 30 13:42:07 -0700 2009 README. [Evan Weaver]
file Rakefile Tue Oct 13 21:18:31 -0700 2009 Use ThriftClient gem. [Evan Weaver]
directory conf/ Thu Oct 01 15:52:04 -0700 2009 Append newlines by default. [Evan Weaver]
directory lib/ Wed Oct 28 12:12:55 -0700 2009 Set strict_read to false. [Evan Weaver]
directory test/ Wed Sep 30 13:38:11 -0700 2009 Tests need a sleep. It works! [Evan Weaver]
directory vendor/ Wed Sep 30 11:55:24 -0700 2009 Thrift bindings. [Evan Weaver]
README
scribe

A Ruby client for the Scribe distributed log server.

== License

Copyright 2009 Twitter, Inc. See included LICENSE file.

The public certificate for this gem is 
here[http://rubyforge.org/frs/download.php/25331/evan_weaver-original-public_cert.pem].

== Features

* clean encapsulation of the Thrift API
* Ruby 1.9 compatibility

The Github source repository is {here}[http://github.com/fauna/scribe/]. Patches and contributions are very welcome.

== Installation

You need Ruby 1.8 or 1.9. If you have those, just run:

  sudo gem install scribe

== Usage

Now, start IRb and require the library:

  require 'scribe'

Connect to a server:

  client = Scribe.new('127.0.0.1')

Log a line:

  client.log("started up")

Log a line with a category:

  client.log("my app started up", "MyApp")

Batch a number of log lines and send them all at once:

  client.batch do
    client.log("booting")
    client.log("loading data")
    client.log("success!")
  end
  
That is all.

== Reporting problems

The Github issue tracker is {here}[http://github.com/fauna/scribe/issues]. If you have problems with Scribe itself, 
please use the {scribe-users mailing list}[http://sourceforge.net/mailarchive/forum.php?forum_name=scribeserver-users].