Contents

module Innate

  # This is a container module for wrappers of templating engines and handles
  # lazy requiring of needed engines.

  module View
    ENGINE, TEMP = {}, {}

    module_function

    # Try to obtain given engine by its registered name.

    def get(engine_or_ext)
      return unless engine_or_ext
      eoe = engine_or_ext.to_s

      if klass = TEMP[eoe]
        return klass
      elsif klass = ENGINE[eoe]
        TEMP[eoe] = obtain(klass)
      else
        TEMP[eoe] = const_get(eoe.capitalize)
      end
    end

    # We need to put this in a Mutex because simultanous calls for the same
    # class will cause race conditions and one call may return the wrong class
    # on the first request (before TEMP is set).
    # No mutex is used in Fiber environment, see Innate::State and subclasses.

    def obtain(klass)
      STATE.sync do
        obj = Object
        klass.split('::').each{|e| obj = obj.const_get(e) }
        obj
      end
    end

    # Register given templating engine wrapper and extensions for later usage.
    #
    # +name+ : the class name of the templating engine wrapper
    # +exts+ : any number of arguments will be turned into strings via #to_s
    #          that indicate which filename-extensions the templates may have.

    def register(klass, *exts)
      exts.each do |ext|
        ext = ext.to_s
        if k = ENGINE[ext]
          Log.warn "#{ext} is assigned to #{k} already"
        else
          ENGINE[ext] = klass
        end
      end
    end

    # Combine Kernel#autoload and Innate::View::register

    def auto_register(name, *exts)
      autoload(name, "innate/view/#{name}".downcase)
      register("#{self}::#{name}", *exts)
    end

    auto_register :None, :css
    auto_register :None, :html, :htm
    auto_register :ERB,  :erb
  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
manveru-innate-2009.02.06	lib/innate/view.rb