arrow 1.0.7

data/lib/arrow/template/attr.rb

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+
+require 'arrow/exceptions'
+require 'arrow/path'
+require 'arrow/template/nodes'
+
+# The Arrow::Arrow::Template::AttrDirective class, a derivative of Arrow::Directive. 
+# This is the class which defines the behaviour of the 'attr' template directive.
+# 
+# == Syntax
+#
+#   <?attr foo ?>
+#   <?attr "%0.2f" % foo ?>
+#
+# == Authors
+# 
+# * Michael Granger <ged@FaerieMUD.org>
+# 
+# Please see the file LICENSE in the top-level directory for licensing details.
+#
+class Arrow::Template::AttrDirective < Arrow::Template::AttributeDirective # :nodoc:
+
+	# SVN Revision
+	SVNRev = %q$Rev$
+	
+	# SVN Id
+	SVNId = %q$Id$
+	
+
+end # class Arrow::Template::AttrDirective
+

data/lib/arrow/template/call.rb

@@ -0,0 +1,31 @@
+#!/usr/bin/env ruby
+
+require 'arrow/exceptions'
+require 'arrow/path'
+require 'arrow/template/nodes'
+
+# The Arrow::Template::CallDirective class, a derivative of
+# Arrow::Template::AttributeDirective. This is the class which defines the
+# behaviour of the 'call' template directive.
+# 
+# == Syntax
+#
+#   <?call foo.to_html ?>
+#   <?call var.any(other_var.method).chain ?>
+#   <?call "$%0.2f" % var.any(other_var.method).chain ?>
+#
+# == Authors
+# 
+# * Michael Granger <ged@FaerieMUD.org>
+# 
+# Please see the file LICENSE in the top-level directory for licensing details.
+#
+class Arrow::Template::CallDirective < Arrow::Template::AttributeDirective # :nodoc:
+
+	# SVN Revision
+	SVNRev = %q$Rev$
+	
+	# SVN Id
+	SVNId = %q$Id$
+
+end # class Arrow::Template::CallDirective

data/lib/arrow/template/comment.rb

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+
+require 'arrow/exceptions'
+require 'arrow/path'
+require 'arrow/template/nodes'
+
+# The Arrow::Template::Comment class, a derivative of
+# Arrow::Template::AttributeDirective. This is the class which defines
+# the behaviour of the 'comment' template directive.
+#
+# == VCS Id
+#
+# $Id$
+#
+# == Authors
+#
+# * Mahlon E. Smith <mahlon@martini.nu>
+#
+# Please see the file LICENSE in the top-level directory for licensing details.
+#
+class Arrow::Template::CommentDirective < Arrow::Template::AttributeDirective # :nodoc:
+
+	######
+	public
+	######
+
+	### Return an empty string instead of rendering anything within
+	### a comment directive.
+	def render( template, scope )
+		return ''
+	end
+
+end # class Arrow::Template::CommentDirective

data/lib/arrow/template/container.rb

