omnibus 3.2.2 → 4.0.0.beta.1

data/lib/omnibus/packagers/solaris.rb

@@ -0,0 +1,110 @@
+#
+# Copyright 2014 Chef Software, Inc.
+#
+# 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.
+#
+
+module Omnibus
+  class Packager::Solaris < Packager::Base
+    id :solaris
+
+    setup do
+      remove_directory('/tmp/pkgmk')
+      create_directory('/tmp/pkgmk')
+    end
+
+    build do
+      Dir.chdir(staging_dir) do
+        shellout! "cd #{install_dirname} && find #{install_basename} -print > /tmp/pkgmk/files"
+      end
+
+      write_prototype_content
+
+      write_pkginfo_content
+
+      copy_file("#{project.package_scripts_path}/postinst", '/tmp/pkgmk/postinstall')
+      copy_file("#{project.package_scripts_path}/postrm", '/tmp/pkgmk/postremove')
+
+      Dir.chdir(staging_dir) do
+        shellout! "pkgmk -o -r #{install_dirname} -d /tmp/pkgmk -f /tmp/pkgmk/Prototype"
+        shellout! "pkgchk -vd /tmp/pkgmk #{project.name}"
+        shellout! "pkgtrans /tmp/pkgmk /var/cache/omnibus/pkg/#{package_name} #{project.name}"
+      end
+    end
+
+    # @see Base#package_name
+    def package_name
+      "#{project.name}-#{pkgmk_version}.#{Ohai['kernel']['machine']}.solaris"
+    end
+
+    def pkgmk_version
+      "#{project.build_version}-#{project.build_iteration}"
+    end
+
+    def install_dirname
+      File.dirname(project.install_dir)
+    end
+
+    def install_basename
+      File.basename(project.install_dir)
+    end
+
+    #
+    # Generate a Prototype file for solaris build
+    #
+    def write_prototype_content
+      prototype_content = <<-EOF.gsub(/^ {8}/, '')
+        i pkginfo
+        i postinstall
+        i postremove
+      EOF
+
+      # generate list of control files
+      File.open '/tmp/pkgmk/Prototype', 'w+' do |f|
+        f.write prototype_content
+      end
+
+      Dir.chdir(staging_dir) do
+        # generate the prototype's file list
+        shellout! "cd #{install_dirname} && pkgproto < /tmp/pkgmk/files > /tmp/pkgmk/Prototype.files"
+
+        # fix up the user and group in the file list to root
+        shellout! "awk '{ $5 = \"root\"; $6 = \"root\"; print }' < /tmp/pkgmk/Prototype.files >> /tmp/pkgmk/Prototype"
+      end
+    end
+
+    #
+    # Generate a pkginfo file for solaris build
+    #
+    def write_pkginfo_content
+      pkginfo_content = <<-EOF.gsub(/^ {8}/, '')
+        CLASSES=none
+        TZ=PST
+        PATH=/sbin:/usr/sbin:/usr/bin:/usr/sadm/install/bin
+        BASEDIR=#{install_dirname}
+        PKG=#{project.name}
+        NAME=#{project.name}
+        ARCH=#{`uname -p`.chomp}
+        VERSION=#{pkgmk_version}
+        CATEGORY=application
+        DESC=#{project.description}
+        VENDOR=#{project.maintainer}
+        EMAIL=#{project.maintainer}
+        PSTAMP=#{`hostname`.chomp + Time.now.utc.iso8601}
+      EOF
+      File.open '/tmp/pkgmk/pkginfo', 'w+' do |f|
+        f.write pkginfo_content
+      end
+    end
+  end
+end

data/lib/omnibus/project.rb

@@ -19,26 +19,42 @@ require 'time'
 require 'json'
 
 module Omnibus
-  #
-  # Omnibus project DSL reader
-  #
-  # @todo It seems like there's a bit of a conflation between a "project" and a
-  #   "package" in this class... perhaps the package-building portions should be
-  #   extracted to a separate class.
-  #
-  #
   class Project
     class << self
       #
-      # @param [String] filepath
-      #   the path to the project definition to load from disk
+      # @param [String] name
+      #   the name to the project definition to load from disk
       #
-      # @return [Software]
+      # @return [Project]
       #
-      def load(filepath)
-        instance = new(filepath)
-        instance.evaluate_file(filepath)
-        instance
+      def load(name)
+        loaded_projects[name] ||= begin
+          filepath = Omnibus.project_path(name)
+
+          if filepath.nil?
+            raise MissingProject.new(name)
+          else
+            log.internal(log_key) do
+              "Loading project `#{name}' from `#{filepath}'."
+            end
+          end
+
+          instance = new(filepath)
+          instance.evaluate_file(filepath)
+          instance.load_dependencies
+          instance
+        end
+      end
+
+      private
+
+      #
+      # The list of projects loaded thus far.
+      #
+      # @return [Hash<String, Project>]
+      #
+      def loaded_projects
+        @loaded_projects ||= {}
       end
     end
 
@@ -66,7 +82,7 @@ module Omnibus
     # @example
     #   name 'chef'
     #
-    # @raise [MissingProjectConfiguration] if a value was not set before being
+    # @raise [MissingRequiredAttribute] if a value was not set before being
     #   subsequently retrieved
     #
     # @param [String] val
