Class: Archive::Tar::Minitar::Reader
- Inherits:
-
Object
- Object
- Archive::Tar::Minitar::Reader
- Defined in:
- lib/minitar/reader.rb
Overview
The class that reads a tar format archive from a data stream. The data stream may be sequential or random access, but certain features only work with random access data streams.
Defined Under Namespace
Modules: InvalidEntryStream Classes: EntryStream
Class Method Summary collapse
-
.open(anIO) ⇒ Object
With no associated block,
Reader::open
is a synonym forReader::new
.
Instance Method Summary collapse
- #close ⇒ Object
-
#each(&block) ⇒ Object
Iterates through each entry in the data stream.
-
#each_entry ⇒ Object
Iterates through each entry in the data stream.
-
#initialize(anIO) ⇒ Reader
constructor
Creates and returns a new Reader object.
-
#rewind ⇒ Object
Resets the read pointer to the beginning of data stream.
Constructor Details
#initialize(anIO) ⇒ Reader
Creates and returns a new Reader object.
138 139 140 141 |
# File 'lib/minitar/reader.rb', line 138 def initialize(anIO) @io = anIO @init_pos = anIO.pos end |
Class Method Details
.open(anIO) ⇒ Object
With no associated block, Reader::open
is a synonym for Reader::new
. If the optional code block is given, it will be passed the new writer as an argument and the Reader object will automatically be closed when the block terminates. In this instance, Reader::open
returns the value of the block.
123 124 125 126 127 128 129 130 131 132 133 134 135 |
# File 'lib/minitar/reader.rb', line 123 def self.open(anIO) reader = Reader.new(anIO) return reader unless block_given? begin res = yield reader ensure reader.close end res end |
Instance Method Details
#close ⇒ Object
193 194 |
# File 'lib/minitar/reader.rb', line 193 def close end |
#each(&block) ⇒ Object
Iterates through each entry in the data stream.
144 145 146 |
# File 'lib/minitar/reader.rb', line 144 def each(&block) each_entry(&block) end |
#each_entry ⇒ Object
Iterates through each entry in the data stream.
162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 |
# File 'lib/minitar/reader.rb', line 162 def each_entry loop do return if @io.eof? header = Archive::Tar::PosixHeader.new_from_stream(@io) return if header.empty? entry = EntryStream.new(header, @io) size = entry.size yield entry skip = (512 - (size % 512)) % 512 if @io.respond_to?(:seek) # avoid reading... @io.seek(size - entry.bytes_read, IO::SEEK_CUR) else pending = size - entry.bytes_read while pending > 0 bread = @io.read([pending, 4096].min).size raise UnexpectedEOF if @io.eof? pending -= bread end end @io.read(skip) # discard trailing zeros # make sure nobody can use #read, #getc or #rewind anymore entry.close end end |
#rewind ⇒ Object
Resets the read pointer to the beginning of data stream. Do not call this during a #each or #each_entry iteration. This only works with random access data streams that respond to #rewind and #pos.
151 152 153 154 155 156 157 158 159 |
# File 'lib/minitar/reader.rb', line 151 def rewind if @init_pos == 0 raise NonSeekableStream unless @io.respond_to?(:rewind) @io.rewind else raise NonSeekableStream unless @io.respond_to?(:pos=) @io.pos = @init_pos end end |