ember 0.1.1 → 0.2.0

data/CREDITS

@@ -0,0 +1,13 @@
+%#----------------------------------------------------------------------------
+## CREDITS
+%#----------------------------------------------------------------------------
+
+Suraj N. Kurapati,
+Kamil Kukura
+
+%#----------------------------------------------------------------------------
+## LICENSE
+%#----------------------------------------------------------------------------
+
+%# See the file named "LICENSE".
+%< "LICENSE"

data/bin/ember

@@ -3,9 +3,16 @@
 require 'ember'
 
 if ARGV.delete('-h') or ARGV.delete('--help')
-  man_dir = File.join(Ember::INSTDIR, 'man')
-  system 'man', '-M', man_dir, '-a', 'ember' or
-  puts Dir["#{man_dir}/**/*.html"].push(Ember::WEBSITE).map {|s| "See #{s}" }
+  # try to display UNIX version of help manual
+  man_path = File.join(Ember::INSTDIR, 'man')
+  unless system 'man', '-M', man_path, '-a', 'ember'
+    # try to display HTML version of help manual
+    man_html = man_path + '.html'
+    unless %w[$BROWSER open start].any? {|b| system "#{b} #{man_html}" }
+      # no luck; direct user to project website
+      puts "See #{Ember::WEBSITE}"
+    end
+  end
   exit
 elsif ARGV.delete('-v') or ARGV.delete('--version')
   puts Ember::VERSION

data/lib/ember/helpers/rails_helper.rb

@@ -0,0 +1,32 @@
+module ActionView
+  module TemplateHandlers
+    #
+    # @example Setting processing options for Ember
+    #
+    #   ActionView::TemplateHandlers::Ember.options = {
+    #     :unindent => true,
+    #     :shorthand => true,
+    #     :infer_end => true
+    #   }
+    #
+    # @see Ember::Template
+    #
+    class Ember < TemplateHandler
+      include Compilable
+
+      @@options = {}
+      cattr_accessor :options
+
+      def compile(template)
+        options = @@options.merge(:result_variable => :@output_buffer,
+                                  :source_file => template.filename)
+        ember = ::Ember::Template.new(template.source, options)
+        "__in_erb_template = true; #{ember.program}"
+      end
+    end
+  end
+
+  ember_handler = TemplateHandlers::Ember
+  Template.register_default_template_handler :erb, ember_handler
+  Template.register_template_handler :rhtml, ember_handler
+end

data/lib/ember/inochi.rb

@@ -18,12 +18,12 @@ module Ember
   ##
   # Number of this release of this project.
   #
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 
   ##
   # Date of this release of this project.
   #
-  RELDATE = "2010-04-20"
+  RELDATE = "2010-04-25"
 
   ##
   # Description of this release of this project.

data/lib/ember/template.rb

@@ -363,7 +363,7 @@ module Ember
 
       # directive
         template_class_name  = '::Ember::Template'
-        nested_template_args = "(#{arguments}), #{@options.inspect}"
+        nested_template_args = "(#{arguments.strip}), #{@options.inspect}"
 
         nest_template_with = lambda do |meth|
           @program.emit_code "#{template_class_name}.#{meth}(#{

data/{man/man1/ember.1.html → man.html}

@@ -12,19 +12,18 @@
       line-height:1.3;
       color:#343331;
       background:#fff; }
-    #man { max-width:81ex; text-align:justify; margin:0 25px 25px 25px }
+    #man { max-width:87ex; margin:0 3ex 1ex 1ex; text-align:justify; }
     #man div.man-navigation {
       position:fixed;
       top:0;
-      left:87ex;
+      left:91ex;
       height:100%;
       width:100%;
-      padding-top:1ex;
-      padding-left:2ex;
-      border-left:1ex solid #DCDCDC;
+      padding:1ex 0 0 2ex;
+      border-left:0.5ex solid #DCDCDC;
       background-color: #F5F5F5;
     }