@@ -76,7 +92,7 @@ module Omnibus
     #
     def name(val = NULL)
       if null?(val)
-        @name || raise(MissingProjectConfiguration.new('name', 'my_project'))
+        @name || raise(MissingRequiredAttribute.new(self, :name, 'hamlet'))
       else
         @name = val
       end
@@ -104,76 +120,20 @@ module Omnibus
     end
     expose :friendly_name
 
-    #
-    # Set or retrieve the custom msi building parameters
-    #
-    # @example Using a hash
-    #   msi_parameters upgrade_code: 'ABCD-1234'
-    #
-    # @example Using a block
-    #   msi_parameters do
-    #     # some complex operation
-    #     { key: value }
-    #   end
-    #
-    # @param [Hash] val
-    #   the parameters to set
-    # @param [Proc] block
-    #   block to run when building the msi that returns a hash
-    #
-    # @return [Hash]
-    #
-    def msi_parameters(val = NULL, &block)
-      if block && !null?(val)
-        raise Error, 'You cannot specify additional parameters to ' \
-          '#msi_parameters when a block is given!'
-      end
-
-      if block
-        @msi_parameters = block
-      else
-        if null?(val)
-          if @msi_parameters.is_a?(Proc)
-            @msi_parameters.call
-          else
-            @msi_parameters ||= {}
-          end
-        else
-          @msi_parameters = val
-        end
-      end
-    end
-    expose :msi_parameters
-
-    #
-    # Set or retrieve the package name of the project. Defaults to the package
-    # name defaults to the project name.
-    #
-    # @example
-    #   package_name 'com.chef.project'
-    #
-    # @param [String] val
-    #   the package name to set
-    #
-    # @return [String]
-    #
-    def package_name(val = NULL)
-      if null?(val)
-        @package_name || name
-      else
-        @package_name = val
-      end
-    end
-    expose :package_name
-
     #
     # **[Required]** Set or retrieve the path at which the project should be
     # installed by the generated package.
     #
+    # Even on Windows-based systems, this path should be the Unix-like path,
+    # since that's what Ruby expects. In the event +\+ is used as a file
+    # separator, it will be replaced with +/+. This method also attempts to
+    # remove duplicate slashes which might be caused as a result of string
+    # interpolation.
+    #
     # @example
     #   install_dir '/opt/chef'
     #
-    # @raise [MissingProjectConfiguration] if a value was not set before being
+    # @raise [MissingRequiredAttribute] if a value was not set before being
     #   subsequently retrieved
     #
     # @param [String] val
@@ -183,49 +143,32 @@ module Omnibus
     #
     def install_dir(val = NULL)
       if null?(val)
-        @install_dir || raise(MissingProjectConfiguration.new('install_dir', '/opt/chef'))
+        @install_dir || raise(MissingRequiredAttribute.new(self, :install_dir, '/opt/chef'))
       else
-        @install_dir = File.expand_path(val, Config.project_root)
+        @install_dir = val.gsub('\\', '/').squeeze('/').chomp('/')
       end
     end
     expose :install_dir
 
     #
-    # @deprecated Use {#install_dir} instead.
-    #
-    # @example (see #install_dir)
-    # @raise (see #install_dir)
-    # @param (see #install_dir)
-    # @return (see #install_dir)
-    #
-    def install_path(val = NULL)
-      log.deprecated(log_key) do
-        "install_path (DSL). Please use install_dir instead."
-      end
-
-      install_dir(val)
-    end
-    expose :install_path
-
-    #
-    # Path to the +/files+ directory in the omnibus project. This directory can
-    # contain assets used for creating packages (e.g., Mac .pkg files and
-    # Windows MSIs can be installed by GUI which can optionally be customized
-    # with background images, license agreements, etc.)
-    #
-    # This method delegates to the {Config.project_root} module function so that
-    # Packagers classes rely only on the Project object for their inputs.
+    # The default root where a project should be installed. On Windows-based
+    # systems, this value defaults to +C:+. On non-Windows systems, this value
+    # defaults to +/opt+.
     #
     # @example
-    #   patch = File.join(files_path, 'rubygems', 'patch.rb')
+    #   install_dir "#{default_root}/chef" #=> Produces +C:/chef+ on Windows and
+    #                                      #=> +/opt/chef+ on Linux
     #
     # @return [String]
-    #   path to the files directory
     #
-    def files_path
-      File.expand_path("#{Config.project_root}/files")
+    def default_root
+      if windows?
+        'C:'
+      else
+        '/opt'
+      end
     end
-    expose :files_path
+    expose :default_root
 
     #
     # **[Required]** Set or retrieve the the package maintainer.
@@ -233,7 +176,7 @@ module Omnibus
     # @example
     #   maintainer 'Chef Software, Inc.'
     #
-    # @raise [MissingProjectConfiguration] if a value was not set before being
+    # @raise [MissingRequiredAttribute] if a value was not set before being
     #   subsequently retrieved
     #
     # @param [String] val
@@ -243,7 +186,7 @@ module Omnibus
     #
     def maintainer(val = NULL)
       if null?(val)
-        @maintainer || raise(MissingProjectConfiguration.new('maintainer', 'Chef Software, Inc.'))
+        @maintainer || raise(MissingRequiredAttribute.new(self, :maintainer, 'Chef Software, Inc.'))
       else
         @maintainer = val
       end
