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

tagz 5.0.1 → 6.0.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/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)
+}