simply 0.1.3

data/.gitignore

@@ -0,0 +1 @@
+pkg

data/README

@@ -0,0 +1,4 @@
+
+== Simply
+
+A simple, fast replacement for markaby.

data/Rakefile

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+PROJECT_NAME = "simply"
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |s|
+    s.name        = PROJECT_NAME
+    s.summary     = "A markaby-like html builder"
+    s.email       = "scott@railsnewbie.com"
+    s.homepage    = "http://github.com/smtlaissezfaire/#{PROJECT_NAME.downcase}"
+    s.description = "Cleaner + smaller markaby clone."
+    s.authors     = ["Scott Taylor"]
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end

data/VERSION.yml

@@ -0,0 +1,5 @@
+--- 
+:minor: 1
+:patch: 3
+:major: 0
+:build: 

data/benchmarks/001_7a22450a80d6253bf9f0aabb2ee0110c2d67c8a6.out

@@ -0,0 +1,23 @@
+# of iterations = 10000
+Rehearsal ------------------------------------------------------------------------------
+counter time                                 0.000000   0.000000   0.000000 (  0.001091)
+counter time + function call overhead time   0.000000   0.000000   0.000000 (  0.002866)
+tagz                                         2.340000   0.020000   2.360000 (  2.356264)
+markaby                                      8.720000   0.030000   8.750000 (  8.764424)
+builder                                      2.140000   0.010000   2.150000 (  2.154632)
+haml                                         5.620000   0.010000   5.630000 (  5.652289)
+erb                                          2.240000   0.010000   2.250000 (  2.248454)
+erubis                                       0.420000   0.000000   0.420000 (  0.418306)
+simply                                       2.010000   0.000000   2.010000 (  2.018264)
+-------------------------------------------------------------------- total: 23.570000sec
+
+                                                 user     system      total        real
+counter time                                 0.000000   0.000000   0.000000 (  0.001062)
+counter time + function call overhead time   0.000000   0.000000   0.000000 (  0.002849)
+tagz                                         2.220000   0.010000   2.230000 (  2.238662)
+markaby                                      9.210000   0.030000   9.240000 (  9.261845)
+builder                                      1.930000   0.000000   1.930000 (  1.934298)
+haml                                         5.220000   0.010000   5.230000 (  5.235850)
+erb                                          2.330000   0.010000   2.340000 (  2.339981)
+erubis                                       0.430000   0.000000   0.430000 (  0.437849)
+simply                                       2.210000   0.010000   2.220000 (  2.223844)

data/benchmarks/002_e462499cd6bd8dface62e433311b3bc0b0b55a42

@@ -0,0 +1,27 @@
+# of iterations = 10000
+Rehearsal ------------------------------------------------------------------------------
+counter time                                 0.000000   0.000000   0.000000 (  0.001055)
+counter time + function call overhead time   0.010000   0.000000   0.010000 (  0.003877)
+tagz                                         2.620000   0.020000   2.640000 (  2.675130)
+markaby                                     10.220000   0.070000  10.290000 ( 10.403767)
+builder                                      1.070000   0.000000   1.070000 (  1.089509)
+haml                                         5.690000   0.040000   5.730000 (  5.770631)
+erb                                          2.400000   0.010000   2.410000 (  2.436488)
+erubis                                       0.470000   0.000000   0.470000 (  0.476391)
+nokogiri                                     1.930000   0.010000   1.940000 (  1.961594)
+simply                                       1.450000   0.010000   1.460000 (  1.465180)
+erector                                      0.150000   0.000000   0.150000 (  0.155925)
+-------------------------------------------------------------------- total: 26.170000sec
+
+                                                 user     system      total        real
+counter time                                 0.000000   0.000000   0.000000 (  0.001063)
+counter time + function call overhead time   0.000000   0.000000   0.000000 (  0.003963)
+tagz                                         2.630000   0.020000   2.650000 (  2.669872)
+markaby                                     10.200000   0.060000  10.260000 ( 10.367525)
+builder                                      1.070000   0.010000   1.080000 (  1.093933)
+haml                                         5.650000   0.040000   5.690000 (  5.745920)
+erb                                          2.420000   0.020000   2.440000 (  2.462542)
+erubis                                       0.430000   0.000000   0.430000 (  0.439791)
+nokogiri                                     1.930000   0.010000   1.940000 (  1.967485)
+simply                                       1.380000   0.010000   1.390000 (  1.405759)
+erector                                      0.160000   0.000000   0.160000 (  0.155949)

data/benchmarks/comparison.rb