-    #man div.man-navigation a { display:block; margin-bottom:15px }
+    #man div.man-navigation a { display:block; margin-bottom:1.5ex }
     #man h1, #man h2, #man h3 { color:#232221;clear:left }
     #man h1 { font-size:28px; margin:15px 0 30px 0; text-align:center }
     #man h2 { font-size:18px; margin-bottom:0; margin-top:10px; line-height:1.3; }
@@ -61,6 +60,7 @@
     #man ol.man li.tr { text-align:right; float: right }
     #man ol.man a { color:#999 }
     #man ol.man a:hover { color:#333231 }
+    #man img { display:block; margin:auto }
   </style>
   <style type='text/css' media='print'>
     #man { max-width:none }
@@ -79,7 +79,7 @@
 
 <ol class='head man'>
   <li class='tl'>ember(1)</li>
-  <li class='tc'>Version 0.1.1</li>
+  <li class='tc'>Version 0.2.0</li>
   <li class='tr'>ember(1)</li>
 </ol>
 
@@ -129,6 +129,11 @@ Ruby.</p></li>
 <pre><code>gem install ember
 </code></pre>
 
+<p>Installing as a <a href="http://rubyonrails.org">Ruby on Rails</a> plugin:</p>
+
+<pre><code>script/plugin install git://github.com/sunaku/ember.git
+</code></pre>
+
 <p>Upgrading:</p>
 
 <pre><code>gem update ember
@@ -152,15 +157,15 @@ given, then the standard input stream (STDIN) is evaluated instead.</p>
 <h2 id="OPTIONS">OPTIONS</h2>
 
 <dl>
-<dt><code>-s</code>, <code>--shorthand</code></dt><dd><p>  Treat lines beginning with zero or more whitespace
-  followed by the "%" character as eRuby directives.</p></dd>
-<dt><code>-i</code>, <code>--infer_end</code></dt><dd><p>  Add missing <code>&lt;% end %></code> directives based on indentation.</p></dd>
-<dt><code>-u</code>, <code>--unindent</code></dt><dd><p>  Unindent the bodies of directives that define a
-  Ruby block (do ... end) or scope (begin ... end).</p></dd>
-<dt><code>-c</code>, <code>--compile</code></dt><dd><p>  Print underlying Ruby program compiled
-  from the input eRuby template and exit.</p></dd>
-<dt><code>-h</code>, <code>--help</code></dt><dd><p>  Print this message and exit.</p></dd>
-<dt><code>-v</code>, <code>--version</code></dt><dd><p>  Print version number and exit.</p></dd>
+<dt><code>-s</code>, <code>--shorthand</code></dt><dd><p>Treat lines beginning with zero or more whitespace
+followed by the "%" character as eRuby directives.</p></dd>
+<dt><code>-i</code>, <code>--infer_end</code></dt><dd><p>Add missing <code>&lt;% end %></code> directives based on indentation.</p></dd>
+<dt><code>-u</code>, <code>--unindent</code></dt><dd><p>Unindent the bodies of directives that define a
+Ruby block (do ... end) or scope (begin ... end).</p></dd>
+<dt><code>-c</code>, <code>--compile</code></dt><dd><p>Print underlying Ruby program compiled
+from the input eRuby template and exit.</p></dd>
+<dt><code>-h</code>, <code>--help</code></dt><dd><p>Display this manual and exit.</p></dd>
+<dt><code>-v</code>, <code>--version</code></dt><dd><p>Print version number and exit.</p></dd>
 </dl>
 
 
