Cellar

Cellar is an experiment to see if I can make the 'pip of salt formulas' which absence if for me the biggest weakness of salt.

Cellar is at its very early stage of development.

You need git to be installed for this to run.

Installation

pip install cellar

Usage

Quite simple:

cellar list  # list all available formulas (from https://github.com/saltstack-formulas)
cellar install <list of formulas>
cellar uninstall <list of formulas>
cellar update <list of formulas, if empty, update all>

You can also install a formula of a custom github repository using the pattern /:

cellar install <username>/<repository>

# stupid example
cellar install saltstack-formulas/openssh-formula

You can also use a git url this way:

cellar install <git url>

# stupid example
cellar install git@github.com:saltstack-formulas/openssh-formula.git

Cellar is expecting the repository to have, either, a directory or a .sls file with the same name than the repository.

If the repository name contains "-formula", it will be removed from the expected name. Meaning that you can name your repository stuff-formula and put inside either a stuff directory or a stuff.sls.

formulas.txt

Alternatively, you can write a formulas.txt file that contains on each line an argument to the command install.

Example:

# you can also write comments in it
dhcpd
saltstack-formulas/canvas-formula
git@github.com:saltstack-formulas/docker-formula.git
https://github.com/saltstack-formulas/epel-formula.git

Then run cellar install without any arguments:

cellar install

Configuring your formula repository with a formula.yml

You can write a formula.yml (so, in yaml, like your sls files) file at the root of your formula repository to add configuration informations. Here is a template, everything is optional:

# list of required formulas on which this formula depends
install_requires:
  - dependancy1
  - dependancy2
  - ...

This file is optional.

For now, I'm planning on using the same key than in a python setup.py file.