pallet 1.2.1

data/CHANGELOG

@@ -0,0 +1,141 @@
+pallet (1.2.1)
+
+  Improvements:
+
+    * better file slurping/gsubbing; whole-file rather than
+      line-by-line
+    * cache of replacements now efficiently reimplemented
+    * dh_installdocs ignores .svn directories
+    * new InstallSpec invocation syntax, old mode is deprecated and
+      will be removed later
+    * build-depends are forced to add pallet's build dependencies
+
+  Bugfixes:
+
+    * fixed bug where files created during the build process aren't
+      included into the Debian package
+    * fixed bug where files in directories not existing before the
+      project was build would not be included in the build
+
+pallet (1.2.0)
+
+  Improvements:
+
+    * reimplemented require overloading as build_dependency and
+      runtime_dependency methods, with no nasty require aliasing
+
+pallet (1.1.1)
+
+  Bugfixes:
+
+    * reverted changes to LoadError in require, since this causes
+      build failures on non-Linux systems
+    * updated Rakefile to include the Debian files in share/
+
+pallet (1.1.0)
+
+  Improvements:
+
+    * Gem::DEFAULT_FILES no longer includes '[A-Z]*'
+    * better documentation
+    * allows calling of rake package without having libraries required
+      for the normal execution of Rakefile; this is disabled for any
+      use of the rakefile _except_ when it is called with a package
+      task or any task in the package namespace (mainly useful for
+      build hosts, to limit the needed Gem dependencies)
+    * debian templates directory now located in share/
+    * gem implementation rewritten to use core gem libraries, rather
+      than being a wrapper around Rake::GemSpecTask
+    * gem task can be renamed
+    * gem allows platform to be set
+    * gem allows dest_dir and filename to be changed
+    * reimplementation of InstallSpec
+    * more efficient case-insensitive globbing implemented
+    * Deb#commands.clean added
+    * debian/rules clean now cleans the source tree too
+    * rake clean doesn't remove debian directory, only rake clobber
+      does now
+    * better DRY-ness of substitution variables (no more having to
+      type the hashes around #FOO#)
+    * debhelper autogenerates entries in postrm
+    * debian/rules streamlined
+    * copyright file added to Debs
+    * debian/rules uses binary-indep and binary-arch smartly, based on
+      the configured package architecture
+    * pallet Rakefile is debianized
+    * Debian conffile support
+
+  Bugfixes:
+
+    * throws an exception when Gem#executables are not all in the same
+      directory
+    * no longer includes bin/bin/* in gems
+    * default Debian build-depends are overrideable, rather than being
+      transparently and secretly added
+    * fixed changelog.Debian.gz formatting
+    * fixed DEFAULT_DOCS and DEFAULT_CHANGELOG in Debian template
+    * fixed template location for debianization
+    * 822-date output chomped in Deb
+    * files generated during build process are now added correctly,
+      and list of files to be added are not cached before the build is
+      run
+
+  Known Bugs:
+
+    * replacements cache no longer as efficient
+    * timestamps can differ if the package is being built when the
+      system clock increments its second hand
+
+pallet (1.0.2)
+
+  Improvements:
+
+    * builds packages binary-only; no source packages
+    * Debian packages signed with author's GPG key if available, or
+      the key id in $GPG_KEY_ID environment if it is set
+    * changelog now reports OS as unstable, stable, and testing
+    * Debian changelog has a better default message
+    * Pallet#requirements field supported by Debian packaging; pops
+      open a debconf warning on install
+    * extended description field Pallet#description added
+    * removed dependency on facets
+    * improved debianization process
+
+  Bugfixes:
+
+    * files are placed into the Debian package with the permissions
+      they already have on the filesystem
+    * fixed bug where InstallSpecs would not always report the base
+      destination directory as needing to exist
+    * default value of Pallet::Deb#docs and Pallet::Deb#files fixed
+    * added dpkg-dev gem requirement
+    * rake clobber always removes packages
+
+ -- Stephen Touset <stouset@damballa.com>  Fri Feb 16 14:17:29 EST 2007
+
+pallet (1.0.1)
+
+  Improvements:
+
+    * added a package:all task to the Rakefile, to generate all
+      supported package types  
+    * added an architecture option for Debian packages, to support
+      scripts supported on the "all" architecture without rebuild
+
+  Bugfixes:
+ 
+    * added debhelper to Debian build-depends
+    * fewer warnings due to non-idiomatic Ruby
+    * adds the CHANGELOG to auto-generated documentation
+    * removed extraneous Rubygems dependencies
+
+ -- Stephen Touset <stouset@damballa.com>  Tue, 13 Feb 2007 17:24:02 -0500
+
+pallet (1.0.0)
+
+  * Initial release of pallet. Allows a small Rakefile-type script to
+    be written which can build packages in the following formats:
+    - Debian
+    - Ruby Gems
+
+ -- Stephen Touset <stouset@damballa.com>  Mon, 12 Feb 2007 12:10:35 -0500

data/lib/dependencies.rb

@@ -0,0 +1,44 @@
+module Kernel
+
+  # 
+  # Tests to see if we're in rake, and any task given on the command
+  # line is equal to or in the namespace of _name_.
+  #
+  def in_rake_task?(name)
+    $0 =~ /rake/ && ARGV.grep(/\A#{name}/).length != 0
+  end
+
+  # 
+  # Requires the library as a build dependency for Pallet, which
+  # ensures it will be loaded whenever the package task is run.
+  #
+  def build_dependency(lib)
+    require lib
+  end
+
+  # 
+  # Requires the given library, ignoring any failures if we're in a
+  # package build task.
+  #
+  def runtime_dependency(lib)
+    if in_rake_task? Pallet::NAMESPACE
+      require lib rescue nil
+    else
+      require lib
+    end
+  end
+
+end
+
+# 
+# Override method_missing and const_missing if we're running a pallet
+# packaging task.
+#
+if in_rake_task? Pallet::NAMESPACE
+  module Kernel #:nodoc:
+    def method_missing(name); nil; end
+  end
+  class Module #:nodoc:
+    def const_missing(name); nil; end
+  end
+end

data/lib/install_spec.rb

@@ -0,0 +1,89 @@
+class InstallSpec
+
+  # The directory or file to move from.
+  attr_accessor :source
+
+  # The directory to move any matching files to.
+  attr_accessor :destination
+
+  # Extra attributes for the install specification. Supported
+  # attributes are +:glob+, to change the default globbing pattern, and
+  # +:conf+, which marks the set of files as configuration files.
+  attr_accessor :attributes
+
+  DEFAULT_GLOB     = '**/*'
+  EXTRA_SEPARATORS = %r{^/+(.*)/+$}
+
+  # 
+  # Initializes the InstallSpec, as a shortcut for InstallSpec#new
+  #
+  def self.[](source, destination, attributes = {})
+    new(source, destination, attributes)
+  end
+
+  # 
+  # Initializes the InstallSpec. Available attributes are +:conf+ and
+  # +:glob+. Accepts a block for backwards compatibility, although
+  # this usage is deprecated.
+  #
+  def initialize(source, destination, attributes = {})
+
+    self.source      = source
+    self.destination = destination
+    self.attributes  = attributes
+
+    # yield for more initialization, for backwards-compatibility
+    # purposes
+    if block_given?
+      puts "WARNING: DEPRECATED USAGE OF INSTALLSPEC. NO LONGER ACCEPTS A BLOCK PARAMETER."
+      yield s = Struct.new(:source, :destination, :glob, :conffiles).new
+      self.source      = s.source      if s.source
+      self.destination = s.destination if s.destination
+      self.attributes[:glob] = s.glob
+      self.attributes[:conf] = s.conffiles
+    end
+
+
+    # remove any leading /'s, since we should be dealing only with
+    # relative directory paths
+    source.sub!      EXTRA_SEPARATORS, '\1'
+    destination.sub! EXTRA_SEPARATORS, '\1'
+
+    # update attributes with the defaults if needed
+    self.attributes[:glob] ||= DEFAULT_GLOB
+    self.attributes[:conf] ||= !! destination.match(%r{/etc|etc/|\Aetc\z})
+
+  end
+
+  # 
+  # A hash of all files in _source_ mapping to their destination.
+  #
+  def files
+    hash_to_dest(Dir[pattern].find_all {|f| File.file? f })
+  end
+
+  # 
+  # A hash of all directories in _source_ mapped to their destination.
+  #
+  def directories
+    hash_to_dest(Dir[pattern].find_all {|f| File.directory? f } << source)
+  end
+
+  private
+
+  #
+  # The full search pattern to use when looking for files.
+  #
+  def pattern
+    File.directory?(source) ? File.join(source, attributes[:glob]) : source
+  end
+
+  #
+  # Creates a hash mapping everything in _files_ beginning with _source_
+  # to its corresponding location in _destination_.
+  #
+  def hash_to_dest(files)
+   Hash[*files.map {|f| [f, f.sub(/^#{source}/, destination)] }.flatten]
+  end
+
+end

data/lib/pallet.rb

@@ -0,0 +1,109 @@
+require 'rubygems'
+require 'rake'
+
+require 'pallet/deb'
+require 'pallet/gem'
+require 'install_spec'
+
+class Pallet
+
+  VERSION      = '1.2.1'
+  NAMESPACE    = 'package'
+
+  # The name of the project.
+  attr_accessor :name
+ 
+  # The version number of the project to tag onto the package.
+  attr_accessor :version
+ 
+  # A short description of the package function.
+  attr_accessor :summary
+
+  # A longer, more detailed description of the package's capabilities.
+  attr_accessor :description
+
+  # The name of the current project maintainer.
+  attr_accessor :author
+  
+  # The maintainer's email address.
+  attr_accessor :email
+
+  # An enumerable with the package definitions for each package type
+  # you wish to support in your project.
+  attr_accessor :packages
+
+  # The preferred packaging format of your project. +rake package+
+  # will build this format, but others can still be built with +rake
+  # package:#{format}+.
+  attr_accessor :preferred_format
+
+  #
+  # Initializes the pallet to a sane state, and creates all the
+  # necessary Rake tasks. Passes a copy of itself to a block, if
+  # given, and uses that block for further initializiation. If no
+  # _version_ is given, defaults to the output of +svnversion+.
+  #
+  def initialize(name, version = %x{svnversion}.chomp)
+
+    # set up defaults
+    self.name        = name
+    self.version     = version
+    self.author      = 'Anonymous'
+    self.email       = 'anonymous@example.org'
+    self.summary     = ''
+    self.description = ''
+    self.packages    = []
+    
+    # let block continue initialization
+    yield self if block_given?
+    
+    # check that we have _some_ package to build
+    if packages.empty?
+      raise TypeError, 'at least one package type must be specified'
+    end
+
+    # if no preferred format given, use the first one specified
+    self.preferred_format ||= packages.first
+
+    define_rake_tasks
+
+  end
+
+  private
+
+  # 
+  # Defines all rake tasks related to packaging.
+  #
+  def define_rake_tasks
+
+    namespace NAMESPACE do
+
+      desc 'Build all supported package types'
+      task :all
+
+      desc 'Remove any ephemeral files used to build packages'
+      task :clean
+
+      desc 'Clean up all package files'
+      task :clobber
+
+      # define a task for all supported packages
+      self.packages.each do |package|
+        package.define
+        task :all => package.task_name
+      end
+
+    end
+
+    # default package task redirection
+    desc "Build a #{preferred_format.task_name}"
+    task :package => "#{NAMESPACE}:#{preferred_format.task_name}"
+
+    # have clean/clobber depend on our own
+    %w{clean clobber}.each {|t| task t => "#{NAMESPACE}:#{t}" }
+
+  end
+
+end
+
+require 'dependencies'

data/lib/pallet/deb.rb

@@ -0,0 +1,311 @@
+class Pallet
+
+  #
+  # = Pallet::Deb
+  #
+  # Automatic builder for Debian packages. Lets users automagically
+  # build a deb after specifying a few customizations.
+  #
+  # == Usage
+  #
+  # At a bare minimum, users must specify lists of files, and where to
+  # place them. The syntax for doing so is not obvious, so we will
+  # demonstrate by example.
+  #
+  # To create a Debian package, moving everything under 'lib/' to
+  # '/usr/lib/ruby/1.8/', everything in 'bin/' to '/usr/bin/', and all
+  # documentation under 'doc/' to the Debian default documentation
+  # directory, under the subdirectory HTML, you would write the
+  # following:
+  #
+  #   Pallet::Deb.new(pallet) do |deb|
+  #--
+  # TODO: EXAMPLE!!
+  #++
+  #   end
+  #
+  # === GPG Integration
+  #
+  # Pallet::Deb will sign its built Debian packages with the GPG key
+  # id in the environment variable $GPG_KEY_ID, if it is set.
+  # Otherwise, it will sign with the key associated with the
+  # maintainer's email address, if it is avaialble.
+  #
+  # == Caveats
+  #
+  # * Uses dpkg-buildpackage, which is not very flexible. Should be
+  #   rewritten later to do everything on its own.
+  # * Can only be used to build a single package, rather than multiple
+  #   packages from one source.
+  # * Packages are installed into .., rather than pkg/
+  # * No doc-base integration
+  #
+  class Deb
+
+    # The name the generated rake task will use. Defaults to 'deb'.
+    attr_accessor :task_name
+
+    # An array of Debian build dependencies needed in order to build
+    # the package for this project. Defaults to any core build
+    # requirements introduced by pallet (currently only debhelper (>=
+    # 5) and dpkg-dev).
+    attr_accessor :build_depends
+
+    # All Debian packages this project depends on.
+    attr_accessor :depends
+
+    # Any additional requirements not satisfiable through the Debian
+    # packaging system. For instance, Ruby gems. Any requirements
+    # provided this way will be presented to the user through a
+    # Debconf dialog upon installation.
+    attr_accessor :requirements
+
+    # An array of any tasks which should run and complete successfully
+    # before the Debian package is built.
+    attr_accessor :prerequisites
+
+    # A struct containing a few statically-named commands that can
+    # replace parts of the Pallet::Deb build process. Currently
+    # allows assignment to the _build_, _install_, _package_,
+    # _document_, and _clean_ instance variables.
+    #
+    # _commands.build_ defaults to 'make', 'ant', or nil depending on
+    # whether or not a Makefile, build.xml, or no build file is
+    # detected, respectively.
+    #
+    # _commands.clean_ deafults to 'rake clean'. It can be overridden
+    # if you have another method of cleaning your build directory.
+    #
+    # _commands.install_ defaults to nil. If your project already
+    # provides a command that installs all files needed for the
+    # project into a prefixed directory, you can specify this rather
+    # than providing InstallSpecs to _Pallet::Deb#files_. However,
+    # this command +must+ be able to support a "DESTDIR=$DIR"-style
+    # parameter which determines the install prefix.
+    #
+    # _commands.package_ defaults to nil. If this is specified, the
+    # +entire+ build process will consist of calling this command.
+    # This might be desirable if your project already provides a
+    # _debian_ directory and a _make deb_ command to build the Debian
+    # package. Otherwise, leave this at its default.
+    #
+    # _commands.document_ defaults to nil. If specified, this command
+    # is run to build any automatically-generated documentation.
+    #
+    attr_accessor :commands
+
+
+    # An array of InstallSpec objects pointing to files and their
+    # destination in the finished package. May be omitted if
+    # _commands.install_ is provided.
+    attr_accessor :files
+
+    # A FileList, array, or other enumerable object containing a list
+    # of all project documentation to include in the Debian pacakge.
+    attr_accessor :docs
+
+    # The location on the filesystem of the project Changelog.
+    # Defaults to 'CHANGELOG', if one exists.
+    attr_accessor :changelog
+
+    # A hash pointing to the location of scripts the Debian package
+    # should include. The key in the hash is the debhelper-reconigzed
+    # type of script (cron.d, postinst, postrm, init.d, etc.). The
+    # value is its location in your project hierarchy.
+    attr_accessor :scripts
+
+    # The machine architecture the package can be built to support.
+    # Defaults to 'any', but 'all' should be used for languages that
+    # aren't compiled to a specific platform.
+    attr_accessor :architecture
+
+    # The version of the Debian policy we support
+    DEBIAN_POLICY_VERSION = '3.7.2'
+
+    # Mapping of build spec files to the command that invokes them. We
+    # don't include rake here, since most Ruby programs don't need
+    # "building", and there is no idiomatic rake task used for
+    # building extensions.
+    BUILD_COMMANDS = { 'Makefile'  => 'make --silent',
+                       'build.xml' => 'ant', }
+
+    # Build dependencies required by pallet, which will always be
+    # added to the debian/control file.
+    BUILD_DEPENDS = ['debhelper (> 5.0)', 'dpkg-dev']
+
+    # Default places to look for documentation.
+    DEFAULT_DOCS = FileList[%w{README* TODO* doc*}]
+    
+    # Default changelog search locations.
+    DEFAULT_CHANGELOG = FileList[%w{CHANGELOG*}]
+
+    # 
+    # Creates a new specification for building a deb. Yields itself to
+    # the blocked passed for further initialization.
+    # 
+    def initialize(pallet)
+
+      @pallet = pallet
+
+      # configure defaults
+      self.task_name     = :deb
+      self.depends       = []
+      self.build_depends = []
+      self.requirements  = []
+      self.prerequisites = []
+      self.files         = []
+      self.docs          = DEFAULT_DOCS
+      self.changelog     = DEFAULT_CHANGELOG.first
+      self.scripts       = {}
+      self.commands      = Struct.new(:build, :clean, :install, :package, :document).new
+      self.architecture  = 'any'
+
+      # try and determine a default build command
+      BUILD_COMMANDS.find do |file, command|
+        self.commands.build = command if File.exist? file
+      end
+
+      # default packaging command; adds GPG key if it's in the environment
+      self.commands.package = "dpkg-buildpackage -rfakeroot -b"
+      self.commands.package << " -k#{ENV['GPG_KEY_ID']}" if ENV['GPG_KEY_ID']
+
+      # default clean command
+      self.commands.clean = 'rake --silent clean'
+
+      # send me off to be configured
+      yield self if block_given?
+
+      # append our core build-dependencies to any others specified, so
+      # the user doesn't have to
+      self.build_depends |= BUILD_DEPENDS
+
+    end
+
+    def define
+
+      desc 'Build this project into a Debian package'
+      task self.task_name => self.prerequisites do
+        debianize unless File.directory? 'debian'
+        packagize
+      end
+
+      task 'clean'     => ['clean:deb']
+      task 'clean:deb' do
+        # don't call debian/rules clean if we've already been called
+        # through Make; this might not be entirely reliable...
+        ENV['MAKELEVEL'] or system 'fakeroot debian/rules clean' if File.exist? 'debian/rules'
+      end
+
+      task 'clobber'     => ['clobber:deb']
+      task 'clobber:deb' do
+        rm_r 'debian' rescue nil
+        files = Dir["../#{@pallet.name}_#{@pallet.version}*.changes"] +
+                Dir["../#{@pallet.name}_#{@pallet.version}*.deb"]
+        files.each {|f| rm f if File.exist? f }
+      end
+
+    end
+
+    private
+
+    # 
+    # Build the _debian/_ directory under the project root
+    #
+    def debianize
+
+      locations = [File.dirname(__FILE__) + '/../../share/debian',
+                   '/usr/share/pallet/debian']
+      templates = locations.find {|f| puts f; File.directory? f }
+
+      # make the target directory
+      mkdir 'debian'
+
+      # copy/gsub template files into place
+      Dir[templates + '/**/*'].each do |file|
+        
+        dest = 'debian/' + File.basename(file)
+
+        # gsub our replacements in the file in memory, then write back
+        # out to the destination
+        begin
+          s = File.open(file, File::RDONLY)
+          d = File.open(dest, File::WRONLY | File::CREAT)
+          d.write replacements.inject(s.readlines.join) {|contents, rep| contents.gsub %r|##{rep[0]}#|, rep[1] }
+        ensure
+          s.close
+          d.close
+        end
+
+      end
+
+      # mark debian/rules as executable
+      chmod 0755, 'debian/rules'
+
+      # relocate any additional scripts into the debian directory
+      scripts.each_pair do |type, location|
+        ln_sf "../#{location}", "debian/#{type}"
+      end
+
+    end
+
+    def packagize
+      system self.commands.package
+    end
+
+    def replacements
+      @replacements_cache ||= {
+        'ARCHITECTURE' => lambda { self.architecture },
+        'BUILD_DEPS'   => lambda { self.build_depends.join ', ' },
+        'CHANGELOG'    => lambda { self.changelog },
+        'CLEAN'        => lambda { self.commands.clean },
+        'CONFFILES'    => lambda { conffiles },
+        'DATE'         => lambda { %x{822-date}.chomp },
+        'DEPENDS'      => lambda { self.depends.join ', ' },
+        'DESCRIPTION'  => lambda { @pallet.description.gsub(/\n/, "\n ") },
+        'DIRECTORIES'  => lambda { directories },
+        'DOCS'         => lambda { system self.commands.document if self.commands.document; self.docs.join "\n" },
+        'EMAIL'        => lambda { @pallet.email },
+        'FILES'        => lambda { system self.commands.build if self.commands.build; install },
+        'INSTALL'      => lambda { self.commands.install ? "#{self.commands.install} DESTDIR=debian/#{@pallet.name}" : nil },
+        'MAKE'         => lambda { self.commands.build },
+        'MODE'         => lambda { self.architecture == 'all' ? 'indep' : 'arch' },
+        'PACKAGE'      => lambda { @pallet.name },
+        'POLICY'       => lambda { DEBIAN_POLICY_VERSION },
+        'REQUIREMENTS' => lambda { self.requirements.map {|r| ' * ' + r }.join "\n" },
+        'SUMMARY'      => lambda { @pallet.summary },
+        'UNUSED-MODE'  => lambda { self.architecture == 'all' ? 'arch' : 'indep' },
+        'USERNAME'     => lambda { @pallet.author },
+        'VERSION'      => lambda { @pallet.version },
+      }.instance_eval { each {|k,v| self[k] = v.call.to_s } }
+    end
+
+    # 
+    # Generate the complete list of directories needed.
+    #
+    def directories
+      self.files.inject([]) {|m, s| m + s.directories.values }.uniq.join "\n"
+    end
+
+    # 
+    # Generate a list of "install" commands to move files into the
+    # correct directory.
+    #
+    def install
+      self.files.inject([]) do |m,s|
+        m + s.files.map {|src, dst| "#{src} #{File.dirname(dst)}" }
+      end.join "\n"
+    end
+
+    #
+    # Returns a list of configuration files in _files_, from the
+    # perspective of the destination on the filesystem when the
+    # package is installed
+    #
+    def conffiles
+     self.files.inject([]) do |m,s|
+        m + (s.attributes[:conf] ? s.files.map {|src, dst| dst } : [])
+      end.join "\n"
+    end
+
+  end
+end

data/lib/pallet/gem.rb

@@ -0,0 +1,198 @@
+require 'rubygems'
+require 'rubygems/builder'
+
+class Pallet
+
+  # 
+  # = Pallet::Gem
+  #
+  # Automatic rubygem builder. Lets users automagically build a gem
+  # after specifying a few customizations.
+  #
+  # == Usage
+  #
+  # Uses several sane defaults, so in many cases, the specification
+  # could be written simply as:
+  #
+  #   Pallet::Gem.new(pallet)
+  #
+  # Which is identical to the following example:
+  #
+  #   Pallet::Gem.new(pallet) do |g|
+  #     g.files       = FileList['lib/**/*', '[A-Z]*']
+  #     g.executables = FileList['bin/*']
+  #     g.tests       = FileList['test/**/*']
+  #     g.readme      = 'README'
+  #   end
+  #
+  # These can be changed, and other attributes can be set.
+  #
+  #   Pallet::Gem.new(pallet) do |g|
+  #     g.files  = FileList['**/*']
+  #     g.readme = 'Readme.txt'
+  #     g.depends      << 'log4r' << 'rake' << 'pallet'
+  #     g.requirements << 'Debian Linux' << 'a fast processor'
+  #   end
+  #
+  # Dependencies are passed directly to the Gem::Specification
+  # backend, so they can be used as GemSpec-style arrays, if you need
+  # explicit version information.
+  #
+  #   Pallet::Gem.new(pallet) do |g|
+  #     g.depends << ['log4r', '>= 1.4.2']
+  #     g.depends << ['pallet', >= 1.0.0']
+  #   end
+  #
+  # == Caveats
+  #
+  #  * Due to limitations in the gem specification format, executables
+  #    _must_ all reside in the same directory -- by default, 'bin/'.
+  #
+  class Gem
+
+    # The name of the rake task we generate. Defaults to 'gem'.
+    attr_accessor :task_name
+    
+    # The directory the package will be built into
+    attr_accessor :dest_dir
+
+    # The filename of the package, when built
+    attr_accessor :filename
+
+    # The target platform of the Gem. Defaults to the sane default of
+    # Gem::Platform::RUBY. See the rdoc for Gem::Platform for other
+    # reasonable values.
+    attr_accessor :platform
+
+    # A list of the files to be contained in the package. Does not
+    # have to contain files implied elsewhere (for instance, 
+    # _docs_, _executables_, or _tests_).
+    attr_accessor :files
+
+    # A list of executables contained in the gem. All of these +must+
+    # be in the same directory. An exception will be thrown if they
+    # are not.
+    attr_accessor :executables
+
+    # A list of all test scripts which should be contained in the Gem.
+    attr_accessor :tests
+
+    # A list of additional documentation that should be included along
+    # with the automatically generated rdoc pages. The first one
+    # given will be the "default" rdoc page.
+    attr_accessor :docs
+
+    # All rubygems this Gem should depend on.
+    attr_accessor :depends
+
+    # Any additional requirements not satisfiable through rubygems.
+    # These are currently ignored.
+    attr_accessor :requirements
+
+    # Array of additional tasks which should be completed before the
+    # Gem is built.
+    attr_accessor :prerequisites
+
+    DEFAULT_FILES       = FileList['lib/**/*']
+    DEFAULT_EXECUTABLES = FileList['bin/*']
+    DEFAULT_TESTS       = FileList['test/**/*']
+    DEFAULT_DOCS        = %w{readme todo changelog}
+   
+    # 
+    # Creates a new specification for building a Gem. Yields itself to
+    # the block passed for initialization.
+    #
+    def initialize(pallet)
+
+      # the name of our rake task
+      self.task_name = :gem
+      self.dest_dir  = 'pkg'
+      self.platform  = ::Gem::Platform::RUBY
+
+      # set up defaults
+      self.files         = DEFAULT_FILES
+      self.executables   = DEFAULT_EXECUTABLES
+      self.tests         = DEFAULT_TESTS
+      self.docs          = Dir['*'].find_all {|f| DEFAULT_DOCS.include? f.downcase }
+      self.depends       = []
+      self.requirements  = []
+      self.prerequisites = []
+
+      yield self if block_given?
+
+      # build the specification
+      @spec = ::Gem::Specification.new do |s|
+
+        # inherited values from the pallet
+        s.name        = pallet.name
+        s.version     = pallet.version
+        s.author      = pallet.author
+        s.email       = pallet.email
+        s.summary     = pallet.summary
+        s.description = pallet.description
+
+        s.platform    = self.platform 
+
+        # aggregate list of files to include
+        s.files = files | executables | tests | docs
+
+        # include binary files
+        unless self.executables.empty?
+          dirs          = self.executables.map {|f| File.dirname(f) }.uniq
+          dirs.length  == 1 or raise RuntimeError, 'all binaries in a Gem must be in the same directory'
+          s.bindir      = dirs.first
+          s.executables = self.executables.map {|f| File.basename(f) }
+        end
+
+        # include tests
+        s.test_files = self.tests
+
+        # include additional documentation
+        s.has_rdoc         = true
+        s.extra_rdoc_files = self.docs
+        s.rdoc_options << '-S' << '-N'
+        unless self.docs.empty?
+          s.rdoc_options << '--main' << self.docs.first
+        end
+
+        # add dependencies
+        self.depends.each {|dependency| s.add_dependency(*dependency) }
+        s.requirements = self.requirements
+
+      end
+
+    end
+
+    # 
+    # Defines the rake task for creating a gem.
+    #
+    def define
+
+      filename = @spec.full_name + '.gem'
+      dest     = File.join(self.dest_dir, filename)
+
+      # create a task for the gem 
+      desc 'Build this project into a gem'
+      task      self.task_name => self.prerequisites + [dest]
+      directory self.dest_dir
+
+      # task to build the package
+      file dest => [self.dest_dir] + @spec.files do
+        when_writing("Building Rubygem") do
+          b = ::Gem::Builder.new(@spec)
+          b.use_ui(::Gem::SilentUI.new) { b.build }
+          mv filename, self.dest_dir
+        end
+      end
+
+      # clobber task
+      task 'clobber'     => 'clobber:gem'
+      task 'clobber:gem' do
+        rm dest rescue nil
+        rmdir self.dest_dir rescue nil
+      end
+
+    end
+
+  end
+end

data/share/debian/changelog

@@ -0,0 +1,7 @@
+#PACKAGE# (#VERSION#-1) unstable; urgency=low
+
+  * Automatically packaged version of #PACKAGE#, using pallet.
+    Please see the project changelog in /usr/share/doc/#PACKAGE#/ 
+    for more details.
+
+ -- #USERNAME# <#EMAIL#>  #DATE#

data/share/debian/compat

@@ -0,0 +1 @@
+5

data/share/debian/conffiles

@@ -0,0 +1 @@
+#CONFFILES#

data/share/debian/config

@@ -0,0 +1,8 @@
+#!/bin/sh -e
+
+. /usr/share/debconf/confmodule
+
+if [ -n "#REQUIREMENTS#" ]; then
+	db_input high #PACKAGE#/requirements || true
+	db_go || true
+fi

data/share/debian/control

@@ -0,0 +1,12 @@
+Source: #PACKAGE#
+Section: non-free/damballa
+Priority: extra
+Maintainer: #USERNAME# <#EMAIL#>
+Build-Depends: #BUILD_DEPS#
+Standards-Version: #POLICY#
+
+Package: #PACKAGE#
+Architecture: #ARCHITECTURE#
+Depends: ${shlibs:Depends}, ${misc:Depends}, #DEPENDS#
+Description: #SUMMARY#
+ #DESCRIPTION#

data/share/debian/copyright

@@ -0,0 +1,7 @@
+This package was created automatically using pallet, for #USERNAME#
+<#EMAIL#> on #DATE#.
+
+This software is for internal use at Damballa, Inc. only. Copyrights
+are claimed on all components of this package owned by Damballa.
+
+No rights to use, distribute, or modify this program are granted.

data/share/debian/dirs

@@ -0,0 +1 @@
+#DIRECTORIES#

data/share/debian/docs

@@ -0,0 +1 @@
+#DOCS#

data/share/debian/install

@@ -0,0 +1 @@
+#FILES#

data/share/debian/postinst

@@ -0,0 +1,3 @@
+#!/bin/sh -e
+
+. /usr/share/debconf/confmodule

data/share/debian/postrm

@@ -0,0 +1,3 @@
+#!/bin/sh -e
+
+#DEBHELPER#

data/share/debian/rules

@@ -0,0 +1,61 @@
+#!/usr/bin/make -f
+
+# Uncomment this to turn on verbose mode.
+#export DH_VERBOSE=1
+
+# The Debhelper compatibility level to use
+#export DH_COMPAT=4
+
+# Debian policy recommended CFLAGS
+CFLAGS = -g -O2 -Wall
+
+build: build-stamp
+build-stamp:
+	dh_testdir
+	#MAKE#
+	touch $@
+
+clean:
+	dh_testdir
+	dh_testroot
+	rm -f build-stamp
+	exit
+	#CLEAN#
+	dh_clean
+
+install: build
+	dh_testdir
+	dh_testroot
+	dh_clean
+	dh_installdirs
+	dh_install
+	#INSTALL#
+
+# Either binary-indep or binary-arch, depending on which one isn't
+# actually used. Both must be present.
+binary-#UNUSED-MODE#: build install
+
+# Either binary-indep or binary-arch, depending on which one is
+# actually used. Both must be present.
+binary-#MODE#: build install
+	dh_testdir
+	dh_testroot
+	dh_installchangelogs #CHANGELOG#
+	dh_installdocs -X.svn
+	dh_installdebconf
+	dh_installlogrotate
+	dh_installinit
+	dh_installcron
+	dh_installman
+	dh_strip
+	dh_compress
+	dh_fixperms
+	dh_makeshlibs
+	dh_installdeb
+	dh_shlibdeps
+	dh_gencontrol
+	dh_md5sums
+	dh_builddeb
+
+binary: binary-indep binary-arch
+.PHONY: build clean binary-indep binary-arch binary install

data/share/debian/templates

@@ -0,0 +1,10 @@
+Template: #PACKAGE#/requirements
+Type: note
+Description: Additional requirements must be filled!
+ This package requires the following software or conditions which
+ cannot be fulfilled by apt:
+ .
+ #REQUIREMENTS#
+ .
+ Until you satisfy these requirements, this software WILL NOT WORK. So
+ satisfy them. Now.

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.0
+specification_version: 1
+name: pallet
+version: !ruby/object:Gem::Version 
+  version: 1.2.1
+date: 2007-04-30 00:00:00 -04:00
+summary: Automated packaging tool for different languages and OSes
+require_paths: 
+- lib
+email: stouset@damballa.com
+homepage: 
+rubyforge_project: 
+description: ""
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Stephen Touset
+files: 
+- lib/pallet
+- lib/install_spec.rb
+- lib/pallet.rb
+- lib/dependencies.rb
+- lib/pallet/gem.rb
+- lib/pallet/deb.rb
+- share/debian
+- share/debian/changelog
+- share/debian/control
+- share/debian/dirs
+- share/debian/compat
+- share/debian/postinst
+- share/debian/postrm
+- share/debian/config
+- share/debian/install
+- share/debian/conffiles
+- share/debian/copyright
+- share/debian/docs
+- share/debian/rules
+- share/debian/templates
+- CHANGELOG
+- README
+test_files: []
+
+rdoc_options: 
+- -S
+- -N
+- --main
+- CHANGELOG
+extra_rdoc_files: 
+- CHANGELOG
+- README
+executables: []
+
+extensions: []
+
+requirements: 
+- fakeroot
+- dpkg-dev
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rake
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">"
+      - !ruby/object:Gem::Version 
+        version: 0.0.0
+    version: