inversion 0.0.1

data/spec/inversion/template/calltag_spec.rb

@@ -0,0 +1,30 @@
+#!/usr/bin/env rspec -cfd -b
+# vim: set noet nosta sw=4 ts=4 :
+
+BEGIN {
+	require 'pathname'
+	basedir = Pathname( __FILE__ ).dirname.parent.parent.parent
+	libdir = basedir + 'lib'
+
+	$LOAD_PATH.unshift( basedir.to_s ) unless $LOAD_PATH.include?( basedir.to_s )
+	$LOAD_PATH.unshift( libdir.to_s ) unless $LOAD_PATH.include?( libdir.to_s )
+}
+
+require 'rspec'
+require 'spec/lib/helpers'
+require 'inversion/template/calltag'
+
+describe Inversion::Template::CallTag do
+
+	before( :all ) do
+		setup_logging( :fatal )
+	end
+
+	after( :all ) do
+		reset_logging()
+	end
+
+	# Since call is just an alias, the attrtag_spec already tests all of
+	# this.
+
+end

data/spec/inversion/template/codetag_spec.rb

@@ -0,0 +1,51 @@
+#!/usr/bin/env rspec -cfd -b
+# vim: set noet nosta sw=4 ts=4 :
+
+BEGIN {
+	require 'pathname'
+	basedir = Pathname( __FILE__ ).dirname.parent.parent.parent
+	libdir = basedir + 'lib'
+
+	$LOAD_PATH.unshift( basedir.to_s ) unless $LOAD_PATH.include?( basedir.to_s )
+	$LOAD_PATH.unshift( libdir.to_s ) unless $LOAD_PATH.include?( libdir.to_s )
+}
+
+require 'rspec'
+require 'spec/lib/helpers'
+require 'inversion/template/codetag'
+
+describe Inversion::Template::CodeTag do
+
+	before( :all ) do
+		setup_logging( :fatal )
+	end
+
+	after( :all ) do
+		reset_logging()
+	end
+
+
+	it "is an abstract class" do
+		Inversion::Template::Tag.should < Inversion::AbstractClass
+	end
+
+
+	describe "subclasses" do
+
+		it "can declare a format for tags using a declarative" do
+			subclass = Class.new( Inversion::Template::CodeTag ) do
+				tag_pattern "$(ident)" do |tag, match|
+					:foo
+				end
+
+			end
+
+			subclass.tag_patterns.should have( 1 ).member
+			subclass.tag_patterns.first[0].
+				should be_an_instance_of( Inversion::Template::CodeTag::TokenPattern )
+			subclass.tag_patterns.first[1].call( :dummy, :king_dummy ).should == :foo
+		end
+
+	end
+
+end

data/spec/inversion/template/commenttag_spec.rb

@@ -0,0 +1,84 @@
+#!/usr/bin/env rspec -cfd -b
+# vim: set noet nosta sw=4 ts=4 :
+
+BEGIN {
+	require 'pathname'
+	basedir = Pathname( __FILE__ ).dirname.parent.parent.parent
+	libdir = basedir + 'lib'
+
+	$LOAD_PATH.unshift( basedir.to_s ) unless $LOAD_PATH.include?( basedir.to_s )
+	$LOAD_PATH.unshift( libdir.to_s ) unless $LOAD_PATH.include?( libdir.to_s )
+}
+
+require 'rspec'
+require 'spec/lib/helpers'
+require 'inversion/template/commenttag'
+require 'inversion/template/attrtag'
+require 'inversion/template/textnode'
+require 'inversion/renderstate'
+
+describe Inversion::Template::CommentTag do
+
+	before( :all ) do
+		setup_logging( :fatal )
+	end
+
+	after( :all ) do
+		reset_logging()
+	end
+
+
+	it "allows any free-form text in its body" do
+		# <?comment Disabled for now ?>...<?end?>
+		Inversion::Template::CommentTag.new( 'Disabled for now' ).
+			should be_a( Inversion::Template::CommentTag )
+	end
+
+	it "allows an empty body" do
+		# <?comment ?>...<?end?>
+		Inversion::Template::CommentTag.new( '' ).
+			should be_a( Inversion::Template::CommentTag )
+	end
+
+
+	it "includes information about its subnodes when rendered as a comment" do
+		tag = Inversion::Template::CommentTag.new( '' )
+
+		# - <?attr foo ?> -
+		tag << Inversion::Template::TextNode.new( '- ', 1, 7 )
+		tag << Inversion::Template::AttrTag.new( 'foo', 1, 9 )
+		tag << Inversion::Template::TextNode.new( ' -', 1, 12 )
+
+		tag.as_comment_body.should == 'Commented out 3 nodes on line 1'
+	end
+
+
+	it "multiline comments include information about its subnodes when rendered as a comment" do
+		tag = Inversion::Template::CommentTag.new( "We couldn't have done it without me" )
+
+		# - <?attr foo ?> -
+		tag << Inversion::Template::TextNode.new( '- ', 2, 0 )
+		tag << Inversion::Template::AttrTag.new( 'foo', 3, 0 )
+		tag << Inversion::Template::TextNode.new( '- ', 4, 0 )
+
+		tag.as_comment_body.should == "Commented out 3 nodes from line 2 to 4: " +
+			"We couldn't have done it without me"
+	end
+
+
+	it "prevents its subnodes from being rendered" do
+		render_state = Inversion::RenderState.new( :plaque => %w[ten years] )
+		tag = Inversion::Template::CommentTag.new( '' )
+
+		# - <?attr foo ?> -
+		tag << Inversion::Template::TextNode.new( '- ' )
+		tag << Inversion::Template::AttrTag.new( 'foo' )
+		tag << Inversion::Template::TextNode.new( ' -' )
+
+		tag.render( render_state ).should == ''
+	end
+
+end
+
+
+

