nestive_rendering 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 099ff10f13d97d6e59b72959b44445ebc9919d52
+  data.tar.gz: d3c8a453d1c30dfb6131f50ef7e51b7cf5735fde
+SHA512:
+  metadata.gz: 463152fc1c35aac30f7d01b57495ce50315d5a0394056563c7799c31022353da41445a38bed1fc04e0489a3a8ce6755c6537691fa50bde160cecaefe0e5883b7
+  data.tar.gz: ed95fd4b280fecbd6721834bb2340f2c3db1dd8446a2b73fcd2fe464fdd0e69abefc4a15cc504f036b27388ec6b28e03c2a07bc2c37e1d5886f8349e7da89032

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Justin French
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,274 @@
+# Nestive Rendering [![Build Status](https://travis-ci.org/mdeering/nestive_rendering.png)](https://travis-ci.org/mdeering/nestive_rendering) [![Code Climate](https://codeclimate.com/github/mdeering/nestive_rendering.png)](https://codeclimate.com/github/mdeering/nestive_rendering)
+## A Nested Inheritable Layouts and Partial Helpers for Rails
+
+## Forked from [Nestive](https://github.com/rwz/nestive) to add option passing and the ability to extend partials.
+
+Nestive Rendering adds powerful layout, template and partial view helpers to your Rails app. It's similar
+to the nested layout technique [already documented in the Rails
+guides](http://guides.rubyonrails.org/layouts_and_rendering.html#using-nested-layouts)
+and found in many other nested layout plugins (a technique using `content_for`
+and rendering the parent layout at the end of the child layout). There's a
+bunch of problems with this technique, including:
+
+* you can only *append* content to the content buffer with `content_for` (you
+  can't prepend to content, you can't replace it)
+* when combined with this nested layout technique, `content_for` actually
+  *prepends* new content to the buffer, because each parent layout is rendered
+  *after* it's child
+
+Nestive Rendering is *better* because it addresses these problems.
+
+## Just seven methods (so far)
+
+### Declaring an area of content with `area`:
+
+The `area` helper is a lot like Rails' own `<%= yield :foo %>`, and is used in
+layouts to define and render a chunk of content in your layout:
+
+```erb
+<%= area :sidebar %>
+```
+
+Unlike `yield`, `area` will allow your parent layouts to add content to the
+area at the same time using either a String or a block:
+
+```erb
+<%= area :sidebar, "Some Content Here" %>
+
+<%= area :sidebar do %>
+  Some Content Here
+<% end %>
+```
+
+It's important to note that this isn't *default* content, it *is* the content
+(unless a child changes it).
+
+### Appending content to an area with `append`:
+
+The implementation details are quite different, but the `append` helper works
+much like Rails' built-in `content_for`. It will work with either a String or
+block, adding the new content onto the end of any content previously provided
+by parent layouts:
+
+```erb
+<%= extends :application do %>
+  <% append :sidebar, "More content." %>
+  <% append :sidebar do %>
+    More content.
+  <% end %>
+<% end %>
+```
+
+### Prepending content to an area with `prepend`:
+
+Exactly what you think it is. The reverse of `append` (duh), adding the new
+content at the start of any content previously provided by parent layouts:
+
+``` erb
+<%= extends :application do %>
+  <%= prepend :sidebar, "Content." %>
+  <%= prepend :sidebar do %>
+    Content.
+  <% end %>
+<% end %>
+```
+
+### Replacing content with `replace`
+
+You can also replace any content provided by parent layouts:
+
+``` erb
+<%= extends :application do %>
+  <%= replace :sidebar, "New content." %>
+  <%= replace :sidebar do %>
+    New content.
+  <% end %>
+<% end %>
+```
+
+### Removing content with `purge`
+
+You can remove the content in the single or in multiple areas
+
+``` erb
+<% purge :sidebar %>
+<% purge :sidebar, :banner %>
+```
+
+... which is equal to:
+
+``` erb
+<% replace :sidebar, nil %>
+```
+
+### Extending a layout in a child layout (or view) with `extends`
+
+Any layout (or view) can declare that it wants to inherit from and extend a
+parent layout, in this case we're extending
+`app/views/layouts/application.html.erb`:
+
+``` erb
+<%= extends :application do %>
+   ...
+<% end %>
+```
+
+You can nest many levels deep:
+
+`app/views/layouts/application.html.erb`:
+
+``` erb
+<!DOCTYPE html>
+  <html>
+    <head>
+      <%= area :head do %>
+        <title><%= area :title, 'Nestive' %></title>
+      <% end %>
+    </head>
+  <body>
+    <%= yield %>
+  </body>
+</html>
+```
+
+`app/views/layouts/with_sidebar.html.erb`:
+
+``` erb
+<%= extends :application do %>
+  <div class="sidebar"><%= area(:sidebar) do %>
+    here goes sidebar
+  <% end %></div>
+  <%= yield -%>
+<% end %>
+```
+
+`app/views/layouts/blog_posts.html.erb`:
+
+``` erb
+<%= extends :with_sidebar do %>
+  <% append :sidebar do %>
+    Blog archive:
+    <%= render_blog_archive %>
+  <% end %>
+
+  <% append :head do %>
+    <%= javascript_include_tag 'fancy_blog_archive_tag_cloud' %>
+  <% end %>
+
+  <%= yield %>
+<% end %>
+```
+
+## The token blog example
+
+Set-up a global layout defining some content areas.
+
+`app/views/layouts/application.html.erb`:
+
+``` erb
+<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <title><%= area :title, "JustinFrench.com" %></title>
+  <meta name="description" content="<%= area :description, "This is my website." %>">
+  <meta name="keywords" content="<%= area :keywords, "justin, french, ruby, design" %>">
+</head>
+<body>
+  <div id="wrapper">
+    <div id="content">
+      <%= area :content do %>
+        <p>Default content goes here.</p>
+      <% end %>
+    </div>
+    <div id="sidebar">
+      <%= area :sidebar do %>
+        <h2>About Me</h2>
+        <p>...</p>
+      <% end %>
+    </div>
+  </div>
+  <%= yield %>
+</body>
+</html>
+```
+
+Next, we set-up a `blog` layout that extends `application`, replacing,
+appending & prepending content to the areas we defined earlier.
+
+`app/views/layouts/blog.html.erb`:
+
+``` erb
+<%= extends :application do %>
+  <% replace :title, "My Blog – " %>
+  <% replace :description, "Justin French blogs here on Ruby, Rails, Design, Formtastic, etc" %>
+  <% prepend :keywords, "blog, weblog, design links, ruby links, formtastic release notes, " %>
+  <%= yield %>
+<% end %>
+```
+
+Now in our blog index view we can use `blog` layout and fill in the areas with
+content specific to the index action.
+
+
+`app/views/posts/index.html.erb`:
+
+``` erb
+<% replace :content do %>
+  <h1>My Blog</h1>
+  <%= render @articles %>
+<% end %>
+
+<% append :sidebar do %>
+  <h2>Blog Roll</h2>
+  <%= render @links %>
+<% end %>
+```
+
+We also need to instruct the `PostsController` to use this `blog` layout:
+
+`app/controllers/posts_controller.rb`:
+
+``` ruby
+class PostsController < ApplicationController
+  layout 'blog'
+end
+```
+
+### Extending a parital in a child partial (or view) with `extends_partial`
+
+Any partial (or view) can declare that it wants to inherit from and extend a
+parent partial.
+
+
+## Caching
+Nestive works the same way `content_for` does and has the same caching
+drawbacks. That means that nestive helpers are completely ignored when called
+from within cached block. You probably don't want to use fragment caching
+around dynamic nestive areas and have to be extra careful what and how you
+cache to avoid unpleasant surprises.
+
+## Installation
+
+* add `gem 'nestive', '~> 0.5'` to your Gemfile
+* run `bundle`
+
+## Compatibility
+
+Nestive should work properly with any Rails 3 and 4. Since version 0.5 only
+Ruby 1.9.3 and newer are supported. For 1.8 compatibility use version 0.4.
+
+
+*Nestive doesn't monkey patch or fiddle with any default behaviors in Rails.* Use it when you want to, don't when you don't.
+
+## You can help with...
+
+* feedback
+* reporting issues
+* fixing issues with pull requests
+* performance testing
+
+## Twitter
+
+* [@rwz](https://twitter.com/rwz) — current maintainer
+* [@justinfrench](http://twitter.com/justinfrench) — author

data/lib/nestive_rendering/layout_helper.rb

@@ -0,0 +1,262 @@
+module NestiveRendering
+
+  # The Nestive Rendering LayoutHelper provides a handful of helper methods for use in your layouts and views.
+  #
+  # See the documentation for each individual method for detailed information, but at a high level,
+  # your parent layouts define `area`s of content. You can define an area and optionally add content
+  # to it at the same time using either a String, or a block:
+  #
+  #     # app/views/layouts/global.html.erb
+  #     <html>
+  #       <head>
+  #         <title><%= area :title, "MySite.com" %></title>
+  #       </head>
+  #       <body>
+  #         <div id="content">
+  #           <%= area :content %>
+  #         </div>
+  #         <div id="sidebar">
+  #           <%= area :sidebar do %>
+  #             <h2>About MySite.com</h2>
+  #             <p>...</p>
+  #           <% end %>
+  #         </div>
+  #       </body>
+  #     </html>
+  #
+  # Your child layouts (or views) inherit and modify the parent by wrapping in an `extends` block
+  # helper. You can then either `append`, `prepend` or `replace` the content that has previously
+  # been assigned to each area by parent layouts.
+  #
+  # The `append`, `prepend` or `replace` helpers are *similar* to Rails' own `content_for`, which
+  # accepts content for the named area with either a String or with a block). They're different to
+  # `content_for` because they're only used modify the content assigned to the area, not retrieve it:
+  #
+  #     # app/views/layouts/admin.html.erb
+  #     <%= extends :global do %>
+  #       <% prepend :title, "Admin :: " %>
+  #       <% replace :sidebar do %>
+  #         <h2>Quick Links</h2>
+  #         <ul>
+  #           <li>...</li>
+  #         </ul>
+  #       <% end %>
+  #     <% end %>
+  #
+  #     # app/views/admin/posts/index.html.erb
+  #     <%= extends :admin do %>
+  #       <% prepend :title, "Posts ::" %>
+  #       <% replace :content do %>
+  #         Normal view stuff goes here.
+  #       <% end %>
+  #     <% end %>
+  module LayoutHelper
+
+    # Declares that the current layour (or view) is inheriting from and extending another layout.
+    #
+    # @param [String] layout
+    #   The base name of the file in `layouts/` that you wish to extend (eg `application` for `layouts/application.html.erb`)
+    # @param [Hash] options
+    #   Any options such as locals that you want to pass through to the layout rendering
+    #
+    # @example Extending the `application` layout to create an `admin` layout
+    #
+    #     # app/views/layouts/admin.html.erb
+    #     <%= extends :application do %>
+    #       ...
+    #     <% end %>
+    #
+    # @example Extending the `admin` layout in a view (you'll need to render the view with `layout: nil`)
+    #
+    #     # app/controllers/admin/posts_controller.rb
+    #     class Admin::PostsController < ApplicationController
+    #       # You can disable Rails' layout rendering for all actions
+    #       layout nil
+    #
+    #       # Or disable Rails' layout rendering per-controller
+    #       def index
+    #         render layout: nil
+    #       end
+    #     end
+    #
+    #     # app/views/admin/posts/index.html.erb
+    #     <%= extends :admin do %>
+    #       ...
+    #     <% end %>
+    def extends(layout, options = {}, &block)
+      # Make sure it's a string
+      layout = layout.to_s
+
+      # If there's no directory component, presume a plain layout name
+      layout = "layouts/#{layout}" unless layout.include?('/')
+
+      # Capture the content to be placed inside the extended layout
+      @view_flow.get(:layout).replace capture(&block)
+
+      render options.merge(file: layout)
+    end
+
+    # Works exactly the same as extends but is targeted at extending partials not
+    # layouts.
+    #
+    # @param [String] partial
+    #   The base name of the partial that you wish to extend (eg `header` for `application/_header.html.erb`)
+    # @param [Hash] options
+    #   Any options such as the object or locals that you want to pass through to the parital rendering
+    #
+    def extends_partial(partial, options = {}, &block)
+      # Make sure it's a string
+      partial = partial.to_s
+      block.call if block_given?
+      render options.merge(partial: partial)
+    end
+
+    # Defines an area of content in your layout that can be modified or replaced by child layouts
+    # that extend it. You can optionally add content to an area using either a String, or a block.
+    #
+    # Areas are declared in a parent layout and modified by a child layout, but since Nestive Rendering
+    # allows for multiple levels of inheritance, a child layout can also declare an area for it's
+    # children to modify.
+    #
+    # @example Define an area without adding content to it:
+    #     <%= area :sidebar %>
+    #
+    # @example Define an area and add a String of content to it:
+    #     <%= area :sidebar, "Some content." %>
+    #
+    # @example Define an area and add content to it with a block:
+    #     <%= area :sidebar do %>
+    #       Some content.
+    #     <% end %>
+    #
+    # @example Define an area in a child layout:
+    #     <%= extends :global do %>
+    #       <%= area :sidebar do %>
+    #         Some content.
+    #       <% end %>
+    #     <% end %>
+    #
+    # @param [Symbol] name
+    #   A unique name to identify this area of content.
+    #
+    # @param [String] content
+    #   An optional String of content to add to the area as you declare it.
+    def area(name, content=nil, &block)
+      content = capture(&block) if block_given?
+      append name, content
+      render_area name
+    end
+
+    # Appends content to an area previously defined or modified in parent layout(s). You can provide
+    # the content using either a String, or a block.
+    #
+    # @example Appending content with a String
+    #     <% append :sidebar, "Some content." %>
+    #
+    # @example Appending content with a block:
+    #     <% append :sidebar do %>
+    #       Some content.
+    #     <% end %>
+    #
+    # @param [Symbol] name
+    #   A name to identify the area of content you wish to append to
+    #
+    # @param [String] content
+    #   Optionally provide a String of content, instead of a block. A block will take precedence.
+    def append(name, content=nil, &block)
+      content = capture(&block) if block_given?
+      add_instruction_to_area name, :push, content
+    end
+
+    # Prepends content to an area previously declared or modified in parent layout(s). You can
+    # provide the content using either a String, or a block.
+    #
+    # @example Prepending content with a String
+    #     <% prepend :sidebar, "Some content." %>
+    #
+    # @example Prepending content with a block:
+    #     <% prepend :sidebar do %>
+    #       Some content.
+    #     <% end %>
+    #
+    # @param [Symbol] name
+    #   A name to identify the area of content you wish to prepend to
+    #
+    # @param [String] content
+    #   Optionally provide a String of content, instead of a block. A block will take precedence.
+    def prepend(name, content=nil, &block)
+      content = capture(&block) if block_given?
+      add_instruction_to_area name, :unshift, content
+    end
+
+    # Replaces the content of an area previously declared or modified in parent layout(s). You can
+    # provide the content using either a String, or a block.
+    #
+    # @example Replacing content with a String
+    #     <% replace :sidebar, "New content." %>
+    #
+    # @example Replacing content with a block:
+    #     <% replace :sidebar do %>
+    #       New content.
+    #     <% end %>
+    #
+    # @param [Symbol] name
+    #   A name to identify the area of content you wish to replace
+    #
+    # @param [String] content
+    #   Optionally provide a String of content, instead of a block. A block will take precedence.
+    def replace(name, content=nil, &block)
+      content = capture(&block) if block_given?
+      add_instruction_to_area name, :replace, [content]
+    end
+
+    # Purge the content of an area previously declared or modified in parent layout(s).
+    #
+    # @example Purge content
+    #     <% purge :sidebar %>
+    #
+    # @param names
+    #   A list of area names to purge
+    def purge(*names)
+      names.each{ |name| replace(name, nil)}
+    end
+
+    private
+
+    # We record the instructions (declaring, appending, prepending and replacing) for an area of
+    # content into an array that we can later retrieve and replay. Instructions are stored in an
+    # instance variable Hash `@_area_for`, with each key representing an area name, and each value
+    # an Array of instructions. Each instruction is a two element array containing a instruction
+    # method (eg `:push`, `:unshift`, `:replace`) and a value (content String).
+    #
+    #     @_area_for[:sidebar] # => [ [:push,"World"], [:unshift,"Hello"] ]
+    #
+    # Due to the way we extend layouts (render the parent layout after the child), the instructions
+    # are captured in reverse order. `render_area` reversed them and plays them back at rendering
+    # time.
+    #
+    # @example
+    #   add_instruction_to_area(:sidebar, :push, "More content.")
+    def add_instruction_to_area(name, instruction, value)
+      @_area_for ||= {}
+      @_area_for[name] ||= []
+      @_area_for[name] << [instruction, value]
+      nil
+    end
+
+    # Take the instructions we've gathered for the area and replay them one after the other on
+    # an empty array. These instructions will push, unshift or replace items into our output array,
+    # which we then join and mark as html_safe.
+    #
+    # These instructions are reversed and replayed when we render the block (rather than as they
+    # happen) due to the way they are gathered by the layout extension process (in reverse).
+    def render_area(name)
+      [].tap do |output|
+        @_area_for.fetch(name, []).reverse_each do |method_name, content|
+          output.public_send method_name, content
+        end
+      end.join.html_safe
+    end
+
+  end
+end

data/lib/nestive_rendering/railtie.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+
+module NestiveRendering
+  class Railtie < Rails::Railtie
+    initializer 'nestive_rendering.initialize' do
+      ActiveSupport.on_load(:action_view) do
+        include NestiveRendering::LayoutHelper
+      end
+    end
+  end
+end

data/lib/nestive_rendering/version.rb

@@ -0,0 +1,3 @@
+module NestiveRendering
+  VERSION = '1.0.0'
+end

data/lib/nestive_rendering.rb

@@ -0,0 +1,6 @@
+require 'nestive_rendering/version'
+require 'nestive_rendering/layout_helper'
+require 'nestive_rendering/railtie'
+
+module NestiveRendering
+end

data/spec/controllers/nestive_spec.rb

@@ -0,0 +1,122 @@
+require 'spec_helper'
+
+describe NestiveController do
+  render_views
+
+  context '#area' do
+    it 'is empty by default' do
+      get :index
+      assert_select '#empty-area', ''
+    end
+
+    it 'shows initial value if any' do
+      get :index
+      assert_select 'title', 'Nestive'
+    end
+
+    it 'can accept blocks as initial value' do
+      get :index
+      assert_select '#some-area', 'Some content'
+    end
+  end
+
+  context '#append' do
+    it 'appends content to area as a string' do
+      get :append
+      assert_select 'title', 'Nestive is awesome'
+    end
+
+    it 'appends content to area as a block' do
+      get :append
+      assert_select '#some-area', "Some content\n  Another content"
+    end
+  end
+
+  context '#prepend' do
+    it 'prepends content to area as a string' do
+      get :prepend
+      assert_select 'title', 'Awesome Nestive'
+    end
+
+    it 'prepends content to area as a block' do
+      get :prepend
+      assert_select '#some-area', "Prepended\n        Some content"
+    end
+  end
+
+  context '#replace' do
+    it 'replaces area content with string' do
+      get :replace
+      assert_select 'title', 'Lolwut'
+    end
+
+    it 'replaces area content with block' do
+      get :replace
+      assert_select '#some-area', 'replaced'
+    end
+  end
+
+  context '#purge' do
+    it 'purge single area content' do
+      get :purge_single
+      assert_select 'title'
+    end
+
+    it 'purge few areas content' do
+      get :purge_multiple
+      assert_select 'title'
+      assert_select '#some-area'
+    end
+  end
+
+  context '#extends' do
+    it 'extends layouts' do
+      get :extended_one
+      assert_select 'p', 'extended: one'
+      assert_select 'title', 'extended: one'
+      assert_select 'h2', 'extended: one'
+    end
+
+    it 'can extend already extended layouts' do
+      get :extended_two
+      assert_select 'p', 'extended: two'
+      assert_select 'title', 'extended: one'
+      assert_select '#some-area', 'extended: two'
+      assert_select 'h2', 'extended: one'
+    end
+
+    it 'extends empty layout' do
+      get :extended_three
+    end
+  end
+
+  context '#locals' do
+    it 'allows for options to be passed through to the file render' do
+      get :locals
+      assert_select 'title', 'Passed in as a local'
+      assert_select '#some-area', 'locals: title'
+    end
+  end
+
+  context '#extends_partial' do
+    it 'nestive works great with partials also!' do
+      get :extended_partial
+      assert_select 'h1', 'Features'
+      assert_select '#basic-features', 'Basic Features'
+      assert_select '#extended-features', 'Extended Features'
+    end
+
+    it 'partials are a lot more fun with options' do
+      get :extended_partial_options
+      assert_select 'h1', 'Features'
+      assert_select '#basic-feature-1', 'Basic Features 1'
+      assert_select '#basic-feature-2', 'Basic Features 2'
+      assert_select '#extended-features', 'Extended Features'
+    end
+
+    it 'should only render the extensions on the partial a single time!' do
+      get :extended_partial_options
+      assert_select '.feature', 3
+    end
+  end
+end

data/spec/internal/app/controllers/application_controller.rb

@@ -0,0 +1,2 @@
+class ApplicationController < ActionController::Base
+end

data/spec/internal/app/controllers/nestive_controller.rb

@@ -0,0 +1,17 @@
+class NestiveController < ApplicationController
+  def extended_one
+    render layout: 'extend_one'
+  end
+
+  def extended_two
+    render layout: 'extend_two'
+  end
+
+  def extended_three
+    render layout: 'extend_one'
+  end
+
+  def locals
+    render layout: 'locals'
+  end
+end

data/spec/internal/app/views/layouts/extend_one.html.erb

@@ -0,0 +1,5 @@
+<%= extends :nestive do %>
+  <% replace :title, 'extended: one' %>
+  <h2>extended: one</h2>
+  <%= yield %>
+<% end %>

data/spec/internal/app/views/layouts/extend_two.html.erb

@@ -0,0 +1,6 @@
+<%= extends :extend_one do %>
+  <%= replace :some_area do %>
+    extended: two
+  <% end %>
+  <%= yield %>
+<% end %>

data/spec/internal/app/views/layouts/locals.html.erb

@@ -0,0 +1,6 @@
+<%= extends :needs_options, locals: { title: 'Passed in as a local' } do %>
+  <%= replace :some_area do %>
+    locals: title
+  <% end %>
+  <%= yield %>
+<% end %>

data/spec/internal/app/views/layouts/needs_options.html.erb

@@ -0,0 +1,5 @@
+<%= extends :nestive do %>
+  <% replace :title, title %>
+  <h2>options: pass throuth</h2>
+  <%= yield %>
+<% end %>

data/spec/internal/app/views/layouts/nestive.html.erb

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title><%= area :title, 'Nestive' %></title>
+  </head>
+  <body>
+    <%= yield %>
+    <div id="some-area">
+      <%= area :some_area do -%>
+        Some content
+      <%- end -%>
+    </div>
+    <div id="empty-area"><%= area :empty_area %></div>
+  </body>
+</html>

data/spec/internal/app/views/nestive/_extended_features.html.erb

@@ -0,0 +1,5 @@
+<%= extends_partial 'features' do %>
+  <%= append :features_list do %>
+    <div id='extended-features'>Extended Features</div>
+  <% end %>
+<% end %>

data/spec/internal/app/views/nestive/_extended_features_options.html.haml

@@ -0,0 +1,3 @@
+= extends_partial 'features_options', as: :features, object: [1, 2] do 
+  = append :features_list do 
+    #extended-features.feature Extended Features

data/spec/internal/app/views/nestive/_features.html.erb

@@ -0,0 +1,4 @@
+<h1>Features</h1>
+<%= area :features_list do %>
+  <div id='basic-features'>Basic Features</div>
+<% end %>

data/spec/internal/app/views/nestive/_features_options.html.erb

@@ -0,0 +1,9 @@
+<h1>Features</h1>
+<%= area :features_list do %>
+  <%- features.each do |feature| %>
+    <div class='feature' id='basic-feature-<%= feature %>'>Basic Features <%= feature %></div>
+  <%- end %>
+<% end %>
+<%= area :features_summary do %>
+  <p>Here is a summary or something like that...</p>
+<%- end %>

data/spec/internal/app/views/nestive/append.html.erb

@@ -0,0 +1,6 @@
+<h1>here we'll be appending to areas</h1>
+
+<% append :title, ' is awesome' %>
+<% append :some_area do %>
+  Another content
+<% end %>

data/spec/internal/app/views/nestive/extended_one.html.erb

@@ -0,0 +1 @@
+<p>extended: one</p>

data/spec/internal/app/views/nestive/extended_partial.html.erb

@@ -0,0 +1 @@
+<%= render 'extended_features' %>

data/spec/internal/app/views/nestive/extended_partial_options.html.haml

@@ -0,0 +1 @@
+= render 'extended_features_options'

data/spec/internal/app/views/nestive/extended_three.html.erb

@@ -0,0 +1 @@
+<% append :title, 'lol' %>

data/spec/internal/app/views/nestive/extended_two.html.erb

@@ -0,0 +1 @@
+<p>extended: two</p>

data/spec/internal/app/views/nestive/index.html.erb

@@ -0,0 +1 @@
+<h1>Hello World</h1>

data/spec/internal/app/views/nestive/locals.html.erb

@@ -0,0 +1 @@
+<h1>Locals</h1>

data/spec/internal/app/views/nestive/prepend.html.erb

@@ -0,0 +1,6 @@
+<h1>here we'll be prepending stuff to areas</h1>
+
+<% prepend :title, 'Awesome ' %>
+<% prepend :some_area do %>
+  Prepended
+<% end %>

data/spec/internal/app/views/nestive/purge_multiple.html.erb

@@ -0,0 +1,3 @@
+<h1>multiple purge area</h1>
+
+<% purge :title, :some_area %>

data/spec/internal/app/views/nestive/purge_single.html.erb

@@ -0,0 +1,3 @@
+<h1>single purge area</h1>
+
+<% purge :title %>

data/spec/internal/app/views/nestive/replace.html.erb

@@ -0,0 +1,7 @@
+<h1>replacing areas</h1>
+
+<% replace :title, 'Lolwut' %>
+
+<%= replace :some_area do %>
+  replaced
+<% end %>

data/spec/internal/config/routes.rb

@@ -0,0 +1,3 @@
+Rails.application.routes.draw do
+  get ':controller/:action'
+end

data/spec/internal/log/test.log

@@ -0,0 +1,43 @@
+Processing by NestiveController#index as HTML
+  Rendered nestive/index.html.erb within layouts/nestive (0.6ms)
+Completed 200 OK in 3.6ms (Views: 3.5ms)
+Processing by NestiveController#index as HTML
+Completed 200 OK in 0.3ms (Views: 0.2ms)
+Processing by NestiveController#index as HTML
+Completed 200 OK in 0.2ms (Views: 0.2ms)
+Processing by NestiveController#append as HTML
+Completed 200 OK in 0.8ms (Views: 0.7ms)
+Processing by NestiveController#append as HTML
+Completed 200 OK in 0.3ms (Views: 0.2ms)
+Processing by NestiveController#prepend as HTML
+Completed 200 OK in 0.7ms (Views: 0.6ms)
+Processing by NestiveController#prepend as HTML
+Completed 200 OK in 0.2ms (Views: 0.2ms)
+Processing by NestiveController#replace as HTML
+Completed 200 OK in 0.8ms (Views: 0.7ms)
+Processing by NestiveController#replace as HTML
+Completed 200 OK in 0.2ms (Views: 0.2ms)
+Processing by NestiveController#purge_single as HTML
+Completed 200 OK in 0.7ms (Views: 0.6ms)
+Processing by NestiveController#purge_multiple as HTML
+Completed 200 OK in 0.9ms (Views: 0.7ms)
+Processing by NestiveController#extended_one as HTML
+Completed 200 OK in 1.2ms (Views: 1.1ms)
+Processing by NestiveController#extended_two as HTML
+Completed 200 OK in 1.2ms (Views: 1.1ms)
+Processing by NestiveController#extended_three as HTML
+Completed 200 OK in 1.1ms (Views: 0.9ms)
+Processing by NestiveController#locals as HTML
+Completed 200 OK in 1.7ms (Views: 1.6ms)
+Processing by NestiveController#extended_partial as HTML
+  Rendered nestive/_features.html.erb (0.3ms)
+  Rendered nestive/_extended_features.html.erb (1.0ms)
+Completed 200 OK in 3.1ms (Views: 3.0ms)
+Processing by NestiveController#extended_partial_options as HTML
+  Rendered nestive/_features_options.html.erb (0.4ms)
+  Rendered nestive/_extended_features_options.html.haml (1.5ms)
+Completed 200 OK in 3.0ms (Views: 2.9ms)
+Processing by NestiveController#extended_partial_options as HTML
+  Rendered nestive/_features_options.html.erb (0.1ms)
+  Rendered nestive/_extended_features_options.html.haml (0.3ms)
+Completed 200 OK in 0.7ms (Views: 0.7ms)

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+require 'bundler'
+
+Bundler.setup
+
+require 'rails'
+require 'combustion'
+require 'nestive_rendering'
+
+Combustion.initialize! :action_controller
+
+require 'rspec/rails'
+
+RSpec.configure do |config|
+  config.infer_spec_type_from_file_location!
+end

metadata

@@ -0,0 +1,122 @@
+--- !ruby/object:Gem::Specification
+name: nestive_rendering
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Justin French
+- Pavel Pravosud
+- Michael Deering
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-12-08 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rails
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.0
+description: A Rails gem for awesome nested templates, layouts and paritals
+email:
+- justin@indent.com.au
+- pavel@pravosud.com
+- mdeering@mdeering.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- lib/nestive_rendering.rb
+- lib/nestive_rendering/layout_helper.rb
+- lib/nestive_rendering/railtie.rb
+- lib/nestive_rendering/version.rb
+- spec/controllers/nestive_spec.rb
+- spec/internal/app/controllers/application_controller.rb
+- spec/internal/app/controllers/nestive_controller.rb
+- spec/internal/app/views/layouts/extend_one.html.erb
+- spec/internal/app/views/layouts/extend_two.html.erb
+- spec/internal/app/views/layouts/locals.html.erb
+- spec/internal/app/views/layouts/needs_options.html.erb
+- spec/internal/app/views/layouts/nestive.html.erb
+- spec/internal/app/views/nestive/_extended_features.html.erb
+- spec/internal/app/views/nestive/_extended_features_options.html.haml
+- spec/internal/app/views/nestive/_features.html.erb
+- spec/internal/app/views/nestive/_features_options.html.erb
+- spec/internal/app/views/nestive/append.html.erb
+- spec/internal/app/views/nestive/extended_one.html.erb
+- spec/internal/app/views/nestive/extended_partial.html.erb
+- spec/internal/app/views/nestive/extended_partial_options.html.haml
+- spec/internal/app/views/nestive/extended_three.html.erb
+- spec/internal/app/views/nestive/extended_two.html.erb
+- spec/internal/app/views/nestive/index.html.erb
+- spec/internal/app/views/nestive/locals.html.erb
+- spec/internal/app/views/nestive/prepend.html.erb
+- spec/internal/app/views/nestive/purge_multiple.html.erb
+- spec/internal/app/views/nestive/purge_single.html.erb
+- spec/internal/app/views/nestive/replace.html.erb
+- spec/internal/config/routes.rb
+- spec/internal/log/test.log
+- spec/spec_helper.rb
+homepage: https://github.com/mdeering/nestive_rendering
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.2
+signing_key: 
+specification_version: 4
+summary: A Rails gem for awesome nested templates, layouts and paritals
+test_files:
+- spec/spec_helper.rb
+- spec/controllers/nestive_spec.rb
+- spec/internal/config/routes.rb
+- spec/internal/app/controllers/nestive_controller.rb
+- spec/internal/app/controllers/application_controller.rb
+- spec/internal/app/views/nestive/_features.html.erb
+- spec/internal/app/views/nestive/extended_partial_options.html.haml
+- spec/internal/app/views/nestive/replace.html.erb
+- spec/internal/app/views/nestive/extended_one.html.erb
+- spec/internal/app/views/nestive/_features_options.html.erb
+- spec/internal/app/views/nestive/extended_partial.html.erb
+- spec/internal/app/views/nestive/extended_three.html.erb
+- spec/internal/app/views/nestive/_extended_features_options.html.haml
+- spec/internal/app/views/nestive/prepend.html.erb
+- spec/internal/app/views/nestive/index.html.erb
+- spec/internal/app/views/nestive/purge_single.html.erb
+- spec/internal/app/views/nestive/locals.html.erb
+- spec/internal/app/views/nestive/purge_multiple.html.erb
+- spec/internal/app/views/nestive/_extended_features.html.erb
+- spec/internal/app/views/nestive/extended_two.html.erb
+- spec/internal/app/views/nestive/append.html.erb
+- spec/internal/app/views/layouts/nestive.html.erb
+- spec/internal/app/views/layouts/needs_options.html.erb
+- spec/internal/app/views/layouts/locals.html.erb
+- spec/internal/app/views/layouts/extend_one.html.erb
+- spec/internal/app/views/layouts/extend_two.html.erb
+- spec/internal/log/test.log