8eaf813984
Currently 'Subscription' class catches ConflictError inside and prints text 'The subscriber has been existed already.'. This is not good for two reasons: 1. The library user(program) wants to handle this exception by himself using convenient try/except mechanism along with many other exceptions that can happen during subscription creation. 2. The library user might not want some text to be printed in this situation by python-zaqarclient. For now this is the only situation when python-zaqarclient prints something when it is used as library. This patch makes "Subscription" class not to handle ConflictError exception by itself. And creates functional and unit tests to assert that this behavior is raised, when Zaqar returns 409 response code on subscription creation. In the future it would be good to list all exceptions that can be raised by the "Client" class's methods in their docstrings. See "zaqarclient/queues/v1/client.py" and "zaqarclient/queues/v2/client.py". Also it would be good if "Pool" and "Flavor" classes would throw ConflictError exception too. Closes-Bug: 1542780 Change-Id: I17c0e32a3dabec8303b3055a0d97db857d947b34 |
||
|---|---|---|
| doc | ||
| examples | ||
| tests | ||
| zaqarclient | ||
| .gitignore | ||
| .gitreview | ||
| HACKING.rst | ||
| LICENSE | ||
| README.rst | ||
| requirements.txt | ||
| setup.cfg | ||
| setup.py | ||
| test-requirements.txt | ||
| tox.ini | ||
Python Zaqar Client
- version
-
0.1.0
- Wiki
- Launchpad
- Review
- Design
- IRC
-
#openstack-zaqar @ freenode
Welcome to the Zaqar Python Client project!
Table of Contents
Installation
The latest stable release can be installed from PyPI:
pip install --upgrade python-zaqarclientFor the adventurous, you may also install the latest code directly from GitHub:
pip install git+https://github.com/openstack/python-zaqarclient.gitWhat's in the box
By installing python-zaqarclient you get programmatic access to the Zaqar v1.0 API library. Plus, it installs a plugin to python-openstackclient that allows you to perform simple queue operations.
How to use
Python client
Details about design, features, usage and workflow can be found in the Python Client Wiki.
Command line interface
Zaqar bases its client implementation in the OpenStack Client. It can be installed and configured by following the instructions in Getting Started and Configuration in the OpenStack Client readme respectively.
The CLI currently allows creation, removal and listing of queues. Some examples are:
$ openstack queue list --limit 3
$ openstack queue create myqueue
$ openstack queue delete myqueueContributing
Be sure to reference the HACKING file for details on coding style. You may also wish to read through Zaqar's Contributor Guide before contributing your first patch.