In Files

  • rake/packagetask.rb

Rake::PackageTask

Create a packaging task that will package the project into distributable files (e.g zip archive or tar files).

The PackageTask will create the following targets:

:package

Create all the requested package files.

:clobber_package

Delete all the package files. This target is automatically added to the main clobber target.

:repackage

Rebuild the package files from scratch, even if they are not out of date.

"package_dir/name-version.tgz"

Create a gzipped tar package (if need_tar is true).

"package_dir/name-version.tar.gz"

Create a gzipped tar package (if need_tar_gz is true).

"package_dir/name-version.tar.bz2"

Create a bzip2’d tar package (if need_tar_bz2 is true).

"package_dir/name-version.zip"

Create a zip package archive (if need_zip is true).

Example:

Rake::PackageTask.new("rake", "1.2.3") do |p|
  p.need_tar = true
  p.package_files.include("lib   /*.rb")
end

Attributes

name[RW]

Name of the package (from the GEM Spec).

need_tar[RW]

True if a gzipped tar file (tgz) should be produced (default is false).

need_tar_bz2[RW]

True if a bzip2’d tar file (tar.bz2) should be produced (default is false).

need_tar_gz[RW]

True if a gzipped tar file (tar.gz) should be produced (default is false).

need_zip[RW]

True if a zip file should be produced (default is false)

package_dir[RW]

Directory used to store the package files (default is ‘pkg’).

package_files[RW]

List of files to be included in the package.

tar_command[RW]

Tar command for gzipped or bzip2ed archives. The default is ‘tar’.

version[RW]

Version of the package (e.g. ‘1.3.2’).

zip_command[RW]

Zip command for zipped archives. The default is ‘zip’.

Public Class Methods

new(name=nil, version=nil) click to toggle source

Create a Package Task with the given name and version. Use :noversion as the version to build a package without a version or to provide a fully-versioned package name.

 
               # File rake/packagetask.rb, line 79
def initialize(name=nil, version=nil)
  init(name, version)
  yield self if block_given?
  define unless name.nil?
end
            

Public Instance Methods

define() click to toggle source

Create the tasks defined by this task library.

 
               # File rake/packagetask.rb, line 100
def define
  fail "Version required (or :noversion)" if @version.nil?
  @version = nil if :noversion == @version

  desc "Build all the packages"
  task :package

  desc "Force a rebuild of the package files"
  task :repackage => [:clobber_package, :package]

  desc "Remove package products"
  task :clobber_package do
    rm_r package_dir rescue nil
  end

  task :clobber => [:clobber_package]

  [
    [need_tar, tgz_file, "z"],
    [need_tar_gz, tar_gz_file, "z"],
    [need_tar_bz2, tar_bz2_file, "j"]
  ].each do |(need, file, flag)|
    if need
      task :package => ["#{package_dir}/#{file}"]
      file "#{package_dir}/#{file}" => [package_dir_path] + package_files do
        chdir(package_dir) do
          sh %Q{#{@tar_command} #{flag}cvf #{file} #{package_name}}
        end
      end
    end
  end

  if need_zip
    task :package => ["#{package_dir}/#{zip_file}"]
    file "#{package_dir}/#{zip_file}" => [package_dir_path] + package_files do
      chdir(package_dir) do
        sh %Q{#{@zip_command} -r #{zip_file} #{package_name}}
      end
    end
  end

  directory package_dir

  file package_dir_path => @package_files do
    mkdir_p package_dir rescue nil
    @package_files.each do |fn|
      f = File.join(package_dir_path, fn)
      fdir = File.dirname(f)
      mkdir_p(fdir) if !File.exist?(fdir)
      if File.directory?(fn)
        mkdir_p(f)
      else
        rm_f f
        safe_ln(fn, f)
      end
    end
  end
  self
end
            
init(name, version) click to toggle source

Initialization that bypasses the “yield self” and “define” step.

 
               # File rake/packagetask.rb, line 86
def init(name, version)
  @name = name
  @version = version
  @package_files = Rake::FileList.new
  @package_dir = 'pkg'
  @need_tar = false
  @need_tar_gz = false
  @need_tar_bz2 = false
  @need_zip = false
  @tar_command = 'tar'
  @zip_command = 'zip'
end
            
package_dir_path() click to toggle source
 
               # File rake/packagetask.rb, line 164
def package_dir_path
  "#{package_dir}/#{package_name}"
end
            
package_name() click to toggle source
 
               # File rake/packagetask.rb, line 160
def package_name
  @version ? "#{@name}-#{@version}" : @name
end
            
tar_bz2_file() click to toggle source
 
               # File rake/packagetask.rb, line 176
def tar_bz2_file
  "#{package_name}.tar.bz2"
end
            
tar_gz_file() click to toggle source
 
               # File rake/packagetask.rb, line 172
def tar_gz_file
  "#{package_name}.tar.gz"
end
            
tgz_file() click to toggle source
 
               # File rake/packagetask.rb, line 168
def tgz_file
  "#{package_name}.tgz"
end
            
zip_file() click to toggle source
 
               # File rake/packagetask.rb, line 180
def zip_file
  "#{package_name}.zip"
end
            

Commenting is here to help enhance the documentation. For example, code samples, or clarification of the documentation.

If you have questions about Ruby or the documentation, please post to one of the Ruby mailing lists. You will get better, faster, help that way.

If you wish to post a correction of the docs, please do so, but also file bug report so that it can be corrected for the next release. Thank you.

If you want to help improve the Ruby documentation, please visit Documenting-ruby.org.

blog comments powered by Disqus