openstack
/
python-congressclient
Code Issues Proposed changes
RETIRED, Client for OpenStack Congress
255 Commits 1 Branch 44 Tags 2.2 MiB
Go to file
Doug Hellmann 795ee99bf5 fix tox python3 overrides 
We want to default to running all tox environments under python 3, so
set the basepython value in each environment.

We do not want to specify a minor version number, because we do not
want to have to update the file every time we upgrade python.

We do not want to set the override once in testenv, because that
breaks the more specific versions used in default environments like
py35 and py36.

Change-Id: I56099c2e073fdba3830ae53fa053c2daded8ada0
Signed-off-by: Doug Hellmann <doug@doughellmann.com>
 		2018-07-20 01:30:51 +00:00
congressclient Merge "Enable include_rules option for library policy" 2017-12-05 05:13:28 +00:00
doc doc update to fix errors from new sphinx version 1.7.5 2018-07-18 11:51:13 -07:00
releasenotes/notes Add release notes 2016-09-01 09:13:48 -07:00
.coveragerc no longer use oslo-incubator code 2016-11-11 00:47:23 -05:00
.gitignore Update .gitignore 2017-01-16 21:20:12 +08:00
.gitreview Update .gitreview file to reflect repo rename 2015-04-18 00:37:36 +00:00
.mailmap create python-congressclient project with cookiecutter 2014-07-02 13:24:29 -07:00
.testr.conf create python-congressclient project with cookiecutter 2014-07-02 13:24:29 -07:00
.zuul.yaml add lower-constraints job 2018-04-12 10:41:09 -04:00
CONTRIBUTING.rst Update the documentation link for doc migration 2017-07-24 10:23:01 +08:00
HACKING.rst Update the documentation link for doc migration 2017-07-24 10:23:01 +08:00
LICENSE create python-congressclient project with cookiecutter 2014-07-02 13:24:29 -07:00
Makefile Add missing makefile so HTML docs can be generated 2016-07-22 11:59:15 -05:00
NEWS Add api bindings for datasource request-request trigger 2015-03-31 15:33:53 -07:00
README.rst Update links in README 2018-03-02 18:45:38 +08:00
babel.cfg create python-congressclient project with cookiecutter 2014-07-02 13:24:29 -07:00
lower-constraints.txt add lower-constraints job 2018-04-12 10:41:09 -04:00
requirements.txt Updated from global requirements 2018-02-17 10:11:03 +00:00
setup.cfg Follow the new PTI for document build 2018-04-17 14:56:41 +08:00
setup.py Updated from global requirements 2017-03-10 03:38:00 +00:00
tenant-list.log Initial congressclient 2014-09-10 15:11:09 -07:00
test-requirements.txt Follow the new PTI for document build 2018-04-17 14:56:41 +08:00
tox.ini fix tox python3 overrides 2018-07-20 01:30:51 +00:00

README.rst

Team and repository tags

image

python-congressclient

Client for Congress

Client for Standalone Congress

Install the Congress CLI by cloning the repository and running the setup file. The master repository always contains the latest source code, so if you are installing and testing a specific branch of Congress, clone the matching branch of the python-congressclient.

To execute CLI commands to standalone Congress installed with noauth:

  • Install python-openstackclient:

    $ pip install python-openstackclient

  • Clone master repository & install python-congressclient:

    $ git clone https://github.com/openstack/python-congressclient.git
$ cd python-congressclient
$ python setup.py install

  • (Optional) Clone a branch; for example, if you are using the Ocata version of OpenStack and Congress:

    $ git clone -b stable/ocata https://github.com/openstack/python-congressclient.git
$ cd python-congressclient
$ python setup.py install

  • Read the HTML documentation. Install python-sphinx and the oslosphinx extension if missing:

    $ sudo pip install sphinx
$ sudo pip install oslosphinx

    Build the docs $ make docs

    Open doc/html/index.html in a browser

  • To execute CLI commands:

    $ cd python-congressclient

For example:
$ export CONGRESS_URL="http://127.0.0.1:1789"
$ openstack --os-token foo --os-url $CONGRESS_URL
(openstack) congress policy create test_policy
+--------------+--------------------------------------+
| Field        | Value                                |
+--------------+--------------------------------------+
| abbreviation | test_                                |
| description  |                                      |
| id           | 8595f24a-7d74-45ee-8168-0b3e937b8419 |
| kind         | nonrecursive                         |
| name         | test_policy                          |
| owner_id     | user                                 |
+--------------+--------------------------------------+

(openstack) congress policy rule create test_policy "p(5)"
+---------+--------------------------------------+
| Field   | Value                                |
+---------+--------------------------------------+
| comment | None                                 |
| id      | 5ce7fb18-a227-447e-bec8-93e99c0052a5 |
| name    | None                                 |
| rule    | p(5)                                 |
+---------+--------------------------------------+

(openstack) congress policy rule list test_policy
// ID: 5ce7fb18-a227-447e-bec8-93e99c0052a5
// Name: None
p(5)

(openstack) exit
$

Features

  • TODO