python-zaqarclient/setup.cfg
Flavio Percoco 6d0391ceb3 Implement queue's API methods
This patch implements methods for every queue operation. The 2
operations left out in this patch are: queue_list and queue_stats.

This patch makes the client, officially, usable as a library. An example
of how this could be use:

    client = Client()
    queue = client.queue('my_queue') # Creates the queue automatically
    queue.metadata() # Get's metadata from the queue
    queue.metadata(dict(new_meta='Yo yo!'))
    queue.delete()

Metadata was implemented as method instead of as a property to make it
explicit that both get and set do something in the remote server.

The client API was implemented in 2 separate levels. The highest level
is the one shown in the example above, which allows users to just query
Marconi instances without worrying about the transport, request build
process, references, deserealization and what not. The lowest instead,
allows the user to control every bit of the communication process - the
user can pick a specific transport, or pass custom params. For example -
which will make it possible to have other implementations around that
API in addition to the asynchronous support. Example of the API:

    transport = http.HttpTransport(cfg.CONF)
    request = request.prepare_request(cfg.CONF,
                                      endpoint='http://localhost:8888')
    core.queue_create(transport, request, 1, callback=my_callback)

There are tons of things to do and improve. For example:

    * The way config params are registered may work when using
    marconiclient as a library but they won't when using it as a CLI
    tool.
    * This code lacks of logging.
    * Handling of 20(1|4) is missing.

Partially-Implements blueprint python-marconiclient-v1
Implements blueprint queues-management

Change-Id: I8bdc8a4aff8ea22b5673bc7440e07796ecaf34cc
2013-10-29 16:43:03 +01:00

50 lines
1.1 KiB
INI

[metadata]
name = python-marconiclient
version = 0.1
summary = Client Library for OpenStack Marconi Queueing API
description-file =
README.rst
author = OpenStack Foundation
author-email = openstack-admins@lists.openstack.org
home-page = http://www.openstack.org/
classifier =
Development Status :: 2 - Pre-Alpha
Environment :: Console
Environment :: OpenStack
Intended Audience :: Information Technology
Intended Audience :: Developers
Intended Audience :: System Administrators
License :: OSI Approved :: Apache Software License
Operating System :: POSIX :: Linux
Programming Language :: Python
Programming Language :: Python :: 2
Programming Language :: Python :: 2.6
Programming Language :: Python :: 2.7
[global]
setup-hooks =
pbr.hooks.setup_hook
[files]
packages =
marconiclient
[entry_points]
marconiclient.transport =
http.v1 = marconiclient.transport.http:HttpTransport
marconiclient.api =
queues.v1 = marconiclient.queues.v1.api:V1
[nosetests]
where=tests
verbosity=2
[build_sphinx]
source-dir = doc/source
build-dir = doc/build
all_files = 1
[upload_sphinx]
upload-dir = doc/build/html