This repository has been archived by the owner. It is now read-only.
Chef LWRP to install and configure oh-my-zsh for your users
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
providers
recipes
resources
templates/default
test
.gitignore
.kitchen.yml
.travis.yml
Berksfile
CHANGELOG.md
Gemfile
README.md
Rakefile
metadata.rb

README.md

lxmx_oh_my_zsh

Moved to https://gitlab.com/lxmx-tech/chef-oh-my-zsh

Build Status

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

Action Description Default
ensure Install only if ~/.oh-my-zsh or ~/.zshrc is missing. Yes
update Install oh-my-zsh into ~/.oh-my-zsh, create and populate ~/.zshrc. No

Attributes

Attribute Description Default Value
login Name attribute: The login of the user. nil
home User's home directory. /home/username or /root
theme Theme to use alanpeabody
plugins Plugins to enable []
case_sensitive Use case sensitive completion false
autocorrect Use autocorrection feature true

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