Class: Rack::RewindableInput

Inherits:
Object
  • Object
show all
Defined in:
lib/rack/rewindable_input.rb

Overview

Class which can make any IO object rewindable, including non-rewindable ones. It does this by buffering the data into a tempfile, which is rewindable.

Don’t forget to call #close when you’re done. This frees up temporary resources that RewindableInput uses, though it does not close the original IO object.

Defined Under Namespace

Classes: Middleware

Instance Method Summary collapse

Constructor Details

#initialize(io) ⇒ RewindableInput

Returns a new instance of RewindableInput.



29
30
31
32
33
 
# File 'lib/rack/rewindable_input.rb', line 29

def initialize(io)
  @io = io
  @rewindable_io = nil
  @unlinked = false
end

Instance Method Details

#close ⇒ Object

Closes this RewindableInput object without closing the originally wrapped IO object. Cleans up any temporary resources that this RewindableInput has created.

This method may be called multiple times. It does nothing on subsequent calls.



65
66
67
68
69
70
71
72
73
74
 
# File 'lib/rack/rewindable_input.rb', line 65

def close
  if @rewindable_io
    if @unlinked
      @rewindable_io.close
    else
      @rewindable_io.close!
    end
    @rewindable_io = nil
  end
end

#each(&block) ⇒ Object 



45
46
47
48
 
# File 'lib/rack/rewindable_input.rb', line 45

def each(&block)
  make_rewindable unless @rewindable_io
  @rewindable_io.each(&block)
end

#gets ⇒ Object 



35
36
37
38
 
# File 'lib/rack/rewindable_input.rb', line 35

def gets
  make_rewindable unless @rewindable_io
  @rewindable_io.gets
end

#read(*args) ⇒ Object 



40
41
42
43
 
# File 'lib/rack/rewindable_input.rb', line 40

def read(*args)
  make_rewindable unless @rewindable_io
  @rewindable_io.read(*args)
end

#rewind ⇒ Object 



50
51
52
53
 
# File 'lib/rack/rewindable_input.rb', line 50

def rewind
  make_rewindable unless @rewindable_io
  @rewindable_io.rewind
end

#size ⇒ Object 



55
56
57
58
 
# File 'lib/rack/rewindable_input.rb', line 55

def size
  make_rewindable unless @rewindable_io
  @rewindable_io.size
end