@@ -512,9 +517,9 @@ _erbout &lt;&lt; "  \n"
 above template compiles into:</p>
 
 <pre><code>(_erbout = []; _erbout &lt;&lt; "\n"
-_erbout &lt;&lt; (::Ember::Template.read_file(( "doc/example.txt" ), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"})) &lt;&lt; "\n"
+_erbout &lt;&lt; (::Ember::Template.read_file(("doc/example.txt"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"})) &lt;&lt; "\n"
 _erbout &lt;&lt; "\n"
-_erbout &lt;&lt; (::Ember::Template.read_file(( "doc/example.txt"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"})) &lt;&lt; "\n"
+_erbout &lt;&lt; (::Ember::Template.read_file(("doc/example.txt"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"})) &lt;&lt; "\n"
 _erbout &lt;&lt; "\n"
 _erbout &lt;&lt; "  \n"
 ; _erbout.join)
@@ -548,9 +553,9 @@ This is a plain-text file.  Notice that &lt;%=
 above template compiles into:</p>
 
 <pre><code>(_erbout = []; _erbout &lt;&lt; "\n"
-::Ember::Template.load_file(( "doc/example.erb" ), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"}.merge!(:continue_result =&gt; true)).render(nil, 79777922); _erbout &lt;&lt; "\n"
+::Ember::Template.load_file(("doc/example.erb"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"}.merge!(:continue_result =&gt; true)).render(nil, 78416100); _erbout &lt;&lt; "\n"
 _erbout &lt;&lt; "\n"
-::Ember::Template.load_file(( "doc/example.erb"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"}.merge!(:continue_result =&gt; true)).render(nil, 79777922); _erbout &lt;&lt; "\n"
+::Ember::Template.load_file(("doc/example.erb"), {:shorthand=&gt;true, :source_file=&gt;"./EXAMPLES"}.merge!(:continue_result =&gt; true)).render(nil, 78416100); _erbout &lt;&lt; "\n"
 _erbout &lt;&lt; "\n"
 _erbout &lt;&lt; "  \n"
 ; _erbout.join)
@@ -574,9 +579,9 @@ This is an eRuby template.  Notice that eRuby directives do take effect here!
 above template compiles into:</p>
 
 <pre><code>(_erbout = []; _erbout &lt;&lt; "\n"
-::Ember::Template.new(( "%= 2 + 2" ), {:shorthand=&gt;true}.merge!(:continue_result =&gt; true)).render(nil, 79408546); _erbout &lt;&lt; "\n"
+::Ember::Template.new(("%= 2 + 2"), {:shorthand=&gt;true}.merge!(:continue_result =&gt; true)).render(nil, 77958272); _erbout &lt;&lt; "\n"
 _erbout &lt;&lt; "\n"
-::Ember::Template.new(( "%= 2 + 2"), {:shorthand=&gt;true}.merge!(:continue_result =&gt; true)).render(nil, 79408546); _erbout &lt;&lt; "\n"
+::Ember::Template.new(("%= 2 + 2"), {:shorthand=&gt;true}.merge!(:continue_result =&gt; true)).render(nil, 77958272); _erbout &lt;&lt; "\n"
 _erbout &lt;&lt; "\n"
 _erbout &lt;&lt; "  \n"
 ; _erbout.join)
@@ -602,12 +607,13 @@ _erbout &lt;&lt; "  \n"
 
 <h3 id="Infrastructure">Infrastructure</h3>
 
-<p><a href="http://snk.tuxfamily.org/lib/inochi/">Inochi</a> serves as Ember's project infrastructure.
-It handles tasks such as building this manual and API documentation, and
-packaging, announcing, and publishing new releases.  See its manual to get
-started:</p>
+<p><a href="http://snk.tuxfamily.org/lib/inochi/">Inochi</a> serves as the project infrastructure for Ember.  It handles tasks
+such as building this help manual and API documentation, and packaging,
+announcing, and publishing new releases.  See its help manual and list of
+tasks to get started:</p>
 
-<pre><code>inochi --help
+<pre><code>inochi --help     # display help manual
+inochi --tasks    # list available tasks
 </code></pre>
 
 <h3 id="-LOAD_PATH-setup">$LOAD_PATH setup</h3>
@@ -617,7 +623,8 @@ use any libraries therein or run any executables in the <code>bin/</code> direct
 
 <p>This can be achieved by passing an option to Ruby:</p>
 
-<pre><code>ruby -Ilib
+<pre><code>ruby -Ilib bin/ember
+irb -Ilib -r ember
 </code></pre>
 
 <p>Or by setting the <code>$RUBYLIB</code> environment variable:</p>
@@ -625,19 +632,23 @@ use any libraries therein or run any executables in the <code>bin/</code> direct
 <pre><code>export RUBYLIB=lib   # bash, ksh, zsh
 setenv RUBYLIB lib   # csh
 set -x RUBYLIB lib   # fish
+
+ruby bin/ember
+irb -r ember
 </code></pre>
 
 <p>Or by installing the <a href="http://github.com/chneukirchen/rup">ruby-wrapper</a> tool.</p>
 
 <h3 id="RubyGems-setup">RubyGems setup</h3>
 
-<p>If you use Ruby 1.8 and RubyGems to manage your Ruby software, then ensure
-that RubyGems is activated before you use any libraries in the <code>lib/</code>
-directory or run any executables in the <code>bin/</code> directory.</p>
+<p>If you use Ruby 1.8 or older, then ensure that RubyGems is activated before
+you use any libraries in the <code>lib/</code> directory or run any executables in the
+<code>bin/</code> directory.</p>
 
 <p>This can be achieved by passing an option to Ruby:</p>
 
-<pre><code>ruby -rubygems
+<pre><code>ruby -rubygems bin/ember
+irb -rubygems -r ember
 </code></pre>
 
 <p>Or by setting the <code>$RUBYOPT</code> environment variable:</p>
@@ -668,6 +679,29 @@ in the <code>test/test_helper.rb</code> file.</p>
 
 <p>This section contains release notes of current and past releases.</p>
 
+<h3 id="Version-0-2-0-2010-04-25-">Version 0.2.0 (2010-04-25)</h3>
+
+<p>This release adds <a href="http://rubyonrails.org">Ruby on Rails</a> integration.</p>
+
+<p>New features:</p>
+
+<ul>
+<li><p>Ember can now be used directly as a <a href="http://rubyonrails.org">Ruby on Rails</a> (2.3 or newer) plugin.
+The plugin registers Ember as the default Rails template handler for "erb"
+and "rhtml" file types.  Ember processing options can be set in the Rails
+environment file:</p>
+
+<pre><code>ActionView::TemplateHandlers::Ember.options = {
+  :unindent =&gt; true,
+  :shorthand =&gt; true,
+  :infer_end =&gt; true
+}
+</code></pre>
+
+<p>This feature was contributed by Kamil Kukura.</p></li>
+</ul>
+
+
 <h3 id="Version-0-1-1-2010-04-20-">Version 0.1.1 (2010-04-20)</h3>
 
 <p>This release fixes a nested rendering bug, updates the manual, and further
@@ -679,9 +713,9 @@ beautifies the Ruby code that results from eRuby template compilation.</p>
 <li><p><code>Ember::Template#render()</code> now creates isolated contexts by default to
 prevent nested calls from clobbering each other's output!</p>
 
-<p>For example, if template A calls method X which renders template B (thinking
-that template B's rendering is isolated and will not affect the rendering of
-template A) then you're in for a hell of a wild bug chase!  >8-(</p></li>
+<p>For example, if template A calls method X which renders template B
+(thinking that template B's rendering is isolated and will not affect the
+rendering of template A) then you're in for a wild bug chase!  >8-(</p></li>
 </ul>
 
 
@@ -710,13 +744,13 @@ with section separators made from single-line comment directives:</p>
 
   Inside some_block_directive.
 
-%#---------------------------------------------------------------------
+%#-------------------------------------------------------------------
 
   Still inside some_block_directive!
 
-  %#-------------------------------------------------------------------
+  %#-----------------------------------------------------------------
   %| nested_block_directive
-  %#-------------------------------------------------------------------
+  %#-----------------------------------------------------------------
 
     Inside nested_block_directive.
 </code></pre></li>
@@ -755,9 +789,7 @@ depends on the "inochi" or "trollop" gems at runtime.</li>
 <ul>
 <li><p>Use simpler Copyright reminder at the top of every file.</p></li>
 <li><p>Rename internal <code>Program</code> class' methods to be self-documenting.</p></li>
-<li><p>Open source is for fun, so <a href="http://loiclemeur.com/english/2009/03/never-criticize-your-competitors.html">be
-nice</a>
-and speak of "related works" instead of "competitors".</p></li>
+<li><p>Open source is for fun, so <a href="http://loiclemeur.com/english/2009/03/never-criticize-your-competitors.html">be nice</a> and speak of "related works" instead of "competitors".</p></li>
 </ul>
 
 
@@ -767,13 +799,14 @@ and speak of "related works" instead of "competitors".</p></li>
 
 <h2 id="CREDITS">CREDITS</h2>
 
-<p>Suraj N. Kurapati</p>
+<p>Suraj N. Kurapati,
+Kamil Kukura</p>
 
 <h2 id="LICENSE">LICENSE</h2>
 
 <p>(the ISC license)</p>
 
-<p>Copyright 2009 Suraj N. Kurapati <a href="&#109;&#97;&#105;&#x6c;&#x74;&#111;&#x3a;&#x73;&#x75;&#110;&#x61;&#107;&#117;&#64;&#x67;&#109;&#x61;&#105;&#x6c;&#x2e;&#x63;&#x6f;&#109;" data-bare-link="true">&#115;&#x75;&#x6e;&#x61;&#x6b;&#117;&#x40;&#103;&#109;&#x61;&#105;&#x6c;&#x2e;&#99;&#111;&#109;</a></p>
+<p>Copyright 2009 Suraj N. Kurapati <a href="&#x6d;&#97;&#x69;&#108;&#116;&#111;&#x3a;&#x73;&#117;&#x6e;&#x61;&#x6b;&#x75;&#64;&#103;&#x6d;&#97;&#105;&#x6c;&#x2e;&#99;&#x6f;&#x6d;" data-bare-link="true">&#115;&#117;&#x6e;&#97;&#x6b;&#117;&#x40;&#x67;&#x6d;&#x61;&#105;&#108;&#46;&#99;&#x6f;&#x6d;</a></p>
 
 <p>Permission to use, copy, modify, and/or distribute this software for any
 purpose with or without fee is hereby granted, provided that the above
@@ -789,9 +822,7 @@ OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.</p>
 
 <h2 id="SEE-ALSO">SEE ALSO</h2>
 
-<p>erb(1),
-<a href="http://www.kuwata-lab.com/erubis/">Erubis</a>,
-<a href="http://modruby.net/en/">eruby</a></p>
+<p>erb(1)</p>
 
 
 <ol class='foot man'>

metadata

@@ -4,17 +4,18 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 1
-  - 1
-  version: 0.1.1
+  - 2
+  - 0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Suraj N. Kurapati
+- Kamil Kukura
 autorequire: 
 bindir: bin
 cert_chain: []
 
-date: 2010-04-20 00:00:00 -07:00
+date: 2010-04-25 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -41,9 +42,7 @@ dependencies:
         version: "2"
   type: :development
   version_requirements: *id002
-description: |-
-  Ember (EMBEdded Ruby) is an eRuby template processor that allows
-  debugging, reduces markup, and improves composability of eRuby templates.
+description: Ember (EMBEdded Ruby) is an eRuby template processor that allows debugging, reduces markup, and improves composability of eRuby templates.
 email: 
 executables: 
 - ember
@@ -56,9 +55,11 @@ files:
 - lib/ember.rb
 - lib/ember/inochi.rb
 - lib/ember/template.rb
-- man/man1/ember.1.html
-- man/man1/ember.1.gz
+- lib/ember/helpers/rails_helper.rb
 - LICENSE
+- CREDITS
+- man.html
+- man/man1/ember.1.gz
 has_rdoc: true
 homepage: http://snk.tuxfamily.org/lib/ember/
 licenses: []