view_driver 0.1.0

data/.gitignore

@@ -0,0 +1 @@
+spec/debug.log

data/README.rdoc

@@ -0,0 +1,138 @@
+view_driver helps to dry up views using sublayouts and sections.
+
+== Sublayouts
+
+Remember when you had to create one more layout which generally was almost the same as the default one for your application or your view templates contained duplicated html-markup.
+
+This is what sublayouts are for.
+
+=== How to use sublayouts
+
+
+* Replace <%= yield %> or <%= @content_for_layout %> in your layout with <%= yield_with_sublayouts %>
+* Put your sublayout into app/views/sublayouts
+* Set the instance variable called @sublayout in the controller using 'sublayout' before_filter or manually
+
+For example, if you've written something like
+
+  sublayout 'edit', :only => [:new, :create, :edit, :update]
+
+in a controller and created a sublayout called app/views/sublayouts/edit.html.erb with <%= yield %> in it, the specified actions will be rendered within that sublayout. 
+
+The action's output will be inserted right in the layout if the sublayout has not been defined.
+
+By default sublayouts live in app/views/sublayouts but you can pick any other folder e.g. 'layouts', creating an initializer with:
+
+  ViewDriver::SUBLAYOUTS_DIR = "layouts"
+  
+Sublayouts are quite suitable with sections.
+
+== Sections
+
+Sections are fragments of view similar to partials, which can be easily used in the application because they are well-structured and can be defined in the controller.
+
+Imagine that in the layout there is a sidebar which can be the same or vary in different places. For example it can have no banner for one controller, or extra-blocks for another one. You can manage it with sections.
+
+=== Naming and location
+
+Default templates for a section are (by precedence):
+
+  1) for an action: 
+  "app/views/#{@controller.controller_path}/#{@controller.action_name}_#{section_name}.html.erb"
+  2) for a controller: 
+  "app/views/#{@controller.controller_path}/default_#{section_name}.html.erb"
+  3) for an application: 
+  "app/views/sections/default_#{section_name}.html.erb"
+
+You can change a default sections' location for an application defining ViewDriver::SECTIONS_DIR.
+
+=== Rendering
+
+For rendering there is a helper render_section, which can be put into your view file (it can be a layout, a sublayout or any other view file as well):
+
+  <%= render_section(:sidebar) %>
+
+It will try to find the first template from the defaults above and render it, so if there is no default file for an action, it will take default for a controller and then for an application. If none of them are found it will render nothing.
+
+==== Templates extensions
+
+By default ViewDriver looks for templates with the "html.erb" extension. You can change this behaviour by defining ViewDriver::SECTIONS_TEMPLATES_EXTENSIONS, for example:
+
+  ViewDriver::SECTIONS_TEMPLATES_EXTENSIONS = ["haml"]
+
+  # be careful because it will require to check if a template exists for both extensions
+  ViewDriver::SECTIONS_TEMPLATES_EXTENSIONS = ["html.erb", "rhtml"]
+  
+ViewDriver caches templates' existence in production, check out ViewDriver::SectionsCollection#template_exists?
+  
+=== How to change templates for sections
+
+You can do it by a 'sections' before_filter or manually (check out ViewDriver::ActionControllerExtensions::ClassMethods#sections for details).
+
+Templates defined by the 'sections' before_filter is of higher precendence than the default ones.
+
+Since the 'sections' is a before_filter it can be chained and controlled by standard options: :only, :except, :if, and :unless.
+
+It will be easier to get it through the examples.
+
+So let's assume that a controller for a current request is PagesController.
+  
+==== Default values for all sections
+
+  # sections will be taken first from :show action
+  sections 'show'
+  # so when you call render_section(:header) it will render 'pages/show_header' and if it doesn't exist it will look through the default chain
+  
+  # if you pass the default value and the options hash, values will be merged
+  # so this will take all the sections from users folder except sidebar, which will be default
+  sections proc{|c| "users/#{c.action_name}"}, :sidebar => 'pages/default'
+  
+==== If you pass false as a template, it won't render section at all
+  
+  # it won't render sections at all if a user is not logged in
+  sections false, :unless => proc{|c| c.logged_in?}
+  
+  # it won't render sidebar section for the particular actions
+  sections :sidebar => false, :only => [:new, :edit, :update, :create]
+  
+==== Other examples
+  
+  # :sidebar will be 'unlogged_sidebar' if a user is not logged in and 'logged_sidebar' otherwise
+  sections :sidebar => :sidebar_section
+  
+  protected
+  def sidebar_section
+    logged_in? ? 'logged' : 'unlogged'
+  end
+  
+  # the sections :sidebar and :navigations will be taken from the 'views/users' folder for :galleries and :users actions
+  sections :sidebar => 'users/show', :navigation => 'users/index', :only => [:galleries, :users]
+
+  # this sets all the sections to be default from 'users' folder for all requests passing the specified proc
+  sections 'users/default', :if => proc{|instance| !%w{static sessions}.include?(instance.controller_name)}
+  
+Besides strings sections before_filter accepts procs and methods (passed as symbols). Check out the sections method in the ActionControllerExtensions module.
+  
+== Add-ons
+
+view_driver also comes with a helper method called 'classes' used to set css-classes or any other attributes conditionally.
+
+  <!-- will add 'logged' class if logged_in? method returns true -->
+  <%= content_tag(:div, 'test', :class => classes('default-class', ['logged', logged_in?])) %>
+  
+it also modifies image_tag a bit in order to use blank :alt attribute by default and duplicate it as :title attribute
+
+  >> image_tag 'quake.gif'
+  => "<img alt='' src='/images/quake.gif' />"
+  >> image_tag 'quake.gif', :alt => 'foo'
+  => "<img alt='foo' src='/images/quake.gif' title='foo' />"
+  >> image_tag 'quake.gif', :alt => 'foo', :title => 'bar'
+  => "<img alt='foo' src='/images/quake.gif' title='bar' />"
+  
+== Installation
+
+  script/plugin install git://github.com/macovsky/view_driver.git
+  
+== Help
+  
+If you have any troubles using this plugin, you can ping me through robotector AT gmail.

data/Rakefile

@@ -0,0 +1,29 @@
+require 'rubygems'  
+require 'rake'
+
+begin  
+  require 'jeweler'  
+  Jeweler::Tasks.new do |gemspec|  
+    gemspec.name = "view_driver"  
+    gemspec.summary = "Helps dry up Rails-views using sublayouts and sections"  
+    gemspec.description = "Helps dry up Rails-views using sublayouts and sections"  
+    gemspec.email = "robotector@gmail.com"  
+    gemspec.homepage = "http://github.com/macovsky/view_driver"  
+    gemspec.authors = ["Macovsky"]
+  end  
+  Jeweler::GemcutterTasks.new  
+rescue LoadError  
+  puts "Jeweler not available. Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"  
+end
+
+# require 'rake'
+# require 'spec/rake/spectask'
+# 
+# desc 'Default: run specs.'
+# task :default => :spec
+# 
+# desc 'Run the specs'
+# Spec::Rake::SpecTask.new(:spec) do |t|
+#   t.spec_opts = ['--colour --format progress --loadby mtime --reverse']
+#   t.spec_files = FileList['spec/**/*_spec.rb']
+# end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/init.rb

@@ -0,0 +1 @@
+require File.dirname(__FILE__) + "/rails/init.rb"

data/lib/view_driver.rb

@@ -0,0 +1,12 @@
+module ViewDriver
+  !defined?(SUBLAYOUTS_DIR)  && SUBLAYOUTS_DIR = 'sublayouts'
+  !defined?(SECTIONS_DIR)    && SECTIONS_DIR   = 'sections'
+  !defined?(SECTIONS_TEMPLATES_EXTENSIONS) && SECTIONS_TEMPLATES_EXTENSIONS = ['html.erb']
+end
+
+require 'view_driver/normalized_section_template'
+require 'view_driver/sections'
+require 'view_driver/sections_collection'
+require 'view_driver/action_controller_extensions'
+require 'view_driver/view_helpers'
+require 'view_driver/image_tag_extension'

data/lib/view_driver/action_controller_extensions.rb

@@ -0,0 +1,80 @@
+module ViewDriver
+  module ActionControllerExtensions
+    FILTER_OPTIONS = [:only, :except, :if, :unless]
+    
+    def self.included(base)
+      base.extend ClassMethods
+      base.cattr_accessor :existing_sections
+      base.send :include, InstanceMethods
+    end
+    
+    module ClassMethods
+    
+      # Filter to define sections in a controller
+      def sections(*args)
+        method = "_sections_#{args.to_s.gsub(/[^a-z_]/, '_')}"
+        options = args.extract_options!
+        raise(ArgumentError, "Only one argument is allowed") if args.size > 1
+      
+        before_filter method, options.slice(*FILTER_OPTIONS)
+      
+        define_method method do        
+          @sections_collection ||= SectionsCollection.new(self)
+          section_templates = options.except(*FILTER_OPTIONS)
+          section_templates.each{|k,v| section_templates[k] = parse_argument_for_sections(v)}
+          @sections_collection << Sections.new(parse_argument_for_sections(args.first), section_templates)
+        end
+      
+        protected method.to_sym
+      end
+    
+      # Filter to define a sublayout in a controller
+      def sublayout(*args)
+        method = "_sublayout_#{args.to_s.gsub(/[^a-z_]/, '_')}"
+        options = args.extract_options!
+      
+        before_filter method, options.slice(*FILTER_OPTIONS)
+      
+        define_method method do
+          @sublayout = case (sublayout = args.first)
+            when Symbol
+              send(sublayout)
+            when Proc
+              sublayout.call(self)
+            else
+              sublayout
+          end
+        end
+        protected method.to_sym
+      end
+      
+      def default_section_templates(section, action_name)
+        [action_name, 'default'].map{|action| controller_path + "/#{action}_#{section}"} + [ViewDriver::SECTIONS_DIR + "/default_#{section}"]
+      end
+      
+    end
+    
+    module InstanceMethods
+      
+      def default_section_templates(section, action = nil)
+        self.class.default_section_templates(section, action || action_name)
+      end
+      
+      def parse_argument_for_sections(arg)
+        case arg
+          when Symbol
+            send(arg)
+          when Proc
+            arg.call(self)
+          when String, NilClass, FalseClass
+            arg
+          else
+            raise ArgumentError, "Unsupported argument"
+        end
+      end
+    end
+            
+  end
+end
+
+ActionController::Base.send(:include, ViewDriver::ActionControllerExtensions)

data/lib/view_driver/image_tag_extension.rb

@@ -0,0 +1,12 @@
+module ActionView
+  module Helpers
+    module AssetTagHelper
+      def image_tag_with_title(source, options = {})
+        options[:alt] ||= ''
+        image_tag_without_title(source, options[:alt].blank? ? options : options.merge(:title => options[:title] || options[:alt]))
+      end
+
+      alias_method_chain :image_tag, :title
+    end
+  end
+end

data/lib/view_driver/normalized_section_template.rb

@@ -0,0 +1,16 @@
+module ViewDriver
+  module ObjectExtensions
+    def normalized_section_template(section)
+      self
+    end
+  end
+  
+  module StringExtensions
+    def normalized_section_template(section)
+      self !~ /_#{section}$/ ? self + "_#{section}" : self
+    end
+  end
+end
+
+Object.send :include, ViewDriver::ObjectExtensions
+String.send :include, ViewDriver::StringExtensions

data/lib/view_driver/sections.rb

@@ -0,0 +1,35 @@
+module ViewDriver
+  class Sections
+    attr_reader :templates
+    
+    def initialize(default_value, options = {})
+      @templates = convert_to_hash(default_value, options)
+    end
+    
+    def template(section)
+      @templates[section].normalized_section_template(section)
+    end
+    
+    def ==(sections)
+      @templates == sections.templates && @templates.default == sections.templates.default
+    end
+    
+    private
+        
+    def convert_to_hash(default_value, options)
+      raise(ArgumentError, "No arguments were provided") if default_value.nil? && options.blank?
+      
+      hash = case default_value
+        when Hash, HashWithIndifferentAccess
+          HashWithIndifferentAccess.new.merge(default_value)
+        when String, NilClass, FalseClass
+          HashWithIndifferentAccess.new(default_value)
+        else
+          raise(ArgumentError, 'Unsupported argument')
+      end
+      # using merge! because simple merge deletes default value
+      hash.merge!(options)
+    end
+    
+  end
+end

data/lib/view_driver/sections_collection.rb

@@ -0,0 +1,49 @@
+module ViewDriver
+  
+  class SectionsCollection < Array
+    attr_reader :controller
+    
+    def initialize(controller)
+      super()
+      @controller = controller
+    end
+    
+    def templates(section)
+      defined_template = defined_template(section)
+      return [] if defined_template == false
+      ([defined_template] + @controller.default_section_templates(section)).compact
+    end
+        
+    def defined_template(section)
+      template = nil
+      each do |sections| 
+        candidate = sections.template(section)
+        template = candidate unless candidate.nil?
+      end
+      prepend_controller_path(template)
+    end
+    
+    def prepend_controller_path(template)
+      template.is_a?(String) && !template.include?("/") ? File.join(@controller.controller_path, template) : template
+    end
+    
+    def template_to_render(section)
+      templates(section).find{|template| template_exists?(template)}
+    end
+    
+    def template_exists?(template)
+      ViewDriver::SECTIONS_TEMPLATES_EXTENSIONS.any? do |ext| 
+        basename = template + ".#{ext}"
+        file = File.join(RAILS_ROOT, 'app', 'views', basename)
+        unless @controller.perform_caching
+          File.exists?(file)
+        else
+          ApplicationController.existing_sections ||= {}
+          ApplicationController.existing_sections[basename].nil? && ApplicationController.existing_sections[basename] = File.exists?(file)
+          ApplicationController.existing_sections[basename]
+        end
+      end
+    end
+    
+  end
+end

data/lib/view_driver/view_helpers.rb

@@ -0,0 +1,56 @@
+module ViewDriver  
+  module ViewHelpers
+        
+    # Renders section :section for the current controller and action
+    def render_section(section)
+      @sections_collection ||= SectionsCollection.new(@controller)
+      
+      if RAILS_ENV == "development"
+        _time1, _time2 = nil, nil
+        _time1 = Time.now
+      end
+      
+      if template = @sections_collection.template_to_render(section)
+        result = render(:file => template)
+        if RAILS_ENV == "development"
+          _time2 = Time.now 
+          logger.debug "Rendered section #{template} (#{((_time2 - _time1)*1000).round(1)}ms)"
+        end
+        result
+      elsif RAILS_ENV == "development"
+        logger.debug "Missing section #{section}"
+        "<!-- Missing section #{section} -->"
+      end
+    end
+    
+    # Renders sublayouts
+    # replace <%= yield %> or <%= @content_for_layout %> with it to use sublayouts
+    def yield_with_sublayouts
+      unless @sublayout.blank?
+        sublayout_file = @sublayout.include?('/') ? @sublayout : File.join(SUBLAYOUTS_DIR, @sublayout) 
+        RAILS_ENV == 'development' && logger.debug("Rendering template within sublayout #{sublayout_file}")
+        render :file => sublayout_file
+      else
+        @content_for_layout
+      end
+    end
+    
+    # classes is to set css-classes or other attributes conditionally
+    # classes("class-without-conditions", ["logged-class", logged_in?], "third-class-without-conditions")
+    def classes(*pairs)
+      glued_classes = []
+      pairs.each do |pair| 
+        next if pair.blank?
+        arr = Array(pair)
+        raise ArgumentError, "css_class or [css_class, condition] are expected (got #{pair.inspect})" if arr.size.zero? || arr.size > 2
+        glued_classes << arr[0] if arr[1] || arr.size == 1
+      end
+      glued_classes.any? ? glued_classes.join(" ") : nil
+    end
+        
+  end
+end
+
+ActionView::Base.module_eval do
+  include ViewDriver::ViewHelpers
+end

data/rails/init.rb

@@ -0,0 +1 @@
+require 'view_driver'

data/spec/sections_collection_spec.rb

@@ -0,0 +1,122 @@
+require File.dirname(__FILE__) + '/spec_helper'
+  
+describe ViewDriver::SectionsCollection do
+  include ViewDriverSpecHelper
+  
+  before :each do
+    @controller = create_controller
+    @controller.action_name = 'show'
+    @collection = ViewDriver::SectionsCollection.new(@controller)
+  end
+  
+  context "defined_template" do
+    it "should return nil when collection is blank" do
+      @collection.defined_template(:sidebar).should be_nil
+    end
+    
+    it "should return last value when only there was only one controller involved" do
+      @collection << ViewDriver::Sections.new('show', {})
+      @collection.defined_template(:sidebar).should == 'pages/show_sidebar'
+    end
+    
+    context "with multiple sections" do
+      it "should return last not null value" do
+        @collection << ViewDriver::Sections.new('show', {})
+        @collection << ViewDriver::Sections.new(:sidebar => 'new')
+        @collection.defined_template(:sidebar).should == 'pages/new_sidebar'
+        @collection.defined_template(:subnavi).should == 'pages/show_subnavi'
+      end
+      
+      it "should return false value as last" do
+        @collection << ViewDriver::Sections.new(:sidebar => 'new')
+        @collection << ViewDriver::Sections.new(:sidebar => false)
+        @collection.defined_template(:sidebar).should be_false
+      end
+    end
+  end
+  
+  context "templates" do
+    it "should return empty collection if section is set to false" do
+      @collection << ViewDriver::Sections.new(false, {})
+      @collection.templates(:sidebar).should be_empty
+    end
+    
+    it "should return default templates if sections aren't set" do
+      @collection.templates(:sidebar).should == @controller.default_section_templates(:sidebar)
+    end
+    
+    context "with defined sections" do
+      before :each do
+        @collection << ViewDriver::Sections.new(nil, {:sidebar => 'users/show'})
+      end
+    
+      it "should return a template defined by section + default templates for defined section" do
+        @collection.templates(:sidebar).should == ['users/show_sidebar'] + @collection.controller.default_section_templates(:sidebar)
+      end
+      
+      it "should return default templates for undefined section" do
+        @collection.templates(:header).should == @controller.default_section_templates(:header)
+      end
+    end
+    
+    context "with multi defined sections" do
+      it "should return defined template + default templates" do
+        @collection << ViewDriver::Sections.new('create')
+        @collection << ViewDriver::Sections.new(nil, {:sidebar => 'new'})
+        
+        @collection.templates(:header).should == ['pages/create_header'] + @controller.default_section_templates(:header)
+        @collection.templates(:sidebar).should == ['pages/new_sidebar']  + @controller.default_section_templates(:sidebar)
+      end
+    end
+  end
+  
+  context 'template_to_render' do
+    it "should return first existing template" do
+      @collection << ViewDriver::Sections.new('create')
+      @collection.should_receive(:template_exists?).with('pages/create_sidebar').and_return(true)
+      @collection.template_to_render(:sidebar).should == 'pages/create_sidebar'
+    end
+    
+    it "should return nil if there weren't any templates" do
+      @collection.should_receive(:templates).with(:header).and_return([])
+      @collection.template_to_render(:header).should be_nil
+    end
+    
+    it "should return nil if there weren't any existing templates" do
+      @collection.should_receive(:template_exists?).exactly(3).and_return(false)
+      @collection.template_to_render(:sidebar).should be_nil
+    end
+  end
+  
+  context 'template_exists?' do
+    
+    it "should ask File.exists? with possible template extensions" do
+      File.should_receive(:exists?).with(File.join(RAILS_ROOT, "app", "views", "pages/show_sidebar.html.erb")).and_return(true)
+      @collection.template_exists?("pages/show_sidebar").should be_true
+    end
+    
+    context "with caching" do
+      before(:each) do
+        @controller.should_receive(:perform_caching).at_most(2).and_return(true)
+      end
+      
+      after(:each) do
+        ApplicationController.existing_sections = nil
+      end
+      
+      it "should save the value" do
+        File.should_receive(:exists?).with(File.join(RAILS_ROOT, "app", "views", "pages/show_sidebar.html.erb")).and_return(true)
+        @collection.template_exists?("pages/show_sidebar").should be_true
+        ApplicationController.existing_sections.should == {"pages/show_sidebar.html.erb" => true}
+      end
+      
+      it "should not ask the file exist" do
+        ApplicationController.existing_sections = {"pages/show_sidebar.html.erb" => true}
+        @collection.template_exists?("pages/show_sidebar").should be_true
+      end
+      
+    end
+    
+  end
+  
+end

data/spec/sections_spec.rb

@@ -0,0 +1,40 @@
+require File.dirname(__FILE__) + '/spec_helper'
+  
+describe ViewDriver::Sections do
+  include ViewDriverSpecHelper
+  
+  context "equality" do
+    before :each do
+      @sections = ViewDriver::Sections.new(nil, {:header => 'show'})
+    end
+    
+    it "should be equal to another object with the same templates" do
+      @sections.should == ViewDriver::Sections.new(nil, {:header => 'show'})
+    end
+    
+    it "should not be equal to objects with different templates" do
+      @sections.should_not == ViewDriver::Sections.new(false)
+      @sections.should_not == ViewDriver::Sections.new(false, {:header => 'show'})
+      @sections.should_not == ViewDriver::Sections.new(nil, {:header => 'temp'})
+    end
+  end
+  
+  context 'template' do
+    it "should return default value for unexisting section" do
+      ViewDriver::Sections.new(false).template(:header).should be_false
+      ViewDriver::Sections.new(false, {:header => 'users/show'}).template(:sidebar).should be_false
+      ViewDriver::Sections.new(nil, {:header => 'users/show'}).template(:sidebar).should be_nil
+      ViewDriver::Sections.new("show").template(:sidebar).should == "show_sidebar"
+    end
+  
+    it "should add section's name" do
+      ViewDriver::Sections.new(nil, {:header => 'show'}).template(:header).should == "show_header"      
+      ViewDriver::Sections.new(nil, {:header => 'users/show'}).template(:header).should == "users/show_header"      
+    end
+    
+    it "should not add section's name" do
+      ViewDriver::Sections.new(nil, {:header => 'show_header'}).template(:header).should == 'show_header'
+    end
+  end
+  
+end

data/spec/spec_helper.rb

@@ -0,0 +1,30 @@
+begin
+  require File.dirname(__FILE__) + '/../../../../spec/spec_helper'
+rescue LoadError
+  puts "You need to install rspec in your base app"
+  exit
+end
+
+plugin_spec_dir = File.dirname(__FILE__)
+# ActiveRecord::Base.logger = Logger.new(plugin_spec_dir + "/debug.log")
+
+module ViewDriverSpecHelper 
+  def create_controller(controller_path = 'pages', super_class = ApplicationController, &block)
+    controller = Class.new(super_class)
+    
+    controller.class_eval do
+      class_eval "def self.controller_path; '#{controller_path}'; end"
+      
+      %w(index show new).each do |action|
+        class_eval <<-EOV, __FILE__, __LINE__
+          def #{action}
+          end
+        EOV
+      end
+    end
+    
+    controller.class_eval(&block) if block
+    controller.new
+  end
+end
+

data/spec/view_driver_action_controller_extensions_spec.rb

@@ -0,0 +1,94 @@
+require File.dirname(__FILE__) + '/spec_helper'
+  
+describe ActionController do
+  include ViewDriverSpecHelper
+  
+  context "default_section_templates" do
+    before :each do
+      @controller = create_controller
+      @controller.action_name = 'show'
+      @default_section_templates = ['pages/show_sidebar', 'pages/default_sidebar', "#{ViewDriver::SECTIONS_DIR}/default_sidebar"]
+    end
+    
+    it "should return default templates" do
+      @controller.default_section_templates(:sidebar).should == @default_section_templates
+      @controller.class.default_section_templates(:sidebar, 'show').should == @default_section_templates
+    end
+  end
+  
+  context "sections" do
+    it "should define sections" do
+      @controller = create_controller do
+        sections :sidebar => 'show'
+      end
+    
+      get 'index'
+      @controller.assigns["sections_collection"].should == (ViewDriver::SectionsCollection.new(@controller) << ViewDriver::Sections.new(nil, {:sidebar => 'show'}))
+    end
+    
+    it "should define multiple sections" do
+      @controller = create_controller('admin/pages') do
+        sections :sidebar => 'show'
+        sections :header => 'default'
+      end
+    
+      get 'index'
+      @controller.assigns["sections_collection"].should == (ViewDriver::SectionsCollection.new(@controller) << ViewDriver::Sections.new(nil, {:sidebar => 'show'}) << ViewDriver::Sections.new(nil, {:header => 'default'}))
+    end
+    
+    it "should define sections using proc" do
+      @controller = create_controller do
+        sections proc{|c| "users/#{c.action_name}" }
+      end
+
+      get 'index'
+      @controller.assigns["sections_collection"].should == (ViewDriver::SectionsCollection.new(@controller) << ViewDriver::Sections.new('users/index'))
+    end
+    
+    it "should define sections using method" do
+      @controller = create_controller do
+        sections :change_sections
+
+        define_method 'change_sections' do 
+          "users/#{action_name}"
+        end
+      end
+
+      get 'index'
+      @controller.assigns["sections_collection"].should == (ViewDriver::SectionsCollection.new(@controller) << ViewDriver::Sections.new('users/index'))
+    end
+  end
+  
+  context "sublayout" do
+    it "should define sublayout" do
+      @controller = create_controller do
+        sublayout 'particular'
+      end
+    
+      get 'index'
+      @controller.assigns["sublayout"].should == 'particular'
+    end
+  
+    it "should define sublayout using proc" do
+      @controller = create_controller do
+        sublayout proc{|c| "#{c.action_name}_particular"}
+      end
+    
+      get 'index'
+      @controller.assigns["sublayout"].should == 'index_particular'
+    end
+  
+    it "should define sublayout using method" do
+      @controller = create_controller do
+        sublayout :change_sublayout
+      
+        define_method 'change_sublayout' do 
+          "#{action_name}_particular"
+        end
+      end
+    
+      get 'index'
+      @controller.assigns["sublayout"].should == 'index_particular'
+    end
+  end
+end

data/spec/view_helpers_spec.rb

@@ -0,0 +1,80 @@
+require File.dirname(__FILE__) + '/spec_helper'
+
+describe ViewDriver::ViewHelpers do
+  include ViewDriver::ViewHelpers
+  include ViewDriverSpecHelper
+  
+  context "render_section" do
+    before(:each) do
+      @controller = create_controller
+      @sections_collection = ViewDriver::SectionsCollection.new(@controller)
+    end
+    
+    it "should return nil if no templates available" do
+      @sections_collection.should_receive(:template_to_render).with(:sidebar).and_return(nil)
+      render_section(:sidebar).should be_nil
+    end
+    
+    it "should return rendered template" do
+      @sections_collection.should_receive(:template_to_render).with(:sidebar).and_return('pages/default_sidebar')
+      should_receive(:render).with(:file => 'pages/default_sidebar').and_return('rendered pages/default_sidebar')
+      render_section(:sidebar).should == 'rendered pages/default_sidebar'
+    end
+  end
+  
+  context "yield_with_sublayouts" do
+    it "should return @content_for_layout if sublayout wasn't defined" do
+      yield_with_sublayouts.should be_nil
+    end
+    
+    it "should return rendered template" do
+      @sublayout = 'default'
+      should_receive(:render).with(:file => File.join(ViewDriver::SUBLAYOUTS_DIR, 'default')).and_return('rendered sublayout')
+      yield_with_sublayouts.should == 'rendered sublayout'
+    end
+  end
+  
+  context "classes" do
+    it "should return default classes" do
+      classes("default1", "default2").should == "default1 default2"
+    end
+  
+    it "should return default classes and classes whose conditions were true" do
+      classes("default", ["one", true], ["two", false]).should == "default one"
+    end
+  
+    it "should return nil if all the conditions were false" do
+      classes(["one", false], ["two", false]).should be_nil
+    end
+  
+    it "should return nil if nothing has been provided" do
+      classes.should be_nil
+    end
+    
+    it "should return nil if nil class has been provided" do
+      classes(nil).should be_nil
+    end
+  
+    it "should raise an error if more than 2 elements have been provided" do
+      lambda do
+        classes('class', ['1', '2', '3'])
+      end.should raise_error(ArgumentError)
+    end
+  end
+  
+  context "image_tag" do
+    it "should include empty alt tag" do
+      image_tag('i.gif').should include('alt=""')
+    end
+    
+    it "should duplicate alt's value to title" do
+      image_tag('i.gif', :alt => 'alt').should include('alt="alt"')
+      image_tag('i.gif', :alt => 'alt').should include('title="alt"')
+    end
+    
+    it "should set title's own value" do
+      image_tag('i.gif', :title => 'title').should include('alt=""')
+      image_tag('i.gif', :title => 'title').should include('title="title"')
+    end
+  end
+end

data/view_driver.gemspec

@@ -0,0 +1,63 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{view_driver}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Macovsky"]
+  s.date = %q{2009-12-07}
+  s.description = %q{Helps dry up Rails-views using sublayouts and sections}
+  s.email = %q{robotector@gmail.com}
+  s.extra_rdoc_files = [
+    "README.rdoc"
+  ]
+  s.files = [
+    ".gitignore",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "init.rb",
+     "lib/view_driver.rb",
+     "lib/view_driver/action_controller_extensions.rb",
+     "lib/view_driver/image_tag_extension.rb",
+     "lib/view_driver/normalized_section_template.rb",
+     "lib/view_driver/sections.rb",
+     "lib/view_driver/sections_collection.rb",
+     "lib/view_driver/view_helpers.rb",
+     "pkg/view_driver-0.1.0.gem",
+     "rails/init.rb",
+     "spec/sections_collection_spec.rb",
+     "spec/sections_spec.rb",
+     "spec/spec_helper.rb",
+     "spec/view_driver_action_controller_extensions_spec.rb",
+     "spec/view_helpers_spec.rb",
+     "view_driver.gemspec"
+  ]
+  s.homepage = %q{http://github.com/macovsky/view_driver}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Helps dry up Rails-views using sublayouts and sections}
+  s.test_files = [
+    "spec/sections_collection_spec.rb",
+     "spec/sections_spec.rb",
+     "spec/spec_helper.rb",
+     "spec/view_driver_action_controller_extensions_spec.rb",
+     "spec/view_helpers_spec.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification 
+name: view_driver
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- Macovsky
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-12-07 00:00:00 +03:00
+default_executable: 
+dependencies: []
+
+description: Helps dry up Rails-views using sublayouts and sections
+email: robotector@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- .gitignore
+- README.rdoc
+- Rakefile
+- VERSION
+- init.rb
+- lib/view_driver.rb
+- lib/view_driver/action_controller_extensions.rb
+- lib/view_driver/image_tag_extension.rb
+- lib/view_driver/normalized_section_template.rb
+- lib/view_driver/sections.rb
+- lib/view_driver/sections_collection.rb
+- lib/view_driver/view_helpers.rb
+- pkg/view_driver-0.1.0.gem
+- rails/init.rb
+- spec/sections_collection_spec.rb
+- spec/sections_spec.rb
+- spec/spec_helper.rb
+- spec/view_driver_action_controller_extensions_spec.rb
+- spec/view_helpers_spec.rb
+- view_driver.gemspec
+has_rdoc: true
+homepage: http://github.com/macovsky/view_driver
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Helps dry up Rails-views using sublayouts and sections
+test_files: 
+- spec/sections_collection_spec.rb
+- spec/sections_spec.rb
+- spec/spec_helper.rb
+- spec/view_driver_action_controller_extensions_spec.rb
+- spec/view_helpers_spec.rb