salt-pepper 0.7.6

Description:

saltpepper 0.7.6

Pepper contains a Python library and CLI scripts for accessing a remote
salt-api instance.
pepperlib abstracts the HTTP calls to salt-api so existing Python
projects can easily integrate with a remote Salt installation just by
instantiating a class.
The pepper CLI script allows users to execute Salt commands from computers
that are external to computers running the salt-master or salt-minion
daemons as though they were running Salt locally. The long-term goal is to add
additional CLI scripts maintain the same interface as Salt’s own CLI scripts
(salt, salt-run, salt-key, etc).
It does not require any additional dependencies and runs on Python 2.5+ and
Python 3. (Python 3 support is new, please file an issue if you encounter
trouble.)

Installation
pip install salt-pepper


Usage
Basic usage is in heavy flux. You can run pepper using the script in %PYTHONHOME%/scripts/pepper (a pepper.cmd wrapper is provided for convenience to Windows users).
export SALTAPI_USER=saltdev SALTAPI_PASS=saltdev SALTAPI_EAUTH=pam
pepper '*' test.ping
pepper '*' test.kwarg hello=dolly
Examples leveraging the runner client.
pepper --client runner reactor.list
pepper --client runner reactor.add event='test/provision/*' reactors='/srv/salt/state/reactor/test-provision.sls'


Configuration
You can configure pepper through the command line, using environment variables
or in a configuration file $HOME/.pepperrc with the following syntax :
[main]
SALTAPI_URL=https://localhost:8000/
SALTAPI_USER=saltdev
SALTAPI_PASS=saltdev
SALTAPI_EAUTH=pam


Contributing
Please feel free to get involved by sending pull requests or join us on the
Salt mailing list or on IRC in #salt or #salt-devel.
This repo follows the same contributing guidelines as Salt and uses
separate develop and master branches for in-progress additions and bug-fix
changes respectively.