builder 3.1.4 → 3.2.0

data/lib/builder/version.rb

@@ -1,8 +1,8 @@
 module Builder
   VERSION_NUMBERS = [
     VERSION_MAJOR = 3,
-    VERSION_MINOR = 1,
-    VERSION_BUILD = 4,
+    VERSION_MINOR = 2,
+    VERSION_BUILD = 0,
   ]
   VERSION = VERSION_NUMBERS.join(".")
 end

data/lib/builder/xmlbase.rb

@@ -31,6 +31,10 @@ module Builder
       @encoding = encoding.downcase
     end
 
+    def explicit_nil_handling?
+      @explicit_nil_handling
+    end
+
     # Create a tag named +sym+.  Other than the first argument which
     # is the tag name, the arguments are the same as the tags
     # implemented via <tt>method_missing</tt>.
@@ -45,7 +49,8 @@ module Builder
           attrs ||= {}
           attrs.merge!(arg)
         when nil
-          # do nothing
+          attrs ||= {}
+          attrs.merge!({:nil => true}) if explicit_nil_handling?
         else
           text ||= ''
           text << arg.to_s
@@ -180,8 +185,10 @@ module Builder
     # significantly.
     def cache_method_call(sym)
       class << self; self; end.class_eval do
-        define_method(sym) do |*args, &block|
-          tag!(sym, *args, &block)
+        unless method_defined?(sym)
+          define_method(sym) do |*args, &block|
+            tag!(sym, *args, &block)
+          end
         end
       end
     end

data/lib/builder/xmlmarkup.rb

@@ -47,7 +47,7 @@ module Builder
   # == Notes:
   #
   # * The order that attributes are inserted in markup tags is
-  #   undefined. 
+  #   undefined.
   #
   # * Sometimes you wish to insert text without enclosing tags.  Use
   #   the <tt>text!</tt> method to accomplish this.
@@ -78,7 +78,7 @@ module Builder
   #   <tt>tag!</tt> will also take text and attribute arguments (after
   #   the tag name) like normal markup methods.  (But see the next
   #   bullet item for a better way to handle XML namespaces).
-  #   
+  #
   # * Direct support for XML namespaces is now available.  If the
   #   first argument to a tag call is a symbol, it will be joined to
   #   the tag to produce a namespace:tag combination.  It is easier to
@@ -93,7 +93,7 @@ module Builder
   # * XmlMarkup builds the markup in any object (called a _target_)
   #   that accepts the <tt><<</tt> method.  If no target is given,
   #   then XmlMarkup defaults to a string target.
-  # 
+  #
   #   Examples:
   #
   #     xm = Builder::XmlMarkup.new
@@ -110,7 +110,7 @@ module Builder
   #     xm = Builder::XmlMarkup.new
   #     x2 = Builder::XmlMarkup.new(:target=>xm)
   #     # Markup written to +x2+ will be send to +xm+.
-  #   
+  #
   # * Indentation is enabled by providing the number of spaces to
   #   indent for each level as a second argument to XmlBuilder.new.
   #   Initial indentation may be specified using a third parameter.
@@ -119,7 +119,7 @@ module Builder
   #
   #     xm = Builder.new(:indent=>2)
   #     # xm will produce nicely formatted and indented XML.
-  #  
+  #
   #     xm = Builder.new(:indent=>2, :margin=>4)
   #     # xm will produce nicely formatted and indented XML with 2
   #     # spaces per indent and an over all indentation level of 4.
@@ -162,34 +162,39 @@ module Builder
     # Create an XML markup builder.  Parameters are specified by an
     # option hash.
     #
-    # :target=><em>target_object</em>::
+    # :target => <em>target_object</em>::
     #    Object receiving the markup.  +target_object+ must respond to
     #    the <tt><<(<em>a_string</em>)</tt> operator and return
     #    itself.  The default target is a plain string target.
-    #    
-    # :indent=><em>indentation</em>::
+    #
+    # :indent => <em>indentation</em>::
     #    Number of spaces used for indentation.  The default is no
     #    indentation and no line breaks.
-    #    
-    # :margin=><em>initial_indentation_level</em>::
+    #
+    # :margin => <em>initial_indentation_level</em>::
     #    Amount of initial indentation (specified in levels, not
     #    spaces).
-    #    
-    # :escape_attrs=><em>OBSOLETE</em>::
+    #
+    # :quote => <em>:single</em>::
+    #    Use single quotes for attributes rather than double quotes.
+    #
+    # :escape_attrs => <em>OBSOLETE</em>::
     #    The :escape_attrs option is no longer supported by builder
     #    (and will be quietly ignored).  String attribute values are
     #    now automatically escaped.  If you need unescaped attribute
     #    values (perhaps you are using entities in the attribute
     #    values), then give the value as a Symbol.  This allows much
     #    finer control over escaping attribute values.
-    #    
+    #
     def initialize(options={})
       indent = options[:indent] || 0
       margin = options[:margin] || 0
+      @quote = (options[:quote] == :single) ? "'" : '"'
+      @explicit_nil_handling = options[:explicit_nil_handling]
       super(indent, margin)
       @target = options[:target] || ""
     end
-    
+
     # Return the target of the builder.
     def target!
       @target
@@ -265,7 +270,7 @@ module Builder
       _ensure_no_block ::Kernel::block_given?
       _special("<![CDATA[", "]]>", text.gsub(']]>', ']]]]><![CDATA[>'), nil)
     end
-    
+
     private
 
     # NOTE: All private methods of a builder object are prefixed when
@@ -275,8 +280,8 @@ module Builder
     def _text(text)
       @target << text
     end
-    
-    # Insert special instruction. 
+
+    # Insert special instruction.
     def _special(open, close, data=nil, attrs=nil, order=[])
       _indent
       @target << open
@@ -294,7 +299,7 @@ module Builder
       @target << "/" if end_too
       @target << ">"
     end
-    
+
     # Insert an ending tag.
     def _end_tag(sym)
       @target << "</#{sym}>"
@@ -305,10 +310,10 @@ module Builder
       return if attrs.nil?
       order.each do |k|
         v = attrs[k]
