zshell cookbook

This is a Chef cookbook to install and configure zshell.

There are 2 LWRPs present, one for arbitrary commands to be added to the shell initialisation (zshell_rcfile) and the other to install and configure antigen (zshell_antigen).

Usage

In order to install zsh you just need to include the default recipe in your node's run_list:

In a recipe:

include 'zshell::default'

In a role:

{
  "run_list": [
    "recipe[zshell::default]"
  ]
}

LWRP

<a id="zshell_rcfile"></a>zshell_rcfile

This LWRP supports two actions:
* :create (default)
* :delete

Defining the file's content inline with content

This snippet creates a file called ~/.zshrc.d/10-java_home.zsh for user username.

zshell_rcfile 'java_home' do
  user 'username'
  content 'JAVA_HOME=/usr/java'
  order '10'
  action :create
end

Passing a template to be rendered

This creates a file called ~/.zshrc.d/20-complex_setup.zsh.

zshell_rcfile 'complex_setup' do
  user 'username'
  source 'rcfile.erb'
  cookbook 'my_wrapper_cookbook'
  variables({
    :my_template_variable => 'some value'
  })
  order '20'
  action :create
end

<a id="zshell_antigen"></a>zshell_antigen

This LWRP supports two actions:
* :enable (default)
* :disable

zshell_antigen 'username' do
  completion_waiting_dots true
  use [ 'oh-my-zsh' ]
  theme 'agnoster'
  bundle [ 'git', 'bundler' ]
  action :enable
end

Author

Cassiano Leal (email | twitter | github)