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 58 58: def initialize(gem_spec) 59: init(gem_spec) 60: yield self if block_given? 61: define if block_given? 62: 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 75 75: def define 76: super 77: task :package => ['package:gem'] 78: desc "Build the gem file #{gem_file}" 79: task 'package:gem' => ["#{package_dir}/#{gem_file}"] 80: file "#{package_dir}/#{gem_file}" => [package_dir] + @gem_spec.files do 81: when_writing("Creating GEM") { 82: Gem::Builder.new(gem_spec).build 83: verbose(true) { 84: mv gem_file, "#{package_dir}/#{gem_file}" 85: } 86: } 87: end 88: end
[ show source ]
# File lib/rake/gempackagetask.rb, line 90 90: def gem_file 91: if @gem_spec.platform == Gem::Platform::RUBY 92: "#{package_name}.gem" 93: else 94: "#{package_name}-#{@gem_spec.platform}.gem" 95: end 96: end
Initialization tasks without the "yield self" or define operations.
[ show source ]
# File lib/rake/gempackagetask.rb, line 66 66: def init(gem) 67: super(gem.name, gem.version) 68: @gem_spec = gem 69: @package_files += gem_spec.files if gem_spec.files 70: end