class Gem::Package::TarWriter

Allows writing of tar files

Public Class Methods

new(io) { |writer| ... } click to toggle source

Creates a new TarWriter, yielding it if a block is given

Calls superclass method

# File lib/rubygems/package/tar_writer.rb, line 78
def self.new(io)
  writer = super

  return writer unless block_given?

  begin
    yield writer
  ensure
    writer.close
  end

  nil
end

new(io) click to toggle source

Creates a new TarWriter that will write to io

# File lib/rubygems/package/tar_writer.rb, line 95
def initialize(io)
  @io = io
  @closed = false
end

Public Instance Methods

add_file(name, mode) { |io| ... } click to toggle source

Adds file name with permissions mode, and yields an IO for writing the file to

# File lib/rubygems/package/tar_writer.rb, line 104
def add_file(name, mode) # :yields: io
  check_closed

  raise Gem::Package::NonSeekableIO unless @io.respond_to? :pos=

  name, prefix = split_name name

  init_pos = @io.pos
  @io.write "\0" * 512 # placeholder for the header

  yield RestrictedStream.new(@io) if block_given?

  size = @io.pos - init_pos - 512

  remainder = (512 - (size % 512)) % 512
  @io.write "\0" * remainder

  final_pos = @io.pos
  @io.pos = init_pos

  header = Gem::Package::TarHeader.new :name => name, :mode => mode,
                                       :size => size, :prefix => prefix,
                                       :mtime => Time.now

  @io.write header
  @io.pos = final_pos

  self
end

add_file_digest(name, mode, digest_algorithms) { |io| ... } click to toggle source

Adds name with permissions mode to the tar, yielding io for writing the file. The digest_algorithm is written to a read-only name.sum file following the given file contents containing the digest name and hexdigest separated by a tab.

The created digest object is returned.

# File lib/rubygems/package/tar_writer.rb, line 142
def add_file_digest name, mode, digest_algorithms # :yields: io
  digests = digest_algorithms.map do |digest_algorithm|
    digest = digest_algorithm.new
    digest_name =
      if digest.respond_to? :name then
        digest.name
      else
        /::([^:]+)$/ =~ digest_algorithm.name
        $1
      end

    [digest_name, digest]
  end

  digests = Hash[*digests.flatten]

  add_file name, mode do |io|
    Gem::Package::DigestIO.wrap io, digests do |digest_io|
      yield digest_io
    end
  end

  digests
end

add_file_signed(name, mode, signer) { |io| ... } click to toggle source

Adds name with permissions mode to the tar, yielding io for writing the file. The signer is used to add a digest file using its digest_algorithm per #add_file_digest and a cryptographic signature in name.sig. If the signer has no key only the checksum file is added.

Returns the digest.

# File lib/rubygems/package/tar_writer.rb, line 175
def add_file_signed name, mode, signer
  digest_algorithms = [
    signer.digest_algorithm,
    Digest::SHA512,
  ].compact.uniq

  digests = add_file_digest name, mode, digest_algorithms do |io|
    yield io
  end

  signature_digest = digests.values.compact.find do |digest|
    digest_name =
      if digest.respond_to? :name then
        digest.name
      else
        /::([^:]+)$/ =~ digest.class.name
        $1
      end

    digest_name == signer.digest_name
  end

  if signer.key then
    signature = signer.sign signature_digest.digest

    add_file_simple "#{name}.sig", 0444, signature.length do |io|
      io.write signature
    end
  end

  digests
end

add_file_simple(name, mode, size) { |io| ... } click to toggle source

Add file name with permissions mode size bytes long. Yields an IO to write the file to.

# File lib/rubygems/package/tar_writer.rb, line 212
def add_file_simple(name, mode, size) # :yields: io
  check_closed

  name, prefix = split_name name

  header = Gem::Package::TarHeader.new(:name => name, :mode => mode,
                                       :size => size, :prefix => prefix,
                                       :mtime => Time.now).to_s

  @io.write header
  os = BoundedStream.new @io, size

  yield os if block_given?

  min_padding = size - os.written
  @io.write("\0" * min_padding)

  remainder = (512 - (size % 512)) % 512
  @io.write("\0" * remainder)

  self
end

add_symlink(name, target, mode) click to toggle source

Adds symlink name with permissions mode, linking to target.

# File lib/rubygems/package/tar_writer.rb, line 238
def add_symlink(name, target, mode)
  check_closed

  name, prefix = split_name name

  header = Gem::Package::TarHeader.new(:name => name, :mode => mode,
                                       :size => 0, :typeflag => "2",
                                       :linkname => target,
                                       :prefix => prefix,
                                       :mtime => Time.now).to_s

  @io.write header

  self
end

check_closed() click to toggle source

Raises IOError if the TarWriter is closed

# File lib/rubygems/package/tar_writer.rb, line 257
def check_closed
  raise IOError, "closed #{self.class}" if closed?
end

close() click to toggle source

Closes the TarWriter

# File lib/rubygems/package/tar_writer.rb, line 264
def close
  check_closed

  @io.write "\0" * 1024
  flush

  @closed = true
end

closed?() click to toggle source

Is the TarWriter closed?

# File lib/rubygems/package/tar_writer.rb, line 276
def closed?
  @closed
end

flush() click to toggle source

Flushes the TarWriter's IO

# File lib/rubygems/package/tar_writer.rb, line 283
def flush
  check_closed

  @io.flush if @io.respond_to? :flush
end

mkdir(name, mode) click to toggle source

Creates a new directory in the tar file name with mode

# File lib/rubygems/package/tar_writer.rb, line 292
def mkdir(name, mode)
  check_closed

  name, prefix = split_name(name)

  header = Gem::Package::TarHeader.new :name => name, :mode => mode,
                                       :typeflag => "5", :size => 0,
                                       :prefix => prefix,
                                       :mtime => Time.now

  @io.write header

  self
end