erector-rails4 0.0.1

data/lib/erector/unicode_builder.rb

@@ -0,0 +1,67 @@
+# Note that this class is only used in building erector itself
+# (and even then, only needs to be run when there is a new
+# UnicodeData.txt file from unicode.org).
+class Erector::UnicodeBuilder
+
+  def initialize(input, output)
+    @input = input
+    @output = output
+    @first = true
+  end
+  
+  def generate()
+    @output.puts "Erector::CHARACTERS = {"
+    process_file
+    @output.puts "}"
+  end
+
+  def process_file()
+    while !@input.eof
+      line = @input.gets.strip
+      if (line == "")
+        next;
+      end
+      
+      process_line(line)
+    end
+    if (!@first)
+      @output.puts
+    end
+  end
+  
+  def output_line(line)
+    if (!@first)
+      @output.puts(',')
+    end
+    
+    @output.print(line)
+
+    @first = false
+  end
+  
+  def process_line(line)
+    fields = line.split(';')
+    code_point = fields[0]
+    name = fields[1]
+    alternate_name = fields[10]
+
+    if /^</.match(name)
+      return ""
+    end
+
+    output name, code_point
+    if (!alternate_name.nil? && alternate_name != "")
+      output alternate_name, code_point
+    end
+  end
+  
+  def output(name, code_point)
+    output_line "  :#{namify(name)} => 0x#{code_point.downcase}"
+  end
+  
+  def namify(name)
+    name.downcase.gsub(/[- ]/, '_')
+  end
+
+end
+

data/lib/erector/version.rb

@@ -0,0 +1,5 @@
+# Erector view framework
+module Erector
+  VERSION = "0.0.1"
+end
+

data/lib/erector/widget.rb

@@ -0,0 +1,94 @@
+require "erector/element"
+require "erector/attributes"
+require "erector/promise"
+require "erector/text"
+require "erector/tag"
+require "erector/html_widget"
+require "erector/needs"
+
+module Erector
+
+  # A Widget is the center of the Erector universe.
+  #
+  # To create a widget, extend Erector::Widget and implement the +content+
+  # method. Inside this method you may call any of the tag methods like +span+
+  # or +p+ to emit HTML/XML tags.
+  #
+  # You can also define a widget on the fly by passing a block to +new+. This
+  # block will get executed when the widget's +content+ method is called. See
+  # the userguide for important details about the scope of this block when run --
+  # http://erector.rubyforge.org/userguide.html#blocks
+  #
+  # To render a widget from the outside, instantiate it and call its +to_html+
+  # method.
+  #
+  # A widget's +new+ method optionally accepts an options hash. Entries in
+  # this hash are converted to instance variables.
+  #
+  # You can add runtime input checking via the +needs+ macro. See #needs.
+  # This mechanism is meant to ameliorate development-time confusion about
+  # exactly what parameters are supported by a given widget, avoiding
+  # confusing runtime NilClass errors.
+  #
+  # To call one widget from another, inside the parent widget's +content+
+  # method, instantiate the child widget and call the +widget+ method. This
+  # assures that the same output stream is used, which gives better
+  # performance than using +capture+ or +to_html+. It also preserves the
+  # indentation and helpers of the enclosing class.
+  #
+  # In this documentation we've tried to keep the distinction clear between
+  # methods that *emit* text and those that *return* text. "Emit" means that
+  # it writes to the output stream; "return" means that it returns a string
+  # like a normal method and leaves it up to the caller to emit that string if
+  # it wants.
+  #
+  # This class extends AbstractWidget and includes several modules,
+  # so be sure to check all of those places for API documentation for the
+  # various methods of Widget:
+  #
+  # * AbstractWidget
+  # * Element
+  # * Attributes
+  # * Text
+  # * Needs
+  # * Caching
+  # * Externals
+  # * AfterInitialize
+  #
+  # * HTML
+  # * Convenience
+  # * JQuery
+  # * Sass
+  #
+  # Also read the API Cheatsheet in the user guide
+  # at http://erector.rubyforge.org/userguide#apicheatsheet
+  class Widget < HTMLWidget
+
+    # for some reason these need to be included in Widget and not AbstractWidget
+    include Needs
+    include Caching
+    include Externals
+
+    include HTML
+    include Convenience
+    include Erector::JQuery
+    include Erector::Sass if Object.const_defined?(:Sass)
+
+    # alias for AbstractWidget#render
+    def to_html(options = {})
+      raise "Erector::Widget#to_html takes an options hash, not a symbol. Try calling \"to_html(:content_method_name=> :#{options})\"" if options.is_a? Symbol
+      _emit(options).to_s
+    end
+
+    # alias for #to_html
+    # @deprecated Please use {#to_html} instead
+    def to_s(*args)
+      unless defined? @@already_warned_to_s
+        $stderr.puts "Erector::Widget#to_s is deprecated. Please use #to_html instead. Called from #{caller.first}"
+        @@already_warned_to_s = true
+      end
+      to_html(*args)
+    end
+
+  end
+end

