RubyGems - tagz - Versions diffs - 1.0.0 → 4.2.0 - Mend

tagz 1.0.0 → 4.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (13) hide show

data/lib/tagz.rb CHANGED Viewed

@@ -5,8 +5,8 @@ unless defined? Tagz
   module Tagz
     unless defined?(Tagz::VERSION)
       Tagz::VERSION = [
-        Tagz::VERSION_MAJOR = 1,
-        Tagz::VERSION_MINOR = 0,
+        Tagz::VERSION_MAJOR = 4,
+        Tagz::VERSION_MINOR = 2,
         Tagz::VERSION_TEENY = 0
       ].join('.')
       def Tagz.version() Tagz::VERSION end
@@ -83,27 +83,20 @@ unless defined? Tagz
       self
     end
-  private
-    def tagz &block
-      if block
-        if not defined?(@tagz) or @tagz.nil?
-          @tagz = Fragment.new
-          top = true
-        end
-        begin
-          size = @tagz.size
-          value = instance_eval(&block)
-          @tagz << value unless(Fragment === value or @tagz.size > size)
-          @tagz
-        ensure
-          @tagz = nil if top
-        end
-      else
-        @tagz ||= Fragment.new
+    module Globally
+    private
+      include Tagz
+      def method_missing m, *a, &b
+        tagz{ super }
       end
     end
+    def Tagz.globally
+      Globally
+    end
+  private
     def tagz__ name, *argv, &block
       options = {}
       content = []
@@ -165,25 +158,54 @@ unless defined? Tagz
       tagz << "</#{ tag }>"
     end
+    def tagz &block
+      if block
+        if not defined?(@tagz) or @tagz.nil?
+          @tagz = Fragment.new
+          top = true
+        end
+        begin
+          size = @tagz.size
+          value = instance_eval(&block)
+          @tagz << value unless(Fragment === value or @tagz.size > size)
+          @tagz.to_s
+        ensure
+          @tagz = nil if top
+        end
+      else
+        @tagz if defined? @tagz
+      end
+    end
     def method_missing m, *a, &b
-      return super unless @tagz
+      if not Globally === self
+        unless defined?(@tagz) and @tagz
+          begin
+            super
+          ensure
+            $!.set_backtrace caller(skip=1) if $!
+          end
+        end
+      end
       case m.to_s
         when %r/^(.*[^_])_(!)?$/o
           m, bang = $1, $2
-          unless bang
-            tagz__(m, *a, &b)
-          else
-            tagz__(m, *a){}
-          end
+          b ||= lambda{} if bang
+          tagz{ tagz__(m, *a, &b) }
         when %r/^_([^_].*)$/o
           m = $1
-          __tagz(m, *a, &b)
+          tagz{ __tagz(m, *a, &b) }
         when 'e'
           Element.new(*a, &b)
         when '__'
-          tagz << "\n"
+          tagz{ tagz << "\n" }
         else
-          super
+          begin
+            super
+          ensure
+            $!.set_backtrace caller(skip=1) if $!
+          end
       end
     end

data/samples/a.rb ADDED Viewed

@@ -0,0 +1,15 @@
+#
+# in the simplest case tagz generates html using a syntax which safely mixes
+# in to any object
+#
+require 'tagz'
+include Tagz.globally
+class GiraffeModel
+  def link
+    a_(:href => "/giraffe/neck/42"){ "whack!" }
+  end
+end
+puts GiraffeModel.new.link

data/samples/b.rb ADDED Viewed

@@ -0,0 +1,41 @@
+#
+# tagz.rb mixes quite easily with your favourite templating engine, avoiding
+# the need for '<% rows.each do |row| %> ... <% row.each do |cell| %> '
+# madness and other types of logic to be coded in the templating language,
+# leaving templating to template engines and logic and looping to ruby -
+# unencumbered by extra funky syntax
+#
+require 'tagz'
+include Tagz.globally
+require 'erb'
+rows = %w( a b c ), %w( 1 2 3 )
+template = ERB.new <<-ERB
+  <html>
+    <body>
+      <%=
+        if rows
+          table_{
+            rows.each do |row|
+              tr_{
+                row.each do |cell|
+                  td_{ cell }
+                end
+              }
+            end
+          }
+        end
+      %>
+    </body>
+  </html>
+ERB
+puts template.result(binding)

