Skip to main content

Suitable is a thin wrapper around the Ansible API.

Project description

An Ansible API for humans.


Suitable is not endorsed by Ansible and it is not affilated with it. Use at your own peril.

The official way to use Ansible from Python is documented here:

Run Tests

pip install tox

Build Status

Build status

Test Coverage

Test coverage

Latest Release

Latest release


0.9.0 (2017-09-19)

  • Adds support for Ansible 2.4. Since this release introduces many changes under the hood support for Ansible 2.3 has been dropped!

    You might want to assume that this will stay this way. Older Ansible releases are supported if possible, but it’s not a goal of this project. [href]

  • Explicitly drops support for Python 3.0 - 3.4. Suitable supports the same Python versions Ansible supports, which excludes these 3.x releases.

    Supported are therefore Python 2.7, 3.5 and 3.6+. [href]

0.8.1 (2017-08-10)

  • Adds support for Ansible’s extra_vars. [Liuyanglong]

0.8.0 (2017-06-02)

  • Adds support for Python 3.3+. Since Python 3 support in Ansible is experimental, only the latest Ansible (2.3+) is henceforth supported. [href]

0.7.4 (2017-01-27)

  • Fixes an issue with Ansible Host lists are now passed to Ansible in a format it expects. [href]

0.7.3 (2016-03-08)

  • Gets password based ssh authentication working again. [href]

0.7.2 (2016-01-15)

0.7.1 (2016-01-15)

  • Removes global state lingering around with Ansible, which introduced a hosts cache leading to Suitable’s api instances to not be independent. [href]

0.7.0 (2016-01-13)

  • Adds support for Ansible 2.0. Does not support 1.x anymore!! [href]

0.6 (2015-06-22)

  • Adds backwards-compatible support for Ansible 1.9. The same code running on suitable for Ansible 1.8 should now work with Ansible 1.9. [href]

0.5 (2014-11-28)

  • Adds support for Ansible 1.8. [href]
  • Includes automated tests for Ansible versions 1.5 through 1.8. [href]
  • Properly escapes spaces in key-value pairs. Fixes #3. [href]

0.4 (2014-09-05)

  • Wraps the result of all module runs to provide easy access to results per server. [href]
  • Default to transport ‘localhost’ if ‘localhost’ or ‘’ is used exclusively on the API object. [href]

0.3 (2014-05-28)

  • Adds a stern warning so users won’t confuse this with the official Ansible API. [href]

0.2 (2014-05-21)

  • Change license to GPL v3 as required by Ansible. [href]

0.1 (2014-05-21)

  • Initial release. [href]

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for suitable, version 0.9.0
Filename, size File type Python version Upload date Hashes
Filename, size suitable-0.9.0-py2.py3-none-any.whl (14.5 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size suitable-0.9.0.tar.gz (24.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page