Parent

Methods

Class/Module Index [+]

Quicksearch

Webgen::Path::SourceIO

Helper class for easy access to the content of a path.

This class is used sothat the creation of the real IO object for stream can be delayed till it is actually needed. This is done by not directly requiring the user of this class to supply the IO object, but by requiring a block that creates the real IO object.

Public Class Methods

new(&block) click to toggle source

Create a new SourceIO object. A block has to be specified that returns the to-be-wrapped IO object.

# File lib/webgen/path.rb, line 45
def initialize(&block)
  @block = block
  raise ArgumentError, 'You need to provide a block which returns an IO object' if @block.nil?
end

Public Instance Methods

data(mode = 'r') click to toggle source

Return the whole content of the wrapped IO object as string. For a description of the parameter mode see stream.

# File lib/webgen/path.rb, line 65
def data(mode = 'r')
  stream(mode) {|io| io.read}
end
stream(mode = 'r') click to toggle source

Provide direct access to the wrapped IO object by yielding it. After the method block returns the IO object is automatically closed.

The parameter mode specifies the mode in which the wrapped IO object should be opened. This can be used, for example, to open a file in binary mode (or specify a certain input encoding under Ruby 1.9).

# File lib/webgen/path.rb, line 56
def stream(mode = 'r')
  io = @block.call(mode)
  yield(io)
ensure
  io.close
end

[Validate]

Generated with the Darkfish Rdoc Generator 2.