-        @target << %{ #{k}="#{_attr_value(v)}"} if v # " WART
+        @target << %{ #{k}=#{@quote}#{_attr_value(v)}#{@quote}} if v
       end
       attrs.each do |k, v|
-        @target << %{ #{k}="#{_attr_value(v)}"} unless order.member?(k) # " WART
+        @target << %{ #{k}=#{@quote}#{_attr_value(v)}#{@quote}} unless order.member?(k) # " WART
       end
     end
 

data/test/performance.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
+# encoding: iso-8859-1
 
 #--
 # Portions copyright 2004 by Jim Weirich (jim@weirichhouse.org).
@@ -13,7 +14,7 @@
 require 'builder/xmlmarkup'
 require 'benchmark'
 
-text = "This is a test of the new xml markup. I�t�rn�ti�n�liz�ti�n\n" * 10000
+text = "This is a test of the new xml markup. I�t�rn�ti�n�liz�ti�n\n" * 10000
 
 include Benchmark          # we need the CAPTION and FMTSTR constants
 include Builder

data/test/test_markupbuilder.rb

@@ -59,23 +59,38 @@ class TestMarkup < Test::Unit::TestCase
     assert_equal %{<ref id="12"/>}, @xml.target!
   end
 
-  def test_string_attributes_are_quoted_by_default
+  def test_single_quotes_for_attrs
+    @xml = Builder::XmlMarkup.new(:quote => :single)
+    @xml.ref(:id => 12)
+    assert_equal %{<ref id='12'/>}, @xml.target!
+  end
+
+  def test_mixed_quotes_for_attrs
+    @xml = Builder::XmlMarkup.new(:quote => :single)
+    x = Builder::XmlMarkup.new(:target=>@xml, :quote => :double)
+    @xml.ref(:id => 12) do
+      x.link(:id => 13)
+    end
+    assert_equal %{<ref id='12'><link id="13"/></ref>}, @xml.target!
+  end
+
+  def test_string_attributes_are_escaped_by_default
     @xml.ref(:id => "H&R")
     assert_equal %{<ref id="H&amp;R"/>}, @xml.target!
   end
 
-  def test_symbol_attributes_are_unquoted_by_default
+ def test_symbol_attributes_are_unescaped_by_default
     @xml.ref(:id => :"H&amp;R")
     assert_equal %{<ref id="H&amp;R"/>}, @xml.target!
   end
 
-  def test_attributes_quoted_can_be_turned_on
+  def test_attributes_escaping_can_be_turned_on
     @xml = Builder::XmlMarkup.new
     @xml.ref(:id => "<H&R \"block\">")
     assert_equal %{<ref id="&lt;H&amp;R &quot;block&quot;&gt;"/>}, @xml.target!
   end
 
-  def test_mixed_attribute_quoting_with_nested_builders
+  def test_mixed_attribute_escaping_with_nested_builders
     x = Builder::XmlMarkup.new(:target=>@xml)
     @xml.ref(:id=>:"H&amp;R") {
       x.element(:tag=>"Long&Short")
@@ -156,6 +171,24 @@ class TestMarkup < Test::Unit::TestCase
     assert_equal %{<div>&lt;hi&gt;<em>H&amp;R Block</em></div>}, @xml.target!
   end
 
+  def test_nil
+    b = Builder::XmlMarkup.new
+    b.tag! "foo", nil
+    assert_equal %{<foo/>}, b.target!
+  end
+
+  def test_nil_without_explicit_nil_handling
+    b = Builder::XmlMarkup.new(:explicit_nil_handling => false)
+    b.tag! "foo", nil
+    assert_equal %{<foo/>}, b.target!
+  end
+
+  def test_nil_with_explicit_nil_handling
+    b = Builder::XmlMarkup.new(:explicit_nil_handling => true)
+    b.tag! "foo", nil
+    assert_equal %{<foo nil="true"/>}, b.target!
+  end
+
   def test_non_escaping
     @xml.div("ns:xml"=>:"&xml;") { |x| x << "<h&i>"; x.em("H&R Block") }
     assert_equal %{<div ns:xml="&xml;"><h&i><em>H&amp;R Block</em></div>}, @xml.target!

data/test/test_method_caching.rb

@@ -54,7 +54,7 @@ class TestMethodCaching < Test::Unit::TestCase
     def xml.method_missing(*args)
       ::Kernel.fail StandardError, "SHOULD BE CALLED"
     end
-    assert_raise(StandardError, /SHOULD BE CALLED/) do
+    assert_raise(StandardError, "SHOULD BE CALLED") do
       xml.do_not_cache_me
     end
   end

data/test/test_xchar.rb

@@ -1,4 +1,5 @@
 #!/usr/bin/env ruby
+# encoding: us-ascii
 
 #--
 # Portions copyright 2004 by Jim Weirich (jim@weirichhouse.org).
@@ -67,7 +68,7 @@ class TestXmlEscaping < Test::Unit::TestCase
     assert_equal '&#8217;', "\xE2\x80\x99".to_xs # right single quote
     assert_equal '&#169;',  "\xC2\xA9".to_xs     # copy
   end
- 
+
   def test_utf8_verbatim
     assert_equal "\xE2\x80\x99", "\xE2\x80\x99".to_xs(false)  # right single quote
     assert_equal "\xC2\xA9",  "\xC2\xA9".to_xs(false)         # copy

metadata

@@ -1,47 +1,46 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: builder
-version: !ruby/object:Gem::Version
-  version: 3.1.4
+version: !ruby/object:Gem::Version 
+  hash: 15
   prerelease: 
+  segments: 
+  - 3
+  - 2
+  - 0
+  version: 3.2.0
 platform: ruby
-authors:
+authors: 
 - Jim Weirich
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-10-16 00:00:00.000000000 Z
+
+date: 2013-02-23 00:00:00 Z
 dependencies: []
-description: ! 'Builder provides a number of builder objects that make creating structured
-  data
 
+description: |
+  Builder provides a number of builder objects that make creating structured data
   simple to do.  Currently the following builder objects are supported:
-
-
+  
   * XML Markup
-
   * XML Events
 
-'
 email: jim.weirich@gmail.com
 executables: []
+
 extensions: []
-extra_rdoc_files:
-- CHANGES
-- MIT-LICENSE
-- Rakefile
-- README.rdoc
-- doc/releases/builder-1.2.4.rdoc
-- doc/releases/builder-2.0.0.rdoc
-- doc/releases/builder-2.1.1.rdoc
-files:
+
+extra_rdoc_files: []
+
+files: 
 - lib/blankslate.rb
+- lib/builder.rb
 - lib/builder/blankslate.rb
 - lib/builder/version.rb
 - lib/builder/xchar.rb
 - lib/builder/xmlbase.rb
 - lib/builder/xmlevents.rb
 - lib/builder/xmlmarkup.rb
-- lib/builder.rb
 - test/performance.rb
 - test/preload.rb
 - test/test_blankslate.rb
@@ -50,44 +49,44 @@ files:
 - test/test_method_caching.rb
 - test/test_namecollision.rb
 - test/test_xchar.rb
-- CHANGES
-- MIT-LICENSE
-- Rakefile
-- README.rdoc
-- doc/releases/builder-1.2.4.rdoc
-- doc/releases/builder-2.0.0.rdoc
-- doc/releases/builder-2.1.1.rdoc
 homepage: http://onestepback.org
-licenses:
+licenses: 
 - MIT
 post_install_message: 
-rdoc_options:
+rdoc_options: 
 - --title
 - Builder -- Easy XML Building
 - --main
 - README.rdoc
 - --line-numbers
-require_paths:
+require_paths: 
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
 requirements: []
+
 rubyforge_project: 
 rubygems_version: 1.8.24
 signing_key: 
 specification_version: 3
 summary: Builders for MarkUp.
-test_files:
+test_files: 
 - test/test_blankslate.rb
 - test/test_eventbuilder.rb
 - test/test_markupbuilder.rb

data/CHANGES

@@ -1,101 +0,0 @@
-= Change Log
-
-== Version 3.1.0
-
-* Included the to_xs arity patch needed for weird Rails compatibility
-  issue.
-
-* Escaping newlines in attributes now.
-
-* Allow method caching
-
-== Version 3.0.0
-
-* Ruby 1.9 compatiblity issues.
-
-== Version 2.2.0
-
-* Applied patch from Thijs van der Vossen to allow UTF-8 encoded
-  output when the encoding is UTF-8 and $KCODE is UTF8.
-
-== Version 2.1.2
-
-* Fixed bug where private methods in kernel could leak through using
-  tag!().  Thanks to Hagen Overdick for finding and diagnosing this
-  bug.
-
-== Version 2.1.1
-
-* Fixed typo in XmlMarkup class docs (ident => indent). (from Martin
-  Fowler).
-* Removed extra directory indirection from legacy CVS to SVN move.
-* Removed some extraneous tabs from source.
-* Fixed test on private methods in blankslate to differentiate between
-  targetted and untargetted private methods.
-* Removed legacy capture of @self in XmlBase (@self was used back when
-  we used instance eval).
-* Added additional tests for global functions (both direct and included).
-
-== Version 2.1.0
-
-* Fixed bug in BlankSlate where including a module into Object could
-  cause methods to leak into BlankSlate.
-* Made BlankSlate available as its own gem.  Currently the builder gem
-  still directly includes the BlankSlate code.
-* Added reveal capability to BlankSlate.
-
-== Version 2.0.0
-
-* Added doc directory
-* Added unit tests for XmlEvents.
-* Added XChar module and used it in the _escape method.
-* Attributes are now quoted by default when strings.  Use Symbol
-  attribute values for unquoted behavior.
-
-== Version 1.2.4
-
-* Added a cdata! command to an XML Builder (from Josh Knowles).
-
-== Version 1.2.3
-
-The attributes in the <?xml ... ?> instruction will be ordered:
-version, encoding, standalone.
-
-== Version 1.2.2
-
-Another fix for BlankSlate.  The Kernal/Object traps added in 1.2.1
-failed when a method was defined late more than once.  Since the
-method was already marked as removed, another attempt to undefine it
-raised an error.  The fix was to check the list of instance methods
-before attempting the undef operation.  Thanks to Florian Gross and
-David Heinemeier Hansson for the patch.
-
-== Version 1.2.1
-
-BlankSlate now traps method definitions in Kernel and Object to avoid
-late method definitions inadvertently becoming part of the definition
-of BlankSlate as well.
-
-== Version 1.2.0
-
-Improved support for entity declarations by allowing nested
-declarations and removal of the attribute processing.
-
-Added namespace support.
-
-== Version 1.1.0
-
-Added support for comments, entity declarations and processing instructions.
-
-== Version 1.0.0
-
-Removed use of <tt>instace_eval</tt> making the use of XmlMarkup much
-less prone to error.
-
-== Version 0.1.1
-
-Bug fix.
-
-== Version 0.1.0
-
-Initial version release.

data/MIT-LICENSE

@@ -1,20 +0,0 @@
-Copyright (c) 2003-2012 Jim Weirich (jim.weirich@gmail.com)
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-"Software"), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
-NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
-LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
-OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
-WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -1,225 +0,0 @@
-# coding: UTF-8
-= Project: Builder
-
-== Goal
-
-Provide a simple way to create XML markup and data structures.
-
-== Classes
-
-Builder::XmlMarkup:: Generate XML markup notiation
-Builder::XmlEvents:: Generate XML events (i.e. SAX-like)
-
-<b>Notes</b>::
-
-* An <tt>Builder::XmlTree</tt> class to generate XML tree
-  (i.e. DOM-like) structures is also planned, but not yet implemented.
-  Also, the events builder is currently lagging the markup builder in
-  features.
-
-== Usage
-
-  require 'rubygems'
-  require_gem 'builder', '~> 2.0'
-
-  builder = Builder::XmlMarkup.new
-  xml = builder.person { |b| b.name("Jim"); b.phone("555-1234") }
-  xml #=> <person><name>Jim</name><phone>555-1234</phone></person>
-
-or
-
-  require 'rubygems'
-  require_gem 'builder'
-
-  builder = Builder::XmlMarkup.new(:target=>STDOUT, :indent=>2)
-  builder.person { |b| b.name("Jim"); b.phone("555-1234") }
-  #
-  # Prints:
-  # <person>
-  #   <name>Jim</name>
-  #   <phone>555-1234</phone>
-  # </person>
-
-== Compatibility
-
-=== Version 2.0.0 Compatibility Changes
-
-Version 2.0.0 introduces automatically escaped attribute values for
-the first time.  Versions prior to 2.0.0 did not insert escape
-characters into attribute values in the XML markup.  This allowed
-attribute values to explicitly reference entities, which was
-occasionally used by a small number of developers.  Since strings
-could always be explicitly escaped by hand, this was not a major
-restriction in functionality.
-
-However, it did suprise most users of builder.  Since the body text is
-normally escaped, everybody expected the attribute values to be
-escaped as well.  Escaped attribute values were the number one support
-request on the 1.x Builder series.
-
-Starting with Builder version 2.0.0, all attribute values expressed as
-strings will be processed and the appropriate characters will be
-escaped (e.g. "&" will be tranlated to "&amp;").  Attribute values
-that are expressed as Symbol values will not be processed for escaped
-characters and will be unchanged in output. (Yes, this probably counts
-as Symbol abuse, but the convention is convenient and flexible).
-
-Example:
-
-  xml = Builder::XmlMarkup.new
-  xml.sample(:escaped=>"This&That", :unescaped=>:"Here&amp;There")
-  xml.target!  =>
-    <sample escaped="This&amp;That" unescaped="Here&amp;There"/>
-
-=== Version 1.0.0 Compatibility Changes
-
-Version 1.0.0 introduces some changes that are not backwards
-compatible with earlier releases of builder.  The main areas of
-incompatibility are:
-
-* Keyword based arguments to +new+ (rather than positional based).  It
-  was found that a developer would often like to specify indentation
-  without providing an explicit target, or specify a target without
-  indentation.  Keyword based arguments handle this situation nicely.
-
-* Builder must now be an explicit target for markup tags.  Instead of
-  writing
-
-    xml_markup = Builder::XmlMarkup.new
-    xml_markup.div { strong("text") }
-
-  you need to write
-
-    xml_markup = Builder::XmlMarkup.new
-    xml_markup.div { xml_markup.strong("text") }
-
-* The builder object is passed as a parameter to all nested markup
-  blocks.  This allows you to create a short alias for the builder
-  object that can be used within the block.  For example, the previous
-  example can be written as:
-
-    xml_markup = Builder::XmlMarkup.new
-    xml_markup.div { |xml| xml.strong("text") }
-
-* If you have both a pre-1.0 and a post-1.0 gem of builder installed,
-  you can choose which version to use through the RubyGems
-  +require_gem+ facility.
-
-    require_gem 'builder', "~> 0.0"   # Gets the old version
-    require_gem 'builder', "~> 1.0"   # Gets the new version
-
-== Features
-
-* XML Comments are supported ...
-
-    xml_markup.comment! "This is a comment"
-      #=>  <!-- This is a comment -->
-
-* XML processing instructions are supported ...
-
-    xml_markup.instruct! :xml, :version=>"1.0", :encoding=>"UTF-8"
-      #=>  <?xml version="1.0" encoding="UTF-8"?>
-
-  If the processing instruction is omitted, it defaults to "xml".
-  When the processing instruction is "xml", the defaults attributes
-  are:
-
-  <b>version</b>:: 1.0
-  <b>encoding</b>:: "UTF-8"
-
-  (NOTE: if the encoding is set to "UTF-8" and $KCODE is set to
-  "UTF8", then Builder will emit UTF-8 encoded strings rather than
-  encoding non-ASCII characters as entities.)
-
-* XML entity declarations are now supported to a small degree.
-
-    xml_markup.declare! :DOCTYPE, :chapter, :SYSTEM, "../dtds/chapter.dtd"
-      #=>  <!DOCTYPE chapter SYSTEM "../dtds/chapter.dtd">
-
-  The parameters to a declare! method must be either symbols or
-  strings. Symbols are inserted without quotes, and strings are
-  inserted with double quotes.  Attribute-like arguments in hashes are
-  not allowed.
-
-  If you need to have an argument to declare! be inserted without
-  quotes, but the arguement does not conform to the typical Ruby
-  syntax for symbols, then use the :"string" form to specify a symbol.
-
-  For example:
-
-    xml_markup.declare! :ELEMENT, :chapter, :"(title,para+)"
-      #=>  <!ELEMENT chapter (title,para+)>
-
-  Nested entity declarations are allowed.  For example:
-
-    @xml_markup.declare! :DOCTYPE, :chapter do |x|
-      x.declare! :ELEMENT, :chapter, :"(title,para+)"
-      x.declare! :ELEMENT, :title, :"(#PCDATA)"
-      x.declare! :ELEMENT, :para, :"(#PCDATA)"
-    end
-
-    #=>
-
-    <!DOCTYPE chapter [
-      <!ELEMENT chapter (title,para+)>
-      <!ELEMENT title (#PCDATA)>
-      <!ELEMENT para (#PCDATA)>
-    ]>
-
-* Some support for XML namespaces is now available.  If the first
-  argument to a tag call is a symbol, it will be joined to the tag to
-  produce a namespace:tag combination.  It is easier to show this than
-  describe it.
-
-   xml.SOAP :Envelope do ... end
-
-  Just put a space before the colon in a namespace to produce the
-  right form for builder (e.g. "<tt>SOAP:Envelope</tt>" =>
-  "<tt>xml.SOAP :Envelope</tt>")
-
-* String attribute values are <em>now</em> escaped by default by
-  Builder (<b>NOTE:</b> this is _new_ behavior as of version 2.0).
-
-  However, occasionally you need to use entities in attribute values.
-  Using a symbols (rather than a string) for an attribute value will
-  cause Builder to not run its quoting/escaping algorithm on that
-  particular value.
-
-  (<b>Note:</b> The +escape_attrs+ option for builder is now
-  obsolete).
-
-  Example:
-
-    xml = Builder::XmlMarkup.new
-    xml.sample(:escaped=>"This&That", :unescaped=>:"Here&amp;There")
-    xml.target!  =>
-      <sample escaped="This&amp;That" unescaped="Here&amp;There"/>
-
-* UTF-8 Support
-
-  Builder correctly translates UTF-8 characters into valid XML.  (New
-  in version 2.0.0).  Thanks to Sam Ruby for the translation code.
-
-  You can get UTF-8 encoded output by making sure that the XML
-  encoding is set to "UTF-8" and that the $KCODE variable is set to
-  "UTF8".
-
-    $KCODE = 'UTF8'
-    xml = Builder::Markup.new
-    xml.instruct!(:xml, :encoding => "UTF-8")
-    xml.sample("Iñtërnâtiônàl")
-    xml.target!  =>
-      "<sample>Iñtërnâtiônàl</sample>"
-
-== Links
-
-Documents           :: http://builder.rubyforge.org/
-Github Clone        :: git://github.com/jimweirich/builder.git
-Issue / Bug Reports :: https://github.com/jimweirich/builder/issues?state=open
-
-== Contact
-
-Author::         Jim Weirich
-Email::          jim.weirich@gmail.com
-Home Page::      http://onestepback.org
-License::        MIT Licence (http://www.opensource.org/licenses/mit-license.html)

data/Rakefile

@@ -1,189 +0,0 @@
-# Rakefile for rake        -*- ruby -*-
-
-# Copyright 2004, 2005, 2006 by Jim Weirich (jim@weirichhouse.org).
-# All rights reserved.
-
-# Permission is granted for use, copying, modification, distribution,
-# and distribution of modified versions of this work as long as the
-# above copyright notice is included.
-
-require 'rake/clean'
-require 'rake/testtask'
-require 'rdoc/task'
-begin
-  require 'rubygems'
-  require 'rubygems/package_task'
-rescue Exception
-  nil
-end
-
-require './lib/builder/version'
-
-# Determine the current version of the software
-
-CLOBBER.include('pkg')
-CLEAN.include('pkg/builder-*').include('pkg/blankslate-*').exclude('pkg/*.gem')
-
-PKG_VERSION = Builder::VERSION
-
-SRC_RB = FileList['lib/**/*.rb']
-
-# The default task is run if rake is given no explicit arguments.
-
-desc "Default Task"
-task :default => :test_all
-
-# Test Tasks ---------------------------------------------------------
-
-desc "Run all tests"
-task :test_all => [:test_units]
-task :ta => [:test_all]
-
-task :tu => [:test_units]
-
-Rake::TestTask.new("test_units") do |t|
-  t.test_files = FileList['test/test*.rb']
-  t.libs << "."
-  t.verbose = false
-end
-
-# Create a task to build the RDOC documentation tree.
-
-rd = RDoc::Task.new("rdoc") { |rdoc|
-  rdoc.rdoc_dir = 'html'
-  rdoc.title    = "Builder for Markup"
-  rdoc.options << '--line-numbers' << '--inline-source' << '--main' << 'README.rdoc'
-  rdoc.rdoc_files.include('lib/**/*.rb', '[A-Z]*', 'doc/**/*.rdoc').exclude("TAGS")
-  rdoc.template = 'doc/jamis.rb'
-}
-
-# ====================================================================
-# Create a task that will package the Rake software into distributable
-# gem files.
-
-PKG_FILES = FileList[
-  'lib/**/*.rb',
-  'test/**/*.rb',
-  'scripts/**/*.rb'
-]
-PKG_FILES.exclude('test/test_cssbuilder.rb')
-PKG_FILES.exclude('lib/builder/css.rb')
-PKG_FILES.exclude('TAGS')
-
-BLANKSLATE_FILES = FileList[
-  'lib/blankslate.rb',
-  'test/test_blankslate.rb'
-]
-
-if ! defined?(Gem)
-  puts "Package Target requires RubyGEMs"
-else
-  spec = Gem::Specification.new do |s|
-
-    #### Basic information.
-
-    s.name = 'builder'
-    s.version = PKG_VERSION
-    s.summary = "Builders for MarkUp."
-    s.description = %{\
-Builder provides a number of builder objects that make creating structured data
-simple to do.  Currently the following builder objects are supported:
-
-* XML Markup
-* XML Events
-}
-
-    s.files = PKG_FILES.to_a
-    s.require_path = 'lib'
-
-    s.test_files = PKG_FILES.select { |fn| fn =~ /^test\/test/ }
-
-    s.has_rdoc = true
-    s.extra_rdoc_files = rd.rdoc_files.reject { |fn| fn =~ /\.rb$/ }.to_a
-    s.rdoc_options <<
-      '--title' <<  'Builder -- Easy XML Building' <<
-      '--main' << 'README.rdoc' <<
-      '--line-numbers'
-
-    s.author = "Jim Weirich"
-    s.email = "jim.weirich@gmail.com"
-    s.homepage = "http://onestepback.org"
-    s.license = 'MIT'
-  end
-
-  blankslate_spec = Gem::Specification.new do |s|
-
-    #### Basic information.
-
-    s.name = 'blankslate'
-    s.version = PKG_VERSION
-    s.summary = "Blank Slate base class."
-    s.description = %{\
-BlankSlate provides a base class where almost all of the methods from Object and
-Kernel have been removed.  This is useful when providing proxy object and other
-classes that make heavy use of method_missing.
-}
-
-    s.files = BLANKSLATE_FILES.to_a
-    s.require_path = 'lib'
-
-    s.test_files = PKG_FILES.select { |fn| fn =~ /^test\/test/ }
-
-    s.has_rdoc = true
-    s.extra_rdoc_files = rd.rdoc_files.reject { |fn| fn =~ /\.rb$/ }.to_a
-    s.rdoc_options <<
-      '--title' <<  'BlankSlate -- Base Class for building proxies.' <<
-      '--main' << 'README.rdoc' <<
-      '--line-numbers'
-
-    s.author = "Jim Weirich"
-    s.email = "jim.weirich@gmail.com"
-    s.homepage = "http://onestepback.org"
-    s.license = 'MIT'
-  end
-
-  namespace 'builder' do
-    Gem::PackageTask.new(spec) do |t|
-      t.need_tar = false
-    end
-  end
-
-  namespace 'blankslate' do
-    Gem::PackageTask.new(blankslate_spec) do |t|
-      t.need_tar = false
-    end
-  end
-
-  task :package => [:remove_tags, 'builder:package', 'blankslate:package']
-end
-
-task :remove_tags do
-  rm "TAGS" rescue nil
-end
-
-# RCov ---------------------------------------------------------------
-begin
-  require 'rcov/rcovtask'
-
-  Rcov::RcovTask.new do |t|
-    t.libs << "test"
-    t.rcov_opts = [
-      '-xRakefile', '--text-report'
-    ]
-    t.test_files = FileList[
-      'test/test*.rb'
-    ]
-    t.output_dir = 'coverage'
-    t.verbose = true
-  end
-rescue LoadError
-  # No rcov available
-end
-
-desc "Install the jamis RDoc template"
-task :install_jamis_template do
-  require 'rbconfig'
-  dest_dir = File.join(Config::CONFIG['rubylibdir'], "rdoc/generators/template/html")
-  fail "Unabled to write to #{dest_dir}" unless File.writable?(dest_dir)
-  install "doc/jamis.rb", dest_dir, :verbose => true
-end

data/doc/releases/builder-1.2.4.rdoc

@@ -1,31 +0,0 @@
-= Builder 1.2.4 Released.
-
-Added a "CDATA" method to the XML Markup builder (from Josh Knowles).
-
-== What is Builder?
-
-Builder::XmlMarkup allows easy programmatic creation of XML markup.
-For example:
-
-  builder = Builder::XmlMarkup.new(:target=>STDOUT, :indent=>2)
-  builder.person { |b| b.name("Jim"); b.phone("555-1234") }
-  puts builder.target!
-
-will generate:
-
-  <person>
-    <name>Jim</name>
-    <phone>555-1234</phone>
-  </person>
-
-== Availability
-
-The easiest way to get and install builder is via RubyGems ...
-
-  gem install builder    (you may need root/admin privileges)
-
-== Thanks
-
-* Josh Knowles for the cdata! patch.
-
--- Jim Weirich

data/doc/releases/builder-2.0.0.rdoc

@@ -1,46 +0,0 @@
-= Builder 2.0.0 Released.
-
-== Changes in 2.0.0
-
-* UTF-8 characters in data are now correctly translated to their XML
-  equivalents. (Thanks to Sam Ruby)
-
-* Attribute values are now escaped by default.  See the README
-  file for details.
-
-<b>NOTE:</b> The escaping attribute values by default is different
-than in previous releases of Builder.  This makes version 2.0.0
-somewhat incompatible with the 1.x series of Builder.  If you use "&",
-"<", or ">" in attributes values, you may have to change your
-code. (Essentially you remove the manual escaping.  The new way is
-easier, believe me).
-
-== What is Builder?
-
-Builder::XmlMarkup is a library that allows easy programmatic creation
-of XML markup.  For example:
-
-  builder = Builder::XmlMarkup.new(:target=>STDOUT, :indent=>2)
-  builder.person { |b| b.name("Jim"); b.phone("555-1234") }
-
-will generate:
-
-  <person>
-    <name>Jim</name>
-    <phone>555-1234</phone>
-  </person>
-
-== Availability
-
-The easiest way to get and install builder is via RubyGems ...
-
-  gem install builder    (you may need root/admin privileges)
-
-== Thanks
-
-* Sam Ruby for the XChar module and the related UTF-8 translation
-  tools.
-* Also to Sam Ruby for gently persuading me to start quoting attribute
-  values.
-
--- Jim Weirich

data/doc/releases/builder-2.1.1.rdoc

@@ -1,58 +0,0 @@
-= Builder 2.1.1 Released.
-
-Release 2.1.1 of Builder is mainly a bug fix release.
-
-== Changes in 2.1.1
-
-* Added <tt>reveal</tt> capability to BlankSlate.
-
-* Fixed a bug in BlankSlate where including a module into Object could
-  cause methods to leak into BlankSlate.
-
-* Fixed typo in XmlMarkup class docs (from Martin Fowler).
-
-* Fixed test on private methods to differentiate between targetted and
-  untargetted private methods.
-
-* Removed legacy capture of @self in XmlBase (@self was used back when
-  we used instance eval).
-
-* Added additional tests for global functions (both direct and
-  included).
-
-* Several misc internal cleanups, including rearranging the source
-  code tree.
-
-<b>NOTE:</b> The escaping attribute values by default is different
-than in previous releases of Builder.  This makes version 2.0.x
-somewhat incompatible with the 1.x series of Builder.  If you use "&",
-"<", or ">" in attributes values, you may have to change your
-code. (Essentially you remove the manual escaping.  The new way is
-easier, believe me).
-
-== What is Builder?
-
-Builder::XmlMarkup is a library that allows easy programmatic creation
-of XML markup.  For example:
-
-  builder = Builder::XmlMarkup.new(:target=>STDOUT, :indent=>2)
-  builder.person { |b| b.name("Jim"); b.phone("555-1234") }
-
-will generate:
-
-  <person>
-    <name>Jim</name>
-    <phone>555-1234</phone>
-  </person>
-
-== Availability
-
-The easiest way to get and install builder is via RubyGems ...
-
-  gem install builder    (you may need root/admin privileges)
-
-== Thanks
-
-* Martin Fowler for spotting some typos in the documentation.
-
--- Jim Weirich