blocks 3.0.4 → 4.0.0.rc1

metadata

@@ -1,45 +1,45 @@
 --- !ruby/object:Gem::Specification
 name: blocks
 version: !ruby/object:Gem::Version
-  version: 3.0.4
+  version: 4.0.0.rc1
 platform: ruby
 authors:
 - Andrew Hunter
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2018-02-05 00:00:00.000000000 Z
+date: 2020-01-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: call_with_params
+  name: rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 3.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 3.0.0
 - !ruby/object:Gem::Dependency
-  name: rails
+  name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.0.0
-  type: :runtime
+        version: '0'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.0.0
+        version: '0'
 - !ruby/object:Gem::Dependency
-  name: simplecov
+  name: memory_profiler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
@@ -82,10 +82,13 @@ files:
 - docs/_includes/custom-builders.md
 - docs/_includes/defining.md
 - docs/_includes/demos/hooks-and-wrappers-output.html
+- docs/_includes/features.md
+- docs/_includes/helper-blocks.md
+- docs/_includes/helper-blocks/content_tag.md
 - docs/_includes/hooks.md
 - docs/_includes/installation.md
-- docs/_includes/introduction.md
 - docs/_includes/option-merging.md
+- docs/_includes/overview.md
 - docs/_includes/rendering.md
 - docs/_includes/reserved-keywords.md
 - docs/_includes/skipping.md
@@ -94,7 +97,6 @@ files:
 - docs/_includes/templating.md
 - docs/_includes/templating/bootstrap_4_cards.md
 - docs/_includes/use-cases.md
-- docs/_includes/wip.md
 - docs/_includes/wrappers.md
 - docs/_layouts/slate.html
 - docs/_plugins/gem_version.rb
@@ -147,14 +149,15 @@ files:
 - gemfiles/Gemfile.rails-4-2-stable
 - gemfiles/Gemfile.rails-5-0-stable
 - gemfiles/Gemfile.rails-5-1-stable
+- gemfiles/Gemfile.rails-5-2-stable
 - lib/blocks.rb
-- lib/blocks/action_view_extensions/view_extensions.rb
 - lib/blocks/builders/block_definition.rb
 - lib/blocks/builders/builder.rb
 - lib/blocks/builders/hook_definition.rb
-- lib/blocks/experimental/builder_permissions.rb
-- lib/blocks/experimental/invalid_permissions_handler.rb
-- lib/blocks/renderers/abstract_renderer.rb
+- lib/blocks/engine.rb
+- lib/blocks/helpers/controller_extensions.rb
+- lib/blocks/helpers/haml_capture.rb
+- lib/blocks/helpers/view_extensions.rb
 - lib/blocks/renderers/adjacent_blocks_renderer.rb
 - lib/blocks/renderers/block_placeholder.rb
 - lib/blocks/renderers/block_renderer.rb
@@ -166,7 +169,6 @@ files:
 - lib/blocks/renderers/runtime_context.rb
 - lib/blocks/renderers/wrapper_renderer.rb
 - lib/blocks/utilities/configurator.rb
-- lib/blocks/utilities/dynamic_configuration.rb
 - lib/blocks/utilities/hash_with_caller.rb
 - lib/blocks/utilities/hash_with_render_strategy.rb
 - lib/blocks/utilities/options_set.rb
@@ -187,12 +189,11 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
-rubyforge_project: 
-rubygems_version: 2.6.13
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: Blocks gives you total control over how your blocks of code render.

data/docs/_includes/wip.md

@@ -1,34 +0,0 @@
-<!-- Defining multiple blocks at once -->
-## Multiple Blocks at Once
-
-```haml
-- namer = Proc.new {|i| "block #{i}" }
-blocks.define_each ["a", 1, "b"],
-  namer do |item|
-  ="Hello from #{item}"
-  &br
-
-= blocks.render("block a")
-= blocks.render("block 1")
-= blocks.render("block b")
-```
-
-```ruby
-# where builder is an instance of
-#  Blocks::Builder
-namer = Proc.new {|i| "block #{i}" }
-builder.define_each ["a", 1, "b"],
-  namer do |item|
-  "Hello from #{item}<br>".html_safe
-end
-
-builder.render("block a") +
-builder.render("block 1") +
-builder.render("block b")
-```
-
-Multiple different blocks may be defined at once using the #define_each method.
-
-#define_each expects at least two parameters: the collection and a proc that can be used to calculate the block name. The proc must at least one parameter, the first being the item in the collection.
-
-The method also expects either an options hash designating the render strategy or a Ruby block.

data/lib/blocks/experimental/builder_permissions.rb

@@ -1,52 +0,0 @@
-# WIP
-module Blocks
-  module BuilderPermissions
-    extend ActiveSupport::Concern
-
-    METHODS_TO_PROTECT = [:render, :define, :deferred_render, :replace, :skip]
-
-    included do
-      attr_writer :permitted_blocks
-      attr_accessor :allow_all_blocks
-      attr_accessor :allow_anonymous_blocks
-
-      METHODS_TO_PROTECT.each do |method_name|
-        alias_method "original_#{method_name}", method_name
-        define_method(method_name) do |*args, &block|
-          if permitted?(args.first)
-            self.send("original_#{method_name}", *args, &block)
-          else
-            InvalidPermissionsHandler.build(method_name, args.first)
-          end
-        end
-      end
-    end
-
-    def restrict_blocks
-      self.allow_all_blocks = false
-    end
-
-    def permitted_blocks
-      @permitted_blocks ||= []
-    end
-
-    def permit(*names)
-      self.permitted_blocks += names
-    end
-
-    def permit_all
-      self.allow_all_blocks = true
-    end
-
-    def permit_anonymous_blocks
-      self.allow_anonymous_blocks = true
-    end
-
-    def permitted?(name)
-      allow_all_blocks ||
-      (block_definitions[name].try(:anonymous) && allow_anonymous_blocks) ||
-      !name.respond_to?(:to_sym) ||
-      permitted_blocks.any? {|e| e.to_sym == name.to_sym }
-    end
-  end
-end

