Ansible Inventory implementation that uses Python syntax
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
pyventory
tests
.gitignore
.travis.yml
LICENSE
README.md
setup.cfg
setup.py
tox.ini

README.md

Build Status

Pyventory

Ansible Inventory implementation that uses Python syntax

Install

pip3 install pyventory

Features

  • Modular inventory.
  • Assests inheritance using Python classes.
  • Support for multiple inheritance.
  • Support for mixins.
  • Support for vars templating using Python string formatting.
  • Python 3 (>=3.6) support.
  • Python 2 is not supported.

Usage

Create hosts.py and make it executable.

A short example of the hosts.py contents:

#!/usr/bin/env python3
from pyventory import Asset, ansible_inventory

class All(Asset):
    run_tests = False
    use_redis = False
    redis_host = 'localhost'
    minify = False
    version = 'develop'

class Staging(All):
    run_tests = True

staging = Staging()

ansible_inventory(locals())

Consider a more complex example which passes the following json output to Ansible.

Run Ansible playbook with the -i hosts.py key:

ansible-playbook -i hosts.py site.yml

Notice that you need to have your inventory package in PYTHONPATH.