textutils 0.1.0 → 0.2.0

data/History.markdown

@@ -1,3 +1,3 @@
-### 0.0.1 / 2012-06-09
+### 0.1.0 / 2012-06-09
 
 * Everything is new. First release

data/Manifest.txt

@@ -3,4 +3,7 @@ Manifest.txt
 README.markdown
 Rakefile
 lib/textutils.rb
+lib/textutils/filter/code_filter.rb
 lib/textutils/filter/comment_filter.rb
+lib/textutils/filter/erb_django_filter.rb
+lib/textutils/filter/erb_filter.rb

data/README.markdown

@@ -2,9 +2,9 @@
 
 ## Filters
 
-### `comments_percent_style`
+### `comments_percent_style` Filter
 
-Strip comments lines starting with percent (that is, %). Example:
+Strip comment lines starting with percent (that is, %). Example:
 
     %%%%%%%%%%%%%%%%
     % Some Headers
@@ -42,13 +42,13 @@ or
     in plain old CSS. Thanks to gradient support in backgrounds in CSS3.
     %end
 
-Note: As a shortcut using a single `%end` directive (that is, without a matching `%begin`)
+Note: As a shortcut using a single `%end` directive (that is, without a leading `%begin`)
 will skip everything until the end of the document.
 
 
-### `skip_end_directive`
+### `skip_end_directive` Filter
 
-Skip/comment out blocks in your document by
+Skip (comment out) text blocks in your document by
 enclosing with `__SKIP__`/`__END__`. Example:
 
     __SKIP__
@@ -57,7 +57,7 @@ enclosing with `__SKIP__`/`__END__`. Example:
     in plain old CSS. Thanks to gradient support in backgrounds in CSS3.
     __END__
 
-As a shortcut if you just use `__END__` (without `__SKIP__`) the filter
+Note: As a shortcut using just `__END__` (without `__SKIP__`)
 will skip everything from `__END__` until the end of the document.
 
 
@@ -77,7 +77,7 @@ Just install the gem:
 
 ## Real World Usage
 