data/spec/inversion/template/configtag_spec.rb

@@ -0,0 +1,105 @@
+#!/usr/bin/env rspec -cfd -b
+# vim: set noet nosta sw=4 ts=4 :
+
+BEGIN {
+	require 'pathname'
+	basedir = Pathname( __FILE__ ).dirname.parent.parent.parent
+	libdir = basedir + 'lib'
+
+	$LOAD_PATH.unshift( basedir.to_s ) unless $LOAD_PATH.include?( basedir.to_s )
+	$LOAD_PATH.unshift( libdir.to_s ) unless $LOAD_PATH.include?( libdir.to_s )
+}
+
+require 'rspec'
+require 'spec/lib/helpers'
+require 'inversion/template/configtag'
+
+describe Inversion::Template::ConfigTag do
+
+	before( :all ) do
+		setup_logging( :fatal )
+	end
+
+	after( :all ) do
+		reset_logging()
+	end
+
+
+	# <?config comment_start: /* ?>
+	# <?config comment_end: */ ?>
+	it "can contain a single configuration setting" do
+		tag = Inversion::Template::ConfigTag.new( 'comment_start: /*' )
+		tag.options.should == { :comment_start => '/*' }
+	end
+
+	# <?config
+	#     on_render_error: propagate
+	#     debugging_comments: true
+	#     comment_start: /*
+	#     comment_end: */
+	# ?>
+	it "can contain multiple configuration settings using a YAML document" do
+		yaml = <<-YAML
+            on_render_error: propagate
+            debugging_comments: true
+            comment_start: "/*"
+            comment_end: "*/"
+		YAML
+		tag = Inversion::Template::ConfigTag.new( yaml )
+		tag.options.should == {
+			:on_render_error    => 'propagate',
+			:debugging_comments => true,
+			:comment_start      => '/*',
+			:comment_end        => '*/'
+		}
+	end
+
+	# <?config { comment_start: "/*", comment_end: "*/" } ?>
+	it "can contain multiple configuration settings using an inline hash" do
+		tag = Inversion::Template::ConfigTag.new( '{ comment_start: "/*", comment_end: "*/" }' )
+		tag.options.should == { :comment_start => '/*', :comment_end => '*/' }
+	end
+
+	it "renders invisibly" do
+		tag = Inversion::Template::ConfigTag.new( 'comment_start: /*' )
+		state = Inversion::RenderState.new
+		tag.render( state ).should == nil
+	end
+
+	it "raises an error on an empty body" do
+		expect {
+			Inversion::Template::ConfigTag.new( '' )
+		}.to raise_exception( Inversion::ParseError, /empty config settings/i )
+	end
+
+
+	it "can change the strictness of the parser as it's parsing the template" do
+		source = <<-TEMPLATE
+		<?hooooowhat ?>
+		<?config ignore_unknown_tags: false ?>
+		something
+		<?what ?>
+		something else
+		TEMPLATE
+		expect {
+			Inversion::Template.new( source, :ignore_unknown_tags => true )
+		}.to raise_exception( Inversion::ParseError, /unknown tag "what"/i )
+	end
+
+	it "can change the strictness of the parser as it's parsing the template" do
+		source = <<-TEMPLATE
+		<?hooooowhat ?>
+		<?config ignore_unknown_tags: false ?>
+		something
+		<?what ?>
+		something else
+		TEMPLATE
+		expect {
+			Inversion::Template.new( source, :ignore_unknown_tags => true )
+		}.to raise_exception( Inversion::ParseError, /unknown tag "what"/i )
+	end
+
+end
+
+
+