@@ -0,0 +1,224 @@
+#!/usr/bin/env ruby
+require 'benchmark'
+require "erb"
+require 'rubygems'
+require 'markaby'
+require 'tagz'
+require 'builder'
+require 'haml'
+require 'erubis'
+require "nokogiri"
+require "erector"
+require File.dirname(__FILE__) + "/../lib/simply"
+
+MAX = (ARGV.shift || 10_000).to_i
+
+def do_nothing
+  # do nothing
+end
+
+def do_erb
+  str = <<-EOF
+<html>
+  <head>
+    <title>happy title</title>
+  </head>
+  <body>
+    <h1>happy heading</h1>
+    <a href='<%= 'url' %>'>a link</a>
+  </body>
+</html>
+EOF
+  ERB.new(str)
+end
+
+def do_erubis
+  str = <<-EOF
+<html>
+  <head>
+    <title>happy title</title>
+  </head>
+  <body>
+    <h1>happy heading</h1>
+    <a href='<%= 'url' %>'>a link</a>
+  </body>
+</html>
+EOF
+  Erubis::Eruby.new(str)
+end
+
+def do_haml
+  str = <<-EOF
+%html
+  %head
+    %title_ "happy title"
+  %body
+    %h1 "happy heading"
+    %a "a link", :href => "url"
+EOF
+  Haml::Engine.new(str)
+end
+
+def do_tagz
+  Tagz {
+    html_ {
+      head_ {
+        title_ "happy title"
+      }
+      body_ {
+        h1_ "happy heading"
+        a_ "a link", :href => "url"
+      }
+    }
+  }
+end
+
+def do_builder
+  Builder::XmlMarkup.new.html do |xm|
+    xm.head do
+      xm.title "happy title"
+    end
+    xm.body do
+      xm.h1 "happy heading"
+      xm.a "a link", :href => "url"
+    end
+  end
+end
+
+def do_markaby
+  mab = Markaby::Builder.new :output_meta_tag => false
+
+  mab.html {
+    head {
+      title "happy title"
+    }
+    body {
+      h1 "happy heading"
+      a "a link", :href => "url"
+    }
+  }.to_s
+end
+
+def do_simply
+  Simply do
+    html do
+      head do
+        title "happy title"
+      end
+
+      body do
+        h1 "happy heading"
+        a "a link", :href => "url"
+      end
+    end
+  end
+end
+
+def do_nokogiri
+  Nokogiri do
+    html do
+      head do
+        title "happy title"
+      end
+
+      body do
+        h1 "happy heading"
+        a :href => "url" do
+          text "a link"
+        end
+      end
+    end
+  end
+end
+
+def do_erector
+  Erector::Widget.new do
+    html do
+      head do
+        title "happy title"
+      end
+
+      body do
+        h1 "happy heading"
+        a "a link", :href => "url"
+      end
+    end
+  end
+end
+
+
+x = do_tagz
+y = do_markaby
+z = do_builder
+
+raise "bad!\n\n#{x}\n\n#{y}" unless x == y
+raise "bad!\n\n#{x}\n\n#{z}" unless x == z
+
+puts "# of iterations = #{MAX}"
+Benchmark.bmbm do |x|
+  x.report("counter time") do
+    for i in 0..MAX
+      # do nothing
+    end
+  end
+
+  x.report("counter time + function call overhead time") do
+    for i in 0..MAX do
+      do_nothing
+    end
+  end
+
+  x.report("tagz") do
+    for i in 0..MAX do
+      do_tagz
+    end
+  end
+
+  x.report("markaby") do
+    for i in 0..MAX do
+      do_markaby
+    end
+  end
+
+  x.report("builder") do
+    for i in 0..MAX do
+      do_builder
+    end
+  end
+
+  x.report("haml") do
+    for i in 0..MAX do
+      do_haml
+    end
+  end
+
+  x.report("erb") do
+    for i in 0..MAX do
+      do_erb
+    end
+  end
+
+  x.report("erubis") do
+    for i in 0..MAX do
+      do_erubis
+    end
+  end
+
+  x.report("nokogiri") do
+    for i in 0..MAX do
+      do_nokogiri
+    end
+  end
+
+  x.report("simply") do
+    for i in 0..MAX do
+      do_simply
+    end
+  end
+
+  x.report("erector") do
+    for i in 0..MAX do
+      do_erector
+    end
+  end
+end

data/lib/simply/html_builder.rb

