module ActionView #:nodoc: class Template class Path attr_reader :path, :paths delegate :hash, :inspect, :to => :path def initialize(path) raise ArgumentError, "path already is a Path class" if path.is_a?(Path) @path = path.freeze end def load! @paths = {} templates_in_path do |template| load_template(template) end end def to_s if defined?(RAILS_ROOT) path.to_s.sub(/^#{Regexp.escape(File.expand_path(RAILS_ROOT))}\//, '') else path.to_s end end def to_str path.to_str end def ==(path) to_str == path.to_str end def eql?(path) to_str == path.to_str end # Returns a ActionView::Template object for the given path string. The # input path should be relative to the view path directory, # +hello/index.html.erb+. This method also has a special exception to # match partial file names without a handler extension. So # +hello/index.html+ will match the first template it finds with a # known template extension, +hello/index.html.erb+. Template extensions # should not be confused with format extensions +html+, +js+, +xml+, # etc. A format must be supplied to match a formated file. +hello/index+ # will never match +hello/index.html.erb+. def [](path) load! if @paths.nil? @paths[path] || find_template(path) end private def templates_in_path (Dir.glob("#{@path}/**/*/**") | Dir.glob("#{@path}/**")).each do |file| yield create_template(file) unless File.directory?(file) end end def create_template(file) Template.new(file.split("#{self}/").last, self) end def load_template(template) template.load! template.accessible_paths.each do |path| @paths[path] = template end end def matching_templates(template_path) Dir.glob("#{@path}/#{template_path}.*").each do |file| yield create_template(file) unless File.directory?(file) end end def find_template(path) return nil if Base.cache_template_loading || ActionController::Base.allow_concurrency matching_templates(path) do |template| if template.accessible_paths.include?(path) load_template(template) return template end end nil end end extend TemplateHandlers extend ActiveSupport::Memoizable include Renderable # Templates that are exempt from layouts @@exempt_from_layout = Set.new([/\.rjs$/]) # Don't render layouts for templates with the given extensions. def self.exempt_from_layout(*extensions) regexps = extensions.collect do |extension| extension.is_a?(Regexp) ? extension : /\.#{Regexp.escape(extension.to_s)}$/ end @@exempt_from_layout.merge(regexps) end attr_accessor :filename, :load_path, :base_path attr_accessor :locale, :name, :format, :extension delegate :to_s, :to => :path def initialize(template_path, load_path) template_path = template_path.dup @load_path, @filename = load_path, File.join(load_path, template_path) @base_path, @name, @locale, @format, @extension = split(template_path) @base_path.to_s.gsub!(/\/$/, '') # Push to split method # Extend with partial super powers extend RenderablePartial if @name =~ /^_/ end def accessible_paths paths = [] paths << path paths << path_without_extension if multipart? formats = format.split(".") paths << "#{path_without_format_and_extension}.#{formats.first}" paths << "#{path_without_format_and_extension}.#{formats.second}" end paths end def format_and_extension (extensions = [format, extension].compact.join(".")).blank? ? nil : extensions end memoize :format_and_extension def multipart? format && format.include?('.') end def content_type format.gsub('.', '/') end def mime_type Mime::Type.lookup_by_extension(format) if format && defined?(::Mime) end memoize :mime_type def path [base_path, [name, locale, format, extension].compact.join('.')].compact.join('/') end memoize :path def path_without_extension [base_path, [name, locale, format].compact.join('.')].compact.join('/') end memoize :path_without_extension def path_without_format_and_extension [base_path, [name, locale].compact.join('.')].compact.join('/') end memoize :path_without_format_and_extension def relative_path path = File.expand_path(filename) path.sub!(/^#{Regexp.escape(File.expand_path(RAILS_ROOT))}\//, '') if defined?(RAILS_ROOT) path end memoize :relative_path def exempt_from_layout? @@exempt_from_layout.any? { |exempted| path =~ exempted } end def mtime File.mtime(filename) end memoize :mtime def source File.read(filename) end def method_segment relative_path.to_s.gsub(/([^a-zA-Z0-9_])/) { $1.ord } end memoize :method_segment def render_template(view, local_assigns = {}) render(view, local_assigns) rescue Exception => e raise e unless filename if TemplateError === e e.sub_template_of(self) raise e elsif Errno::ENOENT === e raise MissingTemplate.new(view.view_paths, filename.sub("#{RAILS_ROOT}/#{load_path}/", "")) else raise TemplateError.new(self, view.assigns, e) end end def stale? reloadable? && (mtime < mtime(:reload)) end def load! reloadable? ? memoize_all : freeze end def reloadable? !(Base.cache_template_loading || ActionController::Base.allow_concurrency) end def cached? ActionController::Base.perform_caching || !reloadable? end private def valid_extension?(extension) !Template.registered_template_handler(extension).nil? end def valid_locale?(locale) I18n.available_locales.include?(locale.to_sym) end # Returns file split into an array # [base_path, name, locale, format, extension] def split(file) if m = file.match(/^(.*\/)?([^\.]+)\.(.*)$/) base_path = m[1] name = m[2] extensions = m[3] else return end locale = nil format = nil extension = nil if m = extensions.split(".") if valid_locale?(m[0]) && m[1] && valid_extension?(m[2]) # All three locale = m[0] format = m[1] extension = m[2] elsif m[0] && m[1] && valid_extension?(m[2]) # Multipart formats format = "#{m[0]}.#{m[1]}" extension = m[2] elsif valid_locale?(m[0]) && valid_extension?(m[1]) # locale and extension locale = m[0] extension = m[1] elsif valid_extension?(m[1]) # format and extension format = m[0] extension = m[1] elsif valid_extension?(m[0]) # Just extension extension = m[0] else # No extension format = m[0] end end [base_path, name, locale, format, extension] end end end