@@ -0,0 +1,118 @@
+#!/usr/bin/env ruby
+
+require 'forwardable'
+
+require 'arrow/exceptions'
+require 'arrow/path'
+
+# The Arrow::Template::Container class, a derivative of
+# Arrow::Object. Instances of this class are stateful containers for
+# ContainerDirective nodes .
+# 
+# == Authors
+# 
+# * Michael Granger <ged@FaerieMUD.org>
+# 
+# Please see the file LICENSE in the top-level directory for licensing details.
+#
+class Arrow::Template::Container < Arrow::Object
+	extend Forwardable
+	include Enumerable
+
+	# SVN Revision
+	SVNRev = %q$Rev$
+	
+	# SVN Id
+	SVNId = %q$Id$
+	
+	# The methods of collections which are delegated to their contents Array
+	DelegatedMethods = 
+		( (Array.instance_methods(false) | Enumerable.instance_methods(false)) -
+		  %w{<<} )
+
+	#############################################################
+	###	I N S T A N C E   M E T H O D S
+	#############################################################
+
+	### Create a new Arrow::Template::Container object with the given +name+
+	### and +contents+.
+	def initialize( name, *contents )
+		@name = name
+		@contents = contents
+
+		@sortblock = nil
+		@filters = []
+
+		super()
+	end
+
+
+
+	######
+	public
+	######
+
+	# Delegate index methods to contents
+	def_delegators :@contents, *DelegatedMethods
+
+	# The contents of the container
+	attr_accessor :contents
+
+	# The name of the container
+	attr_reader :name
+
+	# The Array of transform functions applied to this container at render
+	# time, in the order in which they will be applied.
+	attr_reader :filters
+
+	# The sort block associated with the container.
+	attr_reader :sortblock
+
+
+	### Add the given object/s to this container.
+	def <<( object )
+		@contents << object
+		return self
+	end
+
+
+	### Add the specified filter +block+ to the container. When the
+	### container is used in a render, the filter block will be called once
+	### for each contained object and whatever it returns will be used
+	### instead of the original.
+	def addFilter( &block )
+		@filters << block
+	end
+
+	
+	### Add the specified sort +block+ to the container. When the container
+	### is used in a render, its contents will be used in the order returned
+	### from the sort block.
+	def setSort( &block )
+		@sortblock = block
+	end
+
+
+	### Iterate over the contents of this container after applying filters,
+	### sort blocks, etc. to them.
+	def each( &block )
+		raise LocalJumpError, "no block given" unless block_given?
+
+		contents = @contents.dup
+		contents.sort!( &@sortblock ) if @sortblock
+		@filters.each {|filter|
+			contents = contents.collect( &filter )
+		}
+
+		Arrow::Template::Iterator.new( *contents ).each( &block )
+	end
+
+
+	### Return the last value to be set in this container
+	def last
+		@contents.last
+	end
+
+end # class Arrow::Template::Container
+
+

data/lib/arrow/template/else.rb

@@ -0,0 +1,41 @@
+#!/usr/bin/env ruby
+
+require 'arrow/exceptions'
+require 'arrow/path'
+require 'arrow/template/nodes'
+
+# The Arrow::Template::ElseDirective class, a derivative of
+# Arrow::Template::Directive. This is the class which defines the behaviour of
+# the 'else' template directive.
+# 
+# == Authors
+# 
+# * Michael Granger <ged@FaerieMUD.org>
+# 
+# Please see the file LICENSE in the top-level directory for licensing details.
+#
+class Arrow::Template::ElseDirective < Arrow::Template::Directive # :nodoc:
+
+	# SVN Revision
+	SVNRev = %q$Rev$
+	
+	# SVN Id
+	SVNId = %q$Id$
+	
+
+	#############################################################
+	###	I N S T A N C E   M E T H O D S
+	#############################################################
+
+	### Create a new Arrow::Template::ElsifDirective object.
+	def initialize( body, parser, state )
+		unless state.current_branch_node.is_a?( Arrow::Template::ConditionalDirective )
+			raise Arrow::TemplateError,
+				"else outside of conditional directive (%p)" %
+				state.current_branch_node
+		end
+			
+		super
+	end
+
+end # class Arrow::Template::ElseDirective

data/lib/arrow/template/elsif.rb

@@ -0,0 +1,44 @@
+#!/usr/bin/env ruby
+
+require 'arrow/exceptions'
+require 'arrow/path'
+require 'arrow/template/nodes'
+
+# The Arrow::Template::ElsifDirective class, a derivative of
+# Arrow::Template::Directive. This is the class which defines the behaviour of
+# the 'elsif' template directive.
+# 
+# == Authors
+# 
+# * Michael Granger <ged@FaerieMUD.org>
+# 
+# Please see the file LICENSE in the top-level directory for licensing details.
+#
+class Arrow::Template::ElsifDirective < Arrow::Template::AttributeDirective # :nodoc:
+	include Arrow::Template::ConditionalDirective
+
+	# SVN Revision
+	SVNRev = %q$Rev$
+	
+	# SVN Id
+	SVNId = %q$Id$
+	
+
+	#############################################################
+	###	I N S T A N C E   M E T H O D S
+	#############################################################
+
+	### Create a new Arrow::Template::ElsifDirective object.
+	def initialize( body, parser, state )
+		unless state.current_branch_node.is_a?( Arrow::Template::ConditionalDirective )
+			raise Arrow::TemplateError,
+				"elsif outside of conditional directive (%p)" %
+				state.current_branch_node
+		end
+			
+		super
+	end
+
+
+end # class Arrow::Template::Elsif
+