@@ -0,0 +1,127 @@
+module Simply
+  class HTMLBuilder
+    include Locals
+    
+    unless defined?(SELF_CLOSING_TAGS)
+      SELF_CLOSING_TAGS = HTMLTags::SELF_CLOSING_TAGS
+      BLOCK_TAGS        = HTMLTags::BLOCK_TAGS
+    end
+    
+    def initialize(options={ }, &block)
+      @out = ""
+
+      if locals_hash = options[:locals]
+        self.locals = locals_hash
+      end
+      
+      @indented = true if options[:indent] == true
+      @out.extend Indentation if indented?
+      
+      instance_eval(&block) if block_given?
+    end
+    
+    def indented?
+      @indented ? true : false
+    end
+
+    SELF_CLOSING_TAGS.each do |tag|
+      class_eval <<-HERE, __FILE__, __LINE__
+        def #{tag}(attributes={})
+          __self_closing_tag(:#{tag}, attributes)
+        end
+      HERE
+    end
+    
+    BLOCK_TAGS.each do |tag|
+      class_eval <<-HERE, __FILE__, __LINE__
+        def #{tag}(*args, &block)
+          raise ArgumentError if !block_given? && args.empty?
+
+          if block_given? || args.first.is_a?(Hash)
+            options = args.first || { }
+          else
+            block = lambda { clean_text args.first.to_s }
+            options = args[1] || { }
+          end
+
+          __tag(:#{tag}, options, &block)
+        end
+      HERE
+    end
+
+    def xhtml_transitional
+      text HTMLTags::XML_ENCODING
+      text HTMLTags::TRANSITIONAL
+    end
+
+    def xhtml_strict
+      text HTMLTags::XML_ENCODING
+      text HTMLTags::STRICT
+    end
+
+    def xhtml_frameset
+      text HTMLTags::XML_ENCODING
+      text HTMLTags::FRAMESET
+    end
+    
+    ####################
+    #
+    #  Utilities
+    #
+    ####################
+
+    def text(out)
+      @out << out.to_s
+    end
+
+    def clean_text(out)
+      text html_escape(out)
+    end
+
+    def html_escape(out)
+      out.to_s.to_xs
+    end
+
+    def to_s
+      @out
+    end
+
+  private
+
+    def __tag(tag_name, attributes={ }, &block)
+      text __opening_tag(tag_name, attributes)
+      __eval_block(&block)
+      text __closing_tag(tag_name)
+    end
+    
+    def __eval_block(&block)
+      @out.indent if indented?
+      instance_eval(&block)
+      @out.outdent if indented?
+    end
+
+    def __opening_tag(tag_name, attributes={ })
+      if attributes.any?
+        "<#{tag_name} #{__expand_attributes(attributes)}>"
+      else
+        "<#{tag_name}>"
+      end
+    end
+
+    def __closing_tag(tag_name)
+      "</#{tag_name}>"
+    end
+
+    def __self_closing_tag(tag_name, attributes={ })
+      if attributes.any?
+        text "<#{tag_name} #{__expand_attributes(attributes)} />"
+      else
+        text "<#{tag_name} />"
+      end
+    end
+
+    def __expand_attributes(attributes)
+      attributes.map { |key, value| "#{key}=\"#{value}\""}.join(" ")
+    end
+  end
+end

data/lib/simply/html_tags.rb

@@ -0,0 +1,126 @@
+module Simply
+  module HTMLTags
+    unless defined?(XML_ENCODING)
+      XML_ENCODING = '<?xml version="1.0" encoding="UTF-8"?>'.freeze
+
+      STRICT       = '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">'.freeze
+      TRANSITIONAL = '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">'.freeze
+      FRAMESET     = '<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd">'.freeze
+
+      SELF_CLOSING_TAGS = [
+        :base,
+        :meta,
+        :link,
+        :hr,
+        :br,
+        :param,
+        :img,
+        :area,
+        :input,
+        :col,
+        :frame
+      ]
+    
+      BLOCK_TAGS = [
+        :html,
+        :head,
+        :title,
+        :style,
+        :script,
+        :noscript,
+        :body,
+        :div,
+        :p,
+        :ul,
+        :ol,
+        :li,
+        :dl,
+        :dt,
+        :dd,
+        :address,
+        :pre,
+        :blockquote,
+        :ins,
+        :del,
+        :a,
+        :span,
+        :bdo,
+        :em,
+        :strong,
+        :dfn,
+        :code,
+        :samp,
+        :kbd,
+        :var,
+        :cite,
+        :abbr,
+        :acronym,
+        :q,
+        :sub,
+        :sup,
+        :tt,
+        :i,
+        :b,
+        :big,
+        :small,
+        :object,
+        :map,
+        :form,
+        :label,
+        :select,
+        :optgroup,
+        :option,
+        :textarea,
+        :fieldset,
+        :legend,
+        :button,
+        :table,
+        :caption,
+        :colgroup,
+        :thead,
+        :tfoot,
+        :tbody,
+        :tr,
+        :th,
+        :td,
+        :h1,
+        :h2,
+        :h3,
+        :h4,
+        :h5,
+        :h6,
+        :strike,
+        :center,
+        :dir,
+        :noframes,
+        :basefont,
+        :u,
+        :menu,
+        :iframe,
+        :font,
+        :s,
+        :applet,
+        :isindex,
+        :script,
+        :a,
+        :td,
+        :h5,
+        :h3,
+        :li,
+        :div,
+        :pre,
+        :body,
+        :ol,
+        :h4,
+        :h2,
+        :object,
+        :legend,
+        :dl,
+        :h6,
+        :ul,
+        :form,
+        :h1
+      ]
+    end
+  end
+end

data/lib/simply/indentation.rb

@@ -0,0 +1,37 @@
+module Simply
+  module Indentation
+    class IndentationError < StandardError
+      def message
+        "You can't outdent before the beginning of the page"
+      end
+    end
+    
+    unless defined?(DEFAULT_INDENTATION_LEVEL)
+      DEFAULT_NUM_SPACES_TO_INDENT = 2
+      DEFAULT_INDENTATION_LEVEL    = 0
+    end
+    
+    def <<(text)
+      out = empty? ? "" : "\n"
+      out << "#{" " * indentation_level}#{text}"
+      
+      super(out)
+    end
+    
+    def indent(number_of_spaces = DEFAULT_NUM_SPACES_TO_INDENT)
+      @indentation_level ||= DEFAULT_INDENTATION_LEVEL
+      @indentation_level += number_of_spaces
+    end
+    
+    def outdent(number_of_spaces = DEFAULT_NUM_SPACES_TO_INDENT)
+      @indentation_level ||= DEFAULT_INDENTATION_LEVEL
+      @indentation_level -= number_of_spaces
+      raise IndentationError if @indentation_level < 0
+      @indentation_level
+    end
+    
+    def indentation_level
+      @indentation_level ||= DEFAULT_INDENTATION_LEVEL
+    end
+  end
+end

data/lib/simply/locals.rb

@@ -0,0 +1,29 @@
+module Simply
+  module Locals
+    # Pass in a hash of local variables
+    # which will be available to the template:
+    #
+    #    @builder.locals = { :foo => 1, :bar => 2, :baz => 3}
+    #    @builder.ul do
+    #      li foo
+    #      li bar
+    #      li baz
+    #    end
+    #
+    #    @builder.to_s #=> "<ul><li>1</li><li>2</li><li>3</li></ul>"
+    def locals=(hash={ })
+      def metaclass(&block)
+        meta = class << self; self; end
+        meta.instance_eval(&block)
+      end
+
+      hash.each do |key, value|
+        metaclass do
+          define_method key do
+            value
+          end
+        end
+      end
+    end
+  end
+end

data/lib/simply/version.rb

@@ -0,0 +1,12 @@
+module Simply
+  module Version
+    unless defined?(Simply::VERSION)
+      version_info = YAML.load(File.read(File.dirname(__FILE__) + "/../../VERSION.yml"))
+      
+      MAJOR   = version_info[:major]
+      MINOR   = version_info[:minor]
+      TINY    = version_info[:patch]
+      VERSION = "#{MAJOR}.#{MINOR}.#{TINY}"
+    end
+  end
+end

data/lib/simply.rb

@@ -0,0 +1,18 @@
+module Simply
+  dir = File.dirname(__FILE__) + "/simply"
+  
+  require "#{dir}/version"
+  include Version
+  
+  require "rubygems"
+  require "builder/xchar"
+  require "#{dir}/locals"
+  require "#{dir}/indentation"
+  require "#{dir}/html_tags"
+  require "#{dir}/html_builder"
+end
+
+def Simply(options={}, &block)
+  builder = Simply::HTMLBuilder.new(options, &block)
+  builder.to_s
+end

data/profiling/run_static.rb

@@ -0,0 +1,18 @@
+require File.dirname(__FILE__) + "/../lib/simply"
+
+TIMES = 1000
+
+TIMES.times do
+  Simply do
+    html do
+      head do
+        title "happy title"
+      end
+  
+      body do
+        h1 "happy heading"
+        a "a link", :href => "url"
+      end
+    end
+  end
+end