data/lib/erector/widgets.rb

@@ -0,0 +1,5 @@
+require "erector/widgets/environment_badge"
+require "erector/widgets/field_table"
+require "erector/widgets/external_renderer"
+require "erector/widgets/page"
+require "erector/widgets/table"

data/lib/erector/xml_widget.rb

@@ -0,0 +1,131 @@
+require 'erector/abstract_widget'
+require 'erector/tag'
+require 'erector/needs'
+
+module Erector
+
+  # Abstract base class for XML Widgets and HTMLWidget.
+  # Declares "tags" which define methods that emit tags.
+  class XMLWidget < AbstractWidget
+    include Needs
+
+    def self.tag_named tag_name, checked = []
+      @tags ||= {}
+      @tags[tag_name] || begin
+        tag = nil
+        checked << self
+        taggy_ancestors = (ancestors - checked).select{|k| k.respond_to? :tag_named}
+        taggy_ancestors.each do |k|
+          tag = k.tag_named(tag_name, checked)
+          if tag
+            @tags[tag_name] = tag
+            break
+          end
+        end
+        tag
+      end
+    end
+
+    def self.tag *args
+      tag = Tag.new(*args)
+      @tags ||= {}
+      @tags[tag.name] = tag
+
+      if instance_methods.include?(tag.method_name.to_sym)
+        warn "method '#{tag.method_name}' is already defined; skipping #{caller[1]}"
+        return
+      end
+
+      if tag.self_closing?
+        self.class_eval(<<-SRC, __FILE__, __LINE__ + 1)
+          def #{tag.method_name}(*args, &block)
+            _empty_element('#{tag.name}', *args, &block)
+          end
+        SRC
+      else
+        self.class_eval(<<-SRC, __FILE__, __LINE__ + 1)
+        def #{tag.method_name}(*args, &block)
+              _element('#{tag.name}', *args, &block)
+          end
+
+          def #{tag.method_name}!(*args, &block)
+            _element('#{tag.name}', *(args.map{|a|raw(a)}), &block)
+          end
+        SRC
+      end
+    end
+
+    # Tags which are always self-closing
+    def self.self_closing_tags
+      @tags.values.select{|tag| tag.self_closing?}.map{|tag| tag.name}
+    end
+
+    # Tags which can contain other stuff
+    def self.full_tags
+      @tags.values.select{|tag| !tag.self_closing?}.map{|tag| tag.name}
+    end
+
+    def newliney?(tag_name)
+      tag = self.class.tag_named tag_name
+      if tag
+        tag.newliney?
+      else
+        true
+      end
+    end
+
+    # Emits an XML instruction, which looks like this: <?xml version=\"1.0\" encoding=\"UTF-8\" ?>
+    def instruct(attributes={:version => "1.0", :encoding => "UTF-8"})
+      output << raw("<?xml#{format_attributes(sort_for_xml_declaration(attributes))}?>")
+    end
+
+    # Emits an XML/HTML comment (&lt;!-- ... --&gt;) surrounding +text+ and/or
+    # the output of +block+. see
+    # http://www.w3.org/TR/html4/intro/sgmltut.html#h-3.2.4
+    #
+    # If +text+ is an Internet Explorer conditional comment condition such as
+    # "[if IE]", the output includes the opening condition and closing
+    # "[endif]". See http://www.quirksmode.org/css/condcom.html
+    #
+    # Since "Authors should avoid putting two or more adjacent hyphens inside
+    # comments," we emit a warning if you do that.
+    def comment(text = '')
+      puts "Warning: Authors should avoid putting two or more adjacent hyphens inside comments." if text =~ /--/
+
+      conditional = text =~ /\[if .*\]/
+
+      rawtext "<!--"
+      rawtext text
+      rawtext ">" if conditional
+
+      if block_given?
+        rawtext "\n"
+        yield
+        rawtext "\n"
+      end
+
+      rawtext "<![endif]" if conditional
+      rawtext "-->\n"
+    end
+
+    alias_method :to_xml, :emit
+
+    protected
+
+    def sort_for_xml_declaration(attributes)
+      # correct order is "version, encoding, standalone" (XML 1.0 section 2.8).
+      # But we only try to put version before encoding for now.
+      stringized = []
+      attributes.each do |key, value|
+        stringized << [key.to_s, value]
+      end
+      stringized.sort{|a, b| b <=> a}
+    end
+
+  end
+
+  public
+
+  XmlWidget = XMLWidget
+
+end

