cookbook 'lxmx_oh_my_zsh', '= 0.4.1'
lxmx_oh_my_zsh (3) Versions 0.4.1 Follow2
A chef cookbook to install and configure oh-my-zsh
cookbook 'lxmx_oh_my_zsh', '= 0.4.1', :supermarket
knife supermarket install lxmx_oh_my_zsh
knife supermarket download lxmx_oh_my_zsh
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:
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
Dependent cookbooks
user >= 0.0.0 |
ark >= 0.0.0 |
zsh >= 0.0.0 |
Contingent cookbooks
There are no cookbooks that are contingent upon this one.