tagz 5.0.1 → 6.0.0

data/readme.erb

@@ -0,0 +1,154 @@
+NAME
+
+  tagz.rb
+
+SYNOPSIS
+
+  require Tagz
+
+  include Tagz.globally
+
+  a_(:href => "/foo"){ "bar" }  #=>  <a href="/foo">bar</a> 
+
+DESCRIPTION
+
+  tagz.rb is generates html, xml, or any sgml variant like a small ninja
+  running across the backs of a herd of giraffes swatting of heads like a
+  mark-up weedwacker.  weighing in at less than 300 lines of code tagz.rb adds
+  an html/xml/sgml syntax to ruby that is both unobtrusive, safe, and available
+  globally to objects without the need for any builder or superfluous objects.
+  tagz.rb is designed for applications that generate html to be able to do so
+  easily in any context without heavyweight syntax or scoping issues, like a
+  ninja sword through butter.
+
+FEATURES
+
+  - use as a library or mixin
+
+  - simple, clean and consistent mark-up that is easy to visually
+    distinguish from other ruby methods
+
+  - auto-compatibility with rails/actionview
+
+  - ability to independently open and close tagz in markup
+
+  - intelligent auto-escaping of both attributes and content for both html
+    and xml
+
+  - validate your html/xml with 'ruby -c' syntax check
+
+  - generally bitchin
+
+  - no lame method_missing approach that prevents tagz like 'type' from being
+    generated
+
+RAILS
+  
+  in config/environment.rb
+
+    require 'tagz'
+
+  in a helper
+
+    def list_of_users
+      ul_(:class => 'users'){
+        @users.each{|user| li_{ user }}
+      }
+    end
+
+  in a view
+
+    table_{ 
+      rows.each do |row|
+        tr_{
+          row.each do |cell|
+            td_{ cell }
+          end
+        }
+      end
+    }
+
+  in a controller
+
+    def ajax_responder
+      text =
+        tagz{
+          table_{ 
+            rows.each do |row|
+              tr_{
+                row.each do |cell|
+                  td_{ cell }
+                end
+              }
+            end
+          }
+        }
+
+      render :text => text
+    end
+
+INSTALL
+
+  gem install tagz
+
+URIS
+
+  http://github.com/ahoward/tagz/tree/master
+  http://rubyforge.org/projects/codeforpeople
+
+HISTORY
+  6.0.0 
+    - reorganize lib to avoid dumping a few constants into the includee - aka
+    don't absolutely minimize namespace pollution. there is now reason to
+    thing this version shouldn't be backwards compat - i bumped the version
+    just in case
+
+  5.1.0
+    - attribute/content auto-escaping can be turned off with
+
+        Tagz.i_know_what_the_hell_i_am_doing!
+
+      and turned back on with
+
+        Tagz.i_do_not_know_what_the_hell_i_am_doing!
+
+      attribute and content escaping can be configured individually too. see
+      tests for examples
+
+
+      thanks Dan Fitzpatrick
+
+    - << and concat escape (if configured) while puts and push and write do not
+
+      thanks JoelVanderWerf
+
+  5.0.0
+    - introduce better escaping for attributes using xchar.rb approach
+    - indroduce smart escaping for content
+    - make Tagz.globally kick ass more hard
+    - note that this version is not backward compatibile if you were relying
+      on tagz never escaping any content should be an ok upgrade for most
+      applications
+
+  4.6.0
+    - fix a bug with self closing tagz that had crept in 1.0.0 -> 4.2.0.  thx
+      jeremy hinegardner
+
+    - added tests from 1.0.0 back into svn
+
+  4.4.0
+    - remove dependancy on cgi lib, tagz is now completely standalone
+
+  4.3.0
+    - detect rails and auto-include into ActionController::Base and include
+      globally into ActionView::Base
+
+  4.2.0
+    - general lib cleanup
+    - introduction of dual-mixin technique (Tagz.globally)
+    - few small bug fixes
+    - ninja tales
+
+SAMPLES
+
+  <%= @samples %>

data/samples/d.rb

@@ -12,16 +12,16 @@ def header
     html_
       body_(:class => 'ninja-like', :id => 'giraffe-slayer')
 
-      ___ "<!-- this is the header -->"
+      __ "<!-- this is the header -->"
   }
 end
 
 def footer
   tagz{
-    ___ "<!-- this is the footer -->"
+    __ "<!-- this is the footer -->"
 
-    body_
-      html_
+      _body
+    _html
   }
 end
 

