Class
for reading entries out of a tar file
Attributes
Read
Header for this tar entry
Class Methods
lib/rubygems/package/tar_reader/entry.rb
View on GitHub
# File tmp/rubies/ruby-3.1.3/lib/rubygems/package/tar_reader/entry.rb, line 19
def initialize(header, io)
@closed = false
@header = header
@io = io
@orig_pos = @io.pos
@read = 0
end
Creates a new tar entry for header
that will be read from io
Instance Methods
lib/rubygems/package/tar_reader/entry.rb
View on GitHub
# File tmp/rubies/ruby-3.1.3/lib/rubygems/package/tar_reader/entry.rb, line 34
def bytes_read
@read
end
Number of bytes read out of the tar entry
#
lib/rubygems/package/tar_reader/entry.rb
View on GitHub
# File tmp/rubies/ruby-3.1.3/lib/rubygems/package/tar_reader/entry.rb, line 41
def close
@closed = true
end
Closes the tar entry
#
lib/rubygems/package/tar_reader/entry.rb
View on GitHub
# File tmp/rubies/ruby-3.1.3/lib/rubygems/package/tar_reader/entry.rb, line 48
def closed?
@closed
end
Is the tar entry closed?
lib/rubygems/package/tar_reader/entry.rb
View on GitHub
# File tmp/rubies/ruby-3.1.3/lib/rubygems/package/tar_reader/entry.rb, line 93
def directory?
@header.typeflag == "5"
end
Is this tar entry a directory?
#
lib/rubygems/package/tar_reader/entry.rb
View on GitHub
# File tmp/rubies/ruby-3.1.3/lib/rubygems/package/tar_reader/entry.rb, line 55
def eof?
check_closed
@read >= @header.size
end
Are we at the end of the tar entry?
#
lib/rubygems/package/tar_reader/entry.rb
View on GitHub
# File tmp/rubies/ruby-3.1.3/lib/rubygems/package/tar_reader/entry.rb, line 100
def file?
@header.typeflag == "0"
end
Is this tar entry a file?
lib/rubygems/package/tar_reader/entry.rb
View on GitHub
# File tmp/rubies/ruby-3.1.3/lib/rubygems/package/tar_reader/entry.rb, line 64
def full_name
if @header.prefix != ""
File.join @header.prefix, @header.name
else
@header.name
end
rescue ArgumentError => e
raise unless e.message == "string contains null byte"
raise Gem::Package::TarInvalidError,
"tar is corrupt, name contains null byte"
end
Full name of the tar entry
#
lib/rubygems/package/tar_reader/entry.rb
View on GitHub
# File tmp/rubies/ruby-3.1.3/lib/rubygems/package/tar_reader/entry.rb, line 79
def getc
check_closed
return nil if @read >= @header.size
ret = @io.getc
@read += 1 if ret
ret
end
Read one byte from the tar entry
#
lib/rubygems/package/tar_reader/entry.rb
View on GitHub
# File tmp/rubies/ruby-3.1.3/lib/rubygems/package/tar_reader/entry.rb, line 114
def pos
check_closed
bytes_read
end
The position in the tar entry
lib/rubygems/package/tar_reader/entry.rb
View on GitHub
# File tmp/rubies/ruby-3.1.3/lib/rubygems/package/tar_reader/entry.rb, line 130
def read(len = nil)
check_closed
return nil if @read >= @header.size
len ||= @header.size - @read
max_read = [len, @header.size - @read].min
ret = @io.read max_read
@read += ret.size
ret
end
Reads len
bytes from the tar file entry, or the rest of the entry if nil
lib/rubygems/package/tar_reader/entry.rb
View on GitHub
# File tmp/rubies/ruby-3.1.3/lib/rubygems/package/tar_reader/entry.rb, line 144
def readpartial(maxlen = nil, outbuf = "".b)
check_closed
raise EOFError if @read >= @header.size
maxlen ||= @header.size - @read
max_read = [maxlen, @header.size - @read].min
@io.readpartial(max_read, outbuf)
@read += outbuf.size
outbuf
end
No documentation available
#
lib/rubygems/package/tar_reader/entry.rb
View on GitHub
# File tmp/rubies/ruby-3.1.3/lib/rubygems/package/tar_reader/entry.rb, line 161
def rewind
check_closed
@io.pos = @orig_pos
@read = 0
end
Rewinds to the beginning of the tar file entry
#
lib/rubygems/package/tar_reader/entry.rb
View on GitHub
# File tmp/rubies/ruby-3.1.3/lib/rubygems/package/tar_reader/entry.rb, line 120
def size
@header.size
end
No documentation available
#
lib/rubygems/package/tar_reader/entry.rb
View on GitHub
# File tmp/rubies/ruby-3.1.3/lib/rubygems/package/tar_reader/entry.rb, line 107
def symlink?
@header.typeflag == "2"
end
Is this tar entry a symlink?