Suitable is a thin wrapper around the Ansible API.
Project description
Caution
The endorsed way to use the official Ansible API is documented here: http://docs.ansible.com/developing_api.html
Example
from suitable import Api
# creates the user 'denis' on both hosts
hosts = Api(['web.seantis.dev', 'db.seantis.dev'])
hosts.user(name='denis')
# creates the user 'postgres' on db.seantis.dev
dbhost = Api('dbhost.dev')
dbhost.user(name='postgres')
# returns a list of mounts on the given servers
hosts.setup(filter='ansible_mounts')
# connects to the given server with a specific user/pass
from getpass import getpass
username = 'admin'
password = getpass()
api = Api('web.seantis.dev', remote_user=username, remote_pass=password)
print api.command('whoami').stdout('web.seantis.dev')
>>> adminWhy Suitable?
Because ‘ansible’ is derived from ‘answerable’ whose archaic definitions include ‘suitable’. So not much thought went into it.
Are there tests, docs?
Few tests, we use this so far for our internal deploy and server update scripts, so the code is actually run in production if you will - but it’s an experiment because we’ve been using a number of ways to drive ansible within scripts and we’re not yet sure this is it. We’ll add more over time as the interface stabilizes.
No docs, there are a number of comments if you bother to read the source, but there’s no guide and no readthedocs page. If this module makes sense to anyone else, we’ll add more!
Run Tests
pip install tox
toxMore information
All the heavy lifting is done by Ansible. To get a list of Api arguments have a look at the Runner class found in https://github.com/ansible/ansible/blob/devel/lib/ansible/runner/__init__.py
To get an overview of all the methods provided by the api have a look at the list of Ansible modules: http://docs.ansible.com/modules_by_category.html
The file module for instance includes the following example:
- file: path=/etc/foo.conf owner=foo group=foo mode=0644
This can easily be translated to the suitable api:
api.file(path='/etc/foo.conf', owner='foo', group='foo', mode='0644')
Changelog
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 ‘127.0.0.1’ 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]
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file suitable-0.6.tar.gz.
File metadata
- Download URL: suitable-0.6.tar.gz
- Upload date:
- Size: 21.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 2f922f4beb31598d058d4848ade147818bfe097e895cd5953587406a3821b9b8 |
|
| MD5 | e5d3d4fa377ccffb2f4533ec41e54372 |
|
| BLAKE2b-256 | 61f0f846b0991a894d01fab93f54fce5f7d28f0b463743784ece571c515bf750 |
