blocks 2.5.0 → 2.5.1

data/CHANGELOG.rdoc

@@ -1,3 +1,6 @@
+2.5.1 (October 17, 2013)
+* Changed Blocks.wrap_with_surrounds_before_and_after_blocks to Blocks.wrap_before_and_after_blocks
+
 2.5.0 (October 14, 2013)
 * Added skip method as a shorthand for defining or replacing a block's definition so that nothing is output when the block is rendered
 * Added ability to wrap each block in a collection with an element or render a block with an element, using syntax like:

data/README.rdoc

@@ -1,5 +1,7 @@
 = Blocks
 
+I AM CURRENTLY IN THE PROCESS OF WRITING THIS DOCUMENTATION OVER AGAIN SINCE A LOT HAS CHANGED SINCE THE DOCUMENTATION WAS ORIGINALLY WRITTEN.
+
 How do you render your blocks of code?
 
 The idea of this gem is simple (yet difficult to see the practical application for): blocks of code, regardless of code, whether they are a ruby block or a rails partial, are, or should be, completely interchangeable.

data/VERSION

@@ -1 +1 @@
-2.5.0
+2.5.1

data/blocks.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "blocks"
-  s.version = "2.5.0"
+  s.version = "2.5.1"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Andrew Hunter"]
-  s.date = "2013-10-15"
+  s.date = "2013-10-17"
   s.description = "Blocks goes beyond blocks and partials"
   s.email = "hunterae@gmail.com"
   s.extra_rdoc_files = [

data/lib/blocks.rb

@@ -14,8 +14,8 @@ module Blocks
   mattr_accessor :use_partials
   @@use_partials = false
 
-  mattr_accessor :wrap_with_surrounds_before_and_after_blocks
-  @@wrap_with_surrounds_before_and_after_blocks = false
+  mattr_accessor :wrap_before_and_after_blocks
+  @@wrap_before_and_after_blocks = false
 
   # Shortcut for using the templating feature / rendering templates
   def self.render_template(view, partial, options={}, &block)

data/lib/blocks/base.rb

@@ -24,7 +24,7 @@ module Blocks
     attr_accessor :use_partials
 
     # Boolean variable for whether Blocks should render before and after blocks inside or outside of a collections' elements' wrap_with tags
-    attr_accessor :wrap_with_surrounds_before_and_after_blocks
+    attr_accessor :wrap_before_and_after_blocks
 
     # Checks if a particular block has been defined within the current block scope.
     #   <%= blocks.defined? :some_block_name %>
@@ -143,11 +143,9 @@ module Blocks
     #     [:as]
     #       The variable name to assign the current element in the collection being rendered over
     #     [:wrap_with]
-    #       The content tag to render around a block, which might be particularly useful when rendering a collection of blocks,
-    #       such as for a list or table
+    #       The content tag to render around this block (For example: :wrap_with => {:tag => TAG_TYPE, :class => "my-class", :style => "border: 1px solid black"})
     #     [:wrap_each]
-    #       The attributes to be applied to the HTML content tag, such as styling or special properties. Please note, any Procs passed
-    #       in will automatically be evaluated (For example: :class => lambda { cycle("even", "odd") })
+    #       The content tag to render around each item in a collection (For example: :wrap_each { :class => lambda { cycle("even", "odd") }})
     #     [:use_partials]
     #       Overrides the globally defined use_partials and tells Blocks to render partials in trying to render a block
     #     [:skip_partials]
@@ -186,7 +184,7 @@ module Blocks
       else
         args.push(options)
 
-        if wrap_with_surrounds_before_and_after_blocks
+        if wrap_before_and_after_blocks
           buffer << content_tag_with_block(wrap_with[:tag], wrap_with.except(:tag), *args) do
             temp_buffer = ActiveSupport::SafeBuffer.new
             temp_buffer << render_before_blocks(name_or_container, *args)
@@ -230,12 +228,10 @@ module Blocks
     #       The collection of elements to render blocks for
     #     [:as]
     #       The variable name to assign the current element in the collection being rendered over
-    #     [:surrounding_tag]
-    #       The content tag to render around a block, which might be particularly useful when rendering a collection of blocks,
-    #       such as for a list or table
-    #     [:surrounding_tag_html]
-    #       The attributes to be applied to the HTML content tag, such as styling or special properties. Please note, any Procs passed
-    #       in will automatically be evaluated (For example: :class => lambda { cycle("even", "odd") })
+    #     [:wrap_with]
+    #       The content tag to render around this block (For example: :wrap_with => {:tag => TAG_TYPE, :class => "my-class", :style => "border: 1px solid black"})
+    #     [:wrap_each]
+    #       The content tag to render around each item in a collection (For example: :wrap_each { :class => lambda { cycle("even", "odd") }})
     # [+block+]
     #   The default block to render if no such block block that is to be rendered when "blocks.render" is called for this block.
     def render_without_partials(name_or_container, *args, &block)
@@ -279,12 +275,10 @@ module Blocks
     #       The collection of elements to render blocks for
     #     [:as]
     #       The variable name to assign the current element in the collection being rendered over
-    #     [:surrounding_tag]
-    #       The content tag to render around a block, which might be particularly useful when rendering a collection of blocks,
-    #       such as for a list or table
-    #     [:surrounding_tag_html]
-    #       The attributes to be applied to the HTML content tag, such as styling or special properties. Please note, any Procs passed
-    #       in will automatically be evaluated (For example: :class => lambda { cycle("even", "odd") })
+    #     [:wrap_with]
+    #       The content tag to render around this block (For example: :wrap_with => {:tag => TAG_TYPE, :class => "my-class", :style => "border: 1px solid black"})
+    #     [:wrap_each]
+    #       The content tag to render around each item in a collection (For example: :wrap_each { :class => lambda { cycle("even", "odd") }})
     # [+block+]
     #   The default block to render if no such block block that is to be rendered when "blocks.render" is called for this block.
     def render_with_partials(name_or_container, *args, &block)
@@ -428,7 +422,7 @@ module Blocks
       self.blocks = {}
       self.anonymous_block_number = 0
       self.use_partials = options[:use_partials].nil? ? Blocks.use_partials : options.delete(:use_partials)
-      self.wrap_with_surrounds_before_and_after_blocks = options[:wrap_with_surrounds_before_and_after_blocks].nil? ? Blocks.wrap_with_surrounds_before_and_after_blocks : options.delete(:wrap_with_surrounds_before_and_after_blocks)
+      self.wrap_before_and_after_blocks = options[:wrap_before_and_after_blocks].nil? ? Blocks.wrap_before_and_after_blocks : options.delete(:wrap_before_and_after_blocks)
     end
 
     # Return a unique name for an anonymously defined block (i.e. a block that has not been given a name)

data/spec/blocks/base_spec.rb

@@ -407,7 +407,7 @@ describe Blocks::Base do
       end
 
       it "should allow the global option to be set to render before and after blocks outside of surrounding elements" do
-        Blocks.wrap_with_surrounds_before_and_after_blocks = false
+        Blocks.wrap_before_and_after_blocks = false
         @builder = Blocks::Base.new(@view)
         before_block = Proc.new {|item, options| "before#{options[:some_block]} "}
         @builder.before :some_block, &before_block
@@ -421,7 +421,7 @@ describe Blocks::Base do
       end
 
       it "should allow the option to be set to render before and after blocks outside of surrounding elements to be specified when Blocks is initialized" do
-        @builder = Blocks::Base.new(@view, :wrap_with_surrounds_before_and_after_blocks => false)
+        @builder = Blocks::Base.new(@view, :wrap_before_and_after_blocks => false)
         before_block = Proc.new {|item, options| "before#{options[:some_block]} "}
         @builder.before :some_block, &before_block
 

data/spec/spec_helper.rb

@@ -13,7 +13,7 @@ RSpec.configure do |config|
   
   config.before :each do
     Blocks.template_folder = "blocks"
-    Blocks.wrap_with_surrounds_before_and_after_blocks = true
+    Blocks.wrap_before_and_after_blocks = true
     Blocks.use_partials = false
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: blocks
 version: !ruby/object:Gem::Version
-  version: 2.5.0
+  version: 2.5.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-10-15 00:00:00.000000000 Z
+date: 2013-10-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -134,7 +134,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -2216410614422126676
+      hash: -1089807617590558203
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: