Prerequisites

You will need the following software installed:

• Python >= 2.7

• jinja2

• lxml

lxml is the only one which needs a compiler to install. If this is an issue, I would recomend the great Anaconda Python Distribution which includes all the prerequisites installed by default.

Installing

You can install the latest stable version with the following command:

$ pip install plugemin

or for the latest development version, you can use the following command:

$ pip install git+https://github.com/ilovetux/plugemin.git

Running the tests

In order to run the tests, you will need to clone the repository and kick off the tests with a single command. All of that can be done with the following commands:

$ git clone https://github.com/ilovetux/plugemin
$ cd plugemin
$ python setup.py nosetests

That’s it, the tests should pass, if they don’t please open an issue and be sure to include:

• The commands you ran to get your results

• The versions of Python, lxml and jinja2 you have installed

• What Operating system

• Any details which would cause your setup to be considered non-standard such as running an obscure version of Linux

Basic Usage

Plugemin will look for templates in a series of locations and take a structured data format as input. It will render the template with each piece of data.

Example

in C:\plugemin\templates\backup-delete.j2:

cp {{src}} {{dst}}
rm {{src}}

in C:\tmp\files.csv:

src,dst
/var/log/*,/tmp/.
/usr/var/log/*,/tmp/.
/var/www/*,/tmp/.

Then you can use the following command:

C:\> plugemin -t backup-delete.j2 -d C:\plugemin\files.csv
cp /var/log/* /tmp/.
rm /var/log/*
cp /usr/var/log/* /tmp/.
rm /usr/var/log/*
cp /var/www/* /tmp/.
rm /var/www/*