RubyGems - tagz - Versions diffs - 5.0.1 → 6.0.0 - Mend

tagz 5.0.1 → 6.0.0

Files changed (13) hide show

data/README +40 -249
data/Rakefile +228 -0
data/lib/tagz.rb +234 -154
data/readme.erb +154 -0
data/samples/d.rb +4 -4
data/tagz.gemspec +26 -0
data/test/tagz.rb +154 -0
metadata +6 -8
data/a.rb +0 -12
data/gemspec.rb +0 -44
data/gen_readme.rb +0 -34
data/install.rb +0 -214
data/prof.rb +0 -25

data/README CHANGED

@@ -58,17 +58,15 @@ RAILS
   in a view
-    <%=
-      table_{
-        rows.each do |row|
-          tr_{
-            row.each do |cell|
-              td_{ cell }
-            end
-          }
-        end
-      }
-    %>
+    table_{
+      rows.each do |row|
+        tr_{
+          row.each do |cell|
+            td_{ cell }
+          end
+        }
+      end
+    }
   in a controller
@@ -93,7 +91,37 @@ 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
@@ -123,241 +151,4 @@ HISTORY
 SAMPLES
-  <========< samples/a.rb >========>
-  ~ > cat samples/a.rb
-    #
-    # 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
-  ~ > ruby samples/a.rb
-    <a href="/giraffe/neck/42">whack!</a>
-  <========< samples/b.rb >========>
-  ~ > cat samples/b.rb
-    #
-    # 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.  in rails tagz will automatically be
-    # available in your erb templates.
-    #
-    require 'tagz'
-    include Tagz.globally
-    require 'erb'
-    rows = %w( a b c ), %w( 1 2 3 )
-    template = ERB.new <<-ERB
-      <html>
-        <body>
-          <%=
-            table_{
-              rows.each do |row|
-                tr_{
-                  row.each do |cell|
-                    td_{ cell }
-                  end
-                }
-              end
-            }
-          %>
-        </body>
-      </html>
-    ERB
-    puts template.result(binding)
-  ~ > ruby samples/b.rb
-      <html>
-        <body>
-          <table><tr><td>a</td><td>b</td><td>c</td></tr><tr><td>1</td><td>2</td><td>3</td></tr></table>
-        </body>
-      </html>
-  <========< samples/c.rb >========>
-  ~ > cat samples/c.rb
-    #
-    # 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
-  ~ > ruby samples/c.rb
-    <xml><giraffe>large</giraffe><ninja>small</ninja></xml>
-  <========< samples/d.rb >========>
-  ~ > cat samples/d.rb
-    #
-    # 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')
-          ___ "<!-- this is the header -->"
-      }
-    end
-    def footer
-      tagz{
-        ___ "<!-- this is the footer -->"
-        body_
-          html_
-      }
-    end
-    puts header, footer
-  ~ > ruby samples/d.rb
-    <html><body class="ninja-like" id="giraffe-slayer">
-    <!-- this is the header -->
-    <!-- this is the footer -->
-    <body><html>
-  <========< samples/e.rb >========>
-  ~ > cat samples/e.rb
-    #
-    # 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
-  ~ > ruby samples/e.rb
-    <html>works only in here</html>
-    {:backtrace=>["samples/e.rb:17"]}
-  <========< samples/f.rb >========>
-  ~ > cat samples/f.rb
-    #
-    # tagz.rb can generate really compact html.  this is great to save bandwidth
-    # but can sometimes make reading the generated html a bit rough.  of course
-    # using tidy or the dom inspector in firebug obviates the issue; nevertheless
-    # it's sometime nice to break things up a little.  you can use 'tagz << "\n"'
-    # or the special shorthand '__' or '___' to accomplish this
-    #
-    require 'tagz'
-    include Tagz.globally
-    html =
-      div_{
-        span_{ true }
-        __
-        span_{ false }  # hey ryan, i fixed this ;-)
-        ___
-        ___ 'foo & escaped bar'
-      }
-    puts html
-  ~ > ruby samples/f.rb
-    <div><span>true</span>
-    <span>false</span>
-    foo & escaped bar
-    </div>
-  <========< samples/g.rb >========>
-  ~ > cat samples/g.rb
-    # tagz gives you low-level control of the output and makes even dashersized
-    # xml tagz easy enough to work with
-    #
-    require 'tagz'
-    include Tagz.globally
-    xml =
-      root_{
-        tagz__('foo-bar', :key => 'foo&bar'){ 'content' }
-        tagz__('bar-foo')
-        tagz.concat 'content'
-        tagz.concat tagz.escape('foo&bar')
-        __tagz('bar-foo')
-      }
-    puts xml
-  ~ > ruby samples/g.rb
-    <root><foo-bar key="foo&amp;bar">content</foo-bar><bar-foo>contentfoo&amp;bar</bar-foo></root>

