reflection 0.4.0 → 0.4.1

data/README.rdoc

@@ -1,18 +1,116 @@
-= reflection
+= Reflection
 
-Helps you keeping your development machine in sync with production.
-Currently just a snapshot, so don't use it for any important stuff (you could loose important data).
+Reflection is designed to keep your development system in sync with your production system's files and database (by dumping).
+It uses a shared git repository to store these files, which allows you to mirror your production environment without the need of 
+direct access to your production servers.
+
+It provides two main command modes:
+
+* Stash: Indented to be run on the server side, adds a specified directory and, optionally, a database dump to a shared Git repository
+* Apply: To be used on a local development machine, gets content from the repository, copies it to a specified directory and optionally loads the database dump into your local database
+
+
+== Get it
+
+Reflection is a gem, hosted on Gemcutter:
+
+
+  gem install gemcutter
+  gem tumble
+  gem install reflection
+
+
+
+== Stashing your production data 
+
+==== The simplest form:
+
+  $ reflection --stash --directory /path/to/your/assets --repository git@your-shared-repository.git
+
+This will clone <tt>git@your-shared-repository.git</tt> and add the directory <tt>/path/to/your/assets</tt> to the repository. 
+Reflection keeps a local version of your repository in HOME/.reflection/stash. So the next time you run the command, there is no need of cloning it again.
+
+
+==== Now, lets include a database dump
+
+  $ reflection  --stash \ 
+                --directory /path/to/your/assets \ 
+                --repository git@your-shared-repository.git \ 
+                --rails /rails/root \
+                --rails-env production
+
+This does the same as above, but additionally dumps your production database and adds the fresh dump to your repository.
+
+
+==== I'm lazy..
+
+You too, aren't you? So Reflection allows you to store all command line options in a config file.
+
+
+  $ reflection  --stash \ 
+                --directory /path/to/your/assets \ 
+                --repository git@your-shared-repository.git \ 
+                --rails /rails/root \ 
+                --rails-env production \ 
+                --write /path/to/your/config
+
+
+The next time you want to run the same command as above (useful for cron), you could simply call Reflection with:
+
+  $ reflection /path/to/your/config
+
+
+== Getting the production stuff on your local development machine
+
+This works exactly the same as describe above, but you would use --apply instead of --stash:
+
+  $ reflection  --apply \ 
+                --directory /path/to/your/assets \ 
+                --repository git@your-shared-repository.git \ 
+                --rails /rails/root \ 
+                --rails-env development
+
+This clones or pulls <tt>git@your-shared-repository.git</tt> (again, Reflection keeps a version of your Repository in HOME/.reflection/apply), copies the content to the specified directory (e.g. rails/application/public/assets) and optionally loads the dump into your database. 
+
+As you may have noticed, the Reflection command above got called with <tt>--rails-env development</tt>, which loads the dump in your development database (as defined by /rails/root/config/database.yml).
+
+
+==== A little productivity hint
+
+If you have a <tt>reflection.yml</tt> config file in your current application-development-directory, syncing your server-production environment is as easy as running:
+
+  $ reflection
+  
+
+== reflection --help
+
+  $ reflection --help
+  Usage: reflection --COMMAND --repository=GIT_REPO --directory=PATH
+   -or-
+  Usage: reflection /path/to/reflection-config-file.yml
+ 
+  On the server side:
+      -s, --stash                      Store your assets and/or a database dump in a git-repository.
+  On the client side:
+      -a, --apply                      Apply assets and/or a database dump loaded from a git-repository.
+ 
+  Required options for both:
+      -r, --repository GIT_URL         A Git repository(url) to be used as storage
+      -d, --directory PATH             Path to your asset directory
+ 
+  Additional options for both:
+          --rails [RAILS_ROOT]         Enable dumping/applying of a Rails managed MySQL database
+          --rails-env [ENV]            Rails environment to instrument
+          --write [FILE]               Create a configuration FILE from the current commandline options
 
 
 == Note on Patches/Pull Requests
  
 * Fork the project.
 * Make your feature addition or bug fix.