data/spec/inversion/template/containertag_spec.rb

@@ -0,0 +1,54 @@
+#!/usr/bin/env rspec -cfd -b
+# vim: set noet nosta sw=4 ts=4 :
+
+BEGIN {
+	require 'pathname'
+	basedir = Pathname( __FILE__ ).dirname.parent.parent.parent
+	libdir = basedir + 'lib'
+
+	$LOAD_PATH.unshift( basedir.to_s ) unless $LOAD_PATH.include?( basedir.to_s )
+	$LOAD_PATH.unshift( libdir.to_s ) unless $LOAD_PATH.include?( libdir.to_s )
+}
+
+require 'rspec'
+require 'spec/lib/helpers'
+require 'inversion/template/containertag'
+
+describe Inversion::Template::ContainerTag do
+
+	before( :all ) do
+		setup_logging( :fatal )
+	end
+
+	after( :all ) do
+		reset_logging()
+	end
+
+	context "instances of including classes" do
+
+		before( :each ) do
+			@including_class = Class.new( Inversion::Template::Tag ) do
+				include Inversion::Template::ContainerTag
+			end
+			@tag = @including_class.new( 'a body' )
+		end
+
+		it "are container tags" do
+			@tag.should be_a_container()
+		end
+
+		it "contain a subnodes array" do
+			@tag.subnodes.should be_an( Array )
+		end
+
+		it "can have other nodes appended to them" do
+			other_node = Inversion::Template::TextNode.new( "foom" )
+			@tag << other_node
+			@tag.subnodes.should include( other_node )
+		end
+
+	end
+end
+
+
+

data/spec/inversion/template/elsetag_spec.rb