data/Rakefile ADDED

@@ -0,0 +1,228 @@
+This.rubyforge_project = 'codeforpeople'
+This.author = "Ara T. Howard"
+This.email = "ara.t.howard@gmail.com"
+This.homepage = "http://github.com/ahoward/#{ This.lib }/tree/master"
+task :default do
+  puts(Rake::Task.tasks.map{|task| task.name} - ['default'])
+end
+task :gemspec do
+  ignore_extensions = 'git', 'svn', 'tmp', /sw./, 'bak', 'gem'
+  ignore_directories = 'pkg'
+  ignore_files = 'test/log'
+  shiteless =
+    lambda do |list|
+      list.delete_if do |entry|
+        next unless test(?e, entry)
+        extension = File.basename(entry).split(%r/[.]/).last
+        ignore_extensions.any?{|ext| ext === extension}
+      end
+      list.delete_if do |entry|
+        next unless test(?d, entry)
+        dirname = File.expand_path(entry)
+        ignore_directories.any?{|dir| File.expand_path(dir) == dirname}
+      end
+      list.delete_if do |entry|
+        next unless test(?f, entry)
+        filename = File.expand_path(entry)
+        ignore_files.any?{|file| File.expand_path(file) == filename}
+      end
+    end
+  lib         = This.lib
+  version     = This.version
+  files       = shiteless[Dir::glob("**/**")]
+  executables = shiteless[Dir::glob("bin/*")].map{|exe| File.basename(exe)}
+  has_rdoc    = true #File.exist?('doc')
+  test_files  = "test/#{ lib }.rb" if File.file?("test/#{ lib }.rb")
+  extensions = This.extensions
+  if extensions.nil?
+    %w( Makefile configure extconf.rb ).each do |ext|
+      extensions << ext if File.exists?(ext)
+    end
+  end
+  extensions = [extensions].flatten.compact
+  template =
+    if test(?e, 'gemspec.erb')
+      Template{ IO.read('gemspec.erb') }
+    else
+      Template {
+        <<-__
+          ## #{ lib }.gemspec
+          #
+          Gem::Specification::new do |spec|
+            spec.name = #{ lib.inspect }
+            spec.version = #{ version.inspect }
+            spec.platform = Gem::Platform::RUBY
+            spec.summary = #{ lib.inspect }
+            spec.files = #{ files.inspect }
+            spec.executables = #{ executables.inspect }
+            spec.require_path = "lib"
+            spec.has_rdoc = #{ has_rdoc.inspect }
+            spec.test_files = #{ test_files.inspect }
+            #spec.add_dependency 'lib', '>= version'
+            #spec.add_dependency 'fattr'
+            spec.extensions.push(*#{ extensions.inspect })
+            spec.rubyforge_project = #{ This.rubyforge_project.inspect }
+            spec.author = #{ This.author.inspect }
+            spec.email = #{ This.email.inspect }
+            spec.homepage = #{ This.homepage.inspect }
+          end
+        __
+      }
+    end
+  open("#{ lib }.gemspec", "w"){|fd| fd.puts template}
+  This.gemspec = "#{ lib }.gemspec"
+end
+task :gem => [:clean, :gemspec] do
+  Fu.mkdir_p This.pkgdir
+  before = Dir['*.gem']
+  cmd = "gem build #{ This.gemspec }"
+  `#{ cmd }`
+  after = Dir['*.gem']
+  gem = ((after - before).first || after.first) or abort('no gem!')
+  Fu.mv gem, This.pkgdir
+  This.gem = File.basename(gem)
+end
+task :readme do
+  samples = ''
+  prompt = '~ > '
+  lib = This.lib
+  version = This.version
+  Dir['sample*/*'].sort.each do |sample|
+    samples << "\n" << "  <========< #{ sample } >========>" << "\n\n"
+    cmd = "cat #{ sample }"
+    samples << Util.indent(prompt + cmd, 2) << "\n\n"
+    samples << Util.indent(`#{ cmd }`, 4) << "\n"
+    cmd = "ruby #{ sample }"
+    samples << Util.indent(prompt + cmd, 2) << "\n\n"
+    cmd = "ruby -e'STDOUT.sync=true; exec %(ruby -I ./lib #{ sample })'"
+    samples << Util.indent(`#{ cmd } 2>&1`, 4) << "\n"
+  end
+  template =
+    if test(?e, 'readme.erb')
+      Template{ IO.read('readme.erb') }
+    else
+      Template {
+        <<-__
+          NAME
+            #{ lib }
+          DESCRIPTION
+          INSTALL
+            gem install #{ lib }
+          SAMPLES
+            #{ samples }
+        __
+      }
+    end
+  open("README", "w"){|fd| fd.puts template}
+end
+task :clean do
+  Dir[File.join(This.pkgdir, '**/**')].each{|entry| Fu.rm_rf(entry)}
+end
+task :release => [:clean, :gemspec, :gem] do
+  gems = Dir[File.join(This.pkgdir, '*.gem')].flatten
+  raise "which one? : #{ gems.inspect }" if gems.size > 1
+  raise "no gems?" if gems.size < 1
+  cmd = "rubyforge login && rubyforge add_release #{ This.rubyforge_project } #{ This.lib } #{ This.version } #{ This.pkgdir }/#{ This.gem }"
+  puts cmd
+  system cmd
+end
+BEGIN {
+  $VERBOSE = nil
+  require 'ostruct'
+  require 'erb'
+  require 'fileutils'
+  Fu = FileUtils
+  This = OpenStruct.new
+  This.file = File.expand_path(__FILE__)
+  This.dir = File.dirname(This.file)
+  This.pkgdir = File.join(This.dir, 'pkg')
+  lib = ENV['LIB']
+  unless lib
+    lib = File.basename(Dir.pwd)
+  end
+  This.lib = lib
+  version = ENV['VERSION']
+  unless version
+    name = lib.capitalize
+    require "./lib/#{ lib }"
+    version = eval(name).send(:version)
+  end
+  This.version = version
+  abort('no lib') unless This.lib
+  abort('no version') unless This.version
+  module Util
+    def indent(s, n = 2)
+      s = unindent(s)
+      ws = ' ' * n
+      s.gsub(%r/^/, ws)
+    end
+    def unindent(s)
+      indent = nil
+      s.each do |line|
+      next if line =~ %r/^\s*$/
+      indent = line[%r/^\s*/] and break
+    end
+    indent ? s.gsub(%r/^#{ indent }/, "") : s
+  end
+    extend self
+  end
+  class Template
+    def initialize(&block)
+      @block = block
+      @template = block.call.to_s
+    end
+    def expand(b=nil)
+      ERB.new(Util.unindent(@template)).result(b||@block)
+    end
+    alias_method 'to_s', 'expand'
+  end
+  def Template(*args, &block) Template.new(*args, &block) end
+  Dir.chdir(This.dir)
+}