haml-edge 2.3.209 → 2.3.210

data/.yardopts

@@ -3,6 +3,8 @@
 --markup-provider maruku
 --default-return  ""
 --title           "Haml/Sass Documentation"
+--query           'object.type != :classvariable'
+--query           'object.type != :constant || @api && @api.text == "public"'
 --hide-void-return
 --protected
 --no-private

data/EDGE_GEM_VERSION

@@ -1 +1 @@
-2.3.209
+2.3.210

data/Rakefile

@@ -239,7 +239,7 @@ end
 begin
   require 'yard'
 
-  namespace :yard do
+  namespace :doc do
     task :sass do
       require scope('lib/sass')
       Dir[scope("yard/default/**/*.sass")].each do |sass|
@@ -248,12 +248,27 @@ begin
         end
       end
     end
+
+    desc "List all undocumented methods and classes."
+    task :undocumented do
+      opts = ENV["YARD_OPTS"] || ""
+      ENV["YARD_OPTS"] = opts.dup + <<OPTS
+ --list --query "
+  object.docstring.blank? &&
+  !(object.type == :method && object.is_alias?)"
+OPTS
+      Rake::Task['yard'].execute
+    end
   end
 
   YARD::Rake::YardocTask.new do |t|
     t.files = FileList.new(scope('lib/**/*.rb')) do |list|
       list.exclude('lib/haml/template/*.rb')
+      list.exclude('lib/haml/railtie.rb')
       list.exclude('lib/haml/helpers/action_view_mods.rb')
+      list.exclude('lib/haml/helpers/xss_mods.rb')
+      list.exclude('lib/sass/plugin/merb.rb')
+      list.exclude('lib/sass/plugin/rails.rb')
     end.to_a
     t.options << '--incremental' if Rake.application.top_level_tasks.include?('redoc')
     t.options += FileList.new(scope('yard/*.rb')).to_a.map {|f| ['-e', f]}.flatten
@@ -261,8 +276,15 @@ begin
     t.options << '--files' << files.join(',')
     t.options << '--template-path' << scope('yard')
     t.options << '--title' << ENV["YARD_TITLE"] if ENV["YARD_TITLE"]
+
+    t.before = lambda do
+      if ENV["YARD_OPTS"]
+        require 'shellwords'
+        t.options.concat(Shellwords.shellwords(ENV["YARD_OPTS"]))
+      end
+    end
   end
-  Rake::Task['yard'].prerequisites.insert(0, 'yard:sass')
+  Rake::Task['yard'].prerequisites.insert(0, 'doc:sass')
   Rake::Task['yard'].instance_variable_set('@comment', nil)
 
   desc "Generate Documentation"

data/VERSION

@@ -1 +1 @@
-2.3.209
+2.3.210

data/lib/haml/exec.rb

@@ -115,7 +115,6 @@ module Haml
         @options[:input], @options[:output] = input, output
       end
 
-      # @private
       COLORS = { :red => 31, :green => 32, :yellow => 33 }
 
       # Prints a status message about performing the given action,
@@ -298,7 +297,7 @@ END
           @options[:for_engine][:cache_location] = loc
         end
         opts.on('-C', '--no-cache', "Don't cache to sassc files.") do
-          @options[:for_engine][:cache] = false
+          @options[:for_engine][:read_cache] = false
         end
       end
 
@@ -569,8 +568,9 @@ END
       # @param args [Array<String>] The command-line arguments
       def initialize(args)
         super
+        require 'sass'
         @options[:for_tree] = {}
-        @options[:for_engine] = {}
+        @options[:for_engine] = {:cache => false, :read_cache => true}
       end
 
       # Tells optparse how to parse the arguments.
@@ -630,7 +630,7 @@ END
         end
 
         opts.on('-C', '--no-cache', "Don't cache to sassc files.") do
-          @options[:for_engine][:cache] = false
+          @options[:for_engine][:read_cache] = false
         end
 
         super
@@ -654,6 +654,8 @@ END
         process_file(input, output)
       end
 