@@ -0,0 +1,105 @@
+#!/usr/bin/env rspec -cfd -b
+# vim: set noet nosta sw=4 ts=4 :
+
+BEGIN {
+	require 'pathname'
+	basedir = Pathname( __FILE__ ).dirname.parent.parent.parent
+	libdir = basedir + 'lib'
+
+	$LOAD_PATH.unshift( basedir.to_s ) unless $LOAD_PATH.include?( basedir.to_s )
+	$LOAD_PATH.unshift( libdir.to_s ) unless $LOAD_PATH.include?( libdir.to_s )
+}
+
+require 'rspec'
+require 'spec/lib/helpers'
+require 'inversion/template/iftag'
+require 'inversion/template/elsetag'
+require 'inversion/template/unlesstag'
+require 'inversion/template/commenttag'
+require 'inversion/template/fortag'
+require 'inversion/renderstate'
+
+describe Inversion::Template::ElseTag do
+
+	before( :all ) do
+		setup_logging( :fatal )
+	end
+
+	after( :all ) do
+		reset_logging()
+	end
+
+	it "handles a non-existant body" do
+		Inversion::Template::ElseTag.new( nil )
+	end
+
+	it "can be appended to an 'if' tag" do
+		template    = double( "template object" )
+		parserstate = Inversion::Template::Parser::State.new( template )
+		iftag       = Inversion::Template::IfTag.new( 'foo' )
+		elsetag     = Inversion::Template::ElseTag.new
+		endtag      = Inversion::Template::EndTag.new
+
+		parserstate << iftag << elsetag << endtag
+
+		parserstate.tree.should == [ iftag, endtag ]
+	end
+
+	it "can be appended to an 'unless' tag" do
+		template    = double( "template object" )
+		parserstate = Inversion::Template::Parser::State.new( template )
+		unlesstag   = Inversion::Template::UnlessTag.new( 'foo' )
+		elsetag     = Inversion::Template::ElseTag.new
+		endtag      = Inversion::Template::EndTag.new
+
+		parserstate << unlesstag << elsetag << endtag
+
+		parserstate.tree.should == [ unlesstag, endtag ]
+		unlesstag.subnodes.should include( elsetag )
+	end
+
+	it "can be appended to a 'comment' tag" do
+		template    = double( "template object" )
+		parserstate = Inversion::Template::Parser::State.new( template )
+		commenttag  = Inversion::Template::CommentTag.new( 'else section for later' )
+		elsetag     = Inversion::Template::ElseTag.new
+		endtag      = Inversion::Template::EndTag.new
+
+		parserstate << commenttag << elsetag << endtag
+
+		parserstate.tree.should == [ commenttag, endtag ]
+		commenttag.subnodes.should include( elsetag )
+	end
+
+	it "raises an error if it's about to be appended to anything other than an 'if', 'unless', " +
+	   "or 'comment' tag" do
+		template    = double( "template object" )
+		parserstate = Inversion::Template::Parser::State.new( template )
+		parserstate << Inversion::Template::ForTag.new( 'foo in bar' )
+
+		expect {
+			parserstate << Inversion::Template::ElseTag.new
+		}.to raise_exception( Inversion::ParseError, /'for' tags can't have 'else' clauses/i )
+	end
+
+
+	it "raises an error if it's about to be appended without an opening 'if' or 'unless'" do
+		template    = double( "template object" )
+		parserstate = Inversion::Template::Parser::State.new( template )
+
+		expect {
+			parserstate << Inversion::Template::ElseTag.new
+		}.to raise_exception( Inversion::ParseError, /orphaned 'else' tag/i )
+	end
+
+
+	it "doesn't render as anything by itself" do
+		renderstate = Inversion::RenderState.new
+		tag = Inversion::Template::ElseTag.new
+		tag.render( renderstate ).should be_nil()
+	end
+
+end
+
+
+

data/spec/inversion/template/elsiftag_spec.rb

@@ -0,0 +1,87 @@
+#!/usr/bin/env rspec -cfd -b
+# vim: set noet nosta sw=4 ts=4 :
+
+BEGIN {
+	require 'pathname'
+	basedir = Pathname( __FILE__ ).dirname.parent.parent.parent
+	libdir = basedir + 'lib'
+
+	$LOAD_PATH.unshift( basedir.to_s ) unless $LOAD_PATH.include?( basedir.to_s )
+	$LOAD_PATH.unshift( libdir.to_s ) unless $LOAD_PATH.include?( libdir.to_s )
+}
+
+require 'rspec'
+require 'spec/lib/helpers'
+require 'inversion/template/iftag'
+require 'inversion/template/elsiftag'
+require 'inversion/template/unlesstag'
+require 'inversion/template/textnode'
+require 'inversion/renderstate'
+
+describe Inversion::Template::ElsifTag do
+
+	before( :all ) do
+		setup_logging( :fatal )
+	end
+
+	after( :all ) do
+		reset_logging()
+	end
+
+
+	it "can be appended to an 'if' tag" do
+		template    = double( "template object" )
+		parserstate = Inversion::Template::Parser::State.new( template )
+		iftag       = Inversion::Template::IfTag.new( 'foo' )
+		elsetag     = Inversion::Template::ElsifTag.new( 'bar' )
+		endtag      = Inversion::Template::EndTag.new
+
+		parserstate << iftag << elsetag << endtag
+
+		parserstate.tree.should == [ iftag, endtag ]
+	end
+
+	it "can be appended to a 'comment' tag" do
+		template    = double( "template object" )
+		parserstate = Inversion::Template::Parser::State.new( template )
+		commenttag  = Inversion::Template::CommentTag.new( 'else section for later' )
+		elsetag     = Inversion::Template::ElsifTag.new( 'bar' )
+		endtag      = Inversion::Template::EndTag.new
+
+		parserstate << commenttag << elsetag << endtag
+
+		parserstate.tree.should == [ commenttag, endtag ]
+		commenttag.subnodes.should include( elsetag )
+	end
+
+	it "raises an error if it's about to be appended to anything other than an 'if' or 'comment' tag" do
+		template    = double( "template object" )
+		parserstate = Inversion::Template::Parser::State.new( template )
+		parserstate << Inversion::Template::UnlessTag.new( 'foo in bar' )
+
+		expect {
+			parserstate << Inversion::Template::ElsifTag.new( 'bar' )
+		}.to raise_exception( Inversion::ParseError, /'unless' tags can't have 'elsif' clauses/i )
+	end
+
+
+	it "raises an error if it's about to be appended without an opening 'if'" do
+		template    = double( "template object" )
+		parserstate = Inversion::Template::Parser::State.new( template )
+
+		expect {
+			parserstate << Inversion::Template::ElsifTag.new( 'bar' )
+		}.to raise_exception( Inversion::ParseError, /orphaned 'elsif' tag/i )
+	end
+
+
+	it "renders as its attribute value if it's a simple attribute" do
+		renderstate = Inversion::RenderState.new( :bar => :the_attribute_value )
+		tag = Inversion::Template::ElsifTag.new( 'bar' )
+		tag.render( renderstate ).should == :the_attribute_value
+	end
+
+end
+
+
+