bash-it

Installs Bash it which is an easy way to make your bash shell awesome

Requirements

• apt cookbook
• yum cookbook
• git cookbook

Recipes

default

Installs Git and will automatically configure Bash it for users specified in node['bash-it']['users']

This recipe is not nessesary so long as git is installed before using the bash_it_instance LWRP

Resources

bash_it_instance

To install Bash it for a user you simply put bash_it_instance <username> in your recipe. This is best placed in your users cookbook if you have one.

Default attributes for the bash_it_instance are stored as node attributes in the node['bash-it']['instance_defaults'] hash so that you can easily override the defaults

Examples

# Install Bash it for eddie's user

bash_it_instance 'edhurtig'

# Install Bash it for the root user

bash_it_instance 'root' do
  home '/root'
end

# Instance with a different theme

bash_it_instance 'edhurtig' do
  theme 'candy'
end

# the full set of options

bash_it_instance 'edhurtig' do
    home '/home/edhurtig-custom' # A custom home dir
    theme 'dulice' # Any Bash it theme
    git 'git@git.hurtigtechnologies.com' # Custom Git Server
    scm_check true # Whether to check for SCM continuously
    plugins %w( base history ruby  ) # An array of plugins that should be active
    aliases %w( git rails tmux ) # An array of aliases that should be active
    completions %w( git ssh tmux test-kitchen ) # An array of completions that should be active
end

Usage

Include this recipe in a wrapper cookbook:

depends 'bash-it', '~> 1.0'

include_recipe 'bash-it::default'

TODO

• Fix node attributes are read only bug issue #1
• Add recipe to install bash it globally

Contributing

1. Fork the repository on Github
2. Create a named feature branch (like add_component_x)
3. Write your change
4. Write tests for your change (if applicable)
5. Run the tests with kitchen test, ensuring they all pass
6. Submit a Pull Request using Github

License and Authors

Author:: Eddie Hurtig (admin@hurtigtechnologies.com)