bozo 0.3.8 → 0.4.0

data/VERSION

@@ -1 +1 @@
-0.3.8
+0.4.0

data/bin/bozo

@@ -1,9 +1,9 @@
-#!/usr/bin/env ruby
-$:.push File.expand_path(File.dirname(File.realpath(__FILE__)) + '/../lib')
-
-require "bundler/setup"
-require "rainbow"
-require "bozo"
-
-# Invoke the command
+#!/usr/bin/env ruby
+$:.push File.expand_path(File.dirname(File.realpath(__FILE__)) + '/../lib')
+
+require "bundler/setup"
+require "rainbow"
+require "bozo"
+
+# Invoke the command
 exit GLI.run(ARGV)

data/lib/bozo.rb

@@ -1,131 +1,132 @@
-$:.push File.expand_path(File.dirname(__FILE__))
-
-require 'rubygems'
-require 'rainbow'
-require 'rainbow/ext/string'
-require 'gli'
-require 'gli_version'
-require 'bozo/bozo'
-require 'bozo/class_name_helpers'
-require 'bozo/logging'
-require 'bozo/runner'
-require 'bozo/executor'
-require 'bozo/bozo_configuration'
-require 'bozo/configuration_error'
-require 'bozo/execution_error'
-require 'bozo/versioning/version'
-require 'bozo/versioning/version_bumper'
-require 'bozo/versioning/version_bump_error'
-
-include GLI
-
-# Set the location of the bozo runtime configuration file
-config_file '.bozorc'
-
-version Bozo::VERSION
-
-desc 'Run as a build server, allows more destructive actions'
-switch 'build-server'
-
-default_config_file = 'bozorc.rb'
-
-desc "The build configuration file (defaults to #{default_config_file})"
-default_value default_config_file
-arg_name 'path'
-flag 'config-file'
-
-default_environment = 'development'
-
-desc "The build environment (defaults to #{default_environment})"
-default_value default_environment
-arg_name 'name'
-flag :environment
-
-pre do |global_options, command, options, arguments|
-  # Load the configuration file.
-  config = Bozo::BozoConfiguration.new
-  config.load global_options[:'config-file']
-
-  puts "Building #{config.version} using Bozo #{Bozo::VERSION}"
-  puts ''
-
-  # Initialize the executor.
-  @executor = Bozo::Executor.new config, global_options
-
-  true
-end
-
-# Helper method for defining a command that invokes a bozo task.
-#
-# The first provided name will be passed on to bozo.
-#
-# Takes an optional block for defining command-specific flags and switches.
-#
-# @param [Symbol] command_names
-#     The names to give the command.
-def bozo_command(*command_names)
-  command_name = command_names.first
-  command command_names do |c|
-    yield c if block_given?
-    c.action do |global_options, options, arguments|
-      @executor.execute command_name, options, ENV.to_hash
-    end
-  end
-end
-
-desc 'Remove bozo and all its artifacts'
-bozo_command :uninstall
-
-desc 'Remove all build artifacts'
-bozo_command :clean
-
-desc 'Retrieve all project dependencies'
-bozo_command :dependencies
-
-desc 'Prepare the project'
-bozo_command :prepare
-
-desc 'Compile the project'
-bozo_command :compile, :c
-
-desc 'Run the tests for the project'
-bozo_command :test, :t
-
-desc 'Create a package'
-bozo_command :package, :p do |c|
-  c.desc 'Force a pre-release package to be created'
-  c.switch 'pre-release'
-end
-
-desc 'Publish a package'
-bozo_command :publish do |c|
-  c.desc 'Force a pre-release package to be published'
-  c.switch 'pre-release'
-end
-
-desc 'Bump the version number'
-long_desc <<EOS
-  Specify either 'major', 'minor' or 'patch' as an argument. For example: `bozo bump major`
-EOS
-command :bump do |c|
-  c.action do |global_options, options, args|
-    if args.empty?
-      puts "Specify either 'major', 'minor' or 'patch' as an argument"
-    else
-      version_bumper = Bozo::Versioning::VersionBumper.new
-      version_bumper.bump args[0].to_sym
-    end
-  end
-end
-
-on_error do |exception|
-  puts exception.inspect.color(:red).bright
-
-  if exception.kind_of? Bozo::ExecutionError or exception.kind_of? Bozo::ConfigurationError
-    false
-  else
-    puts ''
-    puts exception.backtrace.join("\n").color(:red)
-    true
-  end
+$:.push File.expand_path(File.dirname(__FILE__))
+
+require 'rubygems'
+require 'rainbow'
+require 'rainbow/ext/string'
+require 'gli'
+require 'gli_version'
+require 'bozo/bozo'
+require 'bozo/class_name_helpers'
+require 'bozo/logging'
+require 'bozo/build_dependency_resolver'
+require 'bozo/runner'
+require 'bozo/executor'
+require 'bozo/bozo_configuration'
+require 'bozo/configuration_error'
+require 'bozo/execution_error'
+require 'bozo/versioning/version'
+require 'bozo/versioning/version_bumper'
+require 'bozo/versioning/version_bump_error'
+
+include GLI
+
+# Set the location of the bozo runtime configuration file
+config_file '.bozorc'
+
+version Bozo::VERSION
+
+desc 'Run as a build server, allows more destructive actions'
+switch 'build-server'
+
+default_config_file = 'bozorc.rb'
+
+desc "The build configuration file (defaults to #{default_config_file})"
+default_value default_config_file
+arg_name 'path'
+flag 'config-file'
+
+default_environment = 'development'
+
+desc "The build environment (defaults to #{default_environment})"
+default_value default_environment
+arg_name 'name'
+flag :environment
+
+pre do |global_options, command, options, arguments|
+  # Load the configuration file.
+  config = Bozo::BozoConfiguration.new
+  config.load global_options[:'config-file']
+
+  puts "Building #{config.version} using Bozo #{Bozo::VERSION}"
+  puts ''
+
+  # Initialize the executor.
+  @executor = Bozo::Executor.new config, global_options
+
+  true
+end
+
+# Helper method for defining a command that invokes a bozo task.
+#
+# The first provided name will be passed on to bozo.
+#
+# Takes an optional block for defining command-specific flags and switches.
+#
+# @param [Symbol] command_names
+#     The names to give the command.
+def bozo_command(*command_names)
+  command_name = command_names.first
+  command command_names do |c|
+    yield c if block_given?
+    c.action do |global_options, options, arguments|
+      @executor.execute command_name, options, ENV.to_hash
+    end
+  end
+end
+
+desc 'Remove bozo and all its artifacts'
+bozo_command :uninstall
+
+desc 'Remove all build artifacts'
+bozo_command :clean
+
+desc 'Retrieve all project dependencies'
+bozo_command :dependencies
+
+desc 'Prepare the project'
+bozo_command :prepare
+
+desc 'Compile the project'
+bozo_command :compile, :c
+
+desc 'Run the tests for the project'
+bozo_command :test, :t
+
+desc 'Create a package'
+bozo_command :package, :p do |c|
+  c.desc 'Force a pre-release package to be created'
+  c.switch 'pre-release'
+end
+
+desc 'Publish a package'
+bozo_command :publish do |c|
+  c.desc 'Force a pre-release package to be published'
+  c.switch 'pre-release'
+end
+
+desc 'Bump the version number'
+long_desc <<EOS
+  Specify either 'major', 'minor' or 'patch' as an argument. For example: `bozo bump major`
+EOS
+command :bump do |c|
+  c.action do |global_options, options, args|
+    if args.empty?
+      puts "Specify either 'major', 'minor' or 'patch' as an argument"
+    else
+      version_bumper = Bozo::Versioning::VersionBumper.new
+      version_bumper.bump args[0].to_sym
+    end
+  end
+end
+
+on_error do |exception|
+  puts exception.inspect.color(:red).bright
+
+  if exception.kind_of? Bozo::ExecutionError or exception.kind_of? Bozo::ConfigurationError
+    false
+  else
+    puts ''
+    puts exception.backtrace.join("\n").color(:red)
+    true
+  end
 end