+      private
+
       def process_directory
         input = @options[:input] = @args.shift
         output = @options[:output] = @args.shift
@@ -665,6 +667,11 @@ END
         end
         @options[:output] ||= @options[:input]
 
+        if @options[:to] == @options[:from] && !@options[:in_place]
+          fmt = @options[:from]
+          raise "Error: converting from #{fmt} to #{fmt} without --in-place"
+        end
+
         ext = @options[:from]
         ext = :sass if ext == :sass2
         Dir.glob("#{@options[:input]}/**/*.#{ext}") do |f|

data/lib/haml/filters.rb

@@ -325,6 +325,9 @@ END
         ::RedCloth.new(text).to_html(:textile)
       end
     end
+    # An alias for the Textile filter,
+    # since the only available Textile parser is RedCloth.
+    # @api public
     RedCloth = Textile
     Filters.defined['redcloth'] = RedCloth
 

data/lib/haml/helpers/action_view_extensions.rb

@@ -1,7 +1,7 @@
-require 'haml/helpers/action_view_mods'
-
 module Haml
   module Helpers
+    @@action_view_defined = true
+
     # This module contains various useful helper methods
     # that either tie into ActionView or the rest of the ActionPack stack,
     # or are only useful in that context.
@@ -51,5 +51,7 @@ module Haml
         @_haml_concat_raw = old
       end
     end
+
+    include ActionViewExtensions
   end
 end

data/lib/haml/helpers/action_view_mods.rb

@@ -126,7 +126,11 @@ module ActionView
       end
 
       def content_tag(*args)
-        content_tag_with_haml(*args)
+        html_tag = content_tag_with_haml(*args)
+        return html_tag unless respond_to?(:error_wrapping)
+        return error_wrapping(html_tag) if method(:error_wrapping).arity == 1
+        return html_tag unless object.respond_to?(:errors) && object.errors.respond_to?(:on)
+        return error_wrapping(html_tag, object.errors.on(@method_name))
       end
     end
 
@@ -156,9 +160,7 @@ module ActionView
         def form_for_with_haml(object_name, *args, &proc)
           if block_given? && is_haml?
             oldproc = proc
-            proc = haml_bind_proc do |*args|
-              with_tabs(1) {oldproc.call(*args)}
-            end
+            proc = proc {|*args| with_tabs(1) {oldproc.call(*args)}}
           end
           res = form_for_without_haml(object_name, *args, &proc)
           res << "\n" if block_given? && is_haml?

data/lib/haml/helpers.rb

@@ -1,8 +1,3 @@
-if defined?(ActionView)
-  require 'haml/helpers/action_view_mods'
-  require 'haml/helpers/action_view_extensions'
-end
-
 module Haml
   # This module contains various helpful methods to make it easier to do various tasks.
   # {Haml::Helpers} is automatically included in the context
@@ -52,8 +47,7 @@ MESSAGE
 
     self.extend self
 
-    @@action_view_defined = defined?(ActionView)
-    @@force_no_action_view = false
+    @@action_view_defined = false
 
     # @return [Boolean] Whether or not ActionView is loaded
     def self.action_view?
@@ -500,7 +494,6 @@ MESSAGE
     end
 
     # Characters that need to be escaped to HTML entities from user input
-    # @private
     HTML_ESCAPE = { '&'=>'&amp;', '<'=>'&lt;', '>'=>'&gt;', '"'=>'&quot;', "'"=>'&#039;', }
 
     # Returns a copy of `text` with ampersands, angle brackets and quotes
@@ -594,11 +587,10 @@ MESSAGE
       _erbout = _hamlout.buffer
       proc { |*args| proc.call(*args) }
     end
-
-    include ActionViewExtensions if self.const_defined? "ActionViewExtensions"
   end
 end
 
+# @private
 class Object
   # Haml overrides various `ActionView` helpers,
   # which call an \{#is\_haml?} method

data/lib/haml/html.rb

