Skip to main content

Pure Python HDFS client

Project description

|logo|
============

.. |logo| image:: https://github.com/spotify/snakebite/blob/master/doc/logo/logo-mini-typo.png
:align: middle
:alt: Snakebite mini logo

Snakebite is a python library that provides a pure python HDFS client and a wrapper around Hadoops minicluster.
The client uses protobuf for communicating with the NameNode and comes in the form of a library and a command line interface.
Currently, the snakebite client supports most actions that involve the Namenode and reading data from DataNodes.

*Note:* all methods that read data from a data node are able to check the
CRC during transfer, but this is disabled by default because of performance
reasons. This is the opposite behaviour from the stock Hadoop client.

Snakebite requires python2 (python3 is not supported yet) and python-protobuf 2.4.1 or higher.

Snakebite 1.3.x has been tested mainly against Cloudera CDH4.1.3 (hadoop 2.0.0) in production. Tests pass on HortonWorks HDP 2.0.3.22-alpha (protocol versions 7 and 8)

Snakebite 2.x has been tested on Hortonworks HDP2.0 and CDH5 Beta and ONLY supports Hadoop 2.2.0 and up (protocol version 9)!

Installing
**********
Snakebite releases are available through pypi at https://pypi.python.org/pypi/snakebite/

The quickest way to install snakebite (1.3.x) is to run:

pip install -I snakebite==1.3.x

To install snakebite 2.x run:

pip install snakebite

Documentation
*************
More information and documentation can be found at http://spotify.github.io/snakebite/

Development
***********
Make sure to read about development `here <http://spotify.github.io/snakebite/development.html>`_ and about testing over `here <http://spotify.github.io/snakebite/testing.html>`_, hack and come back with a pull requests <3

Travis CI status
****************

.. image:: https://api.travis-ci.org/spotify/snakebite.png

Copyright 2013-2014 Spotify AB

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

snakebite-2.6.0.tar.gz (76.8 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page