Metadata-Version: 2.0
Name: elastic-companion
Version: 1.4.0
Summary: Useful commands for Elasticsearch
Home-page: https://github.com/receiptful/elastic-companion
Author: Receiptful
Author-email: dev@receiptful.com
License: MIT
Keywords: elasticsearch cli
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Dist: boto3 (==1.4.0)
Requires-Dist: certifi (==2016.8.31)
Requires-Dist: elasticsearch (>=1.9.0,<2.0.0)
Requires-Dist: python-dateutil (==2.5.3)
Provides-Extra: dev
Requires-Dist: coverage; extra == 'dev'
Requires-Dist: nose; extra == 'dev'
Requires-Dist: twine; extra == 'dev'
Requires-Dist: wheel; extra == 'dev'

elastic-companion
=================

A command-line tool and API for various Elasticsearch operations.

Install
-------

    pip install elastic-companion

Commands
--------

To see the list of commands, use the ``-h`` or ``--help`` flag.

Each command has a corresponding Python module that can be imported and used as
an API rather than from the command-line.

Developing
----------

If you are using Docker and Docker Compose, then you don't need to fiddle with
python and pip manually. Otherwise, see below.

Download Python 3, then::

    $ pyvenv-3.X venv
    $ source venv/bin/activate
    $ pip3 install -r requirements.txt
    $ ./cli.py -h

On Ubuntu, there's a bit of an issue with ``pip3`` and the above might not work.
Then::

    $ pyvenv-3.X venv --without-pip
    $ source venv/bin/activate
    $ cd venv
    $ wget https://bootstrap.pypa.io/get-pip.py
    $ python3 get-pip.py
    $ cd ..
    $ pip3 install -r requirements.txt
    $ ./cli.py -h

Testing
-------

Use ``nose``::

    $ nosetests

or::

    $ docker-compose run --rm companion nosetests

Deploying
---------

You need access to the pypi repository first, then it's just a matter of::

    $ python setup.py sdist bdist_wheel
    $ twine upload dist/*


