merb_comatose 0.0.2

data/lib/liquid/context.rb

@@ -0,0 +1,190 @@
+module Liquid
+  
+  class ContextError < StandardError
+  end
+  
+  # Context keeps the variable stack and resolves variables, as well as keywords
+  #
+  #   context['variable'] = 'testing'
+  #   context['variable'] #=> 'testing'
+  #   context['true']     #=> true
+  #   context['10.2232']  #=> 10.2232
+  #   
+  #   context.stack do 
+  #      context['bob'] = 'bobsen'
+  #   end
+  #
+  #   context['bob']  #=> nil  class Context
+  class Context
+    attr_reader :assigns
+    attr_accessor :registers
+    
+    def initialize(assigns = {}, registers = nil)
+      @assigns = [assigns]
+      @registers = registers || {}
+    end
+           
+    def strainer
+      @strainer ||= Strainer.create(self)
+    end
+               
+    # adds filters to this context. 
+    # this does not register the filters with the main Template object. see <tt>Template.register_filter</tt> 
+    # for that
+    def add_filters(filter)
+      return unless filter.is_a?(Module)
+      strainer.extend(filter)
+    end
+                              
+    def invoke(method, *args)
+      if strainer.respond_to?(method)
+        strainer.__send__(method, *args)
+      else
+        return args[0]
+      end        
+    end
+
+    # push new local scope on the stack. use <tt>Context#stack</tt> instead
+    def push
+      @assigns.unshift({})
+    end
+    
+    # merge a hash of variables in the current local scope
+    def merge(new_assigns)
+      @assigns[0].merge!(new_assigns)
+    end
+  
+    # pop from the stack. use <tt>Context#stack</tt> instead
+    def pop
+      raise ContextError if @assigns.size == 1 
+      @assigns.shift
+    end
+    
+    # pushes a new local scope on the stack, pops it at the end of the block
+    #
+    # Example:
+    #
+    #   context.stack do 
+    #      context['var'] = 'hi'
+    #   end
+    #   context['var]  #=> nil
+    #
+    def stack(&block)
+      push
+      begin
+        result = yield
+      ensure 
+        pop
+      end
+      result      
+    end
+  
+    # Only allow String, Numeric, Hash, Array or <tt>Liquid::Drop</tt>
+    def []=(key, value)
+      @assigns[0][key] = value
+    end
+  
+    def [](key)
+      resolve(key)
+    end
+  
+    def has_key?(key)
+      resolve(key) != nil
+    end
+        
+    private
+    
+    # Look up variable, either resolve directly after considering the name. We can directly handle 
+    # Strings, digits, floats and booleans (true,false). If no match is made we lookup the variable in the current scope and 
+    # later move up to the parent blocks to see if we can resolve the variable somewhere up the tree.
+    # Some special keywords return symbols. Those symbols are to be called on the rhs object in expressions
+    #
+    # Example: 
+    #
+    #   products == empty #=> products.empty?
+    #
+    def resolve(key)    
+      case key
+      when nil
+        nil
+      when 'true'
+        true
+      when 'false'
+        false
+      when 'empty'
+        :empty?
+      when 'nil', 'null'
+        nil
+      # Single quoted strings
+      when /^'(.*)'$/
+        $1.to_s
+      # Double quoted strings
+      when /^"(.*)"$/
+        $1.to_s        
+      # Integer and floats
+      when /^(\d+)$/ 
+        $1.to_i
+      when /^(\d[\d\.]+)$/ 
+        $1.to_f
+      else
+        variable(key)
+      end
+    end
+    
+    # fetches an object starting at the local scope and then moving up 
+    # the hierachy 
+    def fetch(key)
+      begin
+        for scope in @assigns
+          if scope.has_key?(key)
+            obj = scope[key]
+            if obj.is_a?(Liquid::Drop)
+              obj.context = self 
+            end
+            return obj
+          end
+        end
+      rescue => e
+        raise ContextError, "Could not fetch key #{key} from context: " + e.message
+      end 
+      nil
+    end
+
+    # resolves namespaced queries gracefully.
+    # 
+    # Example
+    # 
+    #  @context['hash'] = {"name" => 'tobi'}
+    #  assert_equal 'tobi', @context['hash.name']
+    def variable(key)                  
+      parts = key.split(VariableAttributeSeparator)
+      
+      
+      if object = fetch(parts.shift).to_liquid
+        object.context = self if object.is_a?(Liquid::Drop)
+        
+        while not parts.size.zero?
+          next_part_name = parts.shift
+          
+          # If the last part of the context variable is .size we just 
+          # return the count of the objects in this object
+          if next_part_name == 'size' and parts.empty?
+            return object.size if object.is_a?(Array)
+            return object.size if object.is_a?(Hash) && !object.has_key?(next_part_name)
+          end
+          
+          return nil if not object.respond_to?(:has_key?)
+          return nil if not object.has_key?(next_part_name)
+          
+          object = object[next_part_name].to_liquid
+          object.context = self if object.is_a?(Liquid::Drop)
+        end
+
+        object
+      else
+        nil
+      end
+    end                                   
+    
+  end
+end

data/lib/liquid/document.rb

@@ -0,0 +1,17 @@
+module Liquid
+  class Document < Block                                                             
+    # we don't need markup to open this block
+    def initialize(tokens)
+      parse(tokens)
+    end                                                                        
+  
+    # There isn't a real delimter   
+    def block_delimiter
+      []
+    end
+  
+    # Document blocks don't need to be terminated since they are not actually opened
+    def assert_missing_delimitation!
+    end    
+  end
+end

data/lib/liquid/drop.rb

@@ -0,0 +1,48 @@
+module Liquid
+  
+  # A drop in liquid is a class which allows you to to export DOM like things to liquid
+  # Methods of drops are callable. 
+  # The main use for liquid drops is the implement lazy loaded objects. 
+  # If you would like to make data available to the web designers which you don't want loaded unless needed then 
+  # a drop is a great way to do that
+  #
+  # Example:
+  #
+  # class ProductDrop < Liquid::Drop
+  #   def top_sales
+  #      Shop.current.products.find(:all, :order => 'sales', :limit => 10 )
+  #   end
+  # end
+  #  
+  # tmpl = Liquid::Template.parse( ' {% for product in product.top_sales %} {{ product.name }} {%endfor%} '  )
+  # tmpl.render('product' => ProductDrop.new ) # will invoke top_sales query. 
+  #
+  # Your drop can either implement the methods sans any parameters or implement the before_method(name) method which is a 
+  # catch all
+  class Drop
+    attr_writer :context
+
+    # Catch all for the method 
+    def before_method(method)
+      nil
+    end
+    
+    # called by liquid to invoke a drop
+    def invoke_drop(method)      
+      result = before_method(method)
+      result ||= send(method.to_sym) if self.class.public_instance_methods.include?(method.to_s)
+      result
+    end
+    
+    def has_key?(name)
+      true
+    end
+    
+    def to_liquid
+      self
+    end
+
+    alias :[] :invoke_drop
+  end
+  
+end

data/lib/liquid/errors.rb

@@ -0,0 +1,7 @@
+module Liquid
+  class FilterNotFound < StandardError
+  end
+
+  class FileSystemError < StandardError
+  end
+end

data/lib/liquid/extensions.rb

@@ -0,0 +1,53 @@
+class String
+  def to_liquid
+    self
+  end
+end
+
+class Array 
+  def to_liquid
+    self
+  end
+end
+
+class Hash 
+  def to_liquid
+    self
+  end
+end
+
+class Numeric
+  def to_liquid
+    self
+  end
+end
+
+class Time
+  def to_liquid
+    self
+  end
+end
+
+class DateTime
+  def to_liquid
+    self
+  end
+end
+
+class Date
+  def to_liquid
+    self
+  end
+end
+
+def true.to_liquid
+  self
+end
+
+def false.to_liquid
+  self
+end
+
+def nil.to_liquid
+  self
+end