data/tagz.gemspec

@@ -0,0 +1,26 @@
+## tagz.gemspec
+#
+
+Gem::Specification::new do |spec|
+  spec.name = "tagz"
+  spec.version = "6.0.0"
+  spec.platform = Gem::Platform::RUBY
+  spec.summary = "tagz"
+
+  spec.files = ["lib", "lib/tagz.rb", "Rakefile", "README", "readme.erb", "samples", "samples/a.rb", "samples/b.rb", "samples/c.rb", "samples/d.rb", "samples/e.rb", "samples/f.rb", "samples/g.rb", "tagz.gemspec", "test", "test/tagz.rb"]
+  spec.executables = []
+  
+  spec.require_path = "lib"
+
+  spec.has_rdoc = true
+  spec.test_files = "test/tagz.rb"
+  #spec.add_dependency 'lib', '>= version'
+  #spec.add_dependency 'fattr'
+
+  spec.extensions.push(*[])
+
+  spec.rubyforge_project = "codeforpeople"
+  spec.author = "Ara T. Howard"
+  spec.email = "ara.t.howard@gmail.com"
+  spec.homepage = "http://github.com/ahoward/tagz/tree/master"
+end

data/test/tagz.rb

@@ -550,4 +550,158 @@ class TagzTest < Test::Unit::TestCase
     assert_equal expected, actual
     assert_nothing_raised{ c.b }
   end
+
+  def test_460
+    c = Class.new{
+      include Tagz.globally
+      def a
+        div_( 'a>b' => 'a>b' ){ 'content' }
+      end
+    }.new
+
+    actual = nil
+    assert_nothing_raised{ actual=c.a}
+    expected = %(<div a&gt;b="a&gt;b">content</div>)
+    assert_equal expected, actual
+
+    original = Tagz.escape_attribute! false
+    assert original
+    actual = nil
+    assert_nothing_raised{ actual=c.a}
+    expected = %(<div a>b="a>b">content</div>)
+    assert_equal expected, actual
+
+    Tagz.escape_attribute! original
+    actual = nil
+    assert_nothing_raised{ actual=c.a}
+    expected = %(<div a&gt;b="a&gt;b">content</div>)
+    assert_equal expected, actual
+
+    upcased = Tagz.escape_attribute! lambda{|value| original.call(value).upcase} 
+    assert upcased
+    actual = nil
+    assert_nothing_raised{ actual=c.a}
+    expected = %(<div A&GT;B="A&GT;B">content</div>)
+    assert_equal expected, actual
+
+    Tagz.escape_attributes! lambda{|value| upcased.call(value).downcase} 
+    actual = nil
+    assert_nothing_raised{ actual=c.a}
+    expected = %(<div a&gt;b="a&gt;b">content</div>)
+    assert_equal expected, actual
+  ensure
+    Tagz.escape_attributes!(original)
+  end
+
+  def test_470
+    c = Class.new{
+      include Tagz.globally
+      def a
+        div_( ){ 'a>b' }
+      end
+    }.new
+
+    actual = nil
+    assert_nothing_raised{ actual=c.a}
+    expected = %(<div>a&gt;b</div>)
+    assert_equal expected, actual
+
+    original = Tagz.escape_content! false
+    assert original
+    actual = nil
+    assert_nothing_raised{ actual=c.a}
+    expected = %(<div>a>b</div>)
+    assert_equal expected, actual
+
+    upcased = Tagz.escape_content! lambda{|value| original.call(value).upcase} 
+    assert upcased
+    actual = nil
+    assert_nothing_raised{ actual=c.a}
+    expected = %(<div>A&GT;B</div>)
+    assert_equal expected, actual
+
+    Tagz.escape_content! original
+    actual = nil
+    assert_nothing_raised{ actual=c.a}
+    expected = %(<div>a&gt;b</div>)
+    assert_equal expected, actual
+  ensure
+    Tagz.escape_content!(original)
+  end
+
+  def test_480
+    c = Class.new{
+      include Tagz.globally
+      def a
+        div_( 'a>b' => '<>'){ 'a>b' }
+      end
+    }.new
+
+    Tagz.i_know_what_the_hell_i_am_doing!
+    actual = nil
+    assert_nothing_raised{ actual=c.a}
+    expected = %(<div a>b="<>">a>b</div>)
+    assert_equal expected, actual
+  ensure
+    Tagz.i_do_not_know_what_the_hell_i_am_doing!
+  end
+
+  def test_490
+    c = Class.new{
+      include Tagz.globally
+      def a
+        div_{
+          __
+          tagz.concat 'a>b'
+          __
+          tagz.write 'c>d'
+          __
+          tagz << 'e>f'
+          __
+          tagz.push 'g>h'
+        }
+      end
+    }.new
+
+    actual = nil
+    assert_nothing_raised{ actual=c.a}
+    expected = "<div>\na&gt;b\nc>d\ne&gt;f\ng>h</div>"
+    assert_equal expected, actual
+  end
+
+  def test_500
+    expected = actual = nil
+    Module.new do
+      before = constants
+      include Tagz
+      after = constants
+      expected = %w[ TagzConstants ]
+      actual = after - before
+    end
+    assert_equal expected, actual
+  end
+
+  def test_510
+    expected = actual = nil
+    Module.new do
+      before = constants
+      include Tagz.globally
+      after = constants
+      expected = %w[ TagzConstants ]
+      actual = after - before
+    end
+    assert_equal expected, actual
+  end
+
+  def test_520
+    expected = actual = nil
+    Module.new do
+      before = constants
+      include Tagz.privately
+      after = constants
+      expected = %w[ TagzConstants ]
+      actual = after - before
+    end
+    assert_equal expected, actual
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: tagz
 version: !ruby/object:Gem::Version 