data/lib/erector.rb

@@ -0,0 +1,28 @@
+module Erector
+end
+
+require "cgi"
+
+require "erector/raw_string"
+require "erector/dependencies"
+require "erector/dependency"
+require "erector/externals"
+require "erector/output"
+require "erector/cache"
+require "erector/caching"
+require "erector/after_initialize"
+require "erector/needs"
+require "erector/html"
+require "erector/convenience"
+require "erector/jquery"
+require "erector/sass"
+
+require "erector/abstract_widget"
+require "erector/html_widget"
+require "erector/widget"
+
+require "erector/inline"
+require "erector/version"
+require "erector/mixin"
+
+require "erector/rails" if defined?(Rails)

data/spec/dummy/Rakefile

@@ -0,0 +1,7 @@
+# Add your own tasks in files placed in lib/tasks ending in .rake,
+# for example lib/tasks/capistrano.rake, and they will automatically be available to Rake.
+
+require File.expand_path('../config/application', __FILE__)
+require 'rake'
+
+Dummy::Application.load_tasks

data/spec/dummy/app/controllers/application.rb

@@ -0,0 +1,6 @@
+# Filters added to this controller apply to all controllers in the application.
+# Likewise, all the methods added will be available for all controllers.
+
+class ApplicationController < ActionController::Base
+  helper :all # include all helpers, all the time
+end

data/spec/dummy/app/controllers/application_controller.rb

@@ -0,0 +1,3 @@
+class ApplicationController < ActionController::Base
+  protect_from_forgery
+end

data/spec/dummy/app/helpers/application_helper.rb

@@ -0,0 +1,2 @@
+module ApplicationHelper
+end

data/spec/dummy/app/views/layouts/erb_as_layout.html.erb

@@ -0,0 +1,2 @@
+<%= @layout_content %>
+<%= content_for :layout %>

data/spec/dummy/app/views/layouts/widget_as_layout.rb

@@ -0,0 +1,8 @@
+class Views::Layouts::WidgetAsLayout < Erector::Widget
+  def content
+    content_for(:top) if content_for?(:top)
+    text @before || "BEFORE"
+    content_for(:layout)
+    text @after || "AFTER"
+  end
+end

data/spec/dummy/app/views/test/_erb.erb

@@ -0,0 +1 @@
+<%= "Partial #{@foobar}" %>

data/spec/dummy/app/views/test/_erector.rb

@@ -0,0 +1,5 @@
+class Views::Test::Erector < Erector::Widget
+  def content
+    text "Partial #{@foobar}"
+  end
+end

data/spec/dummy/app/views/test/_partial_with_locals.rb

@@ -0,0 +1,7 @@
+class Views::Test::PartialWithLocals < Erector::Widget
+  needs :foo, :bar => 12345
+  
+  def content
+    text "Partial, foo #{@foo}, bar #{@bar}"
+  end
+end

data/spec/dummy/app/views/test/bare.rb

@@ -0,0 +1,5 @@
+class Views::Test::Bare < Erector::Widget
+  def content
+    text "Bare"
+  end
+end

data/spec/dummy/app/views/test/erb_from_erector.html.rb

@@ -0,0 +1,5 @@
+class Views::Test::ErbFromErector < Erector::Widget
+  def content
+    text! parent.render(:partial => 'erb')
+  end
+end

data/spec/dummy/app/views/test/erector_from_erb.html.erb

@@ -0,0 +1 @@
+<%= render :partial => 'erector' %>

data/spec/dummy/app/views/test/erector_with_locals_from_erb.html.erb

@@ -0,0 +1,6 @@
+<%
+  passed_locals = { }
+  passed_locals[:foo] = @local_foo if @local_foo
+  passed_locals[:bar] = @local_bar if @local_bar
+  passed_locals[:baz] = @local_baz if @local_baz
+%><%= render :partial => 'partial_with_locals', :locals => passed_locals %>

data/spec/dummy/app/views/test/implicit_assigns.html.rb

@@ -0,0 +1,5 @@
+class Views::Test::ImplicitAssigns < Erector::Widget
+  def content
+    text @foobar
+  end
+end

data/spec/dummy/app/views/test/needs.html.rb

@@ -0,0 +1,7 @@
+class Views::Test::Needs < Erector::Widget
+  needs :foobar
+  
+  def content
+    text "Needs #{@foobar}"
+  end
+end

data/spec/dummy/app/views/test/needs_subclass.html.rb

@@ -0,0 +1,5 @@
+class Views::Test::NeedsSubclass < Views::Test::Needs
+  def content
+    text "NeedsSubclass #{@foobar}"
+  end
+end