OpenStack Messaging (Zaqar) Client
Go to file
Flavio Percoco 680e314c0e Rename shard to pool
The server's shard feature has been renamed to pool. This patch reflects
that change in the client library. The patch keeps old `shard*` methods
and functions for backwards compatibility and it also raises a
deprecation warning whenever they are used. These functions will be
removed right after k-1

Change-Id: I842bfbcf075845750bc4fff345086636cc775371
Closes-bug: #1348196
2014-09-17 16:39:23 +02:00
examples Rename Marconi to Zaqar 2014-08-04 16:55:10 +02:00
tests Rename shard to pool 2014-09-17 16:39:23 +02:00
zaqarclient Rename shard to pool 2014-09-17 16:39:23 +02:00
.gitignore Ignore *.egg files. 2013-07-16 17:59:28 -04:00
.gitreview Fix .gitreview due to the repo rename/move 2014-08-16 21:33:03 +04:00
HACKING.rst Rename Marconi to Zaqar 2014-08-04 16:55:10 +02:00
LICENSE Lets get the party started :) 2013-05-07 17:09:55 +02:00
openstack-common.conf Rename Marconi to Zaqar 2014-08-04 16:55:10 +02:00
README.rst Dividing markups into multiple lines 2014-08-13 15:09:50 +02:00
requirements.txt Updated from global requirements 2014-09-11 00:31:28 +00:00
setup.cfg Merge "CLI support for queue existence and metadata operations" 2014-09-16 16:25:33 +00:00
setup.py Updated from global requirements 2014-04-30 02:46:36 +00:00
test-requirements.txt Merge "Start adding support for v1.1" 2014-09-16 15:44:50 +00:00
tox.ini Work toward Python 3.4 support and testing 2014-09-03 19:06:07 +00:00

Python Zaqar Client

version

0.1.0

Wiki

Zaqar Wiki

Launchpad

Zaqar Launchpad

Review

Code Review

Design

Client Wiki

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-zaqarclient

For the adventurous, you may also install the latest code directly from GitHub:

pip install git+https://github.com/openstack/python-zaqarclient.git

What'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 myqueue

Contributing

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.