@@ -256,7 +199,7 @@ module Omnibus
     # @example
     #   homepage 'https://www.getchef.com'
     #
-    # @raise [MissingProjectConfiguration] if a value was not set before being
+    # @raise [MissingRequiredAttribute] if a value was not set before being
     #   subsequently retrieved
     #
     # @param [String] val
@@ -266,7 +209,7 @@ module Omnibus
     #
     def homepage(val = NULL)
       if null?(val)
-        @homepage || raise(MissingProjectConfiguration.new('homepage', 'http://www.getchef.com'))
+        @homepage || raise(MissingRequiredAttribute.new(self, :homepage, 'https://www.getchef.com'))
       else
         @homepage = val
       end
@@ -279,9 +222,6 @@ module Omnibus
     # @example
     #   description 'This is my description'
     #
-    # Corresponds to the +--description+ flag of
-    # {https://github.com/jordansissel/fpm fpm}.
-    #
     # @param [String] val
     #   the project description
     #
@@ -289,7 +229,7 @@ module Omnibus
     #
     def description(val = NULL)
       if null?(val)
-        @description ||= "The full stack of #{name}"
+        @description || "The full stack of #{name}"
       else
         @description = val
       end
@@ -297,14 +237,11 @@ module Omnibus
     expose :description
 
     #
-    # Set or retrieve the name of the package this package will replace.
-    #
-    # Ultimately used as the value for the +--replaces+ flag in
-    # {https://github.com/jordansissel/fpm fpm}.
+    # Add to the list of packages this one replaces.
     #
     # This should only be used when renaming a package and obsoleting the old
-    # name of the package. Setting this to the same name as package_name will
-    # cause RPM upgrades to fail.
+    # name of the package. **Setting this to the same name as package_name will
+    # cause RPM upgrades to fail.**
     #
     # @example
     #   replace 'the-old-package'
@@ -314,21 +251,15 @@ module Omnibus
     #
     # @return [String]
     #
-    def replaces(val = NULL)
-      if null?(val)
-        @replaces
-      else
-        @replaces = val
-      end
+    def replace(val = NULL)
+      replaces << val
+      replaces.dup
     end
-    expose :replaces
+    expose :replace
 
     #
     # Add to the list of packages this one conflicts with.
     #
-    # Specifying conflicts is optional.  See the +--conflicts+ flag in
-    # {https://github.com/jordansissel/fpm fpm}.
-    #
     # @example
     #   conflicts 'foo'
     #   conflicts 'bar'
@@ -417,7 +348,7 @@ module Omnibus
     #
     def build_iteration(val = NULL)
       if null?(val)
-        @build_iteration ||= 1
+        @build_iteration || 1
       else
         @build_iteration = val
       end
@@ -425,40 +356,74 @@ module Omnibus
     expose :build_iteration
 
     #
-    # The identifer for the mac package.
+    # Add or override a customization for the packager with the given +id+. When
+    # given multiple blocks with the same +id+, they are evaluated _in order_,
+    # so the last block evaluated will take precedence over the previous ones.
     #
     # @example
-    #   mac_pkg_identifier 'com.getchef.chefdk'
+    #   package :id do
+    #     key 'value'
+    #   end
     #
-    # @param [String] val
-    #   the package identifier
+    # @param [Symbol] id
+    #   the id of the packager to customize
     #
-    # @return [String]
+    def package(id, &block)
+      unless block
+        raise InvalidValue.new(:package, 'have a block')
+      end
+
+      packagers[id] << block
+    end
+    expose :package
+
     #
-    def mac_pkg_identifier(val = NULL)
-      if null?(val)
-        @mac_pkg_identifier
+    # Add or override a customization for the compressor with the given +id+.
+    # When given multiple blocks with the same +id+, they are evaluated
+    # _in order_, so the last block evaluated will take precedence over the
+    # previous ones.
+    #
+    # @example With customization
+    #   compress :dmg do
+    #     window_bounds '10, 20, 30, 40'
+    #   end
+    #
+    # @example Without customization
+    #   compress :tgz
+    #
+    # If multiple +compress+ blocks are specified, the "most prefered" one for
+    # the current system will be used.
+    #
+    # @param [Symbol] id
+    #   the id of the compressor to customize
+    #
+    def compress(id, &block)
+      if block
+        compressors[id] << block
       else
-        @mac_pkg_identifier = val
+        compressors[id] << Proc.new {}
       end
     end
-    expose :mac_pkg_identifier
+    expose :compress
 
     #
-    # Set or retrieve the +{deb/rpm/solaris}-user+ fpm argument. Defaults
-    # to +root+ if not otherwise set.
+    # Set or retrieve the user the package should install as. This varies with
+    # operating system, and may be ignored if the underlying packager does not
+    # support it.
+    #
+    # Defaults to +"root"+.
     #
     # @example
     #   package_user 'build'
     #
     # @param [String] val
-    #   the user to retrive for the fpm build
+    #   the user to use for the package build
     #
     # @return [String]
     #
     def package_user(val = NULL)
       if null?(val)
-        @package_user ||= 'root'
+        @package_user || 'root'
       else
         @package_user = val
       end
@@ -488,20 +453,24 @@ module Omnibus
     expose :override
 
     #