data/lib/blocks/experimental/invalid_permissions_handler.rb

@@ -1,27 +0,0 @@
-# WIP
-module Blocks
-  class InvalidPermissionsHandler
-    LOG = :log
-    RAISE = :raise
-
-    def self.build(method_name, block_name)
-      message = "Cannot #{method_name} #{block_name}; #{block_name} is not in the permitted_blocks list"
-      new(message)
-      nil
-    end
-
-    def initialize(message)
-      send("handle_#{Blocks.invalid_permissions_approach}", message)
-    end
-
-    private
-
-    def handle_log(message)
-      Rails.logger.info message
-    end
-
-    def handle_raise(message)
-      raise message
-    end
-  end
-end

data/lib/blocks/renderers/abstract_renderer.rb

@@ -1,69 +0,0 @@
-module Blocks
-  class AbstractRenderer
-    RENDERERS = [
-      AdjacentBlocksRenderer,
-      BlockRenderer,
-      BlockWithHooksRenderer,
-      CollectionRenderer,
-      PartialRenderer,
-      NestingBlocksRenderer,
-      WrapperRenderer
-    ]
-
-    attr_accessor :main_renderer
-
-    delegate :builder, *(RENDERERS.map {|r| r.to_s.demodulize.underscore }), to: :main_renderer
-    delegate :block_definitions, :block_for, :view, to: :builder
-    delegate :with_output_buffer, :output_buffer, to: :view
-
-    def initialize(main_renderer=nil)
-      self.main_renderer = main_renderer
-    end
-
-    def render(*args)
-      raise NotImplementedError
-    end
-
-    def capture(*args, &block)
-      without_haml_interference do
-        if block.arity > 0
-          args = args[0, block.arity]
-        end
-
-        with_output_buffer do
-          output_buffer << view.capture(*args, &block)
-        end
-      end
-    end
-
-    protected
-
-    # Complete hack to get around issues with Haml
-    #  Haml does some hacking to ActionView's with_output_buffer and
-    #  output_buffer. In doing so, they make certain assumptions about
-    #  the layout and the view template. The Blocks gem doesn't capture
-    #  blocks immediately but rather stores them for later capturing.
-    #  This can produce an issue if a block that is stored was in Haml
-    #  but the Layout is in ERB. Haml will think that any blocks it
-    #  captures while rendering the layout will be in ERB format. However,
-    #  the block would need to be captured in Haml using a Haml buffer.
-    #  This workaround accomplishes that.
-    def without_haml_interference(&block)
-      if defined?(::Haml) && view.instance_variables.include?(:@haml_buffer)
-        haml_buffer = view.instance_variable_get(:@haml_buffer)
-        if haml_buffer
-          was_active = haml_buffer.active?
-          haml_buffer.active = false
-        else
-          haml_buffer = Haml::Buffer.new(nil, Haml::Options.new.for_buffer)
-          haml_buffer.active = false
-          kill_buffer = true
-          view.instance_variable_set(:@haml_buffer, haml_buffer)
-        end
-      end
-      yield
-    ensure
-      haml_buffer.active = was_active if haml_buffer
-    end
-  end
-end

data/lib/blocks/utilities/dynamic_configuration.rb

@@ -1,71 +0,0 @@
-module Blocks
-  module DynamicConfiguration
-    extend ActiveSupport::Concern
-
-    module ClassMethods
-      def add_config(*attrs)
-        options = attrs.extract_options!
-        instance_reader = options.fetch(:instance_accessor, true) && options.fetch(:instance_reader, true)
-        instance_writer = options.fetch(:instance_accessor, true) && options.fetch(:instance_writer, true)
-        instance_predicate = options.fetch(:instance_predicate, true)
-        default_value = options.fetch(:default, nil)
-
-        attrs.each do |name|
-          define_singleton_method(name) do |value="UNDEFINED"|
-            if value == "UNDEFINED"
-              default_value
-            else
-              public_send("#{name}=", value)
-            end
-          end
-          define_singleton_method("#{name}?") { !!public_send(name) } if instance_predicate
-
-          ivar = "@#{name}"
-
-          define_singleton_method("#{name}=") do |val|
-            singleton_class.class_eval do
-              remove_possible_method(name)
-              define_method(name) do |value="UNDEFINED"|
-                if value == "UNDEFINED"
-                  val
-                else
-                  public_send("#{name}=", value)
-                end
-              end
-            end
-
-            class_eval do
-              remove_possible_method(name)
-              define_method(name) do
-                if instance_variable_defined? ivar
-                  instance_variable_get ivar
-                else
-                  singleton_class.send name
-                end
-              end
-            end
-            val
-          end
-
-          if instance_reader
-            remove_possible_method name
-            define_method(name) do
-              if instance_variable_defined?(ivar)
-                instance_variable_get ivar
-              else
-                self.class.public_send name
-              end
-            end
-            define_method("#{name}?") { !!public_send(name) } if instance_predicate
-          end
-
-          attr_writer name if instance_writer
-        end
-      end
-
-      def configure
-        yield self
-      end
-    end
-  end
-end