Sha256: f2430223297936ef89b81dde67ae9cd89b901561765425d9862a1b22186b88d7
Contents?: true
Size: 1.76 KB
Versions: 12
Compression:
Stored size: 1.76 KB
Contents
module Webgen::Source
# This source class is used to stack several sources together.
#
# It serves two purposes:
#
# * First, it can be used to access more than one source. This is useful when your website
# consists of more than one source directory and you want to use all of them.
#
# * Second, sources can mounted on specific directories. For example, a folder with images that
# you don't want to copy to the website source directory can be mounted under <tt>/images</tt>
# sothat they are available nonetheless.
#
# Also be aware that when a path is returned by a source that has already be returned by a prior
# source, it is discarded and not used.
class Stacked
# Return the stack of Webgen::Source objects.
attr_reader :stack
# Create a new stack. The optional +map+ parameter can be used to provide initial mappings of
# mount points to source objects (see #add for details).
def initialize(map = {})
@stack = []
add(map)
end
# Add all mappings found in +maps+ to the stack. The parameter +maps+ should be an array of
# two-element arrays which contain an absolute directoriy (ie. starting with a slash) and a
# source object.
def add(maps)
maps.each do |mp, source|
raise "Invalid mount point specified: #{mp}" unless mp =~ /^\//
@stack << [mp, source]
end
end
# Return all paths returned by the sources in the stack. Since the stack is ordered, paths
# returned by later source objects are not used if a prior source object has returned the same
# path.
def paths
@paths = Set.new
@stack.each do |mp, source|
source.paths.each do |path|
@paths.add?(path.mount_at(mp))
end
end
@paths
end
end
end
Version data entries
12 entries across 12 versions & 2 rubygems