The source-code to Gizzard is on github: http://github.com/twitter/gizzard.
A sample application that uses Gizzard, called Rowz, is also available: http://github.com/nkallen/Rowz. The best way to get started with Gizzard is to clone Rowz and customize.
We use sbt to build:
$ sbt clean update package-dist
but there are some pre-requisites. You need:
- java 1.6
- sbt 0.7.4
- thrift 0.2.0
If you haven't used sbt before, this page has a quick setup:
http://code.google.com/p/simple-build-tool/wiki/Setup.
My ~/bin/sbt looks like this:
#!/bin/bash
java -server -XX:+CMSClassUnloadingEnabled -XX:MaxPermSize=256m -Xmx1024m -jar `dirname $0`/sbt-launch-0.7.4.jar "$@"
Apache Thrift 0.2.0 is pre-requisite for building java stubs of the thrift IDL. It can't be installed via jar, so you'll need to install it separately before you build. It can be found on the apache incubator site: http://incubator.apache.org/thrift/. This project is still getting its legs, so it can be hard to find the right version. If you have trouble with the mirrors, version 0.2.0 should be hosted here: http://www.apache.org/dist/incubator/thrift/0.2.0-incubating/.
In addition, the tests require a local MySQL instance to be running, and for
DB_USERNAME and DB_PASSWORD environment variables to contain login info
for it.
The sbt build should download any missing jars using ivy (which is ant's
implementation of the maven dependency fetcher) and build a jar in dist/.
<dependency>
<groupId>com.twitter</groupId>
<artifactId>gizzard</artifactId>
<version>1.0</version>
</dependency>
It may require you to add the "scala-tools" maven repo to your repo list. The nest repo is located here:
http://scala-tools.org/repo-releases/
val gizzard = "com.twitter" % "gizzard" % "1.5.0"
You will need to add a reference to the "scala-tools" repo if it isn't already there:
val scalaToolsReleases = "scala-tools.org" at "http://scala-tools.org/repo-releases/"
The Github issue tracker is here.
The google-groups mailing list is here.