RubyGems - ruhl - Versions diffs - 0.6.0 - Mend

ruhl 0.6.0

Files changed (23) hide show

data/.gitignore +4 -0
data/README +241 -0
data/Rakefile +32 -0
data/VERSION +1 -0
data/lib/ruhl.rb +135 -0
data/lib/ruhl/errors.rb +5 -0
data/lib/ruhl/rails.rb +21 -0
data/lib/ruhl/sinatra.rb +29 -0
data/ruhl.gemspec +67 -0
data/spec/html/basic.html +9 -0
data/spec/html/fragment.html +2 -0
data/spec/html/if.html +23 -0
data/spec/html/layout.html +8 -0
data/spec/html/main_with_sidebar.html +22 -0
data/spec/html/medium.html +23 -0
data/spec/html/render_if.html +25 -0
data/spec/html/seo.html +11 -0
data/spec/html/sidebar.html +7 -0
data/spec/rcov.opts +5 -0
data/spec/ruhl_spec.rb +163 -0
data/spec/spec.opts +3 -0
data/spec/spec_helper.rb +26 -0
metadata +96 -0

data/.gitignore ADDED

@@ -0,0 +1,4 @@
+*.DS_Store
+*.swp
+pkg/**
+coverage/**

data/README ADDED

@@ -0,0 +1,241 @@
+Ruhl (Ruby Hypertext Language)
+This project is here to flesh out an idea.  What I want is to have developers
+work with HTML and with the simple addition of a 'data-ruhl' attribute, convert it
+to a dynamic page.
+At no time in the dev process would the view be unviewable in a browser.
+The view could actually retain the original template data the designer used
+because this replaces the content.  I think this is a nice plus.
+Notes (use cases) for me to remember:
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:: Basic Use ::
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+<h1 data-ruhl="page_header">
+Method :page_header would know how to represent itself in the context of
+the h1 element.
+The Ruby executed would replace the content of the element it was being
+called on.
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:: Replacing attribute values ::
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+<meta data-ruhl="content: meta_description" content='This is a description template'
+  id='metaDescription' name='description' />
+content: meta_description is telling the parser to replace attribute 'content'
+with results from meta_description method.
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:: Don't use iterators in views ::
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+<table id="aab">
+  <tr data-ruhl="_collection: user_list">
+    <td data-ruhl="name">John Doe</td>
+    <td data-ruhl="email">john@doe.com</td>
+  </tr>
+</table>
+The above will call the :user_list method and iterate over the results.  For each result it will duplicate the tag and it's contents.  For the above example this means:
+  <tr data-ruhl="_collection: user_list">
+    <td data-ruhl="name">John Doe</td>
+    <td data-ruhl="email">john@doe.com</td>
+  </tr>
+is duplicated for each user in user_list.
+If user_list return an array of User objects like:
+[ User.create(:name => 'Rupert Boy', :email => 'rupert@stonean.com'),
+  User.create(:name => 'Kaylee Girl', :email => 'kaylee@stonean.com'),
+  User.create(:name => 'Monty Man', :email => 'monty@stonean.com')]
+<table id="aab">
+  <tr>
+    <td>Rupert Boy</td>
+    <td>rupert@stonean.com</td>
+  </tr>
+  <tr>
+    <td>Kaylee Girl</td>
+    <td>kaylee@stonean.com</td>
+  </tr>
+  <tr>
+    <td>Monty Man</td>
+    <td>monty@stonean.com</td>
+  </tr>
+</table>
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:: Using a Layout ::
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Layout:
+<html>
+  <head>
+    <title>This is a title template</title>
+  </head>
+  <body>
+    <div data-ruhl="_render_"></div>
+  </body>
+</html>
+Fragment:
+<h1 data-ruhl="generate_h1">I am a templated headline</h1>
+<p data-ruhl="my_content">Lorem ipsum dolor sit amet</p>
+To use:
+Ruhl::Engine.new(File.read(fragment), :layout => path_to_layout).render(self)
+Returns the expected result of parsed Layout w/ parsed Fragment.
+Note the use of the _render_ method.  This is a 'special' method that
+Ruhl uses to inject the results of the parsed fragment into the layout.
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:: Using a Partial ::
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+Main:
+<html>
+  <head>
+    <title>This is a title template</title>
+  </head>
+  <body>
+    <div id="wrap">
+      <div id="sidebar" data-ruhl="_partial: sidebar_partial">
+        <h3>Sidebar links</h3>
+        <ul>
+          <li><a href="#">Link 1</a></li>
+          <li><a href="#">Link 2</a></li>
+          <li><a href="#">Link 3</a></li>
+          <li><a href="#">Link 4</a></li>
+        </ul>
+      </div>
+      <div id="main">
+        <h1> My main content</h1>
+        <p>Text designers would put here to test their layout</p>
+      </div>
+    </div>
+  </body>
+</html>
+Sidebar:
+<h3>Real Sidebarlinks</h3>
+<ul>
+  <li><a href="#">Real Link 1</a></li>
+  <li><a href="#">Real Link 2</a></li>
+  <li><a href="#">Real Link 3</a></li>
+  <li><a href="#">Real Link 4</a></li>
+</ul>
+To use:
+Ruhl::Engine.new(File.read(path_to_main)).render(self)
+Returns the expected result of parsed Main with sidebar div contents
+replaced with parsed sidebar partial contents.
+Note the use of the _partial key.  This is a 'special' key that Ruhl
+uses to inject the results of the parsed partial into the contents
+of the calling node.
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:: Conditional display of block (_render_if)::
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+<html>
+  <head>
+    <title>This is a title template</title>
+  </head>
+  <body>
+    <h1>This is the header template</h1>
+    <div data-ruhl="_render_if: has_users?">
+      <table>
+        <thead>
+          <tr>
+            <td>First Name</td>
+            <td>Last Name</td>
+            <td>Email</td>
+          </tr>
+        </thead>
+        <tr data-ruhl="_collection: user_list">
+          <td data-ruhl="first_name">Andrew</td>
+          <td data-ruhl="last_name">Stone</td>
+          <td data-ruhl="email">andy@stonean.com</td>
+        </tr>
+      </table>
+    </div>
+    </ul>
+  </body>
+</html>
+if has_users? returns false then the div (including it's contents) are not shown
+on output.
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:: Conditional display of tag (_if)::
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+<html>
+  <head>
+    <title>This is a title template</title>
+  </head>
+  <body>
+    <h1>This is the header template</h1>
+    <table>
+      <thead>
+        <tr>
+          <td>First Name</td>
+          <td>Last Name</td>
+          <td>Email</td>
+        </tr>
+      </thead>
+      <tr data-ruhl="_collection: user_list">
+        <td data-ruhl="first_name">Andrew</td>
+        <td data-ruhl="last_name">Stone</td>
+        <td data-ruhl="_if: email">andy@stonean.com</td>
+      </tr>
+    </table>
+    </ul>
+  </body>
+</html>
+if email == nil  then the td is not shown.
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:: Notes ::
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+* No eval (I don't think eval is evil, it's just not the way this works)
+* The data-ruhl attribute is always removed from the output.
+* Each method called must accept a tag parameter.
+    e.g def page_header(tag)
+* Since it's just HTML, syntax highlighting is built-in.
+  For vim, just add this to your ~/.vimrc:
+    au BufNewFile,BufRead *.ruhl set filetype=html
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+:: TODO ::
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+1) Test more scenarios

data/Rakefile ADDED

@@ -0,0 +1,32 @@
+require 'rubygems'
+require 'rake'
+require 'rcov'
+require 'spec/rake/spectask'
+task :default => 'rcov'
+desc "Run all specs and rcov in a non-sucky way"
+Spec::Rake::SpecTask.new(:rcov) do |t|
+  t.spec_opts = IO.readlines("spec/spec.opts").map {|l| l.chomp.split " "}.flatten
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.rcov = true
+  t.rcov_opts = IO.readlines("spec/rcov.opts").map {|l| l.chomp.split " "}.flatten
+end
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "ruhl"
+    gemspec.summary = "Ruby Hypertext Language"
+    gemspec.description = "Make your HTML dynamic with the addition of a ruby attribute."
+    gemspec.email = "andy@stonean.com"
+    gemspec.homepage = "http://github.com/stonean/ruhl"
+    gemspec.authors = ["Andrew Stone"]
+    gemspec.add_dependency('nokogiri','>=1.3.3')
+    gemspec.add_development_dependency('rspec')
+  end
+rescue LoadError
+  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end

data/VERSION ADDED

	@@ -0,0 +1 @@
1	+ 0.6.0

data/lib/ruhl.rb ADDED

@@ -0,0 +1,135 @@
+$:.unshift File.dirname(__FILE__)
+require 'nokogiri'
+require 'ruhl/errors'
+module Ruhl
+  class Engine
+    attr_reader :document, :scope, :layout, :local_object
+    def initialize(html, options = {})
+      @local_object = options[:local_object]
+      if @layout = options[:layout]
+        raise LayoutNotFoundError.new(@layout) unless File.exists?(@layout)
+      end
+      if @layout || @local_object
+        @document = Nokogiri::HTML.fragment(html)
+      else
+        @document = Nokogiri::HTML(html)
+      end
+    end
+    def render(current_scope)
+      set_scope(current_scope)
+      parse_doc(@document)
+      if @layout
+        render_with_layout
+      else
+        document.to_s
+      end
+    end
+    # The _render_ method is used within a layout to inject
+    # the results of the template render.
+    #
+    # Ruhl::Engine.new(html, :layout => path_to_layout).render(self)
+    def _render_
+      document.to_s
+    end
+    private
+    def render_with_layout
+      render_file( File.read(@layout) )
+    end
+    def render_partial(tag, code)
+      file = execute_ruby(tag, code)
+      raise PartialNotFoundError.new(file) unless File.exists?(file)
+      render_file( File.read(file) )
+    end
+    def render_collection(tag, code)
+      results = execute_ruby(tag, code)
+      html = tag.to_html
+      new_content = results.collect do |item|
+        Ruhl::Engine.new(html, :local_object => item).render(scope)
+      end.to_s
+      tag.swap(new_content)
+    end
+    def render_file(contents)
+      doc = Nokogiri::HTML( contents )
+      parse_doc(doc)
+      doc.to_s
+    end
+    def parse_doc(doc)
+      if (nodes = doc.xpath('//*[@data-ruhl][1]')).empty?
+        nodes = doc.search('*[@data-ruhl]')
+      end
+      return if nodes.empty?
+      tag = nodes.first
+      code = tag.remove_attribute('data-ruhl')
+      process_attribute(tag, code.value)
+      parse_doc(doc)
+    end
+    def process_attribute(tag, code)
+      code.split(',').each do |pair|
+        attribute, value = pair.split(':')
+        if value.nil?
+          tag.inner_html = execute_ruby(tag, attribute)
+        else
+          value.strip!
+          if attribute  == "_partial"
+            tag.inner_html = render_partial(tag, value)
+          elsif attribute  == "_collection"
+            render_collection(tag, value)
+          elsif attribute  == "_if"
+            contents = execute_ruby(tag, value)
+            if contents
+              tag.inner_html = contents
+            else
+              tag.remove
+            end
+          elsif attribute  == "_render_if"
+            unless execute_ruby(tag, value)
+              tag.remove
+            end
+          else
+            tag[attribute] = execute_ruby(tag, value)
+          end
+        end
+      end
+    end
+    def execute_ruby(tag, code)
+      unless code == '_render_'
+        if local_object && local_object.respond_to?(code)
+          local_object.send(code)
+        else
+          scope.send(code, tag)
+        end
+      else
+        _render_
+      end
+    end
+    def set_scope(current_scope)
+      raise Ruhl::NoScopeError unless current_scope
+      @scope = current_scope
+    end
+  end
+end

data/lib/ruhl/errors.rb ADDED

@@ -0,0 +1,5 @@
+module Ruhl
+  class LayoutNotFoundError < StandardError; end
+  class PartialNotFoundError < StandardError; end
+  class NoScopeError < StandardError; end
+end

data/lib/ruhl/rails.rb ADDED

@@ -0,0 +1,21 @@
+module Ruhl
+  class Plugin < ActionView::TemplateHandler
+    def initialize(action_view)
+      @action_view = action_view
+    end
+    def render(template, options)
+      layout = @action_view.controller.send(:active_layout)
+      puts "==========> @action_view: #{@action_view.controller.response.inspect}"
+      puts "==========> template: #{template.inspect}"
+      puts "==========> options: #{options.inspect}"
+    end
+  end
+end
+ActionView::Template.register_template_handler(:ruhl, Ruhl::Plugin)
+ActionView::Template.exempt_from_layout(:ruhl)

data/lib/ruhl/sinatra.rb ADDED

@@ -0,0 +1,29 @@
+require 'ruhl'
+module Sinatra
+  module Templates
+    def ruhl(template, options = {}, locals = {})
+      require_warn('Ruhl') unless defined?(::Ruhl::Engine)
+      render :ruhl, template, options, locals
+    end
+    private
+    def render(engine, template, options={}, locals={})
+      # merge app-level options
+      options = self.class.send(engine).merge(options) if self.class.respond_to?(engine)
+      views = options.delete(:views) || self.class.views || "./views"
+      # render template
+      data, options[:filename], options[:line] = lookup_template(engine, template, views)
+      __send__("render_#{engine}", template, data, options)
+    end
+    def render_ruhl(template, data, options)
+      ::Ruhl::Engine.new(data, options).render(self)
+    end
+  end
+end

data/ruhl.gemspec ADDED

@@ -0,0 +1,67 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE
+# Instead, edit Jeweler::Tasks in Rakefile, and run `rake gemspec`
+# -*- encoding: utf-8 -*-
+Gem::Specification.new do |s|
+  s.name = %q{ruhl}
+  s.version = "0.6.0"
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Andrew Stone"]
+  s.date = %q{2009-10-07}
+  s.description = %q{Make your HTML dynamic with the addition of a ruby attribute.}
+  s.email = %q{andy@stonean.com}
+  s.extra_rdoc_files = [
+    "README"
+  ]
+  s.files = [
+    ".gitignore",
+     "README",
+     "Rakefile",
+     "VERSION",
+     "lib/ruhl.rb",
+     "lib/ruhl/errors.rb",
+     "lib/ruhl/rails.rb",
+     "lib/ruhl/sinatra.rb",
+     "ruhl.gemspec",
+     "spec/html/basic.html",
+     "spec/html/fragment.html",
+     "spec/html/if.html",
+     "spec/html/layout.html",
+     "spec/html/main_with_sidebar.html",
+     "spec/html/medium.html",
+     "spec/html/render_if.html",
+     "spec/html/seo.html",
+     "spec/html/sidebar.html",
+     "spec/rcov.opts",
+     "spec/ruhl_spec.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/stonean/ruhl}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Ruby Hypertext Language}
+  s.test_files = [
+    "spec/ruhl_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<nokogiri>, [">= 1.3.3"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+    else
+      s.add_dependency(%q<nokogiri>, [">= 1.3.3"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<nokogiri>, [">= 1.3.3"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+  end
+end

data/spec/html/basic.html ADDED

@@ -0,0 +1,9 @@
+<html>
+  <head>
+    <title>Hello World</title>
+  </head>
+  <body>
+    <h1 data-ruhl="generate_h1">I am a templated headline</h1>
+    <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Curabitur sit amet lacinia metus. Nam sed dui est. Sed pellentesque aliquet massa, vel cursus arcu faucibus tincidunt. Nunc aliquet ultricies tellus sit amet elementum. Integer porttitor lorem dolor. Proin leo nunc, sollicitudin sed ullamcorper non, tempus non erat. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Sed commodo sodales pharetra. Vivamus pharetra, augue a volutpat scelerisque, elit nisl auctor elit, quis mollis dolor urna in ligula. Aliquam nisi augue, adipiscing quis mollis ut, aliquam nec urna. Morbi faucibus semper ante ut dignissim. Maecenas et dui eros, eget tristique odio. Sed vehicula erat nec dui porttitor laoreet.</p>
+  </body>
+</html>

data/spec/html/fragment.html ADDED

	@@ -0,0 +1,2 @@
1	+ <h1 data-ruhl="generate_h1">I am a templated headline</h1>
2	+ <p data-ruhl="my_content">Lorem ipsum dolor sit amet, consectetur adipiscing elit. Curabitur sit amet lacinia metus. Nam sed dui est. Sed pellentesque aliquet massa, vel cursus arcu faucibus tincidunt. Nunc aliquet ultricies tellus sit amet elementum. Integer porttitor lorem dolor. Proin leo nunc, sollicitudin sed ullamcorper non, tempus non erat. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Sed commodo sodales pharetra. Vivamus pharetra, augue a volutpat scelerisque, elit nisl auctor elit, quis mollis dolor urna in ligula. Aliquam nisi augue, adipiscing quis mollis ut, aliquam nec urna. Morbi faucibus semper ante ut dignissim. Maecenas et dui eros, eget tristique odio. Sed vehicula erat nec dui porttitor laoreet.</p>

data/spec/html/if.html ADDED

@@ -0,0 +1,23 @@
+<html>
+  <head>
+    <title>This is a title template</title>
+  </head>
+  <body>
+    <h1>This is the header template</h1>
+    <table>
+      <thead>
+        <tr>
+          <td>First Name</td>
+          <td>Last Name</td>
+          <td>Email</td>
+        </tr>
+      </thead>
+      <tr data-ruhl="_collection: user_list">
+        <td data-ruhl="first_name">Andrew</td>
+        <td data-ruhl="last_name">Stone</td>
+        <td data-ruhl="_if: email">andy@stonean.com</td>
+      </tr>
+    </table>
+    </ul>
+  </body>
+</html>

data/spec/html/layout.html ADDED

@@ -0,0 +1,8 @@
+<html>
+  <head>
+    <title>This is a title template</title>
+  </head>
+  <body>
+    <div data-ruhl="_render_"></div>
+  </body>
+</html>

data/spec/html/main_with_sidebar.html ADDED

@@ -0,0 +1,22 @@
+<html>
+  <head>
+    <title>This is a title template</title>
+  </head>
+  <body>
+    <div id="wrap">
+      <div id="sidebar" data-ruhl="_partial: sidebar_partial">
+        <h3>Sidebar links</h3>
+        <ul>
+          <li><a href="#">Link 1</a></li>
+          <li><a href="#">Link 2</a></li>
+          <li><a href="#">Link 3</a></li>
+          <li><a href="#">Link 4</a></li>
+        </ul>
+      </div>
+      <div id="main">
+        <h1> My main content</h1>
+        <p>Text designers would put here to test their layout</p>
+      </div>
+    </div>
+  </body>
+</html>

data/spec/html/medium.html ADDED

@@ -0,0 +1,23 @@
+<html>
+  <head>
+    <title>This is a title template</title>
+  </head>
+  <body>
+    <h1>This is the header template</h1>
+    <table>
+      <thead>
+        <tr>
+          <td>First Name</td>
+          <td>Last Name</td>
+          <td>Email</td>
+        </tr>
+      </thead>
+      <tr data-ruhl="_collection: user_list">
+        <td data-ruhl="first_name">Andrew</td>
+        <td data-ruhl="last_name">Stone</td>
+        <td data-ruhl="email">andy@stonean.com</td>
+      </tr>
+    </table>
+    </ul>
+  </body>
+</html>

data/spec/html/render_if.html ADDED

@@ -0,0 +1,25 @@
+<html>
+  <head>
+    <title>This is a title template</title>
+  </head>
+  <body>
+    <h1>This is the header template</h1>
+    <div data-ruhl="_render_if: has_users?">
+      <table>
+        <thead>
+          <tr>
+            <td>First Name</td>
+            <td>Last Name</td>
+            <td>Email</td>
+          </tr>
+        </thead>
+        <tr data-ruhl="_collection: user_list">
+          <td data-ruhl="first_name">Andrew</td>
+          <td data-ruhl="last_name">Stone</td>
+          <td data-ruhl="email">andy@stonean.com</td>
+        </tr>
+      </table>
+    </div>
+    </ul>
+  </body>
+</html>

data/spec/html/seo.html ADDED

@@ -0,0 +1,11 @@
+<html>
+  <head>
+    <title>This is a title template</title>
+    <meta data-ruhl="content: generate_description" content='This is a description template' id='metaDescription' name='description' />
+    <meta data-ruhl="content: generate_keywords" content='these,are,template,keywords' id='metaKeywords' name='keywords' />
+  </head>
+  <body>
+    <h1 data-ruhl="generate_h1">I am a templated headline</h1>
+    <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit. Curabitur sit amet lacinia metus. Nam sed dui est. Sed pellentesque aliquet massa, vel cursus arcu faucibus tincidunt. Nunc aliquet ultricies tellus sit amet elementum. Integer porttitor lorem dolor. Proin leo nunc, sollicitudin sed ullamcorper non, tempus non erat. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Sed commodo sodales pharetra. Vivamus pharetra, augue a volutpat scelerisque, elit nisl auctor elit, quis mollis dolor urna in ligula. Aliquam nisi augue, adipiscing quis mollis ut, aliquam nec urna. Morbi faucibus semper ante ut dignissim. Maecenas et dui eros, eget tristique odio. Sed vehicula erat nec dui porttitor laoreet.</p>
+  </body>
+</html>

data/spec/html/sidebar.html ADDED

@@ -0,0 +1,7 @@
+<h3>Real Sidebarlinks</h3>
+<ul>
+  <li><a href="#">Real Link 1</a></li>
+  <li><a href="#">Real Link 2</a></li>
+  <li><a href="#">Real Link 3</a></li>
+  <li><a href="#">Real Link 4</a></li>
+</ul>

data/spec/rcov.opts ADDED

@@ -0,0 +1,5 @@
+--text-summary
+--exclude
+  json,FakeWeb,rcov.rb,rspec,spec
+--sort
+  coverage

data/spec/ruhl_spec.rb ADDED

@@ -0,0 +1,163 @@
+require File.join(File.dirname(__FILE__), 'spec_helper')
+def generate_h1(tag = nil)
+  "data from presenter"
+end
+def data_from_method(tag = nil)
+  "I am data from a method"
+end
+def generate_description(tag = nil)
+  "I am a custom meta description"
+end
+def generate_keywords(tag = nil)
+  "I, am, custom, keywords"
+end
+def my_content(tag = nil)
+  "hello from my content."
+end
+def sidebar_partial(tag = nil)
+  html(:sidebar)
+end
+def user_list(tag = nil)
+  [
+    TestUser.new('Jane', 'Doe', 'jane@stonean.com'),
+    TestUser.new('John', 'Joe', 'john@stonean.com'),
+    TestUser.new('Jake', 'Smo', 'jake@stonean.com'),
+    TestUser.new('Paul', 'Tin', 'paul@stonean.com'),
+    TestUser.new('NoMail', 'Man')
+  ]
+end
+describe Ruhl do
+  describe "basic.html" do
+    before do
+      @html = File.read html(:basic)
+    end
+    it "content of p should be content from data_from_method" do
+       doc = create_doc
+       doc.xpath('//h1').first.content.should == generate_h1
+    end
+  end
+  describe "seo.html" do
+    before do
+      @html = File.read html(:seo)
+    end
+    it "meta keywords should be replaced" do
+      doc = create_doc
+      doc.xpath('//meta[@name="keywords"]').first['content'].
+        should == generate_keywords
+    end
+    it "meta title should be replaced" do
+      doc = create_doc
+      doc.xpath('//meta[@name="description"]').first['content'].
+        should == generate_description
+    end
+  end
+  describe "medium.html" do
+    before do
+      @html = File.read html(:medium)
+      @doc = create_doc
+    end
+    it "first data row should equal first user " do
+      table = @doc.xpath('/html/body/table/tr//td')
+      table.children[0].to_s.should == "Jane"
+      table.children[1].to_s.should == "Doe"
+      table.children[2].to_s.should == "jane@stonean.com"
+    end
+    it "last data row should equal last user " do
+      table = @doc.xpath('/html/body/table/tr//td')
+      table.children[9].to_s.should == "Paul"
+      table.children[10].to_s.should == "Tin"
+      table.children[11].to_s.should == "paul@stonean.com"
+    end
+  end
+  describe "fragment.html" do
+    before do
+      @html = File.read html(:fragment)
+    end
+    it "will be injected into layout.html" do
+      doc  = create_doc( html(:layout) )
+      doc.xpath('//h1').should_not be_empty
+      doc.xpath('//p').should_not be_empty
+    end
+  end
+  describe "main_with_sidebar.html" do
+    before do
+      @html = File.read html(:main_with_sidebar)
+    end
+    it "should replace sidebar with partial contents" do
+      doc = create_doc
+    end
+  end
+  describe "if.html" do
+    before do
+      @html = File.read html(:if)
+      @doc = create_doc
+    end
+    it "first data row should equal first user " do
+      table = @doc.xpath('/html/body/table/tr//td')
+      table.children[0].to_s.should == "Jane"
+      table.children[1].to_s.should == "Doe"
+      table.children[2].to_s.should == "jane@stonean.com"
+    end
+    it "last data row should equal last user " do
+      table = @doc.xpath('/html/body/table/tr//td')
+      table.children[12].to_s.should == "NoMail"
+      table.children[13].to_s.should == "Man"
+      table.children[14].should == nil
+    end
+  end
+  describe "render if.html" do
+    it "table should not render" do
+      def has_users?(tag = nil)
+        false
+      end
+      @html = File.read html(:render_if)
+      @doc = create_doc
+      nodes = @doc.xpath('/html/body//*')
+      nodes.children.length.should == 1
+      nodes.children.to_s.should == "This is the header template"
+    end
+    it "table shouldrender" do
+      def has_users?(tag = nil)
+        true
+      end
+      @html = File.read html(:render_if)
+      @doc = create_doc
+      nodes = @doc.xpath('/html/body//*')
+      nodes.children.length.should > 1
+      table = @doc.xpath('/html/body/div/table/tr//td')
+      table.children[12].to_s.should == "NoMail"
+      table.children[13].to_s.should == "Man"
+    end
+  end
+end

data/spec/spec.opts ADDED

@@ -0,0 +1,3 @@
+--color
+--format
+  progress

data/spec/spec_helper.rb ADDED

@@ -0,0 +1,26 @@
+require File.expand_path(File.join(File.dirname(__FILE__), %w[.. lib ruhl]))
+def html(name)
+  File.join( File.dirname(__FILE__), 'html', "#{name}.html" )
+end
+def do_parse(html)
+  Nokogiri::HTML(html)
+end
+def create_doc(layout = nil)
+  options = {:layout => layout}
+  html = Ruhl::Engine.new(@html, :layout => layout).render(self)
+  do_parse(html)
+end
+class TestUser
+  attr_accessor :first_name, :last_name, :email
+  def initialize(first, last , email = nil)
+    @first_name = first
+    @last_name  = last
+    @email = email
+  end
+end

metadata ADDED

@@ -0,0 +1,96 @@
+--- !ruby/object:Gem::Specification
+name: ruhl
+version: !ruby/object:Gem::Version
+  version: 0.6.0
+platform: ruby
+authors:
+- Andrew Stone
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2009-10-07 00:00:00 -04:00
+default_executable:
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  type: :runtime
+  version_requirement:
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.3.3
+    version:
+- !ruby/object:Gem::Dependency
+  name: rspec
+  type: :development
+  version_requirement:
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: "0"
+    version:
+description: Make your HTML dynamic with the addition of a ruby attribute.
+email: andy@stonean.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- README
+files:
+- .gitignore
+- README
+- Rakefile
+- VERSION
+- lib/ruhl.rb
+- lib/ruhl/errors.rb
+- lib/ruhl/rails.rb
+- lib/ruhl/sinatra.rb
+- ruhl.gemspec
+- spec/html/basic.html
+- spec/html/fragment.html
+- spec/html/if.html
+- spec/html/layout.html
+- spec/html/main_with_sidebar.html
+- spec/html/medium.html
+- spec/html/render_if.html
+- spec/html/seo.html
+- spec/html/sidebar.html
+- spec/rcov.opts
+- spec/ruhl_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/stonean/ruhl
+licenses: []
+post_install_message:
+rdoc_options:
+- --charset=UTF-8
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: "0"
+  version:
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: "0"
+  version:
+requirements: []
+rubyforge_project:
+rubygems_version: 1.3.5
+signing_key:
+specification_version: 3
+summary: Ruby Hypertext Language
+test_files:
+- spec/ruhl_spec.rb
+- spec/spec_helper.rb