bamboo-lib

Bamboo

Bamboo is a library intended to facilitate the process of creating extract, transform, and load (ETL) data pipelines. Bamboo includes many features such as the ability to download and cache HTTP assets, copy files from remote servers, run commands on remote servers, handle zipped archives, perform bulk database ingests and more.

Installation

pip install bamboo-lib

Additional Steps

If you will need to use the distributed locking functionality, you will need to install some additional software. Below are the instructions for macOS

Installing Sherlock on macOS.

brew install libmemcached

pip install pylibmc --install-option="--with-libmemcached=/usr/local/Cellar/libmemcached/1.0.18_2"

pip install sherlock

Running tests

To run the tests, simply run: pytest

Alternatively, if you would like to display all log/print statements run: pytest -s

Configuration

To change the default folder where Bamboo will store HTTP downloads, set the BAMBOO_DOWNLOAD_FOLDER environment variable. By default, downloads will go to /tmp.

To change the default logger settings, set BAMBOO_LOGGER_CONF to point to a logging configuration file (see example in example/logging.conf).

Troubleshooting tips

Mutli-processing issues on macOS

If you are running High Sierra or later and get an error like:

objc[30911]: +[__NSPlaceholderDate initialize] may have been in progress in another thread when fork() was called. We cannot safely call it or ignore it in the fork() child process. Crashing instead. Set a breakpoint on objc_initializeAfterForkError to debug

Try setting:

export OBJC_DISABLE_INITIALIZE_FORK_SAFETY=YES