Tagging release 5.3.3 on branch master.
Merge pull request #13 from phillipkent/fix_bug_windows_readline

fix bug in using readline in WindowsI found a bug with use of 'readline' for Python 2.7 on Windows 7. Cloudmonkey fails to run with this error:

File c:\python27\lib\site-packages\cloudmonkey\cloudmonkey.py  line 70 module>
            If libedit in readline.__doc__
TypeError:  argument of type NoneType is not iterable

It requires modification of cloudmonkey.py at line 70.

The error and fix are the same as reported here:

Note: I haven't tested this for Cloudmonkey in other Windows versions, or other Python versions.

* pr/13:
  fix bug in using readline in Windows

Signed-off-by: Rohit Yadav <rohit.yadav@shapeblue.com>
tree: d8bb942539711f4215b1583c6df19f68f188ff14
  1. .gitignore
  2. CHANGES.md
  3. Dockerfile
  5. Makefile
  7. README.md
  8. cloudmonkey/
  9. config.docker
  10. docs/
  11. performrelease.sh
  12. setup.cfg
  13. setup.py


cloudmonkey :cloud::monkey_face: is a command line interface for Apache CloudStack. CloudMonkey can be use both as an interactive shell and as a command line tool which simplifies Apache CloudStack configuration and management. It can be used with Apache CloudStack 4.0-incubating and above.

version badge download badge

For users


$ pip install cloudmonkey


$ pip install --upgrade cloudmonkey

Install/Upgrade latest using git repository:

$ pip install --upgrade git+https://git-wip-us.apache.org/repos/asf/cloudstack-cloudmonkey.git

Install/upgrade using the Github git mirror:

$ pip install --upgrade git+https://github.com/apache/cloudstack-cloudmonkey.git

Please see the CloudMonkey Wiki for usage.

Using Docker image

The default configuration provided connect to CloudStack managemenent server as container:

Enter the CLI:

$ docker run -ti --rm --link cloudstack:8080 cloudstack/cloudmonkey

To execute single api command:

$ docker run -ti --rm --link cloudstack:8080 cloudstack/cloudmonkey list accounts

Use your own CloudMonkey configuration file:

$ docker run -ti --rm -v `pwd`/.cloudmonkey:/cloudmonkey cloudstack/cloudmonkey



Cleans and then builds with precache
$ make all


$ make build

Build Precache:

$ make buildcache

Build with Precache:

$ make buildwithcache

Check changes, code styles:

$ make check


$ make clean


$ make install

Mailing lists

Development Mailing List

Users Mailing List

Commits Mailing List

Issues Mailing List

Marketing Mailing List


Discuss features development on the Development Mailing List. Report issues on the User mailing list and open issue on JIRA.

  1. Fork the repository on Github
  2. Create a named feature branch (like add_component_x)
  3. Write your change
  4. Write tests for your change (if applicable)
  5. Run the tests, ensuring they all pass
  6. Submit a Pull Request using Github


Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at


Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.