File Manager

Editing File: /usr/share/rubygems/rubygems/package/tar_reader/entry.rb

# -*- coding: utf-8 -*-
#++
# Copyright (C) 2004 Mauricio Julio Fernández Pradier
# See LICENSE.txt for additional licensing information.
#--

##
# Class for reading entries out of a tar file

class Gem::Package::TarReader::Entry

##
  # Header for this tar entry

attr_reader :header

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

def initialize(header, io)
    @closed = false
    @header = header
    @io = io
    @orig_pos = @io.pos
    @read = 0
  end

def check_closed # :nodoc:
    raise IOError, "closed #{self.class}" if closed?
  end

##
  # Number of bytes read out of the tar entry

def bytes_read
    @read
  end

##
  # Closes the tar entry

def close
    @closed = true
  end

##
  # Is the tar entry closed?

def closed?
    @closed
  end

##
  # Are we at the end of the tar entry?

def eof?
    check_closed

@read >= @header.size
  end

##
  # Full name of the tar entry

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

##
  # Read one byte from the tar entry

def getc
    check_closed

return nil if @read >= @header.size

ret = @io.getc
    @read += 1 if ret

ret
  end

##
  # Is this tar entry a directory?

def directory?
    @header.typeflag == "5"
  end

##
  # Is this tar entry a file?

def file?
    @header.typeflag == "0"
  end

##
  # The position in the tar entry

def pos
    check_closed

bytes_read
  end

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

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

##
  # Rewinds to the beginning of the tar file entry

def rewind
    check_closed

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

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

end

Back to Directory File Manager