-    # Set or retrieve the +{deb/rpm/solaris}+-group fpm argument. Defaults
-    # to +root+ if not otherwise set.
+    # Set or retrieve the group the package should install as. This varies with
+    # operating system and may  be ignored if the underlying packager does not
+    # support it.
+    #
+    # Defaults to +Ohai['root_group']+. If +Ohai['root_group']+ is +nil+, it
+    # defaults to +"root"+.
     #
     # @example
     #   package_group 'build'
     #
     # @param [String] val
-    #   the group to retrive for the fpm build
+    #   the group to use for the package build
     #
     # @return [String]
     #
     def package_group(val = NULL)
       if null?(val)
-        @package_group ||= 'root'
+        @package_group || Ohai['root_group'] || 'root'
       else
         @package_group = val
       end
@@ -509,7 +478,7 @@ module Omnibus
     expose :package_group
 
     #
-    # Set or retrieve the resources path to be used by packagers.
+    # Set or retrieve the path to the resources on disk for use in packagers.
     #
     # @example
     #   resources_path '/path/to/resources'
@@ -521,7 +490,7 @@ module Omnibus
     #
     def resources_path(val = NULL)
       if null?(val)
-        @resources_path
+        @resources_path || "#{Config.project_root}/resources/#{name}"
       else
         @resources_path = File.expand_path(val)
       end
@@ -529,28 +498,11 @@ module Omnibus
     expose :resources_path
 
     #
-    # The path to the package scripts directory for this project.
-    # These are optional scripts that can be bundled into the
-    # resulting package for running at various points in the package
-    # management lifecycle.
-    #
-    # Currently supported scripts include:
-    #
-    # * postinst
-    #
-    #   A post-install script
-    # * prerm
-    #
-    #   A pre-uninstall script
-    # * postrm
+    # The path to the package scripts directory for this project. These are
+    # optional scripts that can be bundled into the resulting package for
+    # running at various points in the package management lifecycle.
     #
-    #   A post-uninstall script
-    #
-    # Any scripts with these names that are present in the package
-    # scripts directory will be incorporated into the package that is
-    # built.  This only applies to fpm-built packages.
-    #
-    # Additionally, there may be a +makeselfinst+ script.
+    # These scripts and their names vary with operating system.
     #
     # @return [String]
     #
@@ -592,9 +544,6 @@ module Omnibus
     # This is distinct from a build-time dependency, which should correspond to
     # a software definition.
     #
-    # Corresponds to the +--depends+ flag of
-    # {https://github.com/jordansissel/fpm fpm}.
-    #
     # @example
     #   runtime_dependency 'foo'
     #
@@ -611,13 +560,11 @@ module Omnibus
     expose :runtime_dependency
 
     #
-    # Add a new exclusion pattern.
-    #
-    # Corresponds to the +--exclude+ flag of
-    # {https://github.com/jordansissel/fpm fpm}.
+    # Add a new exclusion pattern for a list of files or folders to exclude
+    # when making the package.
     #
     # @example
-    #   exclude 'foo'
+    #   exclude '.git'
     #
     # @param [String] pattern
     #   the thing to exclude
@@ -650,11 +597,11 @@ module Omnibus
     expose :config_file
 
     #
-    # Add other files or dirs outside of +install_dir+.
+    # Add other files or dirs outside of +install_dir+. These files retain their
+    # relative paths inside the scratch directory:
+    #
+    #   /path/to/foo.txt #=> /tmp/package/path/to/foo.txt
     #
-    # @note This option is currently only supported with FPM based package
-    # builds such as RPM, DEB and .sh (makeselfinst).  This is not supported
-    # on Mac OSX packages, Windows MSI, AIX and Solaris
     #
     # @example
     #   extra_package_file '/path/to/file'
@@ -672,134 +619,55 @@ module Omnibus
     expose :extra_package_file
 
     #
-    # The platform version of the machine on which Omnibus is running, as
-    # determined by Ohai.
-    #
-    # @deprecated Use +Ohai['platform_version']+ instead.
-    #
-    # @return [String]
-    #
-    def platform_version
-      log.deprecated(log_key) do
-        "platform_version (DSL). Please use Ohai['platform_version'] instead."
-      end
-
-      Ohai['platform_version']
-    end
-    expose :platform_version
-
-    #
-    # The platform of the machine on which Omnibus is running, as determined
-    # by Ohai.
+    # A proxy method to the underlying Ohai system.
     #
-    # @deprecated Use +Ohai['platform']+ instead.
+    # @example
+    #   ohai['platform_family']
     #
-    # @return [String]
+    # @return [Ohai]
     #
-    def platform
-      log.deprecated(log_key) do
-        "platform (DSL). Please use Ohai['platform'] instead."
-      end
-
-      Ohai['platform']
+    def ohai
+      Ohai
     end
-    expose :platform
+    expose :ohai
 
     #
-    # The platform family of the machine on which Omnibus is running, as
-    # determined by Ohai.
-    #
-    # @deprecated Use +Ohai['platform_family']+ instead.
-    #
-    # @return [String]
-    #
-    def platform_family
-      log.deprecated(log_key) do
-        "platform_family (DSL). Please use Ohai['platform_family'] instead."
-      end
-
-      Ohai['platform_family']
-    end
-    expose :platform_family
+    # @!endgroup
+    # --------------------------------------------------
 
     #
