Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status


bash-it (8) Versions 0.1.5

Installs/Configures bash-it

cookbook 'bash-it', '~> 0.1.5', :supermarket
cookbook 'bash-it', '~> 0.1.5'
knife supermarket install bash-it
knife supermarket download bash-it
Quality 33%

bash-it Build Status Cookbook Version License

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

Bash it Booby Theme (Dark)


  • apt cookbook
  • yum cookbook
  • git cookbook


The node['bash-it']['instance_default'] attributes are parsed out as defaults for the bash_it_instance resource

The node['bash-it']['repository'] and node['bash-it']['revision'] attributes are used to specify the git repo and revision to clone down bash-it from. It defaults to the official bash-it repo

The node['bash-it']['users'] attribute is an array of usernames that should have bash-it installed accoring to the instance defaults. FYI: I will probably deprecate this in the future

See attributes/default.rb for more details



  • Apt & Yum Recipes
  • Install Git
  • 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


This recipe will install a global version of bash-it for all users on the system. I don't like this approach personally because it is not flexible and a shell should be configurable to a user's own preferances when possible

In any event, to use this recipe you just need to include bash-it::global

Note: You might need the bash-it::default recipe to install dependencies as well

This recipe will use the node['bash-it']['instance_default'] keys to determine plugins, aliases, ect.



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_default'] hash so that you can easily override the defaults


# 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'

# Instance with a different theme

bash_it_instance 'edhurtig' do
  theme 'candy'

# 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 '' # 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


Include this recipe in a wrapper cookbook:

depends 'bash-it', '~> 1.0'
# Install bash it globally using the node['bash-it']['instance_default'] attributes
include_recipe 'bash-it::global'

# Install an instance of bash-it for a specific user using the defaults
bash_it_instance 'edhurtig'


See the Issues


  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 (

Dependent cookbooks

git >= 0.0.0
apt >= 0.0.0
yum >= 0.0.0

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

Change Log for bash-it

All notable changes to this project will be documented in this file.
This project adheres to Semantic Versioning.



[0.1.5] - 2015-08-04


  • Added a user and group attribute to bash_it_instance. User attribute defaults to name attribute if not specified. Group will default to root. Used to set the owner and group of files created

[0.1.4] - 2015-06-23


  • Fixed a potential security problem in the bashrc template where the .exports file could exist outside the user's home directory and an unexpected .exports file could be sourced upon reload

[0.1.3] - 2015-06-17


  • The bashrc template to check if there are any files matching ~/.bashrc_* before iterating


  • Docker from the default list of plugins and aliasses

[0.1.2] - 2015-06-15


  • An unnessesary only_if guard

[0.1.1] - 2015-06-15


  • Fixed Issue #3 where items that were previously enabled were not being disabled

0.1.0 - 2015-06-15


  • Global bash-it installation support
  • CentOS Platform to TK
  • integration to repo



0.0.2 - 2015-06-09


  • templates_cookbook attribute to bash_it_instance LWRP for wrapper cookbooks


  • Fixed Issue #1 where a stateful bug caused convergence failures


0.0.1 - 2015-06-06


  • Initial Release w/ bash_it_instance LWRP

Collaborator Number Metric

0.1.5 failed this metric

Failure: Cookbook has 0 collaborators. A cookbook must have at least 2 collaborators to pass this metric.

Contributing File Metric

0.1.5 passed this metric

Foodcritic Metric

0.1.5 failed this metric

FC085: Resource using new_resource.updated_by_last_action to converge resource: bash-it/providers/instance.rb:57
FC085: Resource using new_resource.updated_by_last_action to converge resource: bash-it/providers/instance.rb:69
Run with Foodcritic Version 16.3.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

No Binaries Metric

0.1.5 passed this metric

Testing File Metric

0.1.5 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must contain a file

Version Tag Metric

0.1.5 failed this metric

Failure: To pass this metric, your cookbook metadata must include a source url, the source url must be in the form of, and your repo must include a tag that matches this cookbook version number