Metadata-Version: 2.0
Name: subspace
Version: 0.1.5
Summary: A pragmatic interface to programmatically use Ansible.
Home-page: https://github.com/iPlantCollaborativeOpenSource/subspace
Author: iPlant Collaborative
Author-email: atmodevs@gmail.com
License: Apache License, Version 2.0
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Information Technology
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: System
Classifier: Topic :: System :: Clustering
Classifier: Topic :: System :: Distributed Computing
Classifier: Topic :: System :: Systems Administration
Requires-Dist: ansible (==1.9.2)
Requires-Dist: redis (==2.10.3)

subspace 0.1.5

A pragmatic interface to programmatically use Ansible.

To install use:
pip install subspace
pip install git+git://git@github.com:iPlantCollaborativeOpenSource/subspace.git

----

subspace
========

A pragmatic interface to programmatically use [Ansible](https://github.com/ansible/ansible).

## Example

```python
import subspace
import logging
my_limits = [{"hostname": "vm3-4", "ip": "1.2.3.4"},
	      {"hostname": "vm3-5", "ip": "1.2.3.5"}]
logger = logging.getlogger("subspace") # Use your own logger.
subspace.use_logger(logger)
subspace.constants("HOST_KEY_CHECKING", False)
subspace.constants("DEFAULT_ROLES_PATH", "/opt/any/roles/path")
playbook_file = "/opt/any/ansible/playbooks/deploy.yml"
host_list_file = "/opt/any/ansible/hosts"
pb = subspace.PlayBook.factory(playbook_file,
                               host_list=host_list_file,
                               limit=my_limits)
```

To follow Ansible's naming, we're named after [Star Trek's subspace technology](http://en.wikipedia.org/wiki/Technology_in_Star_Trek#Subspace).


----

For more information, please see: https://github.com/iPlantCollaborativeOpenSource/subspace


