This repository has been archived by the owner on Apr 19, 2022. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 216
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Wouter de Bie
committed
Sep 24, 2015
1 parent
7b01480
commit 2e28a98
Showing
2 changed files
with
60 additions
and
54 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,60 @@ | ||
![Snakebite mini logo](https://github.com/spotify/snakebite/blob/master/doc/logo/logo-mini-typo.png) | ||
--- | ||
|
||
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` | ||
|
||
To install snakebite 2.x with Kerberos/SASL support, make sure you can | ||
install python-krbV (<https://fedorahosted.org/python-krbV/>) and then | ||
run: | ||
|
||
`pip install "snakebite[kerberos]"` | ||
|
||
Documentation | ||
============= | ||
|
||
More information and documentation can be found at http://snakebite.readthedocs.org/en/latest/ | ||
|
||
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: [![Travis](https://api.travis-ci.org/spotify/snakebite.png)](https://travis-ci.org/spotify/snakebite) | ||
|
||
Copyright 2013-2015 Spotify AB |
This file was deleted.
Oops, something went wrong.