data/lib/liquid/file_system.rb

@@ -0,0 +1,62 @@
+module Liquid
+  # A Liquid file system is way to let your templates retrieve other templates for use with the include tag.
+  #
+  # You can implement subclasses that retrieve templates from the database, from the file system using a different 
+  # path structure, you can provide them as hard-coded inline strings, or any manner that you see fit.
+  #
+  # You can add additional instance variables, arguments, or methods as needed.
+  #
+  # Example:
+  #
+  # Liquid::Template.file_system = Liquid::LocalFileSystem.new(template_path)
+  # liquid = Liquid::Template.parse(template)
+  #
+  # This will parse the template with a LocalFileSystem implementation rooted at 'template_path'.
+  class BlankFileSystem
+    # Called by Liquid to retrieve a template file
+    def read_template_file(template_path)
+      raise FileSystemError, "This liquid context does not allow includes."
+    end
+  end
+  
+  # This implements an abstract file system which retrieves template files named in a manner similar to Rails partials,
+  # ie. with the template name prefixed with an underscore. The extension ".liquid" is also added.
+  #
+  # For security reasons, template paths are only allowed to contain letters, numbers, and underscore.
+  #
+  # Example:
+  #
+  # file_system = Liquid::LocalFileSystem.new("/some/path")
+  # 
+  # file_system.full_path("mypartial")       # => "/some/path/_mypartial.liquid"
+  # file_system.full_path("dir/mypartial")   # => "/some/path/dir/_mypartial.liquid"
+  #
+  class LocalFileSystem
+    attr_accessor :root
+    
+    def initialize(root)
+      @root = root
+    end
+    
+    def read_template_file(template_path)
+      full_path = full_path(template_path)
+      raise FileSystemError, "No such template '#{template_path}'" unless File.exists?(full_path)
+      
+      File.read(full_path)
+    end
+    
+    def full_path(template_path)
+      raise FileSystemError, "Illegal template name '#{template_path}'" unless template_path =~ /^[^.\/][a-zA-Z0-9_\/]+$/
+      
+      full_path = if template_path.include?('/')
+        File.join(root, File.dirname(template_path), "_#{File.basename(template_path)}.liquid")
+      else
+        File.join(root, "_#{template_path}.liquid")
+      end
+      
+      raise FileSystemError, "Illegal template path '#{File.expand_path(full_path)}'" unless File.expand_path(full_path) =~ /^#{File.expand_path(root)}/
+      
+      full_path
+    end
+  end
+end

data/lib/liquid/htmltags.rb