data/samples/c.rb ADDED Viewed

@@ -0,0 +1,15 @@
+#
+# once you've learned to generate html using tagz you're primed to generate
+# xml too
+#
+require 'tagz'
+include Tagz.globally
+doc =
+  xml_{
+    giraffe_{ 'large' }
+    ninja_{ 'small' }
+  }
+puts doc

data/samples/d.rb ADDED Viewed

@@ -0,0 +1,28 @@
+#
+# tagz.rb doesn't cramp your style, allowing even invalid html to be
+# generated.  note the use of the 'tagz' method, which can be used both to
+# capture output and to append content to the top of the stack.
+#
+require 'tagz'
+include Tagz.globally
+def header
+  tagz{
+    html_
+      body_(:class => 'ninja-like', :id => 'giraffe-slayer')
+      tagz << "\n<!-- this is the header -->\n"
+  }
+end
+def footer
+  tagz{
+    tagz << "\n<!-- this is the footer -->\n"
+    body_
+      html_
+  }
+end
+puts header, footer

data/samples/e.rb ADDED Viewed

@@ -0,0 +1,21 @@
+#
+# tagz.rb allows a safer method of mixin which requires any tagz methods to be
+# insider a tagz block - tagz generating methods outside a tagz block with
+# raise an error if tagz is included this way.  also notice that the error is
+# reported from where it was raised - not from the bowels of the the tagz.rb
+# lib.
+#
+require 'tagz'
+include Tagz
+puts tagz{
+ html_{ 'works only in here' }
+}
+begin
+  html_{ 'not out here' }
+rescue Object => e
+  p :backtrace => e.backtrace
+end

metadata CHANGED Viewed

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tagz
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 4.2.0
 platform: ruby
 authors:
 - Ara T. Howard
@@ -9,12 +9,12 @@ autorequire: tagz
 bindir: bin
 cert_chain: []
-date: 2008-02-14 00:00:00 -07:00
+date: 2008-05-08 00:00:00 -06:00
 default_executable:
 dependencies: []
 description:
-email: ara.t.howard@noaa.gov
+email: ara.t.howard@gmail.com
 executables: []
 extensions: []
@@ -22,17 +22,19 @@ extensions: []
 extra_rdoc_files: []
 files:
+- a.rb
 - gemspec.rb
 - gen_readme.rb
 - install.rb
 - lib
 - lib/tagz.rb
 - README
-- README.tmpl
-- sample
-- sample/a.rb
-- test
-- test/tagz.rb
+- samples
+- samples/a.rb
+- samples/b.rb
+- samples/c.rb
+- samples/d.rb
+- samples/e.rb
 has_rdoc: false
 homepage: http://codeforpeople.com/lib/ruby/tagz/
 post_install_message:
@@ -59,5 +61,5 @@ rubygems_version: 1.0.1
 signing_key:
 specification_version: 2
 summary: tagz
-test_files:
-- test/tagz.rb
+test_files: []

data/README.tmpl DELETED Viewed

