Metadata-Version: 2.0
Name: subspace
Version: 0.5.1
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 (>=2.3.0.0)
Requires-Dist: redis (>=2.10.3)

subspace 0.5.1

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

# Use a custom logger
logger = logging.getlogger("subspace")

# Set ansible configuration
subspace.configure({
    "HOST_KEY_CHECKING": False,
    "DEFAULT_ROLES_PATH": "/opt/any/roles/path"
})

# Run playbooks
host_file = "/opt/any/ansible/hosts"
playbook_dir = "/opt/any/ansible/playbooks"
hosts = [ "vm3-4", vm3-5" ]
pb = subspace.Runner.factory(host_file,
                             playbook_dir,
                             limit_hosts=hosts,
                             logger=logger)
pb.run()
```

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


