blob: 25f9b2f9450a95150ae225a77ee08605b21ca84f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
# frozen_string_literal: true
# rubocop:disable Style/AsciiComments
# Copyright (C) 2004 Mauricio Julio Fernández Pradier
# See LICENSE.txt for additional licensing information.
# rubocop:enable Style/AsciiComments
##
# TarReader reads tar files and allows iteration over their items
class Gem::Package::TarReader
include Enumerable
##
# Creates a new TarReader on +io+ and yields it to the block, if given.
def self.new(io)
reader = super
return reader unless block_given?
begin
yield reader
ensure
reader.close
end
nil
end
##
# Creates a new tar file reader on +io+ which needs to respond to #pos,
# #eof?, #read, #getc and #pos=
def initialize(io)
@io = io
@init_pos = io.pos
end
##
# Close the tar file
def close
end
##
# Iterates over files in the tarball yielding each entry
def each
return enum_for __method__ unless block_given?
until @io.eof? do
begin
header = Gem::Package::TarHeader.from @io
rescue ArgumentError => e
# Specialize only exceptions from Gem::Package::TarHeader.strict_oct
raise e unless e.message.match?(/ is not an octal string$/)
raise Gem::Package::TarInvalidError, e.message
end
return if header.empty?
entry = Gem::Package::TarReader::Entry.new header, @io
yield entry
entry.close
end
end
alias_method :each_entry, :each
##
# NOTE: Do not call #rewind during #each
def rewind
if @init_pos == 0
@io.rewind
else
@io.pos = @init_pos
end
end
##
# Seeks through the tar file until it finds the +entry+ with +name+ and
# yields it. Rewinds the tar file to the beginning when the block
# terminates.
def seek(name) # :yields: entry
found = find do |entry|
entry.full_name == name
end
return unless found
yield found
ensure
rewind
end
end
require_relative "tar_reader/entry"
|
