Class for reading entries out of a tar file

Methods
B
C
D
E
F
G
N
P
R
Attributes
[R] header

Header for this tar entry
Class Public methods
new(header, io)

Creates a new tar entry for header that will be read from io

Source: show | on GitHub 

# File 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
Instance Public methods
bytes_read()

Number of bytes read out of the tar entry

Source: show | on GitHub 

# File lib/rubygems/package/tar_reader/entry.rb, line 34
def bytes_read
  @read
end
close()

Closes the tar entry

Source: show | on GitHub 

# File lib/rubygems/package/tar_reader/entry.rb, line 41
def close
  @closed = true
end
closed?()

Is the tar entry closed?

Source: show | on GitHub 

# File lib/rubygems/package/tar_reader/entry.rb, line 48
def closed?
  @closed
end
directory?()

Is this tar entry a directory?

Source: show | on GitHub 

# File lib/rubygems/package/tar_reader/entry.rb, line 93
def directory?
  @header.typeflag == "5"
end
eof?()

Are we at the end of the tar entry?

Source: show | on GitHub 

# File lib/rubygems/package/tar_reader/entry.rb, line 55
def eof?
  check_closed

  @read >= @header.size
end
file?()

Is this tar entry a file?

Source: show | on GitHub 

# File lib/rubygems/package/tar_reader/entry.rb, line 100
def file?
  @header.typeflag == "0"
end
full_name()

Full name of the tar entry

Source: show | on GitHub 

# File lib/rubygems/package/tar_reader/entry.rb, line 64
def full_name
  if @header.prefix != "" then
    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
getc()

Read one byte from the tar entry

Source: show | on GitHub 

# File 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
pos()

The position in the tar entry

Source: show | on GitHub 

# File lib/rubygems/package/tar_reader/entry.rb, line 107
def pos
  check_closed

  bytes_read
end
read(len = nil)

Reads len bytes from the tar file entry, or the rest of the entry if nil

Source: show | on GitHub 

# File lib/rubygems/package/tar_reader/entry.rb, line 117
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
rewind()

Rewinds to the beginning of the tar file entry

Source: show | on GitHub 

# File lib/rubygems/package/tar_reader/entry.rb, line 134
def rewind
  check_closed

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

  @io.pos = @orig_pos
  @read = 0
end