Add a read-only property for Queues

Queue's name is currently a private attribute in the Queue object. Since
this attribute may need to be accessed, this patch adds a read-only
property that returns the value of the private attribute.

Change-Id: I175d6e2d3b8990f8dbea3c44351143067efacff3
Updates API name

Zaqar is a messaging service which provides support for different
messaging patterns and messaging related semantics.
This fix changes the old API name -queuing- to a more accurate name, -messaging-.

Change-Id: Icaf67607de962217819f8040abca7dd9b81aa1d4
Merge "Add a read-only property for Queues"
Updated from global requirements

Change-Id: Id669e640a38c5b31a36ed183ca989c9d5d23b8b0
fix KeystoneAuth doc string

service_type is duplicated.

Change-Id: I3e1a536d676e0e35c3dc42cb3c4ccfd6b2a1524d
Updated from global requirements

Change-Id: I6083acfcd1e6f1cf8712beab8fbb9a0612b47dad
Fix the client name typo

the client name should be messaging, not queuing

Change-Id: I46852cb8dc15038d8f1404e9ba5c44ddece19be7
Merge "fix KeystoneAuth doc string"
Setup developer docs for zaqarclient

Zaqar's client library is lacking of any kind of documentation. This
needs to be fixed, hence this patch. The patch adds the docs'
infrastructure to start writing the required documentation for the
library.

Change-Id: Ife171e352da4ec977202efcb3f1dcf573edcdc27
Add docs for `Client` instances

This patch documents the basic usage of `Client` instances. It does not
provide a detailed documentation about the methods exposed but a high
level documentation of what the recommended way to access these
resources is.

The current version refers to sections like 'core API', 'config' and
others that haven't been documented yet. Once they will be, proper links
to those sections will be added here.

Change-Id: I705498b8e4c19c75c9697419d1fd90c9a9ae40b9
Add reference docs for latest recommended client

Add the reference documentation for the latest supported client version.
Older versions will also be linked there as they come.

Change-Id: I4d9da31ed0aa39ba6cdafb7ad61af1197d4610e4
Extend some docstrings with useful information

This patch extends some of the docstrings in the `Client` class with
more useful information. The patch also adds `intersphinx` to allow for
linking to other docs within zaqarclient. For example:

    :rtype: :class:`zaqarclient.transport.base.Transport`

will link to the documentation for Transport if it has been generated.

Change-Id: I928d63d74739e9e18709979e79c95b5606d97032
Merge "Setup developer docs for zaqarclient"
Merge "Add docs for `Client` instances"
Merge "Add reference docs for latest recommended client"
Merge "Extend some docstrings with useful information"
Merge "Fix the client name typo"
Updated from global requirements

Change-Id: I3e058564c85a96f412cc62f807790972d54177be
CLI support for message CRUD operations

This patch extends the queues operation supported by the CLI.

Features added:
- List the messages
- Post a message
- Get one or set of messages
- Delete one or set of messages

Some examples:
    $ openstack message list --queue_name test_queue
    $ openstack message post --queue_name test_queue --ttl 3600 \
        --body '{"name":"user1", "password":"pass"}'
    $ openstack message get --queue_name test_queue \
        778899 889900 990011
    $ openstack message delete --queue_name test_queue \
        778899 889900 990011

Change-Id: I5ebd153f32704e616fa78d388bf3d50f36c287fa
Partially-Implements: blueprint cli
CLI support for claim CRUD operations

This patch extends the queues operation supported by the CLI.

Features added:
- Create claim
- Query claim
- Update claim
- Release claim

Some examples:
    $ openstack claim create --queue_name test_queue --ttl 3600 \
        --grace 120
    $ openstack claim query --queue_name test_queue 7788990
    $ openstack claim update --queue_name test_queue --ttl 720 \
        7788990
    $ openstack claim release --queue_name test_queue 7788990

Change-Id: I610b1b236376e6be19014717dbe926d8a749198d
Partially-Implements: blueprint cli