-    # The machine which this project is running on.
-    #
-    # @deprecated Use +Ohai['kernel']['machine']+ instead.
-    #
-    # @return [String]
+    # @!group Public API
     #
-    def machine
-      log.deprecated(log_key) do
-        "machine (DSL). Please use Ohai['kernel']['machine'] instead."
-      end
-
-      Ohai['kernel']['machine']
-    end
-    expose :machine
+    # In addition to the DSL methods, the following methods are considered to
+    # be the "public API" for a project.
+    # --------------------------------------------------
 
     #
-    # Convenience method for accessing the global Omnibus configuration object.
-    #
-    # @deprecated Use {Config} instead
+    # Recursively load all the dependencies for this project.
     #
-    # @return Config
+    # @return [true]
     #
-    # @see Config
-    #
-    def config
-      log.deprecated(log_key) do
-        'config (DSL). Please use Config.(thing) instead (capital C).'
+    def load_dependencies
+      dependencies.each do |dependency|
+        Software.load(self, dependency)
       end
 
-      Config
+      true
     end
-    expose :config
 
     #
     # The list of software dependencies for this project. These is the software
     # that comprises your project, and is distinct from runtime dependencies.
     #
-    # @deprecated Use {#dependency} instead (as a setter; the getter will stay)
-    #
-    # @todo Remove the "setter" part of this method and unexpose it as part of
-    # the DSL in the next major release
-    #
     # @see #dependency
     #
     # @param [Array<String>]
     #
     # @return [Array<String>]
     #
-    def dependencies(*args)
+    def dependencies
       @dependencies ||= []
-
-      # Handle the case where an array or list of args were given
-      flattened_args = Array(args).flatten
-
-      if flattened_args.empty?
-        @dependencies
-      else
-        log.deprecated(log_key) do
-          "dependencies (DSL). Please specify each dependency on its own " \
-          "line like `dependency '#{Array(val).first}'`."
-        end
-
-        @dependencies = flattened_args
-      end
     end
-    expose :dependencies
-
-    #
-    # @!endgroup
-    # --------------------------------------------------
-
-    #
-    # @!group Public API
-    #
-    # In addition to the DSL methods, the following methods are considered to
-    # be the "public API" for a project.
-    # --------------------------------------------------
 
     #
     # The path (on disk) where this project came from. Warning: this can be
@@ -850,6 +718,15 @@ module Omnibus
       @conflicts ||= []
     end
 
+    #
+    # The list of things this project replaces with.
+    #
+    # @return [Array<String>]
+    #
+    def replaces
+      @replaces ||= []
+    end
+
     #
     # The list of exclusions for this project.
     #
@@ -868,6 +745,54 @@ module Omnibus
       @overrides ||= {}
     end
 
+    #
+    # The list of packagers, in the following format:
+    #
+    #     {
+    #       id: [#<Proc:0x001>, #<Proc:0x002>],
+    #       # ...
+    #     }
+    #
+    # @return [Hash<Symbol, Array<Proc>>]
+    #   the packager blocks, indexed by key
+    #
+    def packagers
+      @packagers ||= Hash.new { |h, k| h[k] = [] }
+    end
+
+    #
+    # Instantiate a new instance of the best packager for this system.
+    #
+    # @return [~Packager::Base]
+    #
+    def packager
+      @packager ||= Packager.for_current_system.new(self)
+    end
+
+    #
+    # The list of compressors, in the following format:
+    #
+    #     {
+    #       id: [#<Proc:0x001>, #<Proc:0x002>],
+    #       # ...
+    #     }
+    #
+    # @return [Hash<Symbol, Array<Proc>>]
+    #   the compressor blocks, indexed by key
+    #
+    def compressors
+      @compressors ||= Hash.new { |h, k| h[k] = [] }
+    end
+
+    #
+    # Instantiate a new instance of the best compressor for this system.
+    #
+    # @return [~Compressor::Base]
+    #
+    def compressor
+      @compressor ||= Compressor.for_current_system(compressors.keys).new(self)
+    end
+
     #
     # The DSL for this build version.
     #
@@ -929,43 +854,21 @@ module Omnibus
       self.name <=> other.name
     end
 
-    # Defines the iteration for the package to be generated.  Adheres
-    # to the conventions of the platform for which the package is
-    # being built.
     #
-    # All iteration strings begin with the value set in {#build_iteration}
     #
-    # @return [String]
-    def iteration
-      case Ohai['platform_family']
-      when 'rhel'
-        Ohai['platform_version'] =~ /^(\d+)/
-        maj = Regexp.last_match[1]
-        "#{build_iteration}.el#{maj}"
-      when 'freebsd'
-        Ohai['platform_version'] =~ /^(\d+)/
-        maj = Regexp.last_match[1]
-        "#{build_iteration}.#{Ohai['platform']}.#{maj}.#{Ohai['kernel']['machine']}"
-      when 'windows'
-        "#{build_iteration}.windows"
-      when 'aix', 'debian', 'mac_os_x'
-        "#{build_iteration}"
-      else
-        "#{build_iteration}.#{Ohai['platform']}.#{Ohai['platform_version']}"
-      end
-    end
-
+    #
     def build_me
