dry_views 0.0.1

data/.gitignore

@@ -0,0 +1,75 @@
+# gem generated
+*.gem
+Gemfile.lock
+
+# bundle generated
+.bundle
+lib/bundler/man
+
+# rcov generated
+coverage
+
+# rdoc generated
+rdoc
+
+# yard generated
+doc
+.yardoc
+
+# bundler
+.bundle
+
+# jeweler generated
+pkg
+
+# Have editor/IDE/OS specific files you need to ignore? Consider using a global gitignore:
+#
+# * Create a file at ~/.gitignore
+# * Include files you want ignored
+# * Run: git config --global core.excludesfile ~/.gitignore
+#
+# After doing this, these files will be ignored in all your git projects,
+# saving you from having to 'pollute' every project you touch with them
+#
+# Not sure what to needs to be ignored for particular editors/OSes? Here's some ideas to get you started. (Remember, remove the leading # of the line)
+#
+# For MacOS:
+#
+.DS_Store
+
+# For TextMate
+*.tmproj
+tmtags
+
+# For RubyMine
+.idea
+
+# For emacs:
+*~
+\#*
+.\#*
+
+# For vim:
+*.swp
+
+# For redcar:
+.redcar
+
+# For rubinius:
+*.rbc
+
+# From bundle gem my_gem's .gitignore (good practice?)
+.config
+InstalledFiles
+doc/
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+# Other
+log/*.log
+spec/dummy/db/*.sqlite3
+spec/dummy/log/*.log
+spec/dummy/tmp/
+spec/dummy/.sass-cache

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format progress

data/.travis.yml

@@ -0,0 +1,8 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 1.9.2
+  - jruby-19mode
+  - rbx-19mode
+  - ruby-head
+  - jruby-head

data/CHANGELOG

@@ -0,0 +1,2 @@
+Version 0.0.1 - AUG.14.2012
+- Initial Release

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in dry_views.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Peter Boling
+
+MIT License
+
+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,134 @@
+# DryViews
+
+Keep the views dry with content_for_with_default and friends!
+
+DryViews provides extensions to ActionView::Helpers::CaptureHelper, which is part of ActionPack:
+* content_for_with_default
+* no_content_for
+* content_for (enhanced to play nice with the above methods)
+
+The rails rendering chain is sort of inside out so the template rendering happens first, and this is what makes it possible to override everything! The template will ALWAYS override the layout, and a partial will always override a partial layout.
+
+Here are some guidelines for using the code below:
+
+    - no_content_for :key
+    # Use a dash (-) not equals (=)
+    # Will prevent a later content_for from rendering.  This allows template overrides of layouts.
+
+    = content_for_with_default :key
+    # Use an equal (=) not a dash (-)
+    # You provide it with the default HAML via a block *or* a set of params that are the same as you would pass to a standard "render" call (i.e. :partial => 'foo', :locals => {:bar => 'bar'}).
+
+    = content_for :key
+    # Use an equal (=) not a dash (-)
+    # You provide it with a block, i.e. {render :partial => 'foo'}, and it will override content_for_with_default.  It has the same precedence as no_content_for, so whichever is rendered first wins, so if a layout has either no_content_for or content_for (with or without default) the template can now override it.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'dry_views'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install dry_views
+
+## Usage
+
+Example #1:
+in a layout
+
+    - no_content_for :breakfast                 # ARROWED!
+
+in a template
+
+    = content_for :breakfast do                 # WINNER!
+      %h1 Dub Step
+
+will have Dub Step
+
+Example #2:
+in a layout
+
+    = content_for :breakfast do                 # ARROWED!
+      %h1 Dub Step
+
+in a template
+
+    - no_content_for :breakfast                 # WINNER!
+
+will have NOTHING
+
+Example #3:
+
+in a layout
+
+    = content_for :breakfast do                 # WINNER!
+      %h1 Dub Step
+
+in a template
+
+    = content_for :breakfast do                 # WINNER!
+      %h1 Metal
+
+will have Dub Step and Metal (Concatenation!)
+
+Example #4:
+in a layout
+
+    = content_for_with_default :breakfast do    # ARROWED!
+      %h1 Dub Step
+
+in a template
+
+    = content_for :breakfast do                 # WINNER!
+      %h1 Metal
+
+will have Metal only (No Dub Step!)
+
+Example #5:
+
+in a layout
+
+    = content_for_with_default :breakfast do    # ARROWED!
+    %h1 Dub Step
+
+in a template
+
+    - no_content_for :breakfast                 # WINNER!
+
+will have NOTHING
+
+Example #6:
+in a layout
+
+    = content_for_with_default :breakfast do    # ARROWED!
+      %h1 Dub Step
+
+in a template
+
+    = render :partial => 'hip_hop', :layout => 'sample'
+    = no_content_for :breakfast do              # ARROWED!
+
+in the 'sample' partial layout
+
+    = no_content_for :breakfast do              # ARROWED!
+
+in the 'hip_hop' partial
+
+    = content_for :breakfast do                 # WINNER!
+      %h1 Hip Hop
+
+will have Hip Hop only (No Dub Step!)
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Added some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,29 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+
+require 'rake'
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+require 'reek/rake/task'
+Reek::Rake::Task.new do |t|
+  t.fail_on_error = true
+  t.verbose = false
+  t.source_files = 'lib/**/*.rb'
+end
+
+require 'roodi'
+require 'roodi_task'
+RoodiTask.new do |t|
+  t.verbose = false
+end
+
+task :default => :spec
+
+APP_RAKEFILE = File.expand_path("../spec/dummy/Rakefile", __FILE__)
+
+Bundler::GemHelper.install_tasks

