inversion 0.17.2 → 0.17.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6745a33cc02610b46025e012922f4e510eb14825
-  data.tar.gz: 1fe0babb88461e808d34f82391aaf38b23328061
+  metadata.gz: ce3df399edaec700d90c634d354a1f452df4fbbd
+  data.tar.gz: 3df0b15958d115c2a4013ccfa6fbc1bf39b5a7bf
 SHA512:
-  metadata.gz: 9412182ee80045940434ab81977cd1d879e42bd7d7e8c884e73aa0af154c67dcf384dca970dd91e8f492fc98be0b1f6d2153dc4ccd0afa20a7bb5f223e630e92
-  data.tar.gz: 3b3eeabfbe0a1a6eed93d13fe9db06af2c60d7a99bb55e216cbb6a039aca72579a86bce059d5746c583bcddbf821c51087553b5d7a6c5bd7813c2bc98a814c44
+  metadata.gz: fc101d2dddd1c7e70fdf8ad014edaa81db0ea79661f0475636a9906b566066225044d974febc034ef12a6fa0a78510d0c71e5013fb89ee4613230d49a6345ede
+  data.tar.gz: 4be23c2a5f052059043748da5837ed6936c18b4b3fcde7533cac74994208d72cfc509edcf532ee8d5f37f6a4ed1f7fe8bfab5a3f720940c7733eafddca1e073f

data/History.rdoc

@@ -1,3 +1,10 @@
+== v0.17.3 [2015-02-16] Michael Granger <ged@FaerieMUD.org>
+
+- Performance fix: Re-comment the #inspect logging message
+  in the RenderState
+- Updated tag docs
+
+
 == v0.17.2 [2015-01-22] Michael Granger <ged@FaerieMUD.org>
 
 - Fix a bug with the fragment tag.

data/Tags.rdoc

@@ -18,139 +18,6 @@ The second form is especially useful if you're generating HTML and want to put a
 You can mix tag forms in a single document.
 
 
