Allows writing of tar files
# File tmp/rubies/ruby-2.5.9/lib/rubygems/package/tar_writer.rb, line 79
def self.new(io)
writer = super
return writer unless block_given?
begin
yield writer
ensure
writer.close
end
nil
end
Creates a new TarWriter
, yielding it if a block is given
# File tmp/rubies/ruby-2.5.9/lib/rubygems/package/tar_writer.rb, line 105
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
Adds file name
with permissions mode
, and yields an IO
for writing the file to
# File tmp/rubies/ruby-2.5.9/lib/rubygems/package/tar_writer.rb, line 143
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
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 tmp/rubies/ruby-2.5.9/lib/rubygems/package/tar_writer.rb, line 176
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
raise "no #{signer.digest_name} in #{digests.values.compact}" unless signature_digest
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
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 tmp/rubies/ruby-2.5.9/lib/rubygems/package/tar_writer.rb, line 215
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 file name
with permissions mode
size
bytes long. Yields an IO
to write the file to.
# File tmp/rubies/ruby-2.5.9/lib/rubygems/package/tar_writer.rb, line 241
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
Adds symlink name
with permissions mode
, linking to target
.
# File tmp/rubies/ruby-2.5.9/lib/rubygems/package/tar_writer.rb, line 260
def check_closed
raise IOError, "closed #{self.class}" if closed?
end
# File tmp/rubies/ruby-2.5.9/lib/rubygems/package/tar_writer.rb, line 267
def close
check_closed
@io.write "\0" * 1024
flush
@closed = true
end
Closes the TarWriter
# File tmp/rubies/ruby-2.5.9/lib/rubygems/package/tar_writer.rb, line 279
def closed?
@closed
end
Is the TarWriter
closed?
# File tmp/rubies/ruby-2.5.9/lib/rubygems/package/tar_writer.rb, line 286
def flush
check_closed
@io.flush if @io.respond_to? :flush
end
Flushes the TarWriter’s IO
# File tmp/rubies/ruby-2.5.9/lib/rubygems/package/tar_writer.rb, line 295
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
Creates a new directory in the tar file name
with mode