@@ -1,240 +0,0 @@
-NAME
-  tagz.rb
-SYNOPSIS
-  object mixin for squeaky clean and super speedy generation of any sgml
-  (html/xml) tags using a private dsl
-    + module level interface
-        require 'tagz'
-        html =
-          Tagz{
-            html_{
-              body_(:class => 'container'){
-                div_{ 'content' }
-              }
-            }
-          }
-    + private mixin interface
-        require 'tagz'
-        class Table < ::Array
-          include Tagz
-          def initialize width, height
-            @width, @height = width, height
-          end
-          def to_row
-            Tagz{
-              table_(:width => @width, :height => @height){
-                each do |row|
-                  tr_{
-                    row.each{|cell| td_{ cell }}
-                  }
-                end
-              }
-            }
-          end
-        end
-DESCRIPTION
-  tagz.rb offers a mixin module which adds four private methods to the calling
-  object:
-    tagz
-    tagz__
-    __tagz
-    method_missing
-  because the mixing adds only private methods it's safe to use, for instance,
-  in the controller of a web framework which exposes methods to the world as
-  http actions
-  the method_missing tagz.rb adds *only* works from inside a Tagz{}/tagz{}
-  block, for instance
-    include Tagz
-    tagz{ h1_{ 'this works' } }
-    h1_{ 'this throws NameError' }
-  tagz.rb is very non-restrictive, allowing you to generate invalid html,
-  html4, xml, whatever, all using the same simple interface
-  for example
-    require 'tagz'
-    include Tagz
-    tagz{
-      div_(:class => 'pinky'){ 'content' }
-    }
-    #=> <div class="pinky">content</div>
-    tagz{
-      img_(:src => 'foo.png')
-      img_(:src => 'foo.png'){}
-    }
-    #=> <img src="foo.png">
-    #=> <img src="foo.png" />
-    tagz{
-      br_
-      br_!
-      br_{}
-    }
-    #=> <br>
-    #=> <br />
-    #=> <br />
-    tagz{
-      span_('content', :style => 'color:mauve')
-    }
-    #=> <span style="color:mauve">content</span>
-    tagz{
-      div_(:class => 'container'){
-        span_('content', :style => 'color:mauve')
-      }
-    }
-    #=> <div class="container"><span style="color:mauve">content</span></div>
-    tagz{
-      div_(:class => 'container')
-        span_('content', :style => 'color:mauve')
-      _div
-    }
-    #=> <div class="container"><span style="color:mauve">content</span></div>
-    tagz{
-      table_(:width => 42{
-        %w( 1 2 3 ).each do |row|
-          tr_{
-            row.each{|cell| td_{ cell }}
-          }
-        end
-      }
-    }
-    #=> <table width="42"><tr><td>1</td><td>2</td><td>3</td></tr></table>
-    # note that the return value of the table block ( the array %w( 1 2 3 )
-    # is *NOT* added to the content.  the rule is: add the return value of
-    # the block if, and only if, the block did not add any content itself
-    # during evaluation
-    tagz{
-      div_{
-        div_{ 'content' }
-        'this is ignored'
-      }
-    }
-    #=> <div><div>content</div></div>
-    # this is a side effect of the above rule
-    tagz{
-      div_{
-        'this is not ignored, see above rule'
-      }
-    }
-    #=> <div>this is not ignored, see above rule</div>
-    tagz{
-      div_{
-        div_{ 'content' }
-        tagz << 'this is appended' << ' and so is this'
-      }
-    }
-    #=> <div><div>content</div>this is appended and so is this</div>
-    tagz{
-      a_
-      b_
-      c_
-        tagz << 'valid html'
-      _a
-      _b
-      _c
-      _invalid
-    }
-    #=> <a><b><c>valid html</a></b></c></invalid>
-    tagz{
-      __
-      a_{ 'content' }
-      __ __
-      b_{ 'content' }
-      __ __ __
-      c_{ 'content' }
-    }
-    #=> \n<a>content</a>\n\n<b>content</b>\n\n\n<c>content</c>
-    # note that \n is newline.  the html tagz generates is quite compact,
-    # you can do 'tagz << "\n"' or just use the '__' method to output some
-    # linebreaks
-    tagz{
-      link = e(:a, :href => 'foo.com'){ 'link text' }
-      div_{ link }
-    }
-    #=> <div><a href="foo.com">link text</a>
-  a couple of notes: *none* of the method_missing magic is available outside
-  the 'tagz' block and, even inside, it supers-up when the missing method does
-  not look like a tag method.  you can use Tagz{} as a module method but to
-  have access to @ivars you'll want to mixin the module to your own class and
-  use tagz{}.  no public methods are added to your object, only four private
-  ones.
-HISTORY
-  1.0.0
-    totally reworked tagz, dropping 300 loc - only 170 loc now.  this release
-    is *NOT* backward compatible with other tagz versions, though the api is
-    very very close.  the rework makes tagz safer to mixin, faster, and
-    produces nicer looking html.  this version also marks ramaze template
-    support.
-INSTALL
-  gem install tagz
-URI
-  http://rubyforge.org/projects/codeforpeople
-AUTHOR
-  ara.t.howard@gmail.com