-      FileUtils.mkdir_p(Config.package_dir)
       FileUtils.rm_rf(install_dir)
       FileUtils.mkdir_p(install_dir)
 
       # Cache the build order so we don't re-compute
       softwares = library.build_order
 
-      # Download all softwares first
-      softwares.each do |software|
-        software.fetch
+      # Download all softwares in parallel
+      ThreadPool.new(Config.workers) do |pool|
+        softwares.each do |software|
+          pool.schedule { software.fetch }
+        end
       end
 
       # Now build each software
@@ -978,8 +881,14 @@ module Omnibus
 
       # Package
       package_me
+
+      # Compress
+      compress_me
     end
 
+    #
+    #
+    #
     def package_me
       destination = File.expand_path('pkg', Config.project_root)
 
@@ -988,45 +897,46 @@ module Omnibus
         FileUtils.mkdir_p(destination)
       end
 
-      package_types.each do |pkg_type|
-        if pkg_type == 'makeself'
-          run_makeself
-        elsif pkg_type == 'msi'
-          run_msi
-        elsif pkg_type == 'bff'
-          run_bff
-        elsif pkg_type == 'pkgmk'
-          run_pkgmk
-        elsif pkg_type == 'mac_pkg'
-          run_mac_package_build
-        elsif pkg_type == 'mac_dmg'
-          # noop, since the dmg creation is handled by the packager
-        else # pkg_type == "fpm"
-          run_fpm(pkg_type)
-        end
+      # Evaluate any packager-specific blocks, in order.
+      packagers[packager.id].each do |block|
+        packager.evaluate(&block)
+      end
 
-        render_metadata(pkg_type)
+      # Run the actual packager
+      packager.run!
 
-        if Ohai['platform'] == 'windows'
-          FileUtils.cp(Dir["#{Config.package_dir}/*.msi*"], destination, preserve: true)
-        elsif Ohai['platform'] == 'aix'
-          FileUtils.cp(Dir["#{Config.package_dir}/*.bff*"], destination, preserve: true)
-        else
-          FileUtils.cp(Dir["#{Config.package_dir}/*"], destination, preserve: true)
-        end
-      end
+      # Copy the generated package and metadata back into the workspace
+      package_path = File.join(Config.package_dir, packager.package_name)
+      FileUtils.cp(package_path, destination)
+      FileUtils.cp("#{package_path}.metadata.json", destination)
     end
 
-    # Ensures that certain project information has been set
     #
-    # @todo raise MissingProjectConfiguration instead of printing the warning
-    #   in the next major release
     #
-    # @return [void]
-    def validate
-      name && install_dir && maintainer && homepage
-      if package_name == replaces
-        log.warn { BadReplacesLine.new.message }
+    #
+    def compress_me
+      destination = File.expand_path('pkg', Config.project_root)
+
+      # Create the destination directory
+      unless File.directory?(destination)
+        FileUtils.mkdir_p(destination)
+      end
+
+      # Evaluate any compressor-specific blocks, in order.
+      compressors[compressor.id].each do |block|
+        compressor.evaluate(&block)
+      end
+
+      # Run the actual compressor
+      compressor.run!
+
+      # Copy the compressed package and metadata back into the workspace, if it
+      # exists
+      package_path = File.join(Config.package_dir, compressor.package_name)
+
+      if File.file?(package_path)
+        FileUtils.cp(package_path, destination)
+        FileUtils.cp("#{package_path}.metadata.json", destination)
       end
     end
 
@@ -1066,28 +976,17 @@ module Omnibus
       @shasum ||= begin
         digest = Digest::SHA256.new
 
-        log.info(log_key)  { "Calculating shasum" }
-        log.debug(log_key) { "name: #{name.inspect}" }
-        log.debug(log_key) { "install_dir: #{install_dir.inspect}" }
-        log.debug(log_key) { "overrides: #{overrides.inspect}" }
-
         update_with_string(digest, name)
         update_with_string(digest, install_dir)
         update_with_string(digest, JSON.fast_generate(overrides))
 
         if filepath && File.exist?(filepath)
-          log.debug(log_key) { "filepath: #{filepath.inspect}" }
           update_with_file_contents(digest, filepath)
         else
-          log.debug(log_key) { "filepath: <DYNAMIC>" }
           update_with_string(digest, '<DYNAMIC>')
         end
 
-        shasum = digest.hexdigest
-
-        log.debug(log_key) { "shasum: #{shasum.inspect}" }
-
-        shasum
+        digest.hexdigest
       end
     end
 
@@ -1098,313 +997,11 @@ module Omnibus
     private
 
     #
-    # Determine the package type(s) to be built, based on the platform
-    # family for which the package is being built.
-    #
-    # If specific types cannot be determined, default to +["makeself"]+.
+    # The log key for this project, overriden to include the name of the
+    # project for build output.
     #
-    # @return [Array<(String)>]
+    # @return [String]
     #