data/lib/arrow/template/escape.rb

@@ -0,0 +1,53 @@
+#!/usr/bin/env ruby
+
+require 'arrow/exceptions'
+require 'arrow/path'
+require 'arrow/template/call'
+
+# The Arrow::Template::EscapeDirective class, a derivative of
+# Arrow::Template::CallDirective. This is the class which defines the behaviour
+# of the 'escape' template directive., which HTML escapes the stringified
+# version of its associated attribute/s.
+# 
+# == Syntax
+#
+#   <pre><?escape data.to_yaml?></pre>
+#   <?escape some_string_with_htmlish_bits?>
+#
+# == Authors
+# 
+# * Michael Granger <ged@FaerieMUD.org>
+# 
+# Please see the file LICENSE in the top-level directory for licensing details.
+#
+class Arrow::Template::EscapeDirective < Arrow::Template::CallDirective # :nodoc:
+
+	# SVN Revision
+	SVNRev = %q$Rev$
+	
+	# SVN Id
+	SVNId = %q$Id$
+	
+	
+	### Render the content and return it as HTML-escaped text.
+	def render( template, scope )
+		rawary = super
+		rary = []
+
+		# Try our best to skip debugging comments
+		if template._config[:debuggingComments]
+			rary.push( rawary.shift ) if /^<!--.*-->$/ =~ rawary.first
+		end
+
+		rawary.each do |line|
+			rary << line.to_s.
+				gsub( /&/, '&amp;' ).
+				gsub( /</, '&lt;' ).
+				gsub( />/, '&gt;' ).
+				gsub( /"/, '&quot;' )
+		end
+
+		return rary
+	end
+
+end # class Arrow::Template::Escape

data/lib/arrow/template/export.rb

@@ -0,0 +1,87 @@
+#!/usr/bin/env ruby
+
+require 'arrow/exceptions'
+require 'arrow/path'
+require 'arrow/template/nodes'
+
+# 
+# The Arrow::Template::ExportDirective class, a derivative of
+# Arrow::Template::BracketingDirective. This is the class which defines the
+# behaviour of the 'export' template directive.
+#
+# == Syntax
+#
+#	<?export foo ?>
+#	  <!-- Some content for 'foo' attributes of enclosing templates. -->
+#	<?end?>
+#
+# == VCS Id
+# 
+# $Id$
+# 
+# == Authors
+# 
+# * Michael Granger <ged@FaerieMUD.org>
+# 
+# Please see the file LICENSE in the top-level directory for licensing details.
+#
+class Arrow::Template::ExportDirective < Arrow::Template::BracketingDirective # :nodoc:
+	include Arrow::Template::Parser::Patterns
+
+	# SVN Revision
+	SVNRev = %q$Rev$
+	
+	# SVN Id
+	SVNId = %q$Id$
+	
+
+
+	#############################################################
+	###	C L A S S   M E T H O D S
+	#############################################################
+	
+	### Disallow formats and methodchains
+	def self::allows_format?; false; end
+	def self::allows_method_chains?; false; end
+
+
+	#############################################################
+	###	I N S T A N C E   M E T H O D S
+	#############################################################
+	
+	### Add the imported attributes when this node is rendered.
+	def before_rendering( template )
+		st = template
+		
+		while st = st._enclosing_template
+			surrogate = template.class.new( self.subnodes )
+		
+			# :TODO: Does appending to the attribute make more sense?
+			st._attributes[ self.name ] = surrogate
+		end
+	end
+
+
+	### Add attributes contained by subnodes, but not the attribute
+	### for this node itself, which will be looked for in the 
+	### enclosing template.
+	def add_to_template( template ) # :nodoc:
+		self.subnodes.each do |node|
+			template.install_node( node )
+		end
+	end
+
+
+	#########
+	protected
+	#########
+
+	### Override the default behavior, which is to render subnodes. Since the
+	### whole point of this directive is to give content to a containing 
+	### template, this becomes a no-op.
+	def render_contents( template, scope )
+		return []
+	end
+	
+	
+end # class Arrow::Template::ExportDirective