Metadata-Version: 2.0
Name: hydrant
Version: 0.3.0
Summary: Redirects stdin to Amazon Kinesis Firehose.
Home-page: https://github.com/bwbaugh/hydrant
Author: Wesley Baugh
Author-email: wesley@bwbaugh.com
License: BSD
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Topic :: Utilities
Requires-Dist: botocore (>=1.2.9)
Requires-Dist: click

=======
hydrant
=======

.. image:: https://travis-ci.org/bwbaugh/hydrant.svg?branch=master
    :target: https://travis-ci.org/bwbaugh/hydrant
    :alt: Build Status

.. image:: https://coveralls.io/repos/bwbaugh/hydrant/badge.svg
    :target: https://coveralls.io/r/bwbaugh/hydrant
    :alt: Code Coverage Status

Redirects stdin to Amazon Kinesis Firehose.

The application submits each record one at a time,
which limits the throughput.
A future version might batch records together for performance,
but until then
beware of using high throughput streams
(15 records per second or more).
Running from within EC2 will allow higher throughput.


************
Installation
************

Install into a virtualenv.

.. code-block:: bash

    $ pip install --editable .


*****
Usage
*****

Pipe newline separated records into hydrant,
which will send each record to the delivery stream:

.. code-block:: bash

    $ producer | hydrant my-firehose-stream

Specify a region if not using ``us-east-1``:

.. code-block:: bash

    $ producer | hydrant --region='us-west-2' my-firehose-stream

Read the help text for more information:

.. code-block:: bash

    $ hydrant --help