-  version: 5.0.1
+  version: 6.0.0
 platform: ruby
 authors: 
 - Ara T. Howard
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-03-25 00:00:00 -06:00
+date: 2009-07-25 00:00:00 -06:00
 default_executable: 
 dependencies: []
 
@@ -22,14 +22,11 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
-- a.rb
-- gemspec.rb
-- gen_readme.rb
-- install.rb
 - lib
 - lib/tagz.rb
-- prof.rb
+- Rakefile
 - README
+- readme.erb
 - samples
 - samples/a.rb
 - samples/b.rb
@@ -38,10 +35,11 @@ files:
 - samples/e.rb
 - samples/f.rb
 - samples/g.rb
+- tagz.gemspec
 - test
 - test/tagz.rb
 has_rdoc: true
-homepage: http://codeforpeople.com/lib/ruby/tagz/
+homepage: http://github.com/ahoward/tagz/tree/master
 post_install_message: 
 rdoc_options: []
 

data/a.rb

@@ -1,12 +0,0 @@
-require 'tagz'
-
-include Tagz.globally
-
-c = Class.new{
-  include Tagz.globally
-  def a() tagz{ a_{ b(tagz); nil } } end
-  def b(doc) tagz(doc){ b_{ 'content' } } end
-}.new
-
-puts c.a
-

data/gemspec.rb

@@ -1,44 +0,0 @@
-#! /usr/bin/env gem build
-
-require 'rubygems'
-
-Gem::Specification::new do |spec|
-  $VERBOSE = nil
-
-  shiteless = lambda do |list|
-    list.delete_if do |file|
-      file =~ %r/\.svn/ or
-      file =~ %r/\.tmp/
-    end
-  end
-
-  spec.name = $lib 
-  spec.version = $version 
-  spec.platform = Gem::Platform::RUBY
-  spec.summary = $lib 
-
-  spec.files = shiteless[Dir::glob("**/**")]
-  spec.executables = shiteless[Dir::glob("bin/*")].map{|exe| File::basename exe}
-  
-  spec.require_path = "lib" 
-
-  spec.has_rdoc = true #File::exist? "doc" 
-  spec.test_suite_file = "test/#{ $lib }.rb" if File::file?("test/#{ $lib }.rb")
-  #spec.add_dependency 'lib', '>= version'
-  #spec.add_dependency 'fattr'
-
-  spec.extensions << "extconf.rb" if File::exists? "extconf.rb"
-
-  spec.rubyforge_project = 'codeforpeople'
-  spec.author = "Ara T. Howard"
-  spec.email = "ara.t.howard@gmail.com"
-  spec.homepage = "http://codeforpeople.com/lib/ruby/#{ $lib }/"
-end
-
-
-BEGIN{ 
-  Dir.chdir(File.dirname(__FILE__))
-  $lib = 'tagz'
-  Kernel.load "./lib/#{ $lib }.rb"
-  $version = Tagz.version
-}