lxmx_oh_my_zsh

Description

This cookbook features:

• A Chef LWRP to install oh-my-zsh for system users.
• A companion recipe for user::data_bag which adds an oh-my-zsh per user installation option.

Usage

Include recipe[lxmx_oh_my_zsh] in your run_list and lxmx_oh_my_zsh_user resource will become available.

The lxmx_oh_my_zsh::data_bag recipe assumes that you're using the user::data_bag recipe from the excellent user cookbook. It lets you configure oh-my-zsh installation in user specific data_bags, e.g.

{
  "id"        : "testman",
  "home"      : "/home/testman"
  ...
  "oh-my-zsh" : { "enabled": true, "theme": "wedisagree", "plugins": ["git", "rvm"] }
}

Requirements

Platform

This cookbook has been tested with the following OSes:

• centos / redhat
• ubuntu
• gentoo

Cookbooks

The cookbook has got the following dependencies:

• user
• ark
• zsh

Recipes

default

No-op, does nothing.

data_bag

Processes node['users'] and installs oh-my-zsh for the ones whose data_bags enable it, e.g.

{ 
  "id"        : "ranger",
  ...
  "oh-my-zsh" : { "enabled": true }
}

Resources and Providers

lxmx_oh_my_zsh_user

Actions

<table> <thead> <tr> <th>Action</th> <th>Description</th> <th>Default</th> </tr> </thead> <tbody> <tr> <td>create</td> <td> Download oh-my-zsh into <code>~/.oh-my-zsh</code>, create and populate <code>~/.zshrc</code>. </td> <td>Yes</td> </tr> </tbody> </table>

Attributes

<table> <thead> <tr> <th>Attribute</th> <th>Description</th> <th>Default Value</th> </tr> </thead> <tbody> <tr> <td>login</td> <td><b>Name attribute:</b> The login of the user.</td> <td><code>nil</code></td> </tr> <tr> <td>home</td> <td>User's home directory.</td> <td><code>/home/<i>username</i></code> or <code>/root</code></td> </tr> <tr> <td>theme</td> <td>Theme to use</td> <td><code>alanpeabody</code></td> </tr> <tr> <td>plugins</td> <td>Plugins to enable</td> <td><code>[]</code></td> </tr> <tr> <td>case_sensitive</td> <td>Use case sensitive completion</td> <td><code>false</code></td> </tr> <tr> <td>autocorrect</td> <td>Use autocorrection feature</td> <td><code>true</code></td> </tr> </tbody> </table>

Example

lxmx_oh_my_zsh_user 'jessie' do
  plugins        %w{git ruby}
  autocorrect    false
  case_sensitive true
end

License

Copyright:: Vasily Mikhaylichenko and LxMx.

Licensed under BSD license.

http://opensource.org/licenses/BSD-2-Clause