-The [`slideshow`](http://slideshow.rubyforge.org) (also known as Slide Show (S9)) gem
+The [`slideshow`](http://slideshow.rubyforge.org) gem (also known as Slide Show (S9))
 that lets you create slide shows
 and author slides in plain text using a wiki-style markup language that's easy-to-write and easy-to-read.
 

data/lib/textutils/filter/code_filter.rb

@@ -0,0 +1,46 @@
+
+module TextUtils
+  module Filter
+
+  def code_block_curly_style( content, options={} )
+    # replace {{{  w/ <pre class='code'>
+    # replace }}}  w/ </pre>
+    # use 4-6 { or } to escape back to literal value (e.g. {{{{ or {{{{{{ => {{{ )
+    # note: {{{ / }}} are anchored to beginning of line ( spaces and tabs before {{{/}}}allowed )
+    
+    # track statistics
+    code_begin     = 0
+    code_begin_esc = 0
+    code_end       = 0
+    code_end_esc   = 0
+        
+    content.gsub!( /^[ \t]*(\{{3,6})/ ) do |match|
+      escaped = ($1.length > 3)
+      if escaped
+        code_begin_esc += 1
+        "{{{"
+      else
+        code_begin += 1
+        "<pre class='code'>"
+      end
+    end
+    
+    content.gsub!( /^[ \t]*(\}{3,6})/ ) do |match|
+      escaped = ($1.length > 3)
+      if escaped
+        code_end_esc += 1
+        "}}}"
+      else
+        code_end += 1
+        "</pre>"
+      end
+    end
+        
+    puts "  Patching {{{/}}}-code blocks (#{code_begin}/#{code_end} blocks, " +
+         "#{code_begin_esc}/#{code_end_esc} escaped blocks)..."
+    
+    content
+  end
+
+  end  # module Filter
+end   # module TextUtils

data/lib/textutils/filter/erb_django_filter.rb

@@ -0,0 +1,124 @@
+
+module TextUtils
+  module Filter
+
+  def erb_django_style( content, options={} )
+
+    # replace expressions (support for single lines only)
+    #  {{ expr }}  ->  <%= expr %>
+    #  {% stmt %}  ->  <%  stmt %>   !! add in do if missing (for convenience)
+    #
+    # use use {{{ or {{{{ to escape expr back to literal value
+    # and use {%% %} to escape stmts
+
+    erb_expr = 0
+    erb_stmt_beg = 0
+    erb_stmt_end = 0
+
+    content.gsub!( /(\{{2,4})([^{}\n]+?)(\}{2,4})/ ) do |match|
+      escaped = ($1.length > 2)
+      if escaped
+        "{{#{$2}}}"
+      else
+        erb_expr += 1
+        "<%= #{erb_django_simple_params($2)} %>"
+      end
+    end
+
+    content.gsub!( /(\{%{1,2})([ \t]*end[ \t]*)%\}/ ) do |match|
+      escaped = ($1.length > 2)
+      if escaped
+        "{%#{$2}%}"
+      else
+        erb_stmt_end += 1
+        "<% end %>"
+      end
+    end
+
+    content.gsub!( /(\{%{1,2})([^%\n]+?)%\}/ ) do |match|
+      escaped = ($1.length > 2)
+      if escaped
+        "{%#{$2}%}"
+      else
+        erb_stmt_beg += 1
+        "<% #{erb_django_simple_params($2)} do %>"
+      end
+    end
+
+    puts "  Patching embedded Ruby (erb) code Django-style (#{erb_expr} {{-expressions," +
+       " #{erb_stmt_beg}/#{erb_stmt_end} {%-statements)..."
+         
+    content
+  end
+
+
+
+######################
+## "private" helpers - do NOT use as filters - todo: add :nodoc: how?
+
+  def erb_django_simple_params( code )
+    
+    # split into method/directive and parms plus convert params
+    code.sub!( /^[ \t]([\w.]+)(.*)/ ) do |match|
+      directive = $1
+      params    = $2
+      
+      "#{directive} #{params ? erb_simple_params(directive,params) : ''}"
+    end
+    
+    code
+  end
+
+  def erb_simple_params( method, params )
+    
+    # replace params to support html like attributes e.g.
+    #  plus add comma separator
+    #
+    #  class=part       -> :class => 'part'   
+    #  3rd/tutorial     -> '3rd/tutorial'
+    #  :css             -> :css
+    
+    return params   if params.nil? || params.strip.empty?
+
+    params.strip!    
+    ## todo: add check for " ??
+    if params.include?( '=>' )
+      puts "** warning: skipping patching of params for helper '#{method}'; already includes '=>':"
+      puts "  #{params}"
+      
+      return params
+    end
+    
+    before = params.clone
+    
+    # 1) string-ify values and keys (that is, wrap in '')
+    #  plus separate w/ commas
+    params.gsub!( /([:a-zA-Z0-9#][\w\/\-\.#()]*)|('[^'\n]*')/) do |match|
+      symbol = ( Regexp.last_match( 0 )[0,1] == ':' )
+      quoted = ( Regexp.last_match( 0 )[0,1] == "'" )
+      if symbol || quoted  # return symbols or quoted string as is
+        "#{Regexp.last_match( 0 )},"
+      else
+        "'#{Regexp.last_match( 0 )}',"
+      end
+    end
+        
+    # 2) symbol-ize hash keys
+    #    change = to =>
+    #    remove comma for key/value pairs
+    params.gsub!( /'(\w+)',[ \t]*=/ ) do |match|
+      ":#{$1}=>"
+    end
+    
+    # 3) remove trailing comma
+    params.sub!( /[ \t]*,[ \t]*$/, '' ) 
+     
+    puts "    Patching params for helper '#{method}' from '#{before}' to:"
+    puts "      #{params}"
+       
+    params
+  end
+
+
+  end  # module Filter
+end   # module TextUtils

data/lib/textutils/filter/erb_filter.rb

@@ -0,0 +1,14 @@
+
+module TextUtils
+  module Filter
+
+  # allow plugins/helpers; process source (including header) using erb    
+  def erb( content, options={} )
+    puts "  Running embedded Ruby (erb) code/helpers..."
+    
+    content =  ERB.new( content ).result( binding() )
+    content
+  end
+
+  end  # module Filter
+end   # module TextUtils

data/lib/textutils.rb

@@ -6,15 +6,19 @@ require 'pp'
 require 'logger'
 require 'optparse'
 require 'fileutils'
+require 'erb'
 
 
 # our own code
 
+require 'textutils/filter/code_filter'
 require 'textutils/filter/comment_filter'
+require 'textutils/filter/erb_django_filter'
+require 'textutils/filter/erb_filter'
 
 
 module TextUtils
 
-  VERSION = '0.1.0'
+  VERSION = '0.2.0'
 
 end   # module TextUtils

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: textutils
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 23
   prerelease: 
   segments: 
   - 0
-  - 1
+  - 2
   - 0
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Gerald Bauer
@@ -61,7 +61,10 @@ files:
 - README.markdown
 - Rakefile
 - lib/textutils.rb
+- lib/textutils/filter/code_filter.rb
 - lib/textutils/filter/comment_filter.rb
+- lib/textutils/filter/erb_django_filter.rb
+- lib/textutils/filter/erb_filter.rb
 homepage: http://geraldb.github.com/textutils
 licenses: []