data/lib/bozo/bozo.rb

@@ -1,7 +1,7 @@
-# The top level module for Bozo's functionality.
-module Bozo
-  
-  # The version of Bozo in use.
-  VERSION = File.read(File.expand_path(File.dirname(File.realpath(__FILE__)) + '/../../VERSION')).strip
-
+# The top level module for Bozo's functionality.
+module Bozo
+  
+  # The version of Bozo in use.
+  VERSION = File.read(File.expand_path(File.dirname(File.realpath(__FILE__)) + '/../../VERSION')).strip
+
 end

data/lib/bozo/bozo_configuration.rb

@@ -1,300 +1,320 @@
-module Bozo
-
-  # Class used for defining the configuration of a build.
-  class BozoConfiguration
-
-    include Bozo::ClassNameHelpers
-    
-    # Creates a new instance
-    def initialize
-      @build_tools_location = nil
-      @compilers = []
-      @dependency_resolvers = []
-      @hooks = []
-      @packagers = []
-      @preparers = []
-      @publishers = []
-      @test_runners = []
-      @version = nil
-    end
-    
-    # Loads the configuration from the specified file.
-    # 
-    # @param [String] path
-    #     The path to the configuration file.    
-    def load(path)
-      instance_eval IO.read(path), path
-    end
-
-    # The version of the project to build.
-    def version
-      @version ||= Versioning::Version.load_from_file
-    end
-
-    # The location of the base build tools.
-    #
-    # Sets and returns the location if a value is provided, otherwise returns
-    # the current value.
-    #
-    # It is expected the build tools will be in sub-directory of this location
-    # according to the name of the tool and that the runner will be able to
-    # copy the contents of the sub-directory to a local directory via the
-    # `FileUtils.cp_r` method.
-    #
-    # @param [String] location
-    #     The path to set as the build tools location.
-    def build_tools_location(location = nil)
-      @build_tools_location = location if location
-      @build_tools_location
-    end
-
-    # Returns the all the build tools required by the specified compilers,
-    # dependency resolvers, hooks, packagers, publishers and test runners.
-    def build_tools
-      build_tools = get_build_tools @compilers
-      build_tools |= get_build_tools @dependency_resolvers
-      build_tools |= get_build_tools @hooks
-      build_tools |= get_build_tools @packagers
-      build_tools |= get_build_tools @preparers
-      build_tools |= get_build_tools @publishers
-      build_tools | (get_build_tools @test_runners)
-    end
-
-    # Returns the configured dependency resolvers.
-    attr_reader :dependency_resolvers
-
-    # Adds an instance of the named preparer to the preparer collection and
-    # yields it to the configuration block when one is specified.
-    #
-    # @param [Symbol] type
-    #     The name of the preparer.
-    # @param [Proc] block
-    #     Optional block to refine the configuration of the preparer.
-    def prepare(type, &block) # :yields: preparer
-      add_instance @preparers, Bozo::Preparers, type, block
-    end
-
-    # Returns the configured preparers.
-    attr_reader :preparers
-
-    # Adds an instance of the named dependency resolver to the dependency
-    # resolver collection and yields it to the configuration block when one
-    # is specified.
-    #
-    # @param [Symbol] type
-    #     The name of the dependency resolver.
-    # @param [Proc] block
-    #     Optional block to refine the configuration of the dependency
-    #     resolver.
-    def resolve_dependencies_with(type, &block) # :yields: dependency_resolver
-      add_instance @dependency_resolvers, Bozo::DependencyResolvers, type, block
-    end
-
-    # Returns the configured compilers.
-    attr_reader :compilers
-
-    # Adds an instance of the named compiler to the compiler collection and
-    # yields it to the configuration block when one is specified.
-    #
-    # @param [Symbol] type
-    #     The name of the compiler.
-    # @param [Proc] block
-    #     Optional block to refine the configuration of the compiler.
-    def compile_with(type, &block) # :yields: compiler
-      add_instance @compilers, Bozo::Compilers, type, block
-    end
-
-    # Returns the configured test runners.
-    attr_reader :test_runners
-
-    # Adds an instance of the named test runner to the test runner collection
-    # and yields it to the configuration block when one is specified.
-    #
-    # @param [Symbol] type
-    #     The name of the test runner.
-    # @param [Proc] block
-    #     Optional block to refine the configuration of the test runner.
-    def test_with(type, &block) # :yields: test_runner
-      add_instance @test_runners, Bozo::TestRunners, type, block
-    end
-
-    # Returns the configured packagers.
-    attr_reader :packagers
-
-    # Adds an instance of the named packager to the packager collection and
-    # yields it to the configuration block when one is specified.
-    #
-    # @param [Symbol] type
-    #     The name of the packager.
-    # @param [Proc] block
-    #     Optional block to refine the configuration of the packager.
-    def package_with(type, &block) # :yields: packager
-      add_instance @packagers, Bozo::Packagers, type, block
-    end
-
-    # Returns the configured publishers.
-    attr_reader :publishers
-
-    # Adds an instance of the named publisher to the publisher collection and
-    # yields it to the configuration block when one is specified.
-    #
-    # @param [Symbol] type
-    #     The name of the publisher.
-    # @param [Proc] block
-    #     Optional block to refine the configuration of the publisher.
-    def publish_with(type, &block) # :yields: publisher
-      add_instance @publishers, Bozo::Publishers, type, block
-    end
-
-    # Returns the configured hooks.
-    attr_reader :hooks
-
-    # Adds an instance of the named hook to the hook collection and yields it
-    # to the configuration block when one is specified.
-    #
-    # @param [Symbol] type
-    #     The name of the hook.
-    # @param [Proc] block
-    #     Optional block to refine the configuration of the hook.
-    def with_hook(type, &block) # :yields: hook
-      add_instance @hooks, Bozo::Hooks, type, block
-    end
-
-    # Adds an instance of the named hook to the hook collection and yields it
-    # to the configuration block when one is specified.
-    alias :pre_build :with_hook
-
-    # Adds an instance of the named hook to the hook collection and yields it
-    # to the configuration block when one is specified.
-    alias :pre_clean :with_hook
-
-    # Adds an instance of the named hook to the hook collection and yields it
-    # to the configuration block when one is specified.
-    alias :post_clean :with_hook
-
-    # Adds an instance of the named hook to the hook collection and yields it
-    # to the configuration block when one is specified.
-    alias :pre_uninstall :with_hook
-
-    # Adds an instance of the named hook to the hook collection and yields it
-    # to the configuration block when one is specified.
-    alias :post_uninstall :with_hook
-
-    # Adds an instance of the named hook to the hook collection and yields it
-    # to the configuration block when one is specified.
-    alias :pre_dependencies :with_hook
-
-    # Adds an instance of the named hook to the hook collection and yields it
-    # to the configuration block when one is specified.
-    alias :post_dependencies :with_hook
-
-    # Adds an instance of the named hook to the hook collection and yields it
-    # to the configuration block when one is specified.
-    alias :pre_prepare :with_hook
-
-    # Adds an instance of the named hook to the hook collection and yields it
-    # to the configuration block when one is specified.
-    alias :post_prepare :with_hook
-
-    # Adds an instance of the named hook to the hook collection and yields it
-    # to the configuration block when one is specified.
-    alias :pre_compile :with_hook
-
-    # Adds an instance of the named hook to the hook collection and yields it
-    # to the configuration block when one is specified.
-    alias :post_compile :with_hook
-
-    # Adds an instance of the named hook to the hook collection and yields it
-    # to the configuration block when one is specified.
-    alias :pre_test :with_hook
-
-    # Adds an instance of the named hook to the hook collection and yields it
-    # to the configuration block when one is specified.
-    alias :post_test :with_hook
-
-    # Adds an instance of the named hook to the hook collection and yields it
-    # to the configuration block when one is specified.
-    alias :pre_package :with_hook
-
-    # Adds an instance of the named hook to the hook collection and yields it
-    # to the configuration block when one is specified.
-    alias :post_package :with_hook
-
-    # Adds an instance of the named hook to the hook collection and yields it
-    # to the configuration block when one is specified.
-    alias :pre_publish :with_hook
-
-    # Adds an instance of the named hook to the hook collection and yields it
-    # to the configuration block when one is specified.
-    alias :post_publish :with_hook
-
-    # Adds an instance of the named hook to the hook collection and yields it
-    # to the configuration block when one is specified.
-    alias :post_build :with_hook
-    
-    private
-
-    # Resolves the named class within the given namespace and then created an
-    # instance of the class before adding it to the given collection and
-    # yielding it to the configuration block when one is provided.
-    #
-    # @param [Array] collection
-    #     The collection the step executor should be added to once created.
-    # @param [Module] namespace
-    #     The module the named step executor should be found in.
-    # @param [Symbol] type
-    #     The name of the step executor.
-    # @param [Proc] block
-    #     Optional block to refine the configuration of the step executor.
-    def add_instance(collection, namespace, type, block)
-      instance = namespace.const_get(to_class_name(type)).new
-      instance.extend Bozo::Runner
-      collection << instance
-      block.call instance if block
-    end
-
-    # Returns the collection of build tools required for the configuration.
-    #
-    # Sourced from the required tools of compilers, dependency resolvers,
-    # hooks, publishers and test runners.
-    #
-    # @param [Array] providers
-    #     Collection of providers that can define required tools.
-    def get_build_tools(providers)
-      providers.
-          select{|p| p.respond_to? :required_tools}.
-          map{|p| p.required_tools}.
-          flatten
-    end
-  
-  end
-
-  # Module containing all dependency resolvers.
-  module DependencyResolvers
-  end
-
-  # Module containing all compilers.
-  module Compilers
-  end
-
-  # Module containing all test runners.
-  module TestRunners
-  end
-
-  # Module containing all packagers.
-  module Packagers
-  end
-
-  # Module containing all preparers.
-  module Preparers
-  end
-
-  # Module containing all publishers.
-  module Publishers
-  end
-
-  # Module containing all hooks.
-  module Hooks
-  end
-
+module Bozo
+
+  # Class used for defining the configuration of a build.
+  class BozoConfiguration
+
+    include Bozo::ClassNameHelpers
+    
+    # Creates a new instance
+    def initialize
+      @build_tools_location = nil
+      @tools = []
+      @compilers = []
+      @dependency_resolvers = []
+      @hooks = []
+      @packagers = []
+      @preparers = []
+      @publishers = []
+      @test_runners = []
+      @version = nil
+    end
+    
+    # Loads the configuration from the specified file.
+    # 
+    # @param [String] path
+    #     The path to the configuration file.    
+    def load(path)
+      instance_eval IO.read(path), path
+    end
+
+    # The version of the project to build.
+    def version
+      @version ||= Versioning::Version.load_from_file
+    end
+
+    # The location of the base build tools.
+    #
+    # Sets and returns the location if a value is provided, otherwise returns
+    # the current value.
+    #
+    # It is expected the build tools will be in sub-directory of this location
+    # according to the name of the tool and that the runner will be able to
+    # copy the contents of the sub-directory to a local directory via the
+    # `FileUtils.cp_r` method.
+    #
+    # @param [String] location
+    #     The path to set as the build tools location.
+    def build_tools_location(location = nil)
+      @build_tools_location = location if location
+      @build_tools_location
+    end
+
+    # Returns the all the build tools required by the specified compilers,
+    # dependency resolvers, hooks, packagers, publishers and test runners.
+    def build_tools
+      build_tools = get_build_tools @compilers
+      build_tools |= get_build_tools @dependency_resolvers
+      build_tools |= get_build_tools @hooks
+      build_tools |= get_build_tools @packagers
+      build_tools |= get_build_tools @preparers
+      build_tools |= get_build_tools @publishers
+      build_tools | (get_build_tools @test_runners)
+    end
+
+    # Returns the configured dependency resolvers.
+    attr_reader :dependency_resolvers
+
+    # Adds an instance of the named preparer to the preparer collection and
+    # yields it to the configuration block when one is specified.
+    #
+    # @param [Symbol] type
+    #     The name of the preparer.
+    # @param [Proc] block
+    #     Optional block to refine the configuration of the preparer.
+    def prepare(type, &block) # :yields: preparer
+      add_instance @preparers, Bozo::Preparers, type, block
+    end
+
+    # Returns the configured preparers.
+    attr_reader :preparers
+
+    # Adds an instance of the named dependency resolver to the dependency
+    # resolver collection and yields it to the configuration block when one
+    # is specified.
+    #
+    # @param [Symbol] type
+    #     The name of the dependency resolver.
+    # @param [Proc] block
+    #     Optional block to refine the configuration of the dependency
+    #     resolver.
+    def resolve_dependencies_with(type, &block) # :yields: dependency_resolver
+      add_instance @dependency_resolvers, Bozo::DependencyResolvers, type, block
+    end
+
+    # Returns the required tools
+    attr_reader :tools
+
+    # Adds an instance of the named tool to the tools collection and yields it
+    # to the configuration block when one is specified.
+    #
+    # @param [Symbol] type
+    #     The name of the tool.
+    # @param [Proc] block
+    #     Optional block to refine the configuration of the tool.
+    def required_tool(type, &block)
+      @tools ||= []
+      add_instance @tools, Bozo::Tools, type, block
+    end
+
+    # Returns the configured compilers.
+    attr_reader :compilers
+
+    # Adds an instance of the named compiler to the compiler collection and
+    # yields it to the configuration block when one is specified.
+    #
+    # @param [Symbol] type
+    #     The name of the compiler.
+    # @param [Proc] block
+    #     Optional block to refine the configuration of the compiler.
+    def compile_with(type, &block) # :yields: compiler
+      add_instance @compilers, Bozo::Compilers, type, block
+    end
+
+    # Returns the configured test runners.
+    attr_reader :test_runners
+
+    # Adds an instance of the named test runner to the test runner collection
+    # and yields it to the configuration block when one is specified.
+    #
+    # @param [Symbol] type
+    #     The name of the test runner.
+    # @param [Proc] block
+    #     Optional block to refine the configuration of the test runner.
+    def test_with(type, &block) # :yields: test_runner
+      add_instance @test_runners, Bozo::TestRunners, type, block
+    end
+
+    # Returns the configured packagers.
+    attr_reader :packagers
+
+    # Adds an instance of the named packager to the packager collection and
+    # yields it to the configuration block when one is specified.
+    #
+    # @param [Symbol] type
+    #     The name of the packager.
+    # @param [Proc] block
+    #     Optional block to refine the configuration of the packager.
+    def package_with(type, &block) # :yields: packager
+      add_instance @packagers, Bozo::Packagers, type, block
+    end
+
+    # Returns the configured publishers.
+    attr_reader :publishers
+
+    # Adds an instance of the named publisher to the publisher collection and
+    # yields it to the configuration block when one is specified.
+    #
+    # @param [Symbol] type
+    #     The name of the publisher.
+    # @param [Proc] block
+    #     Optional block to refine the configuration of the publisher.
+    def publish_with(type, &block) # :yields: publisher
+      add_instance @publishers, Bozo::Publishers, type, block
+    end
+
+    # Returns the configured hooks.
+    attr_reader :hooks
+
+    # Adds an instance of the named hook to the hook collection and yields it
+    # to the configuration block when one is specified.
+    #
+    # @param [Symbol] type
+    #     The name of the hook.
+    # @param [Proc] block
+    #     Optional block to refine the configuration of the hook.
+    def with_hook(type, &block) # :yields: hook
+      add_instance @hooks, Bozo::Hooks, type, block
+    end
+
+    # Adds an instance of the named hook to the hook collection and yields it
+    # to the configuration block when one is specified.
+    alias :pre_build :with_hook
+
+    # Adds an instance of the named hook to the hook collection and yields it
+    # to the configuration block when one is specified.
+    alias :pre_clean :with_hook
+
+    # Adds an instance of the named hook to the hook collection and yields it
+    # to the configuration block when one is specified.
+    alias :post_clean :with_hook
+
+    # Adds an instance of the named hook to the hook collection and yields it
+    # to the configuration block when one is specified.
+    alias :pre_uninstall :with_hook
+
+    # Adds an instance of the named hook to the hook collection and yields it
+    # to the configuration block when one is specified.
+    alias :post_uninstall :with_hook
+
+    # Adds an instance of the named hook to the hook collection and yields it
+    # to the configuration block when one is specified.
+    alias :pre_dependencies :with_hook
+
+    # Adds an instance of the named hook to the hook collection and yields it
+    # to the configuration block when one is specified.
+    alias :post_dependencies :with_hook
+
+    # Adds an instance of the named hook to the hook collection and yields it
+    # to the configuration block when one is specified.
+    alias :pre_prepare :with_hook
+
+    # Adds an instance of the named hook to the hook collection and yields it
+    # to the configuration block when one is specified.
+    alias :post_prepare :with_hook
+
+    # Adds an instance of the named hook to the hook collection and yields it
+    # to the configuration block when one is specified.
+    alias :pre_compile :with_hook
+
+    # Adds an instance of the named hook to the hook collection and yields it
+    # to the configuration block when one is specified.
+    alias :post_compile :with_hook
+
+    # Adds an instance of the named hook to the hook collection and yields it
+    # to the configuration block when one is specified.
+    alias :pre_test :with_hook
+
+    # Adds an instance of the named hook to the hook collection and yields it
+    # to the configuration block when one is specified.
+    alias :post_test :with_hook
+
+    # Adds an instance of the named hook to the hook collection and yields it
+    # to the configuration block when one is specified.
+    alias :pre_package :with_hook
+
+    # Adds an instance of the named hook to the hook collection and yields it
+    # to the configuration block when one is specified.
+    alias :post_package :with_hook
+
+    # Adds an instance of the named hook to the hook collection and yields it
+    # to the configuration block when one is specified.
+    alias :pre_publish :with_hook
+
+    # Adds an instance of the named hook to the hook collection and yields it
+    # to the configuration block when one is specified.
+    alias :post_publish :with_hook
+
+    # Adds an instance of the named hook to the hook collection and yields it
+    # to the configuration block when one is specified.
+    alias :post_build :with_hook
+    
+    private
+
+    # Resolves the named class within the given namespace and then created an
+    # instance of the class before adding it to the given collection and
+    # yielding it to the configuration block when one is provided.
+    #
+    # @param [Array] collection
+    #     The collection the step executor should be added to once created.
+    # @param [Module] namespace
+    #     The module the named step executor should be found in.
+    # @param [Symbol] type
+    #     The name of the step executor.
+    # @param [Proc] block
+    #     Optional block to refine the configuration of the step executor.
+    def add_instance(collection, namespace, type, block)
+      instance = namespace.const_get(to_class_name(type)).new
+      instance.extend Bozo::Runner
+      collection << instance
+      block.call instance if block
+    end
+
+    # Returns the collection of build tools required for the configuration.
+    #
+    # Sourced from the required tools of compilers, dependency resolvers,
+    # hooks, publishers and test runners.
+    #
+    # @param [Array] providers
+    #     Collection of providers that can define required tools.
+    def get_build_tools(providers)
+      providers.
+          select{|p| p.respond_to? :required_tools}.
+          map{|p| p.required_tools}.
+          flatten
+    end
+  
+  end
+
+  # Module containing all dependency resolvers.
+  module DependencyResolvers
+  end
+
+  # Module containing all compilers.
+  module Compilers
+  end
+
+  # Module containing all test runners.
+  module TestRunners
+  end
+
+  # Module containing all packagers.
+  module Packagers
+  end
+
+  # Module containing all preparers.
+  module Preparers
+  end
+
+  # Module containing all publishers.
+  module Publishers
+  end
+
+  # Module containing all hooks.
+  module Hooks
+  end
+
+  # Module containing all tools.
+  module Tools
+  end
+
 end