bashd

This cookbook provide LWRPs for managing .bash.d snippets for some user.
Those snthat will be executed on user login, and very useful for setupping user's environment variables, bash prompt and so on stuff.
Also it allows you to well structure these scripts.

Features

resource for create .bash.d folder for bash snippets and include all .sh files from the folder with include command in .bashrc file. It adds that include command to the .bashrc file.
resource for create and delete those bash snippets from templates.

Requirements

Platform

Tested on Debian 7

Attribute	Type	Description	Default
`user`	String	User who will get .bash.d snippets. Name attribute.	`root`

bashd_entry resource

Attribute	Type	Description	Default
`snippet`	String	Snippet name, and at the same time .sh.erb template name (if template source isn't specified). Name attribute	`nil`
`user`	String	User who will get .bash.d snippets	`root`
`cookbook`	String	Cookbook that contain snippet's erb template	`nil`
`source`	String	snippet's erb template name	`nil`
`variables`	Hash	Hash with variables that should be passed to snippets template	`{}`
`content`	String	Alternate method to specify snippet content. Just add it to this attribute. template/source/variables attribute will be ignored if this attribute is not nil	`nil`

Usage

Add bashd cookbook to your metadata.rb dependency, like:

depends 'bashd', '~> 0.2.0'

Install bashd

Add to recipe:

bashd 'username'

This will:

create username_home_dir_from_passwd_file/.bash.d folder
The folder will have username as owner, and username's primary group as a group.
Add directive to .bash.rc file to include any .sh file from ~/.bash.d folder

When no user specified, username will be root (by default).

Create snippet

With template

To create new snippet with template:

create erb template for snippet
if it has snippet_name.sh.erb (snippet_name same as snippet attribute) name it will be used automagically
if it has anyothername.erb name it need to be specified in template attribute

Add to your recipe:

bashd_entry 'snippet_name' do
  user 'username'
  action :create
end

This will create ~/.bash.d/snippet_name.sh snippet in ~/.bash.d dir, from snippet_name.sh.erb template.
The snippet will have username as owner, and username's primary group as a group.

With a content attribute

To create new snippet with a content attribute:

if you use content attribute it will override any template/source/variables attributes.
By default content attribute is nil

bashd_entry 'snippet_name' do
  user 'username'
  content 'export FOO=bar'
  action :create
end

This will create ~/.bash.d/snippet_name.sh snippet in ~/.bash.d dir, from content attribute.
The snippet will have username as owner, and username's primary group as a group.

Delete snippet

Add to your recipe:

bashd_entry 'snippet_name' do
  user 'username'
  action :remove
end

This will remove ~/.bash.d/snippet_name.sh snippet for user username.

Tests

Integration tests can be runned via Test Kitchen.

The default .kitchen.yml assumes that you are testing using the vagrant driver, but if you have AWS or DigitalOcean account, you can change the driver and run the tests on remote hosts. To run the tests, exec:

bundle install
bundle exec kitchen verify

Contributing

Fork it
Create your feature branch (git checkout -b my-new-feature)
Write you change
Write tests for your change (if applicable)
Run the tests, ensuring they all pass
Commit your changes (git commit -am 'Added some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request

License and Authors

Author:: Kostiantyn Lysenko (gshaud@gmail.com)

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

jakshi / bashd