Build Status Gem Version Code Climate Gemnasium License

Poise-boiler is a set of helpers to reduce boilerplate in Poise/Halite style gems.


poise-boiler depends on a base set of useful gems for building Halite cookbooks. Make sure you only add it as a development dependency:

spec.add_development_dependency('poise-boiler', '~> 1.0')


The spec_helper sets up chefspec, rspec-its, and simplecov. Coverage reporting is also configured for CodeClimate and CodeCov if the relevant environment variables are set. The Halite spec helper is also enabled by default:

require 'poise_boiler/spec_helper'

You can disable the Halite spec helper if needed:

require 'poise_boiler'
PoiseBoiler.include_halite_spec_helper = false
require 'poise_boiler/spec_helper'


The Rakefile helper sets up the standard gem tasks, the Halite helper tasks, and a spec task to run unit tests.

require 'poise_boiler/rakefile'

Rake Tasks


Run all tests, specs, foodcritic, and kitchen.


Run Rspec tests.


Generate README badges for a project.

debug, quiet, verbose

Set the relevant mode environment variables. Can be abbreviated d, q, and v.


List uncommitted file changes and commits since the last release.


Run quiet check for all projects. This is specific to my folder layout and is less likely to work for others.


Run tests for Travis CI. This does some setup and then runs rake test.

release, release:minor, release:major

Create a new release and push toe RubyGems and Supermarket.


The .kitchen.yml helper sets up a default driver and default values for platforms and chef versions (used by knife-travis).

#<% require 'poise_boiler' %>
<%= PoiseBoiler.kitchen %>

- name: default
  - recipe[mycook]

You can also quickly customize the platforms using platform aliases:

<%= PoiseBoiler.kitchen(platforms: 'ubuntu') %>

You can always redefine a top-level key that has a default setting as well:

#<% require 'poise_boiler' %>
<%= PoiseBoiler.kitchen %>

- name: arch

- name: default
  - recipe[mycook]

Available Aliases

  • ubuntu – ubuntu-12.04, ubuntu-14.04
  • rhel – centos-6.5, ubuntu-7
  • centos – rhel
  • linux – ubuntu, rhel


Copyright 2015-2016, Noah Kantrowitz

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


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.