Create a package based upon a Gem spec. Gem packages, as well as zip files and tar/gzipped packages can be produced by this task.
In addition to the Rake targets generated by PackageTask, a GemPackageTask will also generate the following tasks:
- "package_dir/name-version.gem"
- Create a Ruby GEM package with the given name and version.
Example using a Ruby GEM spec:
require 'rubygems' spec = Gem::Specification.new do |s| s.platform = Gem::Platform::RUBY s.summary = "Ruby based make-like utility." s.name = 'rake' s.version = PKG_VERSION s.requirements << 'none' s.require_path = 'lib' s.autorequire = 'rake' s.files = PKG_FILES s.description = <<EOF Rake is a Make-like program implemented in Ruby. Tasks and dependencies are specified in standard Ruby syntax. EOF end Rake::GemPackageTask.new(spec) do |pkg| pkg.need_zip = true pkg.need_tar = true end
Methods
Attributes
[RW] | gem_spec | Ruby GEM spec containing the metadata for this package. The name, version and package_files are automatically determined from the GEM spec and don‘t need to be explicitly provided. |
Public Class methods
Create a GEM Package task library. Automatically define the gem if a block is given. If no block is supplied, then define needs to be called to define the task.
[ show source ]
# File lib/rake/gempackagetask.rb, line 56 56: def initialize(gem_spec) 57: init(gem_spec) 58: yield self if block_given? 59: define if block_given? 60: end
Public Instance methods
Create the Rake tasks and actions specified by this GemPackageTask. (define is automatically called if a block is given to new).
[ show source ]
# File lib/rake/gempackagetask.rb, line 73 73: def define 74: super 75: task :package => [:gem] 76: desc "Build the gem file #{gem_file}" 77: task :gem => ["#{package_dir}/#{gem_file}"] 78: file "#{package_dir}/#{gem_file}" => [package_dir] + @gem_spec.files do 79: when_writing("Creating GEM") { 80: Gem::Builder.new(gem_spec).build 81: verbose(true) { 82: mv gem_file, "#{package_dir}/#{gem_file}" 83: } 84: } 85: end 86: end
[ show source ]
# File lib/rake/gempackagetask.rb, line 88 88: def gem_file 89: if @gem_spec.platform == Gem::Platform::RUBY 90: "#{package_name}.gem" 91: else 92: "#{package_name}-#{@gem_spec.platform}.gem" 93: end 94: end
Initialization tasks without the "yield self" or define operations.
[ show source ]
# File lib/rake/gempackagetask.rb, line 64 64: def init(gem) 65: super(gem.name, gem.version) 66: @gem_spec = gem 67: @package_files += gem_spec.files if gem_spec.files 68: end