omnibus 3.2.2 → 4.0.0.beta.1

data/Rakefile

@@ -1,7 +1,7 @@
 require 'bundler/gem_tasks'
 
 require 'rspec/core/rake_task'
-[:unit, :functional, :integration].each do |type|
+[:unit, :functional].each do |type|
   RSpec::Core::RakeTask.new(type) do |t|
     t.pattern = "spec/#{type}/**/*_spec.rb"
     t.rspec_opts = [].tap do |a|

data/docs/Building on Debian.md

@@ -0,0 +1,59 @@
+Building Omnibus Packages for Debian
+====================================
+This document details the steps and configurables for building DEB packages with Omnibus.
+
+
+Building a .deb
+---------------
+### Requirements
+Omnibus assumes the existence of the `fakeroot` and `dpkg-deb` command on the build system. The [omnibus cookbook](https://supermarket.getchef.com/cookbooks/omnibus) automatically handles this installation. If you are not using the Omnibus cookbook, you must install these packages manually or using another tool.
+
+### Configurables
+A number of project configuration values are taken into consideration for building Debian packages. These options are further described in the [`Project` documentation](http://rubydoc.info/github/opscode/omnibus/Omnibus/Project).
+
+These values are interpolated and evaluated using Omnibus' internal DEB templates. For 99% of users, these templates should be satisfactory. If you encounter an instance where Omnibus' ERB templates do not satisfy a use case, please open an issue.
+
+Because of the unlikelihood of their necessity, Omnibus does not generate deb-related assets. If you find yourself in a situation where you need to generate highly-customized DEB assets, run the Omnibus generator command with the `--deb-assets` flag:
+
+    $ omnibus generate NAME --deb-assets
+
+**If this is an existing project, be sure to answer "NO" when asked if you want to overwrite existing files!**
+
+With the `--deb-assets` flag, Omnibus will generate the following "stock" resources in `resources/NAME/deb`:
+
+- `conffiles.erb` - the list of configuration files
+- `control.erb` - the Debian spec file
+- `md5sums.erb` - the ERB for generating the list of file checksums
+
+**You should only generate the DEB assets if you cannot set values using attributes!**
+
+### DSL
+You can further customize the behavior of the packager using the `package` DSL command in your project definition:
+
+```ruby
+# project.rb
+name 'hamlet'
+
+package :deb do
+  vendor 'Company <company@example.com>'
+  license 'Apache 2.0'
+  priority 'extra'
+  section 'databases'
+end
+```
+
+Some DSL methods available include:
+
+| DSL Method           | Description                                 |
+| :------------------: | --------------------------------------------|
+| `vendor`             | The name of the package producer            |
+| `license`            | The default license for the package         |
+| `priority`           | The priority for the package                |
+| `section`            | The section for this package                |
+
+If you are unfamilar with any of these terms, you should just accept the defaults. For more information on the purpose of any of these configuration options, please see the DEB spec.
+
+For more information, please see the [`Packager::DEB` documentation](http://rubydoc.info/github/opscode/omnibus/Omnibus/Packager/DEB).
+
+### Notes on DEB-signing
+At this time, signing Debian packages is not supported.

data/docs/Building on OSX.md

@@ -1,45 +1,65 @@
-Building Omnibus Packages for Mac OSX
-=====================================
-This document details the steps and configurables for building omnibus packages
-on Mac OSX. Unlike Linux-based systems, the process for building a `.pkg` and
-a `.dmg` requires some manual preparation of assets.
+Building Omnibus Packages for Mac OS X
+======================================
+This document details the steps and configurables for building omnibus packages on Mac OS X. Unlike Linux-based systems, the process for building a `.pkg` (and compressing with `.dmg`) may involve the customization of some assets.
 
 
 Building a .pkg
 ---------------
-In Mac OSX, a `.pkg` is a special file that is read by Installer.app that
-contains the set of instructions for installating a piece of software on a
-target system.
+In Mac OS X, a `.pkg` is a special file that is read by Installer.app that contains the set of instructions for installating a piece of software on a target system.
 
 ### Requirements
-The omnibus generator will create some stock files in `files/mac_pkg`:
+By default, Omnibus does not generate pkg-related assets. To generate the pkg assets, run the Omnibus generator command with the `--pkg-assets` flag:
+
+    $ omnibus generate NAME --pkg-assets
+
+**If this is an existing project, be sure to answer "NO" when asked if you want to overwrite existing files!**
+
+With the `--pkg-assets` flag, Omnibus will generate the following "stock" resources in `resources/NAME/pkg`:
 
 - `background.png` - the background image for the installer. We recommend this
 image has a light background color (otherwise, the text will be difficult to
 read).
-- `license.html` - the full HTML document for the license
-- `welcome.html` - the full HTML document for the welcome screen
+- `distribution.xml.erb` - the XML file for use during the `productbuild` command
+- `license.html.erb` - the full HTML document for the license
+- `welcome.html.erb` - the full HTML document for the welcome screen
+
+You should use these stock files and templates as a starting point for building your custom pkg.
+
+### DSL
+By default, Omnibus will try to build a pkg package when executed on a Mac OS X operating system. You can further customize the behavior of the packager using the `package` DSL command in your project definition:
+
+```ruby
+# project.rb
+name 'hamlet'
+
+package :pkg do
+  identifier 'com.getchef.hamlet'
+  signing_identity 'acbd1234'
+end
+```
 
-You should use these stock files and templates as a starting point for building
-your custom pkg.
+Some DSL methods available include:
+
+| DSL Method         | Description                                 |
+| :----------------: | --------------------------------------------|
+| `identifier`       | The `com.whatever` id for the package       |
+| `signing_identity` | The key to sign the PKG with                |
+
+For more information, please see the [`Packager::PKG` documentation](http://rubydoc.info/github/opscode/omnibus/Omnibus/Packager/PKG).
 
 
 Building a .dmg
 ---------------
-In Mac OSX, a `.dmg` is a compressed wrapper around a collection of resources,
-often including a `.pkg`. The possibilities for creating and customizing a DMG
-are endless, but Omnibus provides a "basic" starter case that will generate a
-pretty DMG that contains the `.pkg` file it creates.
+In Mac OSX, a `.dmg` is a compressed wrapper around a collection of resources, often including a `.pkg`. The possibilities for creating and customizing a DMG are endless, but Omnibus provides a"basic starter case that will generate a pretty DMG that contains the `.pkg` file it creates.
 
-The following tunables are available:
+### Requirements
+By default, Omnibus does not generate dmg-related assets. To generate the dmg assets, run the Omnibus generator with the `--dmg-assets` flag:
 
-- `dmg_window_bounds` - the starting and ending (x,y) coordinates for the opened
-DMG
-- `dmg_pkg_position` - the (x,y) coordinate for the `.pkg` file inside the
-opened DMG window
+    $ omnibus generate NAME --dmg-assets
 
-### Requirements
-The omnibus generator will create some stock files in `files/mac_dmg`:
+**If this is an existing project, be sure to answer "NO" when asked if you want to overwrite existing files!**
+
+With the `--dmg-assets` flag, Omnibus will generate the following "stock" resources in `resources/NAME/dmg`:
 
 - `background.png` - the background image to use for the DMG. We recommend using
 a high-resolution image that is slightly larger than the final length of your
@@ -47,20 +67,26 @@ window (as determined by the `dmg_window_bounds`)
 - `icon.png` - a 1024x1024 @ 300 icon to use for the DMG. We will automatically
 create an icns and scale to smaller sizes
 
-You should use these stock files and templates as a starting point for building
-your custom dmg.
+You should use these stock files and templates as a starting point for building your custom dmg.
 
-### Disabling dmg building
-DMG creation is enabled by default, but you can disable DMG creation by setting
-the `build_dmg` omnibus configuration option to false:
+### DSL
+By default, Omnibus will **not** try to build a compressed dmg. You can enable this compression using the `compress` DSL command in your project definition:
 
 ```ruby
-# omnibus.rb
-build_dmg false
+# project.rb
+name 'hamlet'
+
+compress :dmg do
+  window_bounds '200, 200, 750, 600'
+  pkg_position '10, 10'
+end
 ```
 
-And run as you normally would:
+Some DSL methods available include:
 
-```bash
-$ ./bin/omnibus build project <name>
-```
+| DSL Method         | Description                                 |
+| :----------------: | --------------------------------------------|
+| `window_bounds`    | The size and location of the DMG window     |
+| `pkg_position`     | The position of the pkg inside the DMG      |
+
+For more information, please see the [`Compressor::DMG` documentation](http://rubydoc.info/github/opscode/omnibus/Omnibus/Compressor/DMG).

data/docs/Building on RHEL.md

@@ -0,0 +1,74 @@
+Building Omnibus Packages for RHEL
+==================================
+This document details the steps and configurables for building RPM packages with Omnibus.
+
+
+Building a .rpm
+---------------
+### Requirements
+Omnibus assumes the existence of the `rpmbuild` command on the build system. The [omnibus cookbook](https://supermarket.getchef.com/cookbooks/omnibus) automatically handles this installation. If you are not using the Omnibus cookbook, you must install the package manually or using another tool.
+
+### Configurables
+The following Project values are taken into consideration when building RPMs:
+
+- `build_version`
+- `config_file`
+- `conflicts`
+- `description`
+- `exclude`
+- `extra_package_files`
+- `iteration`
+- `maintainer`
+- `package_user`
+- `package_group`
+- `package_scripts_path`
+- `replaces`
+- `runtime_dependency`
+- `url`
+
+These options are further described in the [`Project` documentation](http://rubydoc.info/github/opscode/omnibus/Omnibus/Project).
+
+These values are interpolated and evaluated using Omnibus' internal RPM templates. For 99% of users, these templates should be satisfactory. If you encounter an instance where Omnibus' RPM templates do not satisfy a use case, please open an issue.
+
+Because of the unlikelihood of their necessity, Omnibus does not generate rpm-related assets. If you find yourself in a situation where you need to generate highly-customized RPM assets, run the Omnibus generator command with the `--rpm-assets` flag:
+
+    $ omnibus generate NAME --rpm-assets
+
+**If this is an existing project, be sure to answer "NO" when asked if you want to overwrite existing files!**
+
+With the `--rpm-assets` flag, Omnibus will generate the following "stock" resources in `resources/NAME/rpm`:
+
+- `rpmmacros.erb` - the macros file
+- `signing.erb` - a Ruby script for signing RPMs
+- `spec.erb` - the ERB for generating the spec
+
+**You should only generate the RPM assets if you cannot set values using attributes!**
+
+### DSL
+You can further customize the behavior of the packager using the `package` DSL command in your project definition:
+
+```ruby
+# project.rb
+name 'hamlet'
+
+package :rpm do
+  signing_passphrase 'acbd1234'
+end
+```
+
+Some DSL methods available include:
+
+| DSL Method           | Description                                 |
+| :------------------: | --------------------------------------------|
+| `signing_passphrase` | The passphrase to sign the RPM with         |
+| `vendor`             | The name of the package producer            |
+| `license`            | The default license for the package         |
+| `priority`           | The priority for the package                |
+| `catetory`           | The catetory for this package               |
+
+If you are unfamilar with any of these terms, you should just accept the defaults. For more information on the purpose of any of these configuration options, please see the RPM spec.
+
+For more information, please see the [`Packager::RPM` documentation](http://rubydoc.info/github/opscode/omnibus/Omnibus/Packager/RPM).
+
+### Notes on RPM-signing
+To sign an RPM, you will need a GPG keypair. You can [create your own signing key](http://www.madboa.com/geek/gpg-quickstart/) or [import an existing one](http://irtfweb.ifa.hawaii.edu/~lockhart/gpg/gpg-cs.html). Omnibus automatically generates an `.rpmmacros` config file for `rpmbuild` that assumes that the real name associated to the GPG key is the same as the name of the project maintainer as specified in your Omnibus config. You can override this by creating your own `.rpmmacros` using the steps above.

data/docs/Building on Windows.md

@@ -1,98 +1,57 @@
 Building Omnibus Packages for Windows
 =====================================
-This document describes the requirements and configurables for building
-omnibus packages on Windows. Omnibus builds MSI packages on Windows systems.
+This document details the steps and configurables for building omnibus packages on Windows. Unlike Linux-based systems, the process for building an `.msi` may involve the customization of some assets.
 
-Requirements
-------------
-In order to build an omnibus package on Windows you need:
 
-* Open Source Windows Installer Toolset: [WIX](http://wixtoolset.org/)
-* In order to use built in semantic versioning:
-  [Git for Windows](http://msysgit.github.io/)
-
-MSI Source Files
+Building an .msi
 ----------------
-In order to create an MSI package, we will need to have some source files that
-can be used by WIX toolset to be able to build the MSI. Omnibus creates some
-skeletal MSI source files for you to help you get started.
+In Windows, an `.msi` is a special executable that contains the set of instructions for installating a piece of software on a target system. Please note, Omnibus does not support the creation of `.exe` files.
 
-When you execute `omnibus project <<project_name>>` these files will be created
-to be able to build MSIs:
+### Requirements
+By default, Omnibus does not generate msi-related assets. To generate the msi assets, run the Omnibus generator command with the `--msi-assets` flag:
 
-```
-C:\> omnibus project demo
-  ...
-  create  omnibus-demo/files/windows_msi/Resources/localization-en-us.wxl.erb
-  create  omnibus-demo/files/windows_msi/Resources/parameters.wxi.erb
-  create  omnibus-demo/files/windows_msi/Resources/source.wxs
-  create  omnibus-demo/files/windows_msi/Resources/assets/LICENSE.rtf
-  create  omnibus-demo/files/windows_msi/Resources/assets/banner_background.bmp
-  create  omnibus-demo/files/windows_msi/Resources/assets/dialog_background.bmp
-  create  omnibus-demo/files/windows_msi/Resources/assets/project.ico
-  create  omnibus-demo/files/windows_msi/Resources/assets/project_16x16.ico
-  create  omnibus-demo/files/windows_msi/Resources/assets/project_32x32.ico
-  ...
-```
-- `localization-en-us.wxl.erb` => File that contains the strings that are being
-  used in the MSI user interface.
-- `parameters.wxi.erb` => File that contains the dynamic information needed for
-  the MSI e.g. version numbers.
-- `assets/LICENSE.rtf` => License text in Rich Text Format that is displayed
-  during MSI installation.
-- `assets/*.bmp` => Bitmaps that are displayed during installation.
-- `assets/*.ico` => Icons that are used in the system for your application.
-
-Omnibus requires `wxl`, `wxs` and `wxi` files to be present on the system in
-order to build an MSI. You can also create these files as erb templates and
-omnibus will render them before starting building the MSI.
-
-These files are XML files that are created based on Windows WIX Schema. By
-default they will package the files under configured `install_dir` and present
-a UI that lets users to choose an installation location for the packaged files.
-You can modify these XML files based on the documentation
-  [here](http://wixtoolset.org/documentation/manual/v3/xsd/).
-
-Configurables
--------------
-You can use `msi_parameters` DSL option in your Omnibus project files to pass
-dynamic information to your MSI source templates. You can specify a hash or a
-block for this option. When block is specified, it is executed at the time of
-rendering and it is expected to return a hash. Here is an example:
+    $ omnibus generate NAME --msi-assets
 
-```ruby
-# config/projects/my_project.rb
-name 'my_project'
+**If this is an existing project, be sure to answer "NO" when asked if you want to overwrite existing files!**
 
-...
+With the `--msi-assets` flag, Omnibus will generate the following "stock" resources in `resources/NAME/msi`:
 
-msi_parameters do
-  # Set the upgrade code dynamically
-  params = { }
-  params[:upgrade_code] = determine_upgrade_code()
-  params
-end
-```
+- `localization-en-us.wxl.erb` => File that contains the strings that are being used in the MSI user interface
+- `parameters.wxi.erb` => File that contains the dynamic information needed for the MSI e.g. version numbers
+- `assets/LICENSE.rtf` => License text in Rich Text Format that is displayed during MSI installation
+- `assets/*.bmp` => Bitmaps that are displayed during installation
+- `assets/*.ico` => Icons that are used in the system for your application
+
+You should use these stock files and templates as a starting point for building your custom msi.
 
-```xml
-<!-- files/windows_msi/Resources/parameters.wxi.erb -->
+These files are XML files that are created based on Windows WIX Schema. By default they will package the files under configured `install_dir` and present a UI that lets users to choose an installation location for the packaged files. You can modify these XML files based on the [WIX documentation](http://wixtoolset.org/documentation/manual/v3/xsd/).
 
-<?xml version="1.0" encoding="utf-8"?>
-<Include>
-  <!--
-    Versioning. These have to be changed for upgrades.
-  -->
-  <?define VersionNumber="<%= @msi_version %>" ?>
-  <?define DisplayVersionNumber="<%= @msi_display_version %>" ?>
+### DSL
+By default, Omnibus will try to build an msi package when executed on a Windows operating system. You can further customize the behavior of the packager using the `package` DSL command in your project definition:
 
-  <?define UpgradeCode="<%= msi_parameters[:upgrade_code] %>" ?>
-</Include>
+```ruby
+# project.rb
+name 'hamlet'
+
+package :msi do
+  upgrade_code '2CD7259C-776D-4DDB-A4C8-6E544E580AA1'
+  parameters {
+    'KeyThing' => 'ValueThing'
+  }
+end
 ```
 
-MSI Creation
-------------
-To create an MSI you would normally run:
+Note that `upgrade_code` is **required** and will raise an exception if not defined! Once set, this value must persist for all future versions of your package. To generate a GUID in Ruby, run the following command:
 
+```bash
+ruby -r securerandom -e "puts SecureRandom.uuid"
 ```
-C:\> omnibus build project <name>
-```
+
+Some DSL methods available include:
+
+| DSL Method         | Description                                     |
+| :----------------: | ------------------------------------------------|
+| **`upgrade_code`** | The unique GUID for this package                |
+| `parameters`       | And arbirtary list of key-value pairs to render |
+
+For more information, please see the [`Packager::MSI` documentation](http://rubydoc.info/github/opscode/omnibus/Omnibus/Packager/MSI).

data/features/commands/build.feature

@@ -4,6 +4,5 @@ Feature: omnibus build
     * I run `omnibus build bacon`
     * the output should contain:
       """
-      I could not find an Omnibus project named 'bacon'! Valid projects are:
-        * hamlet
+      I could not find a project named `bacon' in any of the project locations:
       """

data/features/commands/clean.feature

@@ -3,7 +3,7 @@ Feature: omnibus clean
     * I run `omnibus clean hamlet`
     * the output should contain:
       """
-      I could not find an Omnibus project named 'hamlet'!
+      I could not find a project named `hamlet' in any of the project locations:
       """
     * the exit status should not be 0
 

data/lib/omnibus.rb

@@ -14,6 +14,9 @@
 # limitations under the License.
 #
 
+require 'omnibus/core_extensions'
+
+require 'cleanroom'
 require 'pathname'
 require 'json'
 
@@ -32,11 +35,12 @@ module Omnibus
   autoload :BuildVersion,     'omnibus/build_version'
   autoload :BuildVersionDSL,  'omnibus/build_version_dsl'
   autoload :Cleaner,          'omnibus/cleaner'
-  autoload :Cleanroom,        'omnibus/cleanroom'
+  autoload :Compressor,       'omnibus/compressor'
   autoload :Config,           'omnibus/config'
   autoload :Digestable,       'omnibus/digestable'
   autoload :Error,            'omnibus/exceptions'
   autoload :Fetcher,          'omnibus/fetcher'
+  autoload :FileSyncer,       'omnibus/file_syncer'
   autoload :Generator,        'omnibus/generator'
   autoload :GitCache,         'omnibus/git_cache'
   autoload :HealthCheck,      'omnibus/health_check'
@@ -44,25 +48,25 @@ module Omnibus
   autoload :Library,          'omnibus/library'
   autoload :Logger,           'omnibus/logger'
   autoload :Logging,          'omnibus/logging'
+  autoload :Metadata,         'omnibus/metadata'
   autoload :NullArgumentable, 'omnibus/null_argumentable'
-  autoload :NullBuilder,      'omnibus/null_builder'
   autoload :Ohai,             'omnibus/ohai'
   autoload :Package,          'omnibus/package'
+  autoload :Packager,         'omnibus/packager'
   autoload :Project,          'omnibus/project'
   autoload :Publisher,        'omnibus/publisher'
   autoload :Reports,          'omnibus/reports'
   autoload :S3Cache,          'omnibus/s3_cache'
   autoload :Software,         'omnibus/software'
   autoload :Sugarable,        'omnibus/sugarable'
+  autoload :Templating,       'omnibus/templating'
+  autoload :ThreadPool,       'omnibus/thread_pool'
   autoload :Util,             'omnibus/util'
 
-  # @todo Remove this in the next major release
-  autoload :OHAI, 'omnibus/ohai'
-
-  autoload :GitFetcher,     'omnibus/fetchers/git_fetcher'
-  autoload :NetFetcher,     'omnibus/fetchers/net_fetcher'
-  autoload :PathFetcher,    'omnibus/fetchers/path_fetcher'
-  autoload :S3CacheFetcher, 'omnibus/fetchers/s3_cache_fetcher'
+  autoload :GitFetcher,  'omnibus/fetchers/git_fetcher'
+  autoload :NetFetcher,  'omnibus/fetchers/net_fetcher'
+  autoload :NullFetcher, 'omnibus/fetchers/null_fetcher'
+  autoload :PathFetcher, 'omnibus/fetchers/path_fetcher'
 
   autoload :ArtifactoryPublisher, 'omnibus/publishers/artifactory_publisher'
   autoload :NullPublisher,        'omnibus/publishers/null_publisher'
@@ -74,13 +78,6 @@ module Omnibus
     autoload :Publish, 'omnibus/cli/publish'
   end
 
-  module Packager
-    autoload :Base,       'omnibus/packagers/base'
-    autoload :MacDmg,     'omnibus/packagers/mac_dmg'
-    autoload :MacPkg,     'omnibus/packagers/mac_pkg'
-    autoload :WindowsMsi, 'omnibus/packagers/windows_msi'
-  end
-
   class << self
     #
     # Reset the current Omnibus configuration. This is primary an internal API
@@ -138,36 +135,34 @@ module Omnibus
       @ui ||= Thor::Base.shell.new
     end
 
-    # Convenience method for access to the {Config} object.
-    # Provided for backward compatibility.
     #
-    # @return [Config]
-    #
-    # @deprecated Just refer to {Config} directly.
-    def config
-      Omnibus.logger.deprecated('Omnibus') do
-        'Omnibus.config. Please use Config.(thing) instead.'
-      end
-
-      Config
-    end
-
     # Load in an Omnibus configuration file.  Values will be merged with
     # and override the defaults defined in {Config}.
     #
     # @param [String] file path to a configuration file to load
     #
     # @return [void]
+    #
     def load_configuration(file)
       Config.load(file)
     end
 
-    # Processes the configuration to construct the dependency tree of
-    # projects and software.
     #
-    # @return [void]
-    def process_configuration
-      process_dsl_files
+    # Locate an executable in the current $PATH.
+    #
+    # @return [String, nil]
+    #   the path to the executable, or +nil+ if not present
+    #
+    def which(executable)
+      if File.file?(executable) && File.executable?(executable)
+        executable
+      elsif ENV['PATH']
+        path = ENV['PATH'].split(File::PATH_SEPARATOR).find do |path|
+          File.executable?(File.join(path, executable))
+        end
+
+        path && File.expand_path(executable, path)
+      end
     end
 
     #
@@ -176,7 +171,9 @@ module Omnibus
     # @return [Array<:Project>]
     #
     def projects
-      _projects.values
+      project_map.map do |name, _|
+        Project.load(name)
+      end
     end
 
     #
@@ -188,165 +185,122 @@ module Omnibus
     # @return [Project]
     #
     def project(name)
-      _projects[name.to_s]
+      Project.load(name)
     end
 
     #
-    # The absolute path to the Omnibus project/reository directory.
-    #
-    # @deprecated Use {Config.project_root} instead.
+    # The source root is the path to the root directory of the `omnibus` gem.
     #
-    # @return [String]
+    # @return [Pathname]
     #
-    def project_root
-      Omnibus.logger.deprecated('Omnibus') do
-        'Omnibus.project_root. Please use Config.project_root instead.'
-      end
-
-      Config.project_root
+    def source_root
+      @source_root ||= Pathname.new(File.expand_path('../..', __FILE__))
     end
 
     #
-    # Backward compat alias.
+    # The preferred filepath to a project with the given name on disk.
     #
-    # @deprecated Use {Config.project_root} instead.
+    # @return [String, nil]
     #
-    # @see (Omnibus.project_root)
-    #
-    def root
-      Omnibus.logger.deprecated('Omnibus') do
-        'Omnibus.root. Please use Omnibus.project_root instead.'
-      end
-
-      Config.project_root
+    def project_path(name)
+      project_map[name.to_s]
     end
 
     #
-    # The source root is the path to the root directory of the `omnibus` gem.
-    #
-    # @return [Pathname]
+    # The preferred filepath to a software with the given name on disk.
     #
-    def source_root
-      @source_root ||= Pathname.new(File.expand_path('../..', __FILE__))
-    end
-
-    # Processes all configured {Omnibus::Project} and
-    # {Omnibus::Software} DSL files.
+    # @return [String, nil]
     #
-    # @return [void]
-    def process_dsl_files
-      expand_software
+    def software_path(name)
+      software_map[name.to_s]
     end
 
     #
-    # The list of directories to search for {Software} files. These paths are
-    # returned **in order** of specifity.
+    # The list of directories to search for the given +path+. These paths are
+    # returned **in order** of specificity.
     #
-    # @see (Config#project_root)
-    # @see (Config#software_dir)
-    # @see (Config#software_gems)
-    # @see (Config#local_software_dirs)
+    # @param [String] path
+    #   the subpath to search for
     #
     # @return [Array<String>]
     #
-    def software_dirs
-      return @software_dirs if @software_dirs
-
-      directories = [
+    def possible_paths_for(path)
+      possible_paths[path] ||= [
         paths_from_project_root,
         paths_from_local_software_dirs,
         paths_from_software_gems,
-      ].flatten
-
-      @software_dirs = directories.inject([]) do |array, directory|
-        softwares_path = File.join(directory, Config.software_dir)
+      ].flatten.inject([]) do |array, directory|
+        destination = File.join(directory, path)
 
-        if File.directory?(softwares_path)
-          array << softwares_path
-        else
-          Omnibus.logger.warn('Omnibus') do
-            "`#{directory}' does not contain a valid directory structure. " \
-            "Does it contain a folder at `#{Config.software_dir}'?"
-          end
+        if File.directory?(destination)
+          array << destination
         end
 
         array
       end
+    end
 
-      @software_dirs
+    private
+
+    #
+    # The list of possible paths, cached as a hash for quick lookup.
+    #
+    # @see {Omnibus.possible_paths_for}
+    #
+    # @return [Hash]
+    #
+    def possible_paths
+      @possible_paths ||= {}
     end
 
     #
-    # A hash of all softwares (by name) and their respective path on disk. These
-    # files are **in order**, meaning the software path is the **first**
-    # occurrence of the software in the list. If the same software is
-    # encountered a second time, it will be skipped.
+    # Map the given file paths to the basename of their file, with the +.rb+
+    # extension removed.
     #
     # @example
-    #   { 'preparation' => '/home/omnibus/project/config/software/preparation.rb' }
+    #   { 'foo' => '/path/to/foo' }
     #
     # @return [Hash<String, String>]
     #
-    def software_map
-      return @software_map if @software_map
-
-      @software_map = software_dirs.inject({}) do |hash, directory|
+    def basename_map(paths)
+      paths.inject({}) do |hash, directory|
         Dir.glob("#{directory}/*.rb").each do |path|
           name = File.basename(path, '.rb')
-
-          if hash[name].nil?
-            Omnibus.logger.debug('Omnibus#software_map') do
-              "Using software `#{name}' from `#{path}'."
-            end
-
-            hash[name] = path
-          else
-            Omnibus.logger.debug('Omnibus#software_map') do
-              "Skipping software `#{name}' because it was loaded from an " \
-              "earlier path."
-            end
-          end
+          hash[name] ||= path
         end
 
         hash
       end
-
-      @software_map
     end
 
-    private
-
     #
-    # @api private
+    # A hash of all softwares (by name) and their respective path on disk. These
+    # files are **in order**, meaning the software path is the **first**
+    # occurrence of the software in the list. If the same software is
+    # encountered a second time, it will be skipped.
     #
-    # The list of omnibus projects. This is an internal API that maps a
-    # project's name to the actual project object.
+    # @example
+    #   { 'preparation' => '/home/omnibus/project/config/software/preparation.rb' }
     #
-    # @return [Hash<String, Project>]
+    # @return [Hash<String, String>]
     #
-    def _projects
-      return @_projects if @_projects
-
-      path = File.expand_path(Config.project_dir, Config.project_root)
-      @_projects = Dir.glob("#{path}/*.rb").inject({}) do |hash, path|
-        name = File.basename(path, '.rb')
-
-        if hash[name].nil?
-          Omnibus.logger.debug('Omnibus#projects') do
-            "Using project `#{name}' from `#{path}'."
-          end
-
-          hash[name] = Project.load(path)
-        else
-          Omnibus.logger.debug('Omnibus#projects') do
-            "Skipping project `#{name}' because it was already loaded."
-          end
-        end
-
-        hash
-      end
+    def software_map
+      @software_map ||= basename_map(possible_paths_for(Config.software_dir))
+    end
 
-      @_projects
+    #
+    # A hash of all projects (by name) and their respective path on disk. These
+    # files are **in order**, meaning the project path is the **first**
+    # occurrence of the project in the list. If the same project is
+    # encountered a second time, it will be skipped.
+    #
+    # @example
+    #   { 'chefdk' => '/home/omnibus/project/config/projects/chefdk.rb' }
+    #
+    # @return [Hash<String, String>]
+    #
+    def project_map
+      @project_map ||= basename_map(possible_paths_for(Config.project_dir))
     end
 
     #
@@ -360,7 +314,8 @@ module Omnibus
     # @return [Array<String>]
     #
     def paths_from_project_root
-      [Config.project_root]
+      @paths_from_project_root ||=
+        [Config.project_root]
     end
 
     #
@@ -372,19 +327,16 @@ module Omnibus
     # @return [Array<String>]
     #
     def paths_from_local_software_dirs
-      Array(Config.local_software_dirs).inject([]) do |array, path|
-        fullpath = File.expand_path(path, Config.project_root)
-
-        if File.directory?(fullpath)
-          array << fullpath
-        else
-          Omnibus.logger.warn('Omnibus') do
-            "Could not load softwares from path `#{fullpath}'. Does it exist?"
+      @paths_from_local_software_dirs ||=
+        Array(Config.local_software_dirs).inject([]) do |array, path|
+          fullpath = File.expand_path(path, Config.project_root)
+
+          if File.directory?(fullpath)
+            array << fullpath
           end
-        end
 
-        array
-      end
+          array
+        end
     end
 
     #
@@ -398,59 +350,14 @@ module Omnibus
     # @return [Array<String>]
     #
     def paths_from_software_gems
-      Array(Config.software_gems).inject([]) do |array, name|
-        if (spec = Gem::Specification.find_all_by_name(name).first)
-          array << File.expand_path(spec.gem_dir)
-        else
-          Omnibus.logger.warn('Omnibus') do
-            "Could not load softwares from gem `#{name}'. Is it installed?"
+      @paths_from_software_gems ||=
+        Array(Config.software_gems).inject([]) do |array, name|
+          if (spec = Gem::Specification.find_all_by_name(name).first)
+            array << File.expand_path(spec.gem_dir)
           end
-        end
-
-        array
-      end
-    end
 
-    #
-    # Generate {Software} objects for all software DSL files in
-    # +software_specs+.
-    #
-    # @return [void]
-    #
-    def expand_software
-      Omnibus.projects.each do |project|
-        project.dependencies.each do |dependency|
-          recursively_load_dependency(dependency, project)
+          array
         end
-      end
-    end
-
-    #
-    # Loads a project's dependencies recursively, ensuring all transitive
-    # dependencies are also loaded in the correct order.
-    #
-    # @param [String] dependency
-    #   the name of the dependency
-    # @param [Project] project
-    #   the project that loaded the software
-    #
-    # @return [void]
-    #
-    def recursively_load_dependency(dependency, project)
-      filepath = software_map[dependency]
-
-      if filepath.nil?
-        raise MissingProjectDependency.new(dependency, software_dirs)
-      end
-
-      software = Software.load(project, filepath)
-
-      # load any transitive deps for the component into the library also
-      software.dependencies.each do |transitive_dependency|
-        recursively_load_dependency(transitive_dependency, project)
-      end
-
-      project.library.component_added(software)
     end
   end
 end