builder 3.2.0 → 3.2.1

data/doc/releases/builder-1.2.4.rdoc

@@ -0,0 +1,31 @@
+= 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

@@ -0,0 +1,46 @@
+= 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

@@ -0,0 +1,58 @@
+= 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

data/lib/builder/version.rb

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

data/rakelib/publish.rake

@@ -0,0 +1,17 @@
+# Optional publish task for Rake
+
+require 'rake/contrib/sshpublisher'
+require 'rake/contrib/rubyforgepublisher'
+
+publisher = Rake::CompositePublisher.new
+publisher.add Rake::RubyForgePublisher.new('builder', 'jimweirich')
+publisher.add Rake::SshFilePublisher.new(
+  'linode',
+  'htdocs/software/builder',
+  '.',
+  'builder.blurb')
+
+desc "Publish the Documentation to RubyForge."
+task :publish => [:rdoc] do
+  publisher.upload
+end

data/rakelib/tags.rake

@@ -0,0 +1,62 @@
+#!/usr/bin/env ruby
+
+module Tags
+  extend Rake::DSL if defined?(Rake::DSL)
+
+  PROG = ENV['TAGS'] || 'ctags'
+
+  RAKEFILES = FileList['Rakefile', '**/*.rake']
+
+  FILES = FileList['**/*.rb', '**/*.js'] + RAKEFILES
+  FILES.exclude('pkg', 'dist')
+
+  PROJECT_DIR = ['.']
+
+  RVM_GEMDIR = File.join(`rvm gemdir`.strip, "gems")
+  SYSTEM_DIRS = File.exists?(RVM_GEMDIR) ? RVM_GEMDIR : []
+
+  module_function
+
+  # Convert key_word to --key-word.
+  def keyword(key)
+    k = key.to_s.gsub(/_/, '-')
+    (k.length == 1) ? "-#{k}" : "--#{k}"
+  end
+
+  # Run ctags command
+  def run(*args)
+    opts = {
+      :e => true,
+      :totals => true,
+      :recurse => true,
+    }
+    opts = opts.merge(args.pop) if args.last.is_a?(Hash)
+    command_args = opts.map { |k, v|
+      (v == true) ? keyword(k) : "#{keyword(k)}=#{v}"
+    }.join(" ")
+    sh %{#{Tags::PROG} #{command_args} #{args.join(' ')}}
+  end
+end
+
+namespace "tags" do
+  desc "Generate an Emacs TAGS file"
+   task :emacs, [:all] => Tags::FILES do |t, args|
+    puts "Making Emacs TAGS file"
+    verbose(true) do
+      Tags.run(Tags::PROJECT_DIR)
+      Tags.run(Tags::RAKEFILES,
+        :language_force => "ruby",
+        :append => true)
+      if args.all
+        Tags::SYSTEM_DIRS.each do |dir|
+          Tags.run(dir,
+            :language_force => "ruby",
+            :append => true)
+        end
+      end
+    end
+  end
+end
+
+desc "Generate the TAGS file"
+task :tags, [:all] => ["tags:emacs"]

metadata

@@ -1,38 +1,40 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: builder
-version: !ruby/object:Gem::Version 
-  hash: 15
+version: !ruby/object:Gem::Version
+  version: 3.2.1
   prerelease: 
-  segments: 
-  - 3
-  - 2
-  - 0
-  version: 3.2.0
 platform: ruby
-authors: 
+authors:
 - Jim Weirich
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2013-02-23 00:00:00 Z
+date: 2013-05-30 00:00:00.000000000 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: []
-
-files: 
+files:
+- CHANGES
+- MIT-LICENSE
+- README.md
+- Rakefile
+- doc/jamis.rb
+- doc/releases/builder-1.2.4.rdoc
+- doc/releases/builder-2.0.0.rdoc
+- doc/releases/builder-2.1.1.rdoc
 - lib/blankslate.rb
 - lib/builder.rb
 - lib/builder/blankslate.rb
@@ -49,44 +51,39 @@ files:
 - test/test_method_caching.rb
 - test/test_namecollision.rb
 - test/test_xchar.rb
+- rakelib/publish.rake
+- rakelib/tags.rake
 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 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      hash: 3
-      segments: 
-      - 0
-      version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      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