@@ -146,7 +146,6 @@ module Haml
     end
     alias_method :to_haml, :render
 
-    # @private
     TEXT_REGEXP = /^(\s*).*$/
 
     # @see Hpricot

data/lib/haml/precompiler.rb

@@ -8,60 +8,46 @@ module Haml
     include Haml::Util
 
     # Designates an XHTML/XML element.
-    # @private
     ELEMENT         = ?%
 
     # Designates a `<div>` element with the given class.
-    # @private
     DIV_CLASS       = ?.
 
     # Designates a `<div>` element with the given id.
-    # @private
     DIV_ID          = ?#
 
     # Designates an XHTML/XML comment.
-    # @private
     COMMENT         = ?/
 
     # Designates an XHTML doctype or script that is never HTML-escaped.
-    # @private
     DOCTYPE         = ?!
 
     # Designates script, the result of which is output.
-    # @private
     SCRIPT          = ?=
 
     # Designates script that is always HTML-escaped.
-    # @private
     SANITIZE        = ?&
 
     # Designates script, the result of which is flattened and output.
-    # @private
     FLAT_SCRIPT     = ?~
 
     # Designates script which is run but not output.
-    # @private
     SILENT_SCRIPT   = ?-
 
     # When following SILENT_SCRIPT, designates a comment that is not output.
-    # @private
     SILENT_COMMENT  = ?#
 
     # Designates a non-parsed line.
-    # @private
     ESCAPE          = ?\\
 
     # Designates a block of filtered text.
-    # @private
     FILTER          = ?:
 
     # Designates a non-parsed line. Not actually a character.
-    # @private
     PLAIN_TEXT      = -1
 
     # Keeps track of the ASCII values of the characters that begin a
     # specially-interpreted line.
