Extract Transform Load toolkit (python).
Branch: dev
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
doc
example
rdc
.gitignore update gitignore to ignore coverage Oct 10, 2014
.travis.yml separate dev requirements Mar 6, 2014
LICENSE Change licence model to apache 2.0 license, add documentation, cleans… Nov 6, 2013
MANIFEST.in
Makefile
README.rst
classifiers.txt Project restructuration using http://pound-python.org/ directives, ch… Jan 13, 2014
requirements-dev.txt Update build files. May 4, 2014
requirements.txt
setup.py
version.txt Restoring version number scheme, cant go back now. Jan 14, 2014

README.rst

rdc.etl

rdc.etl is an Extract Transform Load (ETL) toolkit for python 2.7+ (no python 3 support yet). It gives you all the tools needed to create complex data integration jobs from simple atomic io-connected transformation blocks.

Build Status

We started to repackage this for modern python using a similar but cleaner and simpler API. This package is called Bonobo.

Documentation

Full documentation for rdc.etl on ReadTheDocs.

This is a work in progress, the 1.0 API may change until 1.0 is released.

Example usage

>>> # Sample data extract transformation.
>>> # Use hardcoded data here for sample purpose.
>>> from rdc.etl.transform.extract import Extract
>>> @Extract
... def sample_extract():
...     yield {'first_name': 'John', 'last_name': 'Doe', }
...     yield {'first_name': 'Jane', 'last_name': 'Dae', }
>>> # Sample data transformation.
>>> from rdc.etl.transform import Transform
>>> @Transform
... def sample_transform(hash, channel):
...     hash['last_name'] = hash['last_name'].upper()
...     hash['initials'] = '{0}.{1}.'.format(hash['first_name'][0], hash['last_name'][0]).upper()
...     yield hash
>>> # Sample load. This is only a screen log for sample purpose.
>>> from rdc.etl.transform.util import Log
>>> sample_load_to_screen = Log()
>>> # Tie everything together, then run!
>>> from rdc.etl.harness.threaded import ThreadedHarness
>>> job = ThreadedHarness()
>>> job.add_chain(sample_extract, sample_transform, sample_load_to_screen)
>>> job()

Running the Test Suite

pip install nose
make test

Release Notes

1.0.0a6

  • Database transformations: now present in rdc.etl.extra subpackages, to avoid mixing core API and sugar box.
  • Database transformations: more flexibility in what is allowed (insert/update).
  • Better standard compliance (thanks #python)
  • Harness is now called Job, for simplicity sake. Old name will be kept too (BC).
  • XMLMap enhancements.
  • HTTP status interface (early minimalistic version).
  • Changed examples name to avoid import hell.
  • Less hackish http reader, better unicode support (@jmorel).
  • PasteScript can now be used to generate an empty working ETL project.
  • FileProxy based download manager.
  • Minor fixes.

1.0.0a5

  • Status: console now has amazing ansi, detailed io statistics, overall stats (memory, time) added, experimental http status, db stats for database load.
  • API stabilization, cleanup and simplification towards 1.0.0.
  • Simple handling of KeyboardInterrupt: CTRL-C will now exit the running job instead of making your process stale.
  • Maps simplification.
  • Enhancements to various transform classes: load.database.DatabaseLoad, filter.Filter, map.xml.XmlMap, util.Log, join.database.DatabaseJoin
  • New transforms: util.Limit
  • Various bugfixes.
  • Minor enhancements: custom names in transforms, some more tests.
  • Moved repository to github.com/rdcli/etl.

Contributing

I'm Romain Dorgueil.

rdc.etl is on GitHub.

Get in touch, via GitHub or otherwise, if you've got something to contribute, it'd be most welcome!

If you feel overwhelmingly grateful, or want to support the project you can tip me on Gittip.