template-test 0.0.2 → 0.0.3

data/lib/template-test.rb

@@ -9,12 +9,7 @@ module Template
     # @see #set
     class Context
       attr_accessor :nodes
-
-      def initialize(template_path, &block)
-        @template_path = template_path
-        # how to capture local variables
-        self.instance_eval(&block)
-      end
+      attr_writer :html, :template_path
 
       # @return [Nokogiri::HTML] the document that wraps the rendered template
       # @param [Boolean] reload true if the document should be parsed again
@@ -22,26 +17,30 @@ module Template
         if reload
           @document = nil
         end
-        @document ||= Nokogiri::HTML(render())
+        @document ||= Nokogiri::HTML(html())
       end
 
-      # Evaluates the given block of test code in the context
-      # of the document which wraps the rendered template.
-      # The nodes retrieved by the given xpath expression can
-      # be accessed through the 'nodes' method.
+      # @return [String] the rendered template
+      def html()
+        @html ||= render();
+      end
+
+      # Searches the rendered HTML document for the given
+      # XPATH query. In the given block the result of the
+      # xpath query is available through the 'nodes' instance variable.
       # @param [String] xpath an XPATH search expression
       # @param [Proc] block the testing code
-      # @see {file:spec/erb_spec.rb}
+      # @example see {file:spec/erb_spec.rb}.
       def xpath(xpath, &block)
         @xpath = xpath
         @nodes = document().xpath(@xpath)
         self.instance_eval(&block)
       end
 
-      # Creates an instance variable which is available in the rendered template.
+      # Assigns an instance variable which is available when the template is rendered.
       # @param [Symbol] symbol the name of the instance variable
       # @param [Object] value the value of the instance variable
-      # @see {file:spec/erb_spec.rb}
+      # @example see {file:spec/erb_spec.rb}.
       def set(symbol, value)
         sym = "@#{symbol.to_s}".to_sym
         instance_variable_set(sym, value)
@@ -50,7 +49,7 @@ module Template
         end
       end
 
-      # Renders the template in this context. All variables defined by #set
+      # Renders the template. All variables defined by @see #set
       # are available in the template. They can be accessed as instance
       # variables or by using the attribute accessor.
       # @return [String] the rendered template
@@ -86,10 +85,25 @@ module Template
     # Runs the test code in the provided block for the specified template.
     # @param [String] template_path the path to the template
     # @param [Proc] block a block with the template testing code
-    # @see {file:spec/erb_spec.rb}
     # @return [Context] the template test context
+    # @example see {file:spec/erb_spec.rb}.
     def template(template_path, &block)
-      Context.new(template_path, &block)
+      context = Context.new
+      context.template_path = template_path
+      context.instance_eval &block
+      context
+    end
+
+    # Runs the test code in the provided block for the specified rendered HTML.
+    # @param [String] html the rendered HTML content
+    # @param [Proc] block a block with template testing code
+    # @return [Context] the template test context
+    # @example see {file:spec/html_spec.rb}
+    def html(html, &block)
+      context = Context.new
+      context.html = html
+      context.instance_eval &block
+      context
     end
   end
 end

data/lib/template-test/version.rb

@@ -1,5 +1,5 @@
 module Template
   module Test
-    VERSION = "0.0.2"
+    VERSION = "0.0.3"
   end
 end

data/spec/html_spec.rb

@@ -0,0 +1,30 @@
+require 'spec_helper'
+
+describe "test custom rendered HTML" do
+  it "should test custom rendered HTML" do
+
+    # render the template manually
+    @title = "the title"
+    @content = "the content"
+    template = ERB.new File.read("spec/template/form.html.erb")
+    body = template.result(binding())
+
+    # inject the rendered template into the context
+    html body do
+      # check if the rendered template was properly injected
+      @html.should == body
+      html().should == body
+
+      # and query on the injected rendered template
+      xpath "//input[@name='title']" do
+        nodes.length.should == 1
+        nodes[0].attr("text").should == @title
+      end
+      xpath "//textarea[@name='content']" do
+        nodes.length.should == 1
+        # FIXME why is the @content not available here ?
+        nodes[0].text().should == "the content"
+      end
+    end
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: template-test
 version: !ruby/object:Gem::Version
-  version: 0.0.2
+  version: 0.0.3
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-04-29 00:00:00.000000000 Z
+date: 2012-04-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -127,6 +127,7 @@ files:
 - lib/template-test/version.rb
 - spec/erb_spec.rb
 - spec/haml_spec.rb
+- spec/html_spec.rb
 - spec/spec_helper.rb
 - spec/template/form.html.erb
 - spec/template/form.html.haml
@@ -159,7 +160,9 @@ summary: Simple DSL for HTML template (ERB,HAML) testing
 test_files:
 - spec/erb_spec.rb
 - spec/haml_spec.rb
+- spec/html_spec.rb
 - spec/spec_helper.rb
 - spec/template/form.html.erb
 - spec/template/form.html.haml
 - spec/template/form_local.html.erb
+has_rdoc: