README

===============================
Introduction
===============================

cascading.utils is an open source set of utilities for Cascading workflows that we
use here at Scale Unlimited for the Bixo Java web mining toolkit and other projects.
There are classes that wrap Cascading Tuples with "datum" objects, a few utility classes
such as TupleLogger and SplitterAssembly, some classes to help monitor running
workflows, etc.

cascading.utils is licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

===============================
Building
===============================

You need Apache Ant 1.7 or higher. 

To get a list of valid targets:

% cd <project directory>
% ant -p

To  clean and build a jar (which also runs all tests):

% ant clean jar

Note that "ant clean test jar" will currently fail, due to a bug in the maven ant task
plugin used for managing dependencies.

To create Eclipse project files:

% ant eclipse

Then, from Eclipse follow the standard procedure to import an existing Java project into your Workspace.