twitter/cascading

Name: cascading

Owner: Twitter, Inc.

Description: Cascading is a feature rich API for defining and executing complex and fault tolerant data processing workflows on a Hadoop cluster.

Created: 2013-04-18 15:51:08.0

Updated: 2017-11-08 01:33:19.0

Pushed: 2016-02-20 00:58:54.0

Homepage: http://www.cascading.org/

Size: 17387

Language: Java

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

Cascading

Thanks for using Cascading.

General Information:

For project documentation and community support, visit: cascading.org

To download a pre-built distribution, visit http://www.cascading.org/downloads/, or use Maven (described below).

The distribution includes four Cascading jar files:

These class jars, along with, tests, source and javadoc jars, are all available via the Conjars.org Maven repository.

Hadoop mode is where the Cascading application should run on a Hadoop cluster.

Local mode is where the Cascading application will run locally in memory without any Hadoop dependenices.

Versioning

Cascading stable releases are always of the form x.y.z, where z is the current maintenance release.

The source and tags for all stable releases can be found here: https://github.com/Cascading/cascading

WIP (work in progress) releases are fully tested builds of code not yet deemed fully stable. On every build by our continuous integration servers, the WIP build number is increased. Successful builds are then tagged and published.

The WIP releases are always of the form x.y.z-wip-n, where x.y.z will be the next stable release version the WIP releases are leading up to. n is the current successfully tested build.

The source, working branches, and tags for all WIP releases can be found here: https://github.com/cwensel/cascading

When a WIP is deemed stable and ready for production use, it will be published as a x.y.z release.

Using with Maven/Ivy

It is strongly recommended developers pull Cascading from our Maven compatible jar repository Conjars.org.

You can find the latest public and wip (work in progress) releases here:

When creating tests, make sure to add any of the relevant above dependencies to your “test” scope or equivalent configuration along with the cascading-platform dependency.

Note the cascading-plaform compile dependency has no classes, you must pull the tests dependency with the “tests” classifier.

See http://www.cascading.org/downloads/#maven for example Maven pom dependency settings.

Source and Javadoc artifacts (using the appropriate classifier) are also available through Conjars.

Note that cascading-hadoop has a “provided” dependency on the Hadoop jars so that it won't get sucked into any application packaging as a dependency, typically.

Building:

To build Cascading, run the following in the shell:

t clone https://github.com/cascading/cascading.git
 cascading
adle build

Cascading currently requires Gradle 1.0.

To use an IDE like IntelliJ, run the following to get create IntelliJ module files:

adle ideaModule
Using with Apache Hadoop:

To use Cascading with Hadoop, we suggest stuffing cascading-core, cascading-hadoop, (optionally) cascading-xml jarfiles and all third-party libs into the lib folder of your job jar and executing your job via $HADOOP_HOME/bin/hadoop jar your.jar <your args>.

For example, your job jar would look like this (via: jar -t your.jar)

l your class and resource files>
/cascading-core-x.y.z.jar
/cascading-hadoop-x.y.z.jar
/cascading-xml-x.y.z.jar
/<cascading third-party jar files>

Hadoop will unpack the jar locally and remotely (in the cluster) and add any libraries in lib to the classpath. This is a feature specific to Hadoop.


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.