123456789_123456789_123456789_123456789_123456789_

Class: Gem::Package::TarReader::Entry

Relationships & Source Files
Inherits: Object
Defined in: lib/rubygems/package/tar_reader/entry.rb

Overview

Class for reading entries out of a tar file

Class Method Summary

Instance Attribute Summary

Instance Method Summary

  • #bytes_read

    Number of bytes read out of the tar entry.

  • #close

    Closes the tar entry.

  • #full_name

    Full name of the tar entry.

  • #getc

    Read one byte from the tar entry.

  • #pos

    The position in the tar entry.

  • #read(len = nil) (also: #readpartial)

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

  • #rewind

    Rewinds to the beginning of the tar file entry.

Constructor Details

.new(header, io) ⇒ Entry

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

[ GitHub ] 

  


# File 'lib/rubygems/package/tar_reader/entry.rb', line 21



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


  







Instance Attribute Details



  

    #closed?  ⇒ Boolean  (readonly)
  



  

    

Is the tar entry closed?


  





  


  [ GitHub ]


  

  


# File 'lib/rubygems/package/tar_reader/entry.rb', line 50



def closed?
  @closed
end


  








  

    #directory?  ⇒ Boolean  (readonly)
  



  

    

Is this tar entry a directory?


  





  


  [ GitHub ]


  

  


# File 'lib/rubygems/package/tar_reader/entry.rb', line 95



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


  








  

    #eof?  ⇒ Boolean  (readonly)
  



  

    

Are we at the end of the tar entry?


  





  


  [ GitHub ]


  

  


# File 'lib/rubygems/package/tar_reader/entry.rb', line 57



def eof?
  check_closed

  @read >= @header.size
end


  








  

    #file?  ⇒ Boolean  (readonly)
  



  

    

Is this tar entry a file?


  





  


  [ GitHub ]


  

  


# File 'lib/rubygems/package/tar_reader/entry.rb', line 102



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


  








  

    #header   (readonly)
  



  

    

Header for this tar entry


  



  [ GitHub ]


  

  


# File 'lib/rubygems/package/tar_reader/entry.rb', line 16



attr_reader :header


  








  

    #symlink?  ⇒ Boolean  (readonly)
  



  

    

Is this tar entry a symlink?


  





  


  [ GitHub ]


  

  


# File 'lib/rubygems/package/tar_reader/entry.rb', line 109



def symlink?
  @header.typeflag == "2"
end


  







Instance Method Details



  

    #bytes_read  
  



  

    

Number of bytes read out of the tar entry


  



  [ GitHub ]


  

  


# File 'lib/rubygems/package/tar_reader/entry.rb', line 36



def bytes_read
  @read
end


  








  

    #close  
  



  

    

Closes the tar entry


  



  [ GitHub ]


  

  


# File 'lib/rubygems/package/tar_reader/entry.rb', line 43



def close
  @closed = true
end


  








  

    #full_name  
  



  

    

Full name of the tar entry


  



  [ GitHub ]


  

  


# File 'lib/rubygems/package/tar_reader/entry.rb', line 66



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


  



  [ GitHub ]


  

  


# File 'lib/rubygems/package/tar_reader/entry.rb', line 81



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


  



  [ GitHub ]


  

  


# File 'lib/rubygems/package/tar_reader/entry.rb', line 116



def pos
  check_closed

  bytes_read
end


  








  

    #read(len = nil)  
    Also known as: #readpartial
  



  

    

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


  



  [ GitHub ]


  

  


# File 'lib/rubygems/package/tar_reader/entry.rb', line 126



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


  





  
Raises:





  [ GitHub ]


  

  


# File 'lib/rubygems/package/tar_reader/entry.rb', line 145



def rewind
  check_closed

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

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