-== Tags
-
-=== begin/rescue
-
-These tags work as you'd expect from their ruby counterparts. 
-
-The +begin+ section of the template to be rendered only if no exceptions are raised while it's
-being rendered. If an exception is raised, it is checked against any +rescue+ sections, and the
-first with a matching exception is rendered instead. If no +rescue+ block is found, the exception
-is handled by the configured exception behavior for the template (see Inversion::Template@Template+Options).
-
-  <?begin ?><?call employees.length ?><?end?>
-  
-  <?begin ?>
-    <?for employee in employees.all ?>
-      <?attr employee.name ?> --> <?attr employee.title ?>
-    <?end for?>
-  <?rescue DatabaseError => err ?>
-    Oh no!! I can't talk to the database for some reason.  The
-    error was as follows:
-    <pre>
-      <?attr err.message ?>
-    </pre>
-  <?end?>
-
-=== comment
-
-The +comment+ tag can be used to temporarily stop a section of a document from being rendered:
-
-  <?comment?>
-  This stuff won't be rendered.
-  <?end comment ?>
-  But this stuff will.
-
-Note that the tags inside the comment will still be parsed, so the template's interface won't be affected by the comment:
-
-  <?comment?>
-  <?attr content ?>
-  <?end comment ?>
-
-If you have +debugging_comments+ enabled in the template options[rdoc-ref:Templates@Template+Options], sections which are commented out will be rendered as a comment describing what was omitted, surrounded by the comment characters set in +comment_start+ and +comment_end+ options, respectively.
-
-  <!-- Commented out 1 nodes on line 1 -->
-
-You can also embed a description of why the section is commented in the tag body, which will be used as a label when rendering the comment. For example:
-
-  <?comment Disabled until there's content ?>
-  <?attr content ?>
-  <?end comment ?>
-
-will be rendered as:
-
-  <!-- Commented out 1 nodes on line 1: Disabled until there's content -->
-
-
-=== config
-
-The +config+ tag can be used to override template options[Templates@Template+Options]
-on a per-template basis.  It allows for convenient, inline settings from
-within a template rather than from the code in which the template is
-loaded.
-
-For example, if you want to enable debugging comments on a single template:
-
-  <?config debugging_comments: true ?>
-
-Multiple template options can be set simultaneously by using a YAML hash:
-
-  <?config
-      on_render_error: propagate
-      debugging_comments: true
-      comment_start: /*
-      comment_end: */
-  ?>
-
-Note that this also allows you to set multiple options on a single line, if you wrap them in braces:
-
-  <?config { comment_start: "/*", comment_end: "*/" } ?>
-
-
-=== default
-
-The +default+ tag sets an attribute from within the template, and this value is used if the attribute is otherwise unset.
-
-  template = Inversion::Template.new <<-TMPL
-    <?default adjective to "cruel" ?>
-    <?default noun to "world" ?>
-    Goodbye, <?attr adjective ?> <?attr noun ?>!
-  TMPL
-
-  template.render
-
-  template.adjective = "delicious"
-  template.render
-
-  template.adjective = nil
-  template.noun = "banana"
-  template.render
-
-Would produce the output:
-
-  Goodbye, cruel world!
-  Goodbye, delicious world!
-  Goodbye, cruel banana!
-
-
-=== fragment
-
-A +fragment+ tag also sets an attribute from within the template, but under the scope of the global
-template itself.  A fragment can use other Inversion tags, and the attribute is both usable
-elsewhere in the template, and accessible from calling code after rendering.
-
-  template = Inversion::Template.new <<-TMPL
-	<?fragment subject ?>Your order status (Order #<?call order.number ?>)<?end ?>
-
-	Dear <?call order.customer.name ?>,
-
-	Your recent order was modified by our Order Fulfillment Team.
-
-	After careful deliberation, it was decided that no one should have need for that many hot dogs
-	with overnight shipping.  Frankly, we're more than a little concerned for your health.
-
-	Sincerely,
-	Rowe's Meat Emporium
-	(Buy!  Sell!  Consignment!)
-  TMPL
-
-  template.order = order
-  template.render
-
-  template.fragments[ :subject ] #=> "Your order status (Order #3492)"
-
-
 == Placeholder Tags
 
 Placeholder tags represent the main functionality of Inversion; they create a placeholder in the output text which can be filled in via a method on the template object with the same name.
@@ -231,9 +98,9 @@ Dates are compared against the current time, and render to approximate descripti
 * less than a minute from now
 
 
-== Import and Publish/Subscribe
+== Inter-template Tags
 
-Both of these tags operate on nested templates: one copies objects from an outer template into an inner one (+import+), and the other publishes sections of content from one template to any other subscribed template.
+These tags operate on nested templates, allowing you to selectively use or send attributes or content from other templates.
 
 
 === import
@@ -401,6 +268,34 @@ The +include+ tag allows inclusion of other template files from within a templat
   Your Friends at Spime Thorpe!
 
 
+=== fragment
+
+A +fragment+ tag also sets an attribute from within the template, but under the
+scope of the global template itself. A fragment can use other Inversion tags,
+and the attribute is both usable elsewhere in the template, and accessible from
+calling code after rendering.
+
+  template = Inversion::Template.new <<-TMPL
+	<?fragment subject ?>Your order status (Order #<?call order.number ?>)<?end ?>
+
+	Dear <?call order.customer.name ?>,
+
+	Your recent order was modified by our Order Fulfillment Team.
+
+	After careful deliberation, it was decided that no one should have need for that many hot dogs
+	with overnight shipping.  Frankly, we're more than a little concerned for your health.
+
+	Sincerely,
+	Rowe's Meat Emporium
+	(Buy!  Sell!  Consignment!)
+  TMPL
+
+  template.order = order
+  template.render
+
+  template.fragments[ :subject ] #=> "Your order status (Order #3492)"
+
+
 == Flow Control
 
 The following tags are used to alter the flow of rendering from within templates.
@@ -517,6 +412,86 @@ The +yield+ tag is used to defer rendering of some part of the template to the c
 This will insert the +report_table+ template in place of the yield, but only if $DEBUG is true.
 
 
+=== begin/rescue
+
+These tags work as you'd expect from their ruby counterparts. 
+
+The +begin+ section of the template to be rendered only if no exceptions are raised while it's
+being rendered. If an exception is raised, it is checked against any +rescue+ sections, and the
+first with a matching exception is rendered instead. If no +rescue+ block is found, the exception
+is handled by the configured exception behavior for the template (see Inversion::Template@Template+Options).
+
+  <?begin ?><?call employees.length ?><?end?>
+  
+  <?begin ?>
+    <?for employee in employees.all ?>
+      <?attr employee.name ?> --> <?attr employee.title ?>
+    <?end for?>
+  <?rescue DatabaseError => err ?>
+    Oh no!! I can't talk to the database for some reason.  The
+    error was as follows:
+    <pre>
+      <?attr err.message ?>
+    </pre>
+  <?end?>
+
+
+== Control Tags
+
+There are a few tags that can be used to set values in the templating system itself.
+
+=== config
+
+The +config+ tag can be used to override template options[Templates@Template+Options]
+on a per-template basis.  It allows for convenient, inline settings from
+within a template rather than from the code in which the template is
+loaded.
+
+For example, if you want to enable debugging comments on a single template:
+
+  <?config debugging_comments: true ?>
+
+Multiple template options can be set simultaneously by using a YAML hash:
+
+  <?config
+      on_render_error: propagate
+      debugging_comments: true
+      comment_start: /*
+      comment_end: */
+  ?>
+
+Note that this also allows you to set multiple options on a single line, if you wrap them in braces:
+
+  <?config { comment_start: "/*", comment_end: "*/" } ?>
+
+
+=== default
+
+The +default+ tag sets an attribute from within the template, and this value is used if the attribute is otherwise unset.
+
+  template = Inversion::Template.new <<-TMPL
+    <?default adjective to "cruel" ?>
+    <?default noun to "world" ?>
+    Goodbye, <?attr adjective ?> <?attr noun ?>!
+  TMPL
+
+  template.render
+
+  template.adjective = "delicious"
+  template.render
+
+  template.adjective = nil
+  template.noun = "banana"
+  template.render
+
+Would produce the output:
+
+  Goodbye, cruel world!
+  Goodbye, delicious world!
+  Goodbye, cruel banana!
+
+
+
 == Troubleshooting/Introspection
 
 === pp

data/lib/inversion.rb

@@ -26,10 +26,10 @@ module Inversion
 	warn ">>> Inversion requires Ruby 2.0.0 or later. <<<" if RUBY_VERSION < '2.0.0'
 
 	# Library version constant
-	VERSION = '0.17.2'
+	VERSION = '0.17.3'
 
 	# Version-control revision constant
-	REVISION = %q$Revision: 25c7ea1fcb58 $
+	REVISION = %q$Revision: ad70311aa386 $
 
 
 	### Get the Inversion version.

data/lib/inversion/renderstate.rb

@@ -479,7 +479,7 @@ class Inversion::RenderState
 
 	### Return the given +nodes+ as a String in the configured encoding.
 	def stringify_nodes( nodes )
-		self.log.debug "Rendering nodes: %p" % [ nodes ]
+		# self.log.debug "Rendering nodes: %p" % [ nodes ]
 		strings = nodes.flatten.map( &:to_s )
 
 		if enc = self.options[ :encoding ]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: inversion
 version: !ruby/object:Gem::Version
-  version: 0.17.2
+  version: 0.17.3
 platform: ruby
 authors:
 - Michael Granger
@@ -31,7 +31,7 @@ cert_chain:
   c7ZKPJcWBv0sm81+FCZXNACn2f9jfF8OQinxVs0O052KbGuEQaaiGIYeuuwQE2q6
   ggcrPfcYeTwWlfZPu2LrBg==
   -----END CERTIFICATE-----
-date: 2015-01-23 00:00:00.000000000 Z
+date: 2015-02-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: loggability

metadata.gz.sig

@@ -1,2 +1,3 @@
-���^(����\Q
-!�ݚw���$��L��lN�Z��}Y:4�㻐5��6�}^���ݎs��B:��ˑ��7t�Z��2�sb��[Ÿ��Xp�?ft&��6�=a�俓��M�puPa#"�d�a��GӘG�ꠔλ�.���{����Y0��OP_�mYvb�zV��M}���p%�NwA������a�fڵK��������j�<`�E��\Sґc50A�W��d%�V�[@�:`v����A��j�H����'�
+t�T4=�ɵd�I�_@�����]���$w��Y	�~�+ �:X���x���ǯ0u���{r�K�!���
+:�;ș��{�X�S���;͔��S|� ҙ�n
+w5�6>TI0���`���bQc���O�!�����s[|٣&L�m��h���LQ3���gL��	�9p��44�Z������ЃH���	�*���8�*E ���񚳴��|���q+Hą�4_"�sD��l��7�\�Z���F;