Skip to content
This repository has been archived by the owner on Jul 30, 2024. It is now read-only.

snowplow-archive/sluice

Repository files navigation

Sluice

Gem Version Build Status Code Climate Coverage Status License

Sluice is a Ruby gem (built with Bundler bundler) to help you build cloud-friendly ETL (extract, transform, load) processes.

Currently Sluice provides the following very robust, very parallel S3 operations:

  • File upload to S3
  • File download from S3
  • File delete from S3
  • File move within S3 (from/to the same or different AWS accounts)
  • File copy within S3 (from/to the same or different AWS accounts; optionally using a manifest)

Sluice has been extracted from a pair of Ruby ETL applications built by the [Snowplow Analytics] snowplow-analytics team, specifically:

  1. [EmrEtlRunner] emr-etl-runner, a Ruby application to run the Snowplow ETL process on Elastic MapReduce
  2. [StorageLoader] storage-loader, a Ruby application to load Snowplow event files from Amazon S3 into databases such as Redshift and Postgres

Installation

$ gem install sluice

Or in your Gemfile:

gem 'sluice', '~> 0.4.0'

Usage

Rubydoc and usage examples to come.

Developer quickstart

Assuming git, [Vagrant] vagrant-install and [VirtualBox] virtualbox-install installed:

 host$ git clone https://github.com/snowplow/sluice.git
 host$ cd sluice
 host$ vagrant up && vagrant ssh
guest$ cd /vagrant
guest$ gem install bundler
guest$ rspec

Publishing

 host$ vagrant push

Copyright and license

Sluice is copyright 2012-2015 Snowplow Analytics Ltd.

Licensed under the [Apache License, Version 2.0] license (the "License"); you may not use this software except in compliance with the License.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.