Metadata-Version: 2.0
Name: python-lunrclient
Version: 1.3.1
Summary: Lunr API client
Home-page: https://github.com/rackerlabs/python-lunrclient
Author: Derrick J Wippler
Author-email: thrawn01@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Environment :: Other Environment
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Requires-Dist: prettytable (>=0.7)
Requires-Dist: requests (>=2.9.1)
Requires-Dist: requests-mock (>=0.7.0)
Requires-Dist: six (>=1.10.0)

.. image:: https://travis-ci.org/rackerlabs/python-lunrclient.svg?branch=master
    :target: https://travis-ci.org/rackerlabs/python-lunrclient

LunrClient
----------

An HTTP Client for use with the Lunr Storage Backend for Cinder

Installation
------------

::

    $ pip install python-lunrclient

Usage
-----

| This package provides 2 command line tools ``lunr`` an inteface to the
  lunr
| API and ``storage`` an interface to the storage API.

Lunr API commandline usage
^^^^^^^^^^^^^^^^^^^^^^^^^^

::

    $ lunr -h
    Usage: lunr <command> [-h]

    Command line interface to the lunr api

    Available Commands:
       node
       account
       volume
       export
       env
       backup

Storage API commandline usage
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

::

    $ storage -h
    -- Warning: Failed to load tools module, Missing dependency?
    Usage: storage <command> [-h]

    Command line interface to the lunr storage api

    Available Commands:
       volume
       status
       export
       backup
       env

Both ``lunr`` and ``storage`` can use environment variables for
convenience.

Use ``lunr env`` and ``storage env`` to list environment variables that
are used.

Currently the following are supported:

::

    export OS_TENANT_NAME='thrawn'
    export LUNR_ADMIN='admin'
    export LUNR_TENANT_ID='admin'
    export LUNR_STORAGE_URL='http://localhost:8081'
    export LUNR_API_URL='http://localhost:8080'

Lunr API Examples
-----------------

Create a 1 gig volume with a uuid for a name and use the default volume
type:

::

    $ lunr volume create 1

List the available volumes for ``OS_TENANT_NAME``:

::

    $ lunr volume list

Delete a volume:

::

    $ lunr volume delete my-volume

Storage API Examples
--------------------

Create a 1 gig volume with a uuid for a name:

::

    $ storage volume create 1

List the available volumes on the storage node:

::

    $ storage volume list

Delete a volume:

::

    $ storage volume delete my-volume

Storage Tools
-------------

There are some additional storage server tools that are only available
when run on the storage node:

::

    $ storage tools -h
    Usage: storage tools <command> [-h]

    A collection of misc Storage Node tools

    Available Commands:
       read
       randomize
       clone
       write
       backup



