class Tar::Minitar::Reader::EntryStream

EntryStreams are pseudo-streams on top of the main data stream.

Public Class Methods

new(header, io) click to toggle source
# File lib/archive/tar/minitar/reader.rb, line 32
def initialize(header, io)
  @io       = io
  @name     = header.name
  @mode     = header.mode
  @uid      = header.uid
  @gid      = header.gid
  @size     = header.size
  @mtime    = header.mtime
  @checksum = header.checksum
  @typeflag = header.typeflag
  @linkname = header.linkname
  @magic    = header.magic
  @version  = header.version
  @uname    = header.uname
  @gname    = header.gname
  @devmajor = header.devmajor
  @devminor = header.devminor
  @prefix   = header.prefix
  @read     = 0
  @orig_pos =
    if Archive::Tar::Minitar.seekable?(@io)
      @io.pos
    else
      0
    end
end

Public Instance Methods

bytes_read() click to toggle source
# File lib/archive/tar/minitar/reader.rb, line 122
def bytes_read
  @read
end
close() click to toggle source

Closes the entry.

# File lib/archive/tar/minitar/reader.rb, line 141
def close
  invalidate
end
closed?() click to toggle source

Returns false if the entry stream is valid.

# File lib/archive/tar/minitar/reader.rb, line 136
def closed?
  false
end
directory()
Alias for: directory?
directory?() click to toggle source

Returns true if the entry represents a directory.

# File lib/archive/tar/minitar/reader.rb, line 80
def directory?
  case @typeflag
  when '5'
    true
  when '0', "\0"
    # If the name ends with a slash, treat it as a directory.
    # This is what other major tar implementations do for
    # interoperability and compatibility with older tar variants
    # and some new ones.
    @name.end_with?('/')
  else
    false
  end
end
Also aliased as: directory
eof?() click to toggle source

Returns true if the current read pointer is at the end of the EntryStream data.

# File lib/archive/tar/minitar/reader.rb, line 104
def eof?
  @read >= @size
end
file()
Alias for: file?
file?() click to toggle source

Returns true if the entry represents a plain file.

# File lib/archive/tar/minitar/reader.rb, line 97
def file?
  (@typeflag == '0' || @typeflag == "\0") && !@name.end_with?('/')
end
Also aliased as: file
full_name() click to toggle source

Returns the full and proper name of the entry.

# File lib/archive/tar/minitar/reader.rb, line 127
def full_name
  if @prefix != ''
    File.join(@prefix, @name)
  else
    @name
  end
end
getc() click to toggle source

Reads one byte from the entry. Returns nil if there is no more data to read.

# File lib/archive/tar/minitar/reader.rb, line 72
def getc
  return nil if @read >= @size
  ret = @io.getc
  @read += 1 if ret
  ret
end
pos() click to toggle source

Returns the current read pointer in the EntryStream.

# File lib/archive/tar/minitar/reader.rb, line 109
def pos
  @read
end
read(len = nil) click to toggle source

Reads len bytes (or all remaining data) from the entry. Returns nil if there is no more data to read.

# File lib/archive/tar/minitar/reader.rb, line 61
def read(len = nil)
  return nil if @read >= @size
  len ||= @size - @read
  max_read = [len, @size - @read].min
  ret = @io.read(max_read)
  @read += bytesize(ret)
  ret
end
rewind() click to toggle source

Sets the current read pointer to the beginning of the EntryStream.

# File lib/archive/tar/minitar/reader.rb, line 114
def rewind
  unless Archive::Tar::Minitar.seekable?(@io, :pos=)
    raise Archive::Tar::Minitar::NonSeekableStream
  end
  @io.pos = @orig_pos
  @read = 0
end

Private Instance Methods

invalidate() click to toggle source
# File lib/archive/tar/minitar/reader.rb, line 147
def invalidate
  extend InvalidEntryStream
end