-    def package_types
-      case Ohai['platform_family']
-      when 'debian'
-        %w(deb)
-      when 'fedora', 'rhel'
-        %w(rpm)
-      when 'aix'
-        %w(bff)
-      when 'solaris2'
-        %w(pkgmk)
-      when 'windows'
-        %w(msi)
-      when 'mac_os_x'
-        %w(mac_pkg mac_dmg)
-      else
-        %w(makeself)
-      end
-    end
-
-    def render_metadata(pkg_type)
-      basename = output_package(pkg_type)
-      pkg_path = "#{Config.package_dir}/#{basename}"
-
-      # Don't generate metadata for packages that haven't been created.
-      # TODO: Fix this and make it betterer
-      return unless File.exist?(pkg_path)
-
-      package = Package.new(pkg_path)
-      Package::Metadata.generate(package,
-        name:             name,
-        friendly_name:    friendly_name,
-        homepage:         homepage,
-        version:          build_version,
-        iteration:        build_iteration,
-      )
-    end
-
-    # The basename of the resulting package file.
-    # @return [String] the basename of the package file
-    def output_package(pkg_type)
-      case pkg_type
-      when 'makeself'
-        "#{package_name}-#{build_version}_#{iteration}.sh"
-      when 'msi'
-        Packager::WindowsMsi.new(self).package_name
-      when 'bff'
-        "#{package_name}.#{bff_version}.bff"
-      when 'pkgmk'
-        "#{package_name}-#{build_version}-#{iteration}.solaris"
-      when 'mac_pkg'
-        Packager::MacPkg.new(self).package_name
-      when 'mac_dmg'
-        pkg = Packager::MacPkg.new(self)
-        Packager::MacDmg.new(pkg).package_name
-      else # fpm
-        require "fpm/package/#{pkg_type}"
-        pkg = FPM::Package.types[pkg_type].new
-        pkg.version = build_version
-        pkg.name = package_name
-        pkg.iteration = iteration
-        if pkg_type == 'solaris'
-          pkg.to_s('NAME.FULLVERSION.ARCH.TYPE')
-        else
-          pkg.to_s
-        end
-      end
-    end
-
-    def bff_command
-      bff_command = ['sudo /usr/sbin/mkinstallp -d / -T /tmp/bff/gen.template']
-      [bff_command.join(' '), { returns: [0] }]
-    end
-
-    # The {https://github.com/jordansissel/fpm fpm} command to
-    # generate a package for RedHat, Ubuntu, Solaris, etc. platforms.
-    #
-    # Does not execute the command, only assembles it.
-    #
-    # @return [Array<String>] the components of the fpm command; need
-    #   to be joined with " " first.
-    #
-    # @todo Just make this return a String instead of an Array
-    # @todo Use the long option names (i.e., the double-dash ones) in
-    #   the fpm command for maximum clarity.
-    def fpm_command(pkg_type)
-      command_and_opts = [
-        'fpm',
-        '-s dir',
-        "-t #{pkg_type}",
-        "-v #{build_version}",
-        "-n #{package_name}",
-        "-p #{output_package(pkg_type)}",
-        "--iteration #{iteration}",
-        "-m '#{maintainer}'",
-        "--description '#{description}'",
-        "--url #{homepage}",
-      ]
-
-      if File.exist?(File.join(package_scripts_path, 'preinst'))
-        command_and_opts << "--before-install '#{File.join(package_scripts_path, "preinst")}'"
-      end
-
-      if File.exist?("#{package_scripts_path}/postinst")
-        command_and_opts << "--after-install '#{File.join(package_scripts_path, "postinst")}'"
-      end
-      # solaris packages don't support --pre-uninstall
-      if File.exist?("#{package_scripts_path}/prerm")
-        command_and_opts << "--before-remove '#{File.join(package_scripts_path, "prerm")}'"
-      end
-      # solaris packages don't support --post-uninstall
-      if File.exist?("#{package_scripts_path}/postrm")
-        command_and_opts << "--after-remove '#{File.join(package_scripts_path, "postrm")}'"
-      end
-
-      exclusions.each do |pattern|
-        command_and_opts << "--exclude '#{pattern}'"
-      end
-
-      config_files.each do |config_file|
-        command_and_opts << "--config-files '#{config_file}'"
-      end
-
-      runtime_dependencies.each do |runtime_dep|
-        command_and_opts << "--depends '#{runtime_dep}'"
-      end
-
-      conflicts.each do |conflict|
-        command_and_opts << "--conflicts '#{conflict}'"
-      end
-
-      if package_user
-        %w(deb rpm solaris).each do |type|
-          command_and_opts << " --#{type}-user #{package_user}"
-        end
-      end
-
-      if package_group
-        %w(deb rpm solaris).each do |type|
-          command_and_opts << " --#{type}-group #{package_group}"
-        end
-      end
-
-      command_and_opts << " --replaces #{replaces}" if replaces
-
-      # All project files must be appended to the command "last", but before
-      # the final install path
-      extra_package_files.each do |files|
-        command_and_opts << files
-      end
-
-      # Install path must be the final entry in the command
-      command_and_opts << install_dir
-      command_and_opts
-    end
-
-    # TODO: what's this do?
-    def makeself_command
-      command_and_opts = [
-        Omnibus.source_root.join('bin', 'makeself.sh'),
-        '--gzip',
-        install_dir,
-        output_package('makeself'),
-        "'The full stack of #{@name}'",
-      ]
-      command_and_opts << './makeselfinst' if File.exist?("#{package_scripts_path}/makeselfinst")
-      command_and_opts
-    end
-
-    # Runs the makeself commands to make a self extracting archive package.
-    # As a (necessary) side-effect, sets
-    # @return void
-    def run_makeself
-      package_commands = []
-      # copy the makeself installer into package
-      if File.exist?("#{package_scripts_path}/makeselfinst")
-        package_commands << "cp #{package_scripts_path}/makeselfinst #{install_dir}/"
-      end
-
-      # run the makeself program
-      package_commands << makeself_command.join(' ')
-
-      # rm the makeself installer (for incremental builds)
-      package_commands << "rm -f #{install_dir}/makeselfinst"
-      package_commands.each { |cmd| run_package_command(cmd) }
-    end
-
-    # Runs the necessary command to make an MSI. As a side-effect, sets +output_package+
-    # @return void
-    def run_msi
-      Packager::WindowsMsi.new(self).run!
-    end
-
-    def bff_version
-      build_version.split(/[^\d]/)[0..2].join('.') + ".#{iteration}"
-    end
-
-    def run_bff
-      FileUtils.rm_rf '/.info/*'
-      FileUtils.rm_rf '/tmp/bff'
-      FileUtils.mkdir '/tmp/bff'
-
-      system "find #{install_dir} -print > /tmp/bff/file.list"
-
-      system "cat #{package_scripts_path}/aix/opscode.chef.client.template | sed -e 's/TBS/#{bff_version}/' > /tmp/bff/gen.preamble"
-
-      # @todo can we just use an erb template here?
-      system "cat /tmp/bff/gen.preamble /tmp/bff/file.list #{package_scripts_path}/aix/opscode.chef.client.template.last > /tmp/bff/gen.template"
-
-      FileUtils.cp "#{package_scripts_path}/aix/unpostinstall.sh", "#{install_dir}/bin"
-      FileUtils.cp "#{package_scripts_path}/aix/postinstall.sh", "#{install_dir}/bin"
-
-      run_package_command(bff_command)
-
-      FileUtils.cp "/tmp/chef.#{bff_version}.bff", "/var/cache/omnibus/pkg/chef.#{bff_version}.bff"
-    end
-
-    def pkgmk_version
-      "#{build_version}-#{iteration}"
-    end
-
-    def run_pkgmk
-      install_dirname = File.dirname(install_dir)
-      install_basename = File.basename(install_dir)
-
-      system 'sudo rm -rf /tmp/pkgmk'
-      FileUtils.mkdir '/tmp/pkgmk'
-
-      system "cd #{install_dirname} && find #{install_basename} -print > /tmp/pkgmk/files"
-
-      prototype_content = <<-EOF
-i pkginfo
-i postinstall
-i postremove
-      EOF
-
-      File.open '/tmp/pkgmk/Prototype', 'w+' do |f|
-        f.write prototype_content
-      end
-
-      # generate the prototype's file list
-      system "cd #{install_dirname} && pkgproto < /tmp/pkgmk/files > /tmp/pkgmk/Prototype.files"
-
-      # fix up the user and group in the file list to root
-      system "awk '{ $5 = \"root\"; $6 = \"root\"; print }' < /tmp/pkgmk/Prototype.files >> /tmp/pkgmk/Prototype"
-
-      pkginfo_content = <<-EOF
-CLASSES=none
-TZ=PST
-PATH=/sbin:/usr/sbin:/usr/bin:/usr/sadm/install/bin
-BASEDIR=#{install_dirname}
-PKG=#{package_name}
-NAME=#{package_name}
-ARCH=#{`uname -p`.chomp}
-VERSION=#{pkgmk_version}
-CATEGORY=application
-DESC=#{description}
-VENDOR=#{maintainer}
-EMAIL=#{maintainer}
-PSTAMP=#{`hostname`.chomp + Time.now.utc.iso8601}
-      EOF
-
-      File.open '/tmp/pkgmk/pkginfo', 'w+' do |f|
-        f.write pkginfo_content
-      end
-
-      FileUtils.cp "#{package_scripts_path}/postinst", '/tmp/pkgmk/postinstall'
-      FileUtils.cp "#{package_scripts_path}/postrm", '/tmp/pkgmk/postremove'
-
-      shellout!("pkgmk -o -r #{install_dirname} -d /tmp/pkgmk -f /tmp/pkgmk/Prototype")
-
-      system 'pkgchk -vd /tmp/pkgmk chef'
-
-      system "pkgtrans /tmp/pkgmk /var/cache/omnibus/pkg/#{output_package("pkgmk")} chef"
-    end
-
-    def run_mac_package_build
-      Packager::MacPkg.new(self).run!
-    end
-
-    # Runs the necessary command to make a package with fpm. As a side-effect,
-    # sets +output_package+
-    # @return void
-    def run_fpm(pkg_type)
-      run_package_command(fpm_command(pkg_type).join(' '))
-    end
-
-    # Executes the given command via mixlib-shellout.
-    # @return [Mixlib::ShellOut] returns the underlying Mixlib::ShellOut
-    #   object, so the caller can inspect the stdout and stderr.
-    def run_package_command(cmd)
-      if cmd.is_a?(Array)
-        command = cmd[0]
-        cmd_options.merge!(cmd[1])
-      else
-        command = cmd
-      end
-
-      shellout!(command, cwd: Config.package_dir)
-    end
-
     def log_key
       @log_key ||= "#{super}: #{name}"
     end