class Gem::Package::TarWriter
允许写入 tar 文件
Public Class Methods
Source
# File lib/rubygems/package/tar_writer.rb, line 75 def self.new(io) writer = super return writer unless block_given? begin yield writer ensure writer.close end nil end
创建一个新的 TarWriter,如果提供了块,则会对其进行屈服
调用超类方法
BasicObject::newPublic Instance Methods
Source
# File lib/rubygems/package/tar_writer.rb, line 102 def add_file(name, mode, mtime = nil) # :yields: io check_closed name, prefix = split_name name init_pos = @io.pos @io.write Gem::Package::TarHeader::EMPTY_HEADER # 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: mtime || Gem.source_date_epoch @io.write header @io.pos = final_pos self end
添加文件 name,具有权限 mode 和 mtime mtime(如果未指定,则设置为 Gem.source_date_epoch),并屈服一个 IO 用于写入文件
Source
# File lib/rubygems/package/tar_writer.rb, line 138 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 digest.name else digest_algorithm.class.name[/::([^:]+)\z/, 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
将具有权限 mode 的 name 添加到 tar 中,屈服 io 以写入文件。digest_algorithm 被写入一个只读的 name.sum 文件,该文件位于给定文件内容之后,并包含由制表符分隔的摘要名称和十六进制摘要。
返回创建的摘要对象。
Source
# File lib/rubygems/package/tar_writer.rb, line 170 def add_file_signed(name, mode, signer) digest_algorithms = [ signer.digest_algorithm, Gem::Security.create_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 digest.name else digest.class.name[/::([^:]+)\z/, 1] end digest_name == signer.digest_name end raise "no #{signer.digest_name} in #{digests.values.compact}" unless signature_digest if signer.key signature = signer.sign signature_digest.digest add_file_simple "#{name}.sig", 0o444, signature.length do |io| io.write signature end end digests end
将具有权限 mode 的 name 添加到 tar 中,屈服 io 以写入文件。signer 用于根据 add_file_digest 添加摘要文件(使用其 digest_algorithm)以及 name.sig 中的加密签名。如果签名器没有密钥,则仅添加校验和文件。
返回摘要。
Source
# File lib/rubygems/package/tar_writer.rb, line 208 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: Gem.source_date_epoch).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
添加文件 name,具有权限 mode,长度为 size 字节。屈服一个 IO 来写入文件。
Source
# File lib/rubygems/package/tar_writer.rb, line 234 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: Gem.source_date_epoch).to_s @io.write header self end
添加符号链接 name,具有权限 mode,指向 target。
Source
# File lib/rubygems/package/tar_writer.rb, line 253 def check_closed raise IOError, "closed #{self.class}" if closed? end
Source
# File lib/rubygems/package/tar_writer.rb, line 260 def close check_closed @io.write "\0" * 1024 flush @closed = true end
关闭 TarWriter
Source
# File lib/rubygems/package/tar_writer.rb, line 279 def flush check_closed @io.flush if @io.respond_to? :flush end
刷新 TarWriter 的 IO
Source
# File lib/rubygems/package/tar_writer.rb, line 288 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: Gem.source_date_epoch @io.write header self end
在 tar 文件 name 中创建具有 mode 的新目录