-* Add tests for it. This is important so I don't break it in a
-  future version unintentionally.
+* Add specs for it. This is important so I don't break it in a future version unintentionally.
 * Commit, do not mess with rakefile, version, or history.
-  (if you want to have your own version, that is fine but
-   bump version in a commit by itself I can ignore when I pull)
+  (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
 * Send me a pull request. Bonus points for topic branches.
 
 == Copyright

data/Reflection.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{reflection}
-  s.version = "0.4.0"
+  s.version = "0.4.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Andreas Wolff"]
@@ -25,6 +25,7 @@ Gem::Specification.new do |s|
   s.files = [
     ".document",
      ".gitignore",
+     ".yardoc",
      "LICENSE",
      "README.rdoc",
      "Rakefile",
@@ -32,6 +33,36 @@ Gem::Specification.new do |s|
      "TODO",
      "VERSION",
      "bin/reflection",
+     "doc/Reflection.html",
+     "doc/Reflection/CLI.html",
+     "doc/Reflection/Command.html",
+     "doc/Reflection/Command/Apply.html",
+     "doc/Reflection/Command/Base.html",
+     "doc/Reflection/Command/Stash.html",
+     "doc/Reflection/Config.html",
+     "doc/Reflection/ConfigArgumentError.html",
+     "doc/Reflection/Directory.html",
+     "doc/Reflection/Directory/Base.html",
+     "doc/Reflection/Directory/Stash.html",
+     "doc/Reflection/Rails.html",
+     "doc/Reflection/Repository.html",
+     "doc/Reflection/Support.html",
+     "doc/Reflection/Support/Home.html",
+     "doc/Reflection/Support/Log.html",
+     "doc/Reflection/Validations.html",
+     "doc/_index.html",
+     "doc/class_list.html",
+     "doc/css/common.css",
+     "doc/css/full_list.css",
+     "doc/css/style.css",
+     "doc/file.README.html",
+     "doc/file_list.html",
+     "doc/index.html",
+     "doc/js/app.js",
+     "doc/js/full_list.js",
+     "doc/js/jquery.js",
+     "doc/method_list.html",
+     "doc/top-level-namespace.html",
      "lib/reflection.rb",
      "lib/reflection/cli.rb",
      "lib/reflection/command.rb",

data/VERSION

@@ -1 +1 @@
-0.4.0
+0.4.1

data/doc/Reflection/CLI.html

@@ -0,0 +1,153 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta name="Content-Type" content="text/html; charset=UTF-8" />
+<title>Module: Reflection::CLI</title>
+<link rel="stylesheet" href="../css/style.css" type="text/css" media="screen" charset="utf-8" />
+<link rel="stylesheet" href="../css/common.css" type="text/css" media="screen" charset="utf-8" />
+
+<script type="text/javascript" charset="utf-8">
+  relpath = '..';
+  if (relpath != '') relpath += '/';
+</script>
+<script type="text/javascript" charset="utf-8" src="../js/jquery.js"></script>
+<script type="text/javascript" charset="utf-8" src="../js/app.js"></script>
+
+  </head>
+  <body>
+    <div id="header">
+      <div id="menu">
+  
+    <a href="../_index.html">Index (C)</a> &raquo; 
+    <a title="Reflection" href="../Reflection.html">Reflection</a>
+     &raquo; 
+    <span class="title">CLI</span>
+  
+</div>
+
+      <div id="search">
+  <a id="class_list_link" href="#">Namespace List</a>
+  <a id="method_list_link" href="#">Method List</a>
+  <a id ="file_list_link" href="#">File List</a>
+</div>
+
+      <div class="clear"></div>
+    </div>
+    
+    <iframe id="search_frame"></iframe>
+    
+    <div id="content"><h1>Module: Reflection::CLI 
+  
+  
+</h1>
+
+<dl class="box">
+  
+  
+    
+  
+    
+  
+  
+    <dt class="r1 last">Defined in:</dt>
+    <dd class="r1 last">lib/reflection/cli.rb</dd>
+  
+</dl>
+<div class="clear"></div>
+
+
+
+
+  <h2>Method Summary</h2>
+  <ul class="summary">
+    
+      <li class="public ">
+  <span class="summary_signature"><a title="run! (class method)" href="#run%21-class_method">+ (Object) <strong>run!</strong>(args = nil) </a>
+  
+  </span>
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"></span>
+  
+</li>
+
+    
+  </ul>
+
+
+
+  <div id="method_details">
+    <h2>Method Details</h2>
+    
+      <div class="method_details first">
+  <p class="signature first" id="run!-class_method">
+  
+    + (<tt>Object</tt>) <strong>run!</strong>(args = nil) 
+  
+
+  
+</p><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+5
+6
+7
+8
+9
+10
+11
+12
+13
+14
+15
+16
+17
+18
+19
+20</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/reflection/cli.rb', line 5</span>
+
+<span class='def def kw'>def</span> <span class='run! fid id'>run!</span><span class='lparen token'>(</span><span class='args identifier id'>args</span> <span class='assign token'>=</span> <span class='nil nil kw'>nil</span><span class='rparen token'>)</span>
+  <span class='config identifier id'>config</span> <span class='assign token'>=</span> <span class='Reflection constant id'>Reflection</span><span class='colon2 op'>::</span><span class='Config constant id'>Config</span><span class='dot token'>.</span><span class='parse identifier id'>parse</span><span class='lparen token'>(</span><span class='args identifier id'>args</span><span class='rparen token'>)</span>
+
+  <span class='if if kw'>if</span> <span class='verify_config identifier id'>verify_config</span><span class='lparen token'>(</span><span class='config identifier id'>config</span><span class='rparen token'>)</span> <span class='eq op'>==</span> <span class='false false kw'>false</span>
+    <span class='Reflection constant id'>Reflection</span><span class='colon2 op'>::</span><span class='Support constant id'>Support</span><span class='dot token'>.</span><span class='exit_with_error identifier id'>exit_with_error</span><span class='lparen token'>(</span><span class='string val'>&quot;Ahh ja, missing arguments. Please read 'reflection --help' to get a feeling of how it works.&quot;</span><span class='rparen token'>)</span>
+  <span class='else else kw'>else</span>
+    <span class='case case kw'>case</span> <span class='config identifier id'>config</span><span class='dot token'>.</span><span class='command identifier id'>command</span>
+      <span class='when when kw'>when</span> <span class='symbol val'>:apply</span>
+        <span class='Reflection constant id'>Reflection</span><span class='colon2 op'>::</span><span class='Command constant id'>Command</span><span class='colon2 op'>::</span><span class='Apply constant id'>Apply</span><span class='dot token'>.</span><span class='run! fid id'>run!</span><span class='lparen token'>(</span><span class='config identifier id'>config</span><span class='rparen token'>)</span>
+      <span class='when when kw'>when</span> <span class='symbol val'>:stash</span>
+        <span class='Reflection constant id'>Reflection</span><span class='colon2 op'>::</span><span class='Command constant id'>Command</span><span class='colon2 op'>::</span><span class='Stash constant id'>Stash</span><span class='dot token'>.</span><span class='run! fid id'>run!</span><span class='lparen token'>(</span><span class='config identifier id'>config</span><span class='rparen token'>)</span>
+      <span class='else else kw'>else</span>
+        <span class='Reflection constant id'>Reflection</span><span class='colon2 op'>::</span><span class='Support constant id'>Support</span><span class='dot token'>.</span><span class='exit_with_error identifier id'>exit_with_error</span><span class='lparen token'>(</span><span class='string val'>&quot;Couldn't identify command. Please run 'reflection --help'.&quot;</span><span class='rparen token'>)</span>
+    <span class='end end kw'>end</span>
+  <span class='end end kw'>end</span>
+<span class='end end kw'>end</span>
+</pre>
+    </td>
+  </tr>
+</table>
+</div>
+    
+  </div>
+
+</div>
+    
+    <div id="footer">
+  Generated on Wed Nov 18 18:17:11 2009 by 
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool">yard</a>
+  0.4.0 (ruby-1.8.7).
+</div>
+
+  </body>
+</html>

data/doc/Reflection/Command/Apply.html

@@ -0,0 +1,266 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta name="Content-Type" content="text/html; charset=UTF-8" />
+<title>Class: Reflection::Command::Apply</title>
+<link rel="stylesheet" href="../../css/style.css" type="text/css" media="screen" charset="utf-8" />
+<link rel="stylesheet" href="../../css/common.css" type="text/css" media="screen" charset="utf-8" />
+
+<script type="text/javascript" charset="utf-8">
+  relpath = '../..';
+  if (relpath != '') relpath += '/';
+</script>
+<script type="text/javascript" charset="utf-8" src="../../js/jquery.js"></script>
+<script type="text/javascript" charset="utf-8" src="../../js/app.js"></script>
+
+  </head>
+  <body>
+    <div id="header">
+      <div id="menu">
+  
+    <a href="../../_index.html">Index (A)</a> &raquo; 
+    <a title="Reflection" href="../../Reflection.html">Reflection</a> &raquo; <a title="Command" href="../Command.html">Command</a>
+     &raquo; 
+    <span class="title">Apply</span>
+  
+</div>
+
+      <div id="search">
+  <a id="class_list_link" href="#">Namespace List</a>
+  <a id="method_list_link" href="#">Method List</a>
+  <a id ="file_list_link" href="#">File List</a>
+</div>
+
+      <div class="clear"></div>
+    </div>
+    
+    <iframe id="search_frame"></iframe>
+    
+    <div id="content"><h1>Class: Reflection::Command::Apply 
+  
+  
+</h1>
+
+<dl class="box">
+  
+    <dt class="r1">Inherits:</dt>
+    <dd class="r1">
+      <span class="inheritName"><a title="Reflection::Command::Base" href="Base.html">Reflection::Command::Base</a></span>
+      
+        <ul class="fullTree">
+          <li>Object</li>
+          
+            <li class="next"><a title="Reflection::Command::Base" href="Base.html">Reflection::Command::Base</a></li>
+          
+            <li class="next">Reflection::Command::Apply</li>
+          
+        </ul>
+        <a href="#" class="inheritanceTree">show all</a>
+      
+      </dd>
+    
+  
+  
+    
+  
+    
+  
+  
+    <dt class="r2 last">Defined in:</dt>
+    <dd class="r2 last">lib/reflection/command/apply.rb</dd>
+  
+</dl>
+<div class="clear"></div>
+
+
+
+  
+  
+  
+  
+
+  <h2>Method Summary</h2>
+  <ul class="summary">
+    
+      <li class="public ">
+  <span class="summary_signature"><a title="#run! (instance method)" href="#run%21-instance_method">- (Object) <strong>run!</strong> </a>
+  
+  </span>
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"></span>
+  
+</li>
+
+    
+      <li class="public ">
+  <span class="summary_signature"><a title="#validate! (instance method)" href="#validate%21-instance_method">- (Object) <strong>validate!</strong> </a>
+  
+  </span>
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"></span>
+  
+</li>
+
+    
+  </ul>
+
+
+  
+  
+  
+  
+  
+  <h3 class="inherited">Methods inherited from <a title="Reflection::Command::Base" href="Base.html">Reflection::Command::Base</a></h3>
+  <p class="inherited"><a title="#initialize" href="Base.html#initialize-instance_method">#initialize</a>, <a title="run!" href="Base.html#run%21-class_method">run!</a>, <a title="#validate" href="Base.html#validate-instance_method">#validate</a>, <a title="#verify_that_target_is_not_a_repository" href="Base.html#verify_that_target_is_not_a_repository-instance_method">#verify_that_target_is_not_a_repository</a></p>
+<div id="constructor_details">
+  <h2>Constructor Details</h2>
+  
+    <p class="notice">This class inherits a constructor from <a title="Reflection::Command::Base" href="Base.html#initialize-instance_method">Reflection::Command::Base</a></p>
+  
+</div>
+
+
+  <div id="method_details">
+    <h2>Method Details</h2>
+    
+      <div class="method_details first">
+  <p class="signature first" id="run!-instance_method">
+  
+    - (<tt>Object</tt>) <strong>run!</strong> 
+  
+
+  
+</p><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+15
+16
+17
+18
+19
+20
+21
+22
+23
+24
+25
+26
+27
+28
+29
+30
+31
+32
+33
+34
+35
+36
+37
+38
+39
+40
+41
+42
+43</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/reflection/command/apply.rb', line 15</span>
+
+<span class='def def kw'>def</span> <span class='run! fid id'>run!</span>
+  <span class='stash_directory identifier id'>stash_directory</span> <span class='assign token'>=</span> <span class='Directory constant id'>Directory</span><span class='colon2 op'>::</span><span class='Stash constant id'>Stash</span><span class='dot token'>.</span><span class='new identifier id'>new</span><span class='lparen token'>(</span><span class='Reflection constant id'>Reflection</span><span class='colon2 op'>::</span><span class='Repository constant id'>Repository</span><span class='dot token'>.</span><span class='new identifier id'>new</span><span class='lparen token'>(</span><span class='config identifier id'>config</span><span class='dot token'>.</span><span class='repository identifier id'>repository</span><span class='rparen token'>)</span><span class='comma token'>,</span> <span class='string val'>'apply'</span><span class='rparen token'>)</span>
+  <span class='target_directory identifier id'>target_directory</span> <span class='assign token'>=</span> <span class='Directory constant id'>Directory</span><span class='colon2 op'>::</span><span class='Base constant id'>Base</span><span class='dot token'>.</span><span class='new identifier id'>new</span><span class='lparen token'>(</span><span class='config identifier id'>config</span><span class='dot token'>.</span><span class='directory identifier id'>directory</span><span class='rparen token'>)</span>
+
+  <span class='get_user_approval_for_cleaning_target identifier id'>get_user_approval_for_cleaning_target</span><span class='lparen token'>(</span><span class='target_directory identifier id'>target_directory</span><span class='rparen token'>)</span>
+  <span class='get_user_approval_for_apply_database_dump identifier id'>get_user_approval_for_apply_database_dump</span> <span class='if if_mod kw'>if</span> <span class='config identifier id'>config</span><span class='dot token'>.</span><span class='rails_root identifier id'>rails_root</span>
+  
+  <span class='verify_that_target_is_not_a_repository identifier id'>verify_that_target_is_not_a_repository</span><span class='lparen token'>(</span><span class='target_directory identifier id'>target_directory</span><span class='rparen token'>)</span>
+
+  <span class='Reflection constant id'>Reflection</span><span class='dot token'>.</span><span class='log identifier id'>log</span><span class='dot token'>.</span><span class='info identifier id'>info</span> <span class='dstring node'>&quot;Applying '#{config.repository}' &gt;&gt; '#{config.directory}'..&quot;</span>
+
+  <span class='target_directory identifier id'>target_directory</span><span class='dot token'>.</span><span class='clean! fid id'>clean!</span>
+
+  <span class='if if kw'>if</span> <span class='stash_directory identifier id'>stash_directory</span><span class='dot token'>.</span><span class='exists? fid id'>exists?</span>
+    <span class='stash_directory identifier id'>stash_directory</span><span class='dot token'>.</span><span class='validate_repository identifier id'>validate_repository</span>
+    <span class='stash_directory identifier id'>stash_directory</span><span class='dot token'>.</span><span class='copy_git_index_to identifier id'>copy_git_index_to</span><span class='lparen token'>(</span><span class='target_directory identifier id'>target_directory</span><span class='dot token'>.</span><span class='path identifier id'>path</span><span class='rparen token'>)</span>
+    <span class='repo identifier id'>repo</span> <span class='assign token'>=</span> <span class='Repository constant id'>Repository</span><span class='dot token'>.</span><span class='new_from_path identifier id'>new_from_path</span><span class='lparen token'>(</span><span class='target_directory identifier id'>target_directory</span><span class='dot token'>.</span><span class='path identifier id'>path</span><span class='rparen token'>)</span>
+    <span class='repo identifier id'>repo</span><span class='dot token'>.</span><span class='reset! fid id'>reset!</span>
+    <span class='repo identifier id'>repo</span><span class='dot token'>.</span><span class='pull identifier id'>pull</span>
+    <span class='stash_directory identifier id'>stash_directory</span><span class='dot token'>.</span><span class='get_git_index_from identifier id'>get_git_index_from</span><span class='lparen token'>(</span><span class='target_directory identifier id'>target_directory</span><span class='dot token'>.</span><span class='path identifier id'>path</span><span class='rparen token'>)</span>
+  <span class='else else kw'>else</span>
+    <span class='stash_directory identifier id'>stash_directory</span><span class='dot token'>.</span><span class='clone_repository identifier id'>clone_repository</span>
+    <span class='stash_directory identifier id'>stash_directory</span><span class='dot token'>.</span><span class='move_content_to identifier id'>move_content_to</span><span class='lparen token'>(</span><span class='target_directory identifier id'>target_directory</span><span class='dot token'>.</span><span class='path identifier id'>path</span><span class='rparen token'>)</span>
+    <span class='stash_directory identifier id'>stash_directory</span><span class='dot token'>.</span><span class='get_git_index_from identifier id'>get_git_index_from</span><span class='lparen token'>(</span><span class='target_directory identifier id'>target_directory</span><span class='dot token'>.</span><span class='path identifier id'>path</span><span class='rparen token'>)</span>
+  <span class='end end kw'>end</span>
+
+  <span class='Reflection constant id'>Reflection</span><span class='colon2 op'>::</span><span class='Rails constant id'>Rails</span><span class='dot token'>.</span><span class='apply identifier id'>apply</span><span class='lparen token'>(</span><span class='config identifier id'>config</span><span class='comma token'>,</span> <span class='target_directory identifier id'>target_directory</span><span class='rparen token'>)</span>
+  <span class='Reflection constant id'>Reflection</span><span class='dot token'>.</span><span class='log identifier id'>log</span><span class='dot token'>.</span><span class='info identifier id'>info</span> <span class='string val'>&quot;Apply Command done.&quot;</span>
+<span class='end end kw'>end</span>
+</pre>
+    </td>
+  </tr>
+</table>
+</div>
+    
+      <div class="method_details ">
+  <p class="signature " id="validate!-instance_method">
+  
+    - (<tt>Object</tt>) <strong>validate!</strong> 
+  
+
+  
+</p><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+7
+8
+9
+10
+11
+12
+13</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/reflection/command/apply.rb', line 7</span>
+
+<span class='def def kw'>def</span> <span class='validate! fid id'>validate!</span>
+  <span class='validate identifier id'>validate</span><span class='dot token'>.</span><span class='existence_of identifier id'>existence_of</span> <span class='config identifier id'>config</span><span class='dot token'>.</span><span class='directory identifier id'>directory</span>
+  <span class='if if kw'>if</span> <span class='config identifier id'>config</span><span class='dot token'>.</span><span class='rails_root identifier id'>rails_root</span>
+    <span class='validate identifier id'>validate</span><span class='dot token'>.</span><span class='existence_of identifier id'>existence_of</span> <span class='config identifier id'>config</span><span class='dot token'>.</span><span class='rails_root identifier id'>rails_root</span>
+    <span class='Reflection constant id'>Reflection</span><span class='colon2 op'>::</span><span class='Rails constant id'>Rails</span><span class='dot token'>.</span><span class='validate_environment identifier id'>validate_environment</span><span class='lparen token'>(</span><span class='config identifier id'>config</span><span class='rparen token'>)</span>
+  <span class='end end kw'>end</span>
+<span class='end end kw'>end</span>
+</pre>
+    </td>
+  </tr>
+</table>
+</div>
+    
+  </div>
+
+</div>
+    
+    <div id="footer">
+  Generated on Wed Nov 18 18:17:10 2009 by 
+  <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool">yard</a>
+  0.4.0 (ruby-1.8.7).
+</div>
+
+  </body>
+</html>