Skip to content
This repository has been archived by the owner on Apr 19, 2022. It is now read-only.

Commit

Permalink
Move from README.rst to README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Wouter de Bie committed Sep 24, 2015
1 parent 7b01480 commit 2e28a98
Show file tree
Hide file tree
Showing 2 changed files with 60 additions and 54 deletions.
60 changes: 60 additions & 0 deletions README.md
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 &lt;3

Travis CI status: [![Travis](https://api.travis-ci.org/spotify/snakebite.png)](https://travis-ci.org/spotify/snakebite)

Copyright 2013-2015 Spotify AB
54 changes: 0 additions & 54 deletions README.rst

This file was deleted.

0 comments on commit 2e28a98

Please sign in to comment.