@@ -0,0 +1,64 @@
+module Liquid
+  class TableRow < Block                                             
+    Syntax = /(\w+)\s+in\s+(#{AllowedVariableCharacters}+)/   
+    
+    def initialize(markup, tokens)
+      super
+
+      if markup =~ Syntax
+        @variable_name = $1
+        @collection_name = $2
+        @attributes = {}
+        markup.scan(TagAttributes) do |key, value|
+          @attributes[key] = value
+        end
+      else
+        raise SyntaxError.new("Syntax Error in 'table_row loop' - Valid syntax: table_row [item] in [collection] cols=3")
+      end
+    end
+    
+    def render(context)        
+      collection = context[@collection_name] or return ''
+      
+      if @attributes['limit'] or @attributes['offset']
+        limit = context[@attributes['limit']] || -1
+        offset = context[@attributes['offset']] || 0
+        collection = collection[offset.to_i..(limit.to_i + offset.to_i - 1)]
+      end
+            
+      length = collection.length
+      
+      cols = context[@attributes['cols']].to_i
+
+      row = 1
+      col = 0
+
+      result = ["<tr class=\"row1\">\n"]
+      context.stack do 
+
+        collection.each_with_index do |item, index|
+          context[@variable_name] = item
+          context['tablerowloop'] = {
+            'length'  => length,
+            'index'   => index + 1, 
+            'index0'  => index, 
+            'rindex'  => length - index,
+            'rindex0' => length - index -1,
+            'first'   => (index == 0),
+            'last'    => (index == length - 1) }
+                                
+          result << ["<td class=\"col#{col += 1}\">"] + render_all(@nodelist, context) + ['</td>']
+
+          if col == cols and not (index == length - 1)            
+            col  = 0
+            result << ["</tr>\n<tr class=\"row#{row += 1}\">"] 
+          end
+          
+        end
+      end
+      result + ["</tr>\n"]
+    end    
+  end
+  
+  Template.register_tag('tablerow', TableRow)  
+end

data/lib/liquid/standardfilters.rb

@@ -0,0 +1,111 @@
+module Liquid
+  
+  module StandardFilters
+    
+    # Return the size of an array or of an string
+    def size(input)
+      
+      input.respond_to?(:size) ? input.size : 0
+    end         
+    
+    # convert a input string to DOWNCASE
+    def downcase(input)
+      input.downcase rescue input
+    end         
+
+    # convert a input string to UPCASE
+    def upcase(input)
+      input.upcase rescue input
+    end
+    
+    # Truncate a string down to x characters
+    def truncate(input, characters = 100)    
+      if input.to_s.size > characters.to_i
+        input.to_s[0..characters.to_i] + '…'
+      else
+        input
+      end
+    end  
+
+    # Truncate string down to x words
+    def truncatewords(input, words = 15)    
+      wordlist = [input.to_s.split].flatten
+      if wordlist.size > words.to_i
+        wordlist[0..words.to_i].join(' ') + '…'
+      else
+        input
+      end
+    end  
+    
+    def strip_html(input)
+      input.to_s.gsub(/<.*?>/, '')
+    end
+    
+    # Join elements of the array with certain character between them
+    def join(input, glue = ' ')
+      [input].flatten.join(glue)
+    end
+
+    # Sort elements of the array
+    def sort(input)
+      [input].flatten.sort
+    end
+    
+    # Reformat a date
+    #
+    #   %a - The abbreviated weekday name (``Sun'')
+    #   %A - The  full  weekday  name (``Sunday'')
+    #   %b - The abbreviated month name (``Jan'')
+    #   %B - The  full  month  name (``January'')
+    #   %c - The preferred local date and time representation
+    #   %d - Day of the month (01..31)
+    #   %H - Hour of the day, 24-hour clock (00..23)
+    #   %I - Hour of the day, 12-hour clock (01..12)
+    #   %j - Day of the year (001..366)
+    #   %m - Month of the year (01..12)
+    #   %M - Minute of the hour (00..59)
+    #   %p - Meridian indicator (``AM''  or  ``PM'')
+    #   %S - Second of the minute (00..60)
+    #   %U - Week  number  of the current year,
+    #           starting with the first Sunday as the first
+    #           day of the first week (00..53)
+    #   %W - Week  number  of the current year,
+    #           starting with the first Monday as the first
+    #           day of the first week (00..53)
+    #   %w - Day of the week (Sunday is 0, 0..6)
+    #   %x - Preferred representation for the date alone, no time
+    #   %X - Preferred representation for the time alone, no date
+    #   %y - Year without a century (00..99)
+    #   %Y - Year with century
+    #   %Z - Time zone name
+    #   %% - Literal ``%'' character
+    def date(input, format)
+      date = input
+      date = Time.parse(input) if input.is_a?(String)
+      date.strftime(format)      
+    rescue => e 
+      input
+    end
+    
+    # Get the first element of the passed in array 
+    # 
+    # Example:
+    #    {{ product.images | first | to_img }}
+    #  
+    def first(array)
+      array.first if array.respond_to?(:first)
+    end
+
+    # Get the last element of the passed in array 
+    # 
+    # Example:
+    #    {{ product.images | last | to_img }}
+    #  
+    def last(array)
+      array.last if array.respond_to?(:last)
+    end
+    
+  end
+   
+  Template.register_filter(StandardFilters)
+end