data/dry_views.gemspec

@@ -0,0 +1,25 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/dry_views/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Peter Boling"]
+  gem.email         = ["peter.boling@gmail.com"]
+  gem.description   = %q{Provides extensions to ActionView::Helpers::CaptureHelper: content_for_with_default, no_content_for, and an enhanced content_for that plays nice with friends}
+  gem.summary       = %q{Keep the views dry with content_for_with_default and friends!}
+  gem.homepage      = "https://github.com/pboling/dry_views"
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "dry_views"
+  gem.require_paths = ["lib"]
+  gem.version       = DryViews::VERSION
+
+  # Development Dependencies
+  gem.add_development_dependency(%q<rails>, ["> 3"])
+  gem.add_development_dependency(%q<activesupport>, ["> 3"])
+  gem.add_development_dependency(%q<rspec-rails>, [">= 2.8.0"])
+  gem.add_development_dependency(%q<reek>, [">= 1.2.8"])
+  gem.add_development_dependency(%q<roodi>, [">= 2.1.0"])
+
+end

data/lib/dry_views.rb

@@ -0,0 +1,12 @@
+require "dry_views/version"
+
+module DryViews
+
+  EMPTY_CONTENT = ' ' # For Rails 3.0+ only works with ' '.
+                      # nil, false, :empty, cannot work, because @view_flow.get(name) is always converted to an
+                      # ActiveSupport::SafeBuffer (a fancy string)
+
+  require 'dry_views/railtie'
+
+
+end

data/lib/dry_views/rails3_two.rb

@@ -0,0 +1,70 @@
+module ActionView
+  module Helpers
+    module CaptureHelper
+
+      # Reference: http://api.rubyonrails.org/classes/ActionView/Helpers/CaptureHelper.html
+      #
+      # Custom method (not overriding anything in Rails)
+      #
+      # In a template/layout
+      #
+      #  = content_for_with_default :my_default_content, :partial => 'layouts/my_default_content'
+      #
+      # Override in a nested layout/template/partial:
+      #
+      #  = content_for :my_default_content do
+      #    = render :partial => 'layouts/my_custom_content', :collection => my_stuff, :as => :stuff
+      #
+      # All params after the first will be used as options for the default render
+      #
+      #  = content_for_with_default :my_default_content, :partial => 'some/partial', :locals => {:variable => 'Some Text'}
+      #
+      def content_for_with_default(name, *args, &block)
+        if content_check = content_for?(name) # returns true, false, or :empty
+          content_for_without_empty_check(name) unless content_check == :empty # when content_check is :empty, does nothing
+        elsif block_given?
+          content_for_without_empty_check(name, yield) # No need to recheck for empty here, as initial condition handles the :empty case
+        else
+          options = args.extract_options!
+          # Supports the default API of with content as the second param, content_for(name, content = nil, &block)
+          if options.empty?
+            content_for_without_empty_check(name, args.first) # No need to recheck for empty here, as initial condition handles the :empty case
+          else
+            render options
+          end
+        end
+      end
+
+      # Override file actionpack/lib/action_view/helpers/capture_helper.rb, line 136
+      # If the empty check has already been performed (as content_for_with_default), you can call content_for_without_empty_check to bypass a duplicate check
+      def content_for_with_empty_check(name, content = nil, &block)
+        if content_for?(name) == :empty
+          # Some preceding layout or template has already specified that there is to be no content for this name, and that is FINAL.
+          return nil
+        else
+          content_for_without_empty_check(name, content, &block)
+        end
+      end
+      alias_method_chain :content_for, :empty_check
+
+      # Override file actionpack/lib/action_view/helpers/capture_helper.rb, line 175
+      def content_for_with_empty_check?(name)
+        if @view_flow.get(name) == DryViews::EMPTY_CONTENT
+          #add a check for empty, and return :empty, so we can switch on it for empty content
+          return :empty
+        elsif content_for_without_empty_check?(name)
+          return true
+        else
+          return false
+        end
+      end
+      alias_method_chain :content_for?, :empty_check
+
+      # Custom method (not overriding anything in Rails)
+      def no_content_for(name)
+        @view_flow.append!(name, DryViews::EMPTY_CONTENT)
+      end
+
+    end
+  end
+end

data/lib/dry_views/rails3_zero.rb

@@ -0,0 +1,48 @@
+# See dry_views/rails2_two for comments... this is the same logic applied to the older ActionView @_content_for chain
+
+module ActionView
+  module Helpers
+    module CaptureHelper
+
+      def content_for_with_default(name, *args, &block)
+        if content_check = content_for?(name)
+          content_for_without_empty_check(name) unless content_check == :empty
+        elsif block_given?
+          content_for_without_empty_check(name, yield)
+        else
+          options = args.extract_options!
+          if options.empty?
+            content_for_without_empty_check(name, args.first)
+          else
+            render options
+          end
+        end
+      end
+
+      def content_for_with_empty_check(name, content = nil, &block)
+        if content_for?(name) == :empty
+          return nil
+        else
+          content_for_without_empty_check(name, content, &block)
+        end
+      end
+      alias_method_chain :content_for, :empty_check
+
+      def content_for_with_empty_check?(name)
+        if @_content_for[name] == DryViews::EMPTY_CONTENT
+          return :empty
+        elsif content_for_without_empty_check?(name)
+          return true
+        else
+          return false
+        end
+      end
+      alias_method_chain :content_for?, :empty_check
+
+      def no_content_for(name)
+        @_content_for[name] << DryViews::EMPTY_CONTENT
+      end
+
+    end
+  end
+end