chef

https://github.com/opscode/chef

Ruby

A systems integration framework, built to bring the benefits of configuration management to your entire infrastructure.

Chef::Mixin::WhyRun::ResourceRequirements::Assertion#block_action!

Prevents associated actions from being invoked in whyrun mode.
This will also stop further processing of assertions for a given action.

An example from the template provider: if the source template doesn't exist
we can't parse it in the action_create block of template - something that we do
even in whyrun mode.  Because the source template may have been created in an earlier
step, we still want to keep going in whyrun mode.

assert(:create, :create_if_missing) do |a|
  a.assertion { File::exists?(@new_resource.source) }
  a.whyrun "Template source file does not exist, assuming it would have been created."
  a.block_action!
end

Source | Google | Stack overflow

Edit

git clone [email protected]:opscode/chef.git

cd chef

open lib/chef/mixin/why_run.rb

Contribute

# Make a new branch

git checkout -b -your-name--update-docs-Chef--Mixin--WhyRun--ResourceRequirements--Assertion-block_action--for-pr

# Commit to git

git add lib/chef/mixin/why_run.rbgit commit -m "better docs for Chef::Mixin::WhyRun::ResourceRequirements::Assertion#block_action!"

# Open pull request

gem install hub # on a mac you can `brew install hub`

hub fork

git push <your name> -your-name--update-docs-Chef--Mixin--WhyRun--ResourceRequirements--Assertion-block_action--for-pr

hub pull-request

# Celebrate!