-    # @private
     SPECIAL_CHARACTERS   = [
       ELEMENT,
       DIV_CLASS,
@@ -78,7 +64,6 @@ module Haml
 
     # The value of the character that designates that a line is part
     # of a multiline string.
-    # @private
     MULTILINE_CHAR_VALUE = ?|
 
     # Regex to match keywords that appear in the middle of a Ruby block
@@ -94,15 +79,12 @@ module Haml
     #
     # The block is ended after `%p no!`, because `else`
     # is a member of this array.
-    # @private
     MID_BLOCK_KEYWORD_REGEX = /^-\s*(#{%w[else elsif rescue ensure when end].join('|')})\b/
 
     # The Regex that matches a Doctype command.
-    # @private
     DOCTYPE_REGEX = /(\d(?:\.\d)?)?[\s]*([a-z]*)/i
 
     # The Regex that matches a literal string or symbol value
-    # @private
     LITERAL_VALUE_REGEX = /:(\w*)|(["'])((?![\\#]|\2).|\\.)*\2/
 
     private
@@ -146,6 +128,7 @@ END
     class Line < Struct.new(:text, :unstripped, :full, :index, :precompiler, :eod)
       alias_method :eod?, :eod
 
+      # @private
       def tabs
         line = self
         @tabs ||= precompiler.instance_eval do
@@ -252,6 +235,7 @@ You don't need to use "- end" in Haml. Un-indent to close a block:
 %p This line is un-indented, so it isn't part of the "if" block
 END
 
+        text = handle_ruby_multiline(text)
         push_silent(text[1..-1], true)
         newline_now
 
@@ -395,6 +379,7 @@ END
     # the result before it is added to `@buffer`
     def push_script(text, opts = {})
       raise SyntaxError.new("There's no Ruby code for = to evaluate.") if text.empty?
+      text = handle_ruby_multiline(text)
       return if options[:suppress_eval]
       opts[:escape_html] = options[:escape_html] if opts[:escape_html].nil?
 
@@ -781,10 +766,13 @@ END
       end.compact!
 
       raise SyntaxError.new("Illegal nesting: nesting within a self-closing tag is illegal.", @next_line.index) if block_opened? && self_closing
-      raise SyntaxError.new("Illegal nesting: content can't be both given on the same line as %#{tag_name} and nested within it.", @next_line.index) if block_opened? && !value.empty?
       raise SyntaxError.new("There's no Ruby code for #{action} to evaluate.", last_line - 1) if parse && value.empty?
       raise SyntaxError.new("Self-closing tags can't have content.", last_line - 1) if self_closing && !value.empty?
 
+      if block_opened? && !value.empty? && !is_ruby_multiline?(value)
+        raise SyntaxError.new("Illegal nesting: content can't be both given on the same line as %#{tag_name} and nested within it.", @next_line.index)
+      end
+
       self_closing ||= !!(!block_opened? && value.empty? && @options[:autoclose].any? {|t| t === tag_name})
       value = nil if value.empty? && (block_opened? || self_closing)
 
@@ -984,18 +972,17 @@ END
     end
 
     def handle_multiline(line)
-      if is_multiline?(line.text)
-        line.text.slice!(-1)
-        while new_line = raw_next_line.first
-          break if new_line == :eod
-          newline and next if new_line.strip.empty?
-          break unless is_multiline?(new_line.strip)
-          line.text << new_line.strip[0...-1]
-          newline
-        end
-        un_next_line new_line
-        resolve_newlines
+      return unless is_multiline?(line.text)
+      line.text.slice!(-1)
+      while new_line = raw_next_line.first
+        break if new_line == :eod
+        newline and next if new_line.strip.empty?
+        break unless is_multiline?(new_line.strip)
+        line.text << new_line.strip[0...-1]
+        newline
       end
+      un_next_line new_line
+      resolve_newlines
     end
 
     # Checks whether or not +line+ is in a multiline sequence.
@@ -1003,6 +990,26 @@ END
       text && text.length > 1 && text[-1] == MULTILINE_CHAR_VALUE && text[-2] == ?\s
     end
 
+    def handle_ruby_multiline(text)
+      text = text.rstrip
+      return text unless is_ruby_multiline?(text)
+      un_next_line @next_line.full
+      begin
+        new_line = raw_next_line.first
+        break if new_line == :eod
+        newline and next if new_line.strip.empty?
+        text << " " << new_line.strip
+        newline
+      end while is_ruby_multiline?(new_line.strip)
+      next_line
+      resolve_newlines
+      text
+    end
+
+    def is_ruby_multiline?(text)
+      text && text.length > 1 && text[-1] == ?, && text[-2] != ?? && text[-3..-2] != "?\\"
+    end
+
     def contains_interpolation?(str)
       str.include?('#{')
     end

data/lib/haml/railtie.rb

@@ -3,10 +3,14 @@
 # Yehuda promises there will be soon,
 # and once there is we should switch to that.
 
-if defined?(Rails::Railtie)
+if defined?(ActiveSupport) && Haml::Util.has?(:public_method, ActiveSupport, :on_load)
+  # Rails 3.0.0.beta.2+
+  ActiveSupport.on_load(:action_view) {Haml.init_rails(binding)}
+elsif defined?(Rails::Railtie)
+  # Rails 3.0.0.beta1
   module Haml
     class Railtie < Rails::Railtie
-      initializer :haml do
+      ActiveSupport.on_load(:action_view) do
         Haml.init_rails(binding)
       end
     end

data/lib/haml/root.rb

@@ -1,3 +1,7 @@
 module Haml
+  # The root directory of the Haml source tree.
+  # This may be overridden by the package manager
+  # if the lib directory is separated from the main source tree.
+  # @api public
   ROOT_DIR = File.expand_path("../../..", __FILE__)
 end

data/lib/haml/template.rb

@@ -1,4 +1,6 @@
 require 'haml/engine'
+require 'haml/helpers/action_view_mods'
+require 'haml/helpers/action_view_extensions'
 
 module Haml
   # The class that keeps track of the global options for Haml within Rails.

data/lib/haml/util/subset_map.rb

@@ -0,0 +1,101 @@
+require 'set'
+
+module Haml
+  module Util
+    # A map from sets to values.
+    # A value is \{#\[]= set} by providing a set (the "set-set") and a value,
+    # which is then recorded as corresponding to that set.
+    # Values are \{#\[] accessed} by providing a set (the "get-set")
+    # and returning all values that correspond to set-sets
+    # that are subsets of the get-set.
+    #
+    # SubsetMap preserves the order of values as they're inserted.
+    #
+    # @example
+    # ssm = SubsetMap.new
+    # ssm[Set[1, 2]] = "Foo"
+    # ssm[Set[2, 3]] = "Bar"
+    # ssm[Set[1, 2, 3]] = "Baz"
+    #
+    # ssm[Set[1, 2, 3]] #=> ["Foo", "Bar", "Baz"]
+    class SubsetMap
+      # Creates a new, empty SubsetMap.
+      def initialize
+        @hash = {}
+        @vals = []
+      end
+
+      # Whether or not this SubsetMap has any key-value pairs.
+      #
+      # @return [Boolean]
+      def empty?
+        @hash.empty?
+      end
+
+      # Associates a value with a set.
+      # When `set` or any of its supersets is accessed,
+      # `value` will be among the values returned.
+      #
+      # Note that if the same `set` is passed to this method multiple times,
+      # all given `value`s will be associated with that `set`.
+      #
+      # This runs in `O(n)` time, where `n` is the size of `set`.
+      #
+      # @param set [#to_set] The set to use as the map key. May not be empty.
+      # @param value [Object] The value to associate with `set`.
+      # @raise [ArgumentError] If `set` is empty.
+      def []=(set, value)
+        raise ArgumentError.new("SubsetMap keys may not be empty.") if set.empty?
+
+        index = @vals.size
+        @vals << value
+        set.each do |k|
+          @hash[k] ||= []
+          @hash[k] << [set, set.to_set, index]
+        end
+      end
+
+      # Returns all values associated with subsets of `set`.
+      #
+      # In the worst case, this runs in `O(m*max(n, log m))` time,
+      # where `n` is the size of `set`
+      # and `m` is the number of assocations in the map.
+      # However, unless many keys in the map overlap with `set`,
+      # `m` will typically be much smaller.
+      #
+      # @param set [Set] The set to use as the map key.
+      # @return [Array<(Object, #to_set)>] An array of pairs,
+      #   where the first value is the value associated with a subset of `set`,
+      #   and the second value is that subset of `set`
+      #   (or whatever `#to_set` object was used to set the value)
+      #   This array is in insertion order.
+      # @see #[]
+      def get(set)
+        res = set.map do |k|
+          next unless subsets = @hash[k]
+          subsets.map do |subenum, subset, index|
+            next unless subset.subset?(set)
+            [index, subenum]
+          end
+        end
+        res.flatten!(1)
+        res.compact!
+        res.uniq!
+        res.sort!
+        res.map! {|i, s| [@vals[i], s]}
+        return res
+      end
+
+      # Same as \{#get}, but doesn't return the subsets of the argument
+      # for which values were found.
+      #
+      # @param set [Set] The set to use as the map key.
+      # @return [Array] The array of all values
+      #   associated with subsets of `set`, in insertion order.
+      # @see #get
+      def [](set)
+        get(set).map {|v, _| v}
+      end
+    end
+  end
+end

data/lib/haml/util.rb

@@ -3,6 +3,7 @@ require 'set'
 require 'enumerator'
 require 'stringio'
 require 'haml/root'
+require 'haml/util/subset_map'
 
 module Haml
   # A module containing various useful functions.
@@ -10,6 +11,7 @@ module Haml
     extend self
 
     # An array of ints representing the Ruby version number.
+    # @api public
     RUBY_VERSION = ::RUBY_VERSION.split(".").map {|s| s.to_i}
 
     # Returns the path of a file relative to the Haml root directory.
@@ -135,6 +137,33 @@ module Haml
       end
     end
 
+    # Intersperses a value in an enumerable, as would be done with `Array#join`
+    # but without concatenating the array together afterwards.
+    #
+    # @param enum [Enumerable]
+    # @param val
+    # @return [Array]
+    def intersperse(enum, val)
+      enum.inject([]) {|a, e| a << e << val}[0...-1]
+    end
+
+    # Substitutes a sub-array of one array with another sub-array.
+    #
+    # @param ary [Array] The array in which to make the substitution
+    # @param from [Array] The sequence of elements to replace with `to`
+    # @param to [Array] The sequence of elements to replace `from` with
+    def substitute(ary, from, to)
+      res = ary.dup
+      i = 0
+      while i < res.size
+        if res[i...i+from.size] == from
+          res[i...i+from.size] = to
+        end
+        i += 1
+      end
+      res
+    end
+
     # Destructively strips whitespace from the beginning and end
     # of the first and last elements, respectively,
     # in the array (if those elements are strings).
@@ -147,6 +176,23 @@ module Haml
       arr
     end
 
+    # Return an array of all possible paths through the given arrays.
+    #
+    # @param arrs [Array<Array>]
+    # @return [Array<Arrays>]
+    #
+    # @example
+    # paths([[1, 2], [3, 4], [5]]) #=>
+    #   # [[1, 3, 5],
+    #   #  [2, 3, 5],
+    #   #  [1, 4, 5],
+    #   #  [2, 4, 5]]
+    def paths(arrs)
+      arrs.inject([[]]) do |paths, arr|
+        arr.map {|e| paths.map {|path| path + [e]}}.flatten(1)
+      end
+    end
+
     # Returns information about the caller of the previous method.
     #
     # @param entry [String] An entry in the `#caller` list, or a similarly formatted string
@@ -237,6 +283,30 @@ module Haml
           ActionPack::VERSION::TINY == "0.beta")
     end
 
+    # Returns whether this environment is using ActionPack
+    # version 3.0.0.beta.3 or greater.
+    #
+    # @return [Boolean]
+    def ap_geq_3_beta_3?
+      # The ActionPack module is always loaded automatically in Rails >= 3
+      return false unless defined?(ActionPack) && defined?(ActionPack::VERSION)
+
+      version =
+        if defined?(ActionPack::VERSION::MAJOR)
+          ActionPack::VERSION::MAJOR
+        else
+          # Rails 1.2
+          ActionPack::VERSION::Major
+        end
+      version >= 3 &&
+        ((defined?(ActionPack::VERSION::TINY) &&
+          ActionPack::VERSION::TINY.is_a?(Fixnum) &&
+          ActionPack::VERSION::TINY >= 1) ||
+         (defined?(ActionPack::VERSION::BUILD) &&
+          ActionPack::VERSION::BUILD =~ /beta(\d+)/ &&
+          $1.to_i >= 3))
+    end
+
     # Returns an ActionView::Template* class.
     # In pre-3.0 versions of Rails, most of these classes
     # were of the form `ActionView::TemplateFoo`,
@@ -282,6 +352,10 @@ module Haml
       raise Haml::Error.new("Expected #{text.inspect} to be HTML-safe.")
     end
 
+    # The class for the Rails SafeBuffer XSS protection class.
+    # This varies depending on Rails version.
+    #
+    # @return [Class]
     def rails_safe_buffer_class
       return ActionView::SafeBuffer if defined?(ActionView::SafeBuffer)
       ActiveSupport::SafeBuffer

data/lib/haml.rb

@@ -17,6 +17,7 @@ module Haml
 
   # A string representing the version of Haml.
   # A more fine-grained representation is available from Haml.version.
+  # @api public
   VERSION = version[:string] unless defined?(Haml::VERSION)
 
   # Initializes Haml for Rails.
@@ -37,5 +38,7 @@ module Haml
 end
 
 require 'haml/util'
-require 'haml/engine'
-require 'haml/railtie'
+unless $0 =~ /sass(-convert)?$/
+  require 'haml/engine'
+  require 'haml/railtie'
+end