view_models 1.5.2

data/CHANGELOG

@@ -0,0 +1,26 @@
+1.5.2 - 25.02.10 - floere: The capture method - if included per Capturehelper - works now in view models.
+1.5.1 - 22.02.10 - floere: Renamed ViewModels::Helper to ViewModels::Helpers.
+1.5.0 - 20.02.10 - floere: format propagates through collection rendering
+                           render_as, new sig: :partial => to explicitly define the partial. (Syntactic Discouragement)
+                           Added: render_with, an alias of render_as.
+                           Added: render_template, to render non-partials.
+1.4.2 - 10.02.10 - floere: render_as does not check the deprecated API anymore. Use the new options
+                           form to pass a format.
+                 - floere: MissingViewModelError is not thrown anymore.
+                 - floere: include ViewModels::Extensions::ActiveRecord in your Project view model to
+                           give id, dom_id, to_param capabilities to your view_models. Or include in a
+                           subclass.
+1.4.0 - 08.02.10 - floere: Changed Api of ViewModels::Base#render_as to go up through the view model
+                           class hierarchy to find a partial.
+1.3.0 - 29.01.10 - andi:   Changed Api of ViewModels::Base#render_as to take an options hash. Now supports
+                           passing locals to the render call.
+1.2.0 - 13.01.10 - floere: Simple generator written.
+1.1.0 - 30.06.09 - floere: Rewrite: Representer => ViewModel.
+1.0.2 - 08.08.08 - floere: Renamed Representers::Helper::Rails to Representers::Helper::Rails.
+                 - floere: Added Representers::Helpers::View for conveniently integrating common view-helpers.
+                 - floere: Added controller_methods for RequestForgeryProtection in ViewModels::Base.
+                 - floere: Added methods for id and dom_id in Representers::ActiveRecord.
+                 - floere: Included ActionController::Helpers in Representers::Base and removed own helper-method.
+                 - floere: Changed visibility of method view_instance in Representers::Base from private to protected.
+1.0.1 - 24.07.08 - floere: Rewrite: Presenter => Representer.
+1.0.0 - May 2008 - floere: Initial commit.

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2007 Florian Hanke & Kaspar Schiess
+
+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.textile

@@ -0,0 +1,242 @@
+h1. ViewModels for Rails
+
+h2. Previous contributors
+
+Code:
+
+"Kaspar":http://github.com/kschiess @http://github.com/kschiess@, for the first, and foundation-laying version.
+
+"Niko":http://github.com/niko @http://github.com/niko@, for handling collections and better Helpers handling.
+
+"Andi":http://github.com/andi @http://github.com/andi@, for refactoring it into a cleaner structure.
+
+Inspiration:
+
+"Severin":http://github.com/severin @http://github.com/severin@, for bits and pieces here and there.
+
+"rainhead":http://github.com/rainhead @http://github.com/rainhead@, for the idea to subclass ActionView::Base.
+
+Important note: These guys rock! :)
+
+h2. Installation
+
+@script/plugin install git://github.com/floere/view_models.git@
+
+h2. Description
+
+A possible view_model solution, i.e. no view logic in model code.
+
+h2. Feedback
+
+Ask/Write florian.hanke@gmail.com if you have questions/feedback, thanks! :)
+Fork if you have improvements. Send me a pull request, it is much appreciated.
+
+h2. Problem
+
+Display Methods are not well placed either in
+* models: Violation of the MVC principle.
+* helpers: No Polymorphism.
+
+h2. Solution
+
+A thin proxy layer over a model, with access to the controller, used by the view or controller.
+
+@The view@ -> to @the view model@ which in turn -> @the model@ and -> @the controller@
+
+h2. Examples & What you can do
+
+h3. A quick one
+
+In the view:
+<pre><code>user = view_model_for @user
+%h1= "You, #{user.full_name}, the user"
+%h2 This is how you look as a search result:
+= user.render_as :result
+%h2 This is how you look as a Vcard:
+= user.render_as :vcard</code></pre>
+In the view model:
+<pre><code>class ViewModels::User < ViewModels::Project
+  model_reader :first_name, :last_name
+  def full_name
+    "#{last_name}, #{first_name}"
+  end
+end</code></pre>
+In the model:
+<pre><code>class User < ActiveRecord::Base
+end</code></pre>
+Also, there are two partials in @app/views/view_models/user/@, @_result.html.haml@ and @_vcard.html.haml@ that define how the result of @user.render_as :result@ and @user.render_as :vcard@ look. The ViewModel can be accessed inside the view by using the local variable @view_model@.
+
+h3. Getting a view_model in a view or a controller.
+
+Call view_model_for: @view_model_instance = view_model_for model_instance@
+By convention, uses @ViewModels::Model::Class::Name@, thus prefixing @ViewModels::@ to the model class name.
+
+Note: You can override @specific_view_model_class_for@ to change the mapping of model to class, or make it dynamic.
+
+h3. Getting a collection view model in a view.
+
+The collection view_model renders each of the given items with its view_model.
+
+Call collection_view_model_for: @collection_view_model_instance = collection_view_model_for enumerable_containing_model_instances@
+
+Rendering a list: @collection_view_model_instance.list@
+
+Rendering a collection: @collection_view_model_instance.collection@
+
+Rendering a table: @collection_view_model_instance.table@
+
+Rendering a pagination: @collection_view_model_instance.pagination@
+Note: Only works if the passed parameter for @collection_view_model_for@ is a @PaginationEnumeration@.
+
+Important note:
+  As of yet it is needed to copy the templates/views/view_models/collection
+  directory to the corresponding location in app/views/view_models/collection.
+  This is only needed if you wish to use the collection view model.
+  The collections are automatically copied if you use the generator.
+
+Note: Rewrite the collection templates as needed, they are rather basic.
+
+h3. Writing filtered delegate methods on the view model.
+
+Will create two delegate methods first_name and last_name that delegate to the model: @model_reader :first_name, :last_name@
+
+Will create a description delegate method that filters the model value through h: @model_reader :description, :filter_through => :h@
+
+Will create a description delegate method that filters the model value through first textilize, then h: @model_reader :description, :filter_through => [:textilize, :h]@
+
+Will create both a first_name and last_name delegate method that filters the model value through first textilize, then h: @model_reader :first_name, :last_name, :filter_through => [:textilize, :h]@
+Note: Filter methods can be any method on the view_model with arity 1.
+
+h3. Rendering view model templates
+
+Use @render_as(template_name, options)@.
+
+Gets a @ViewModels::Model::Class@ instance: @view_model = view_model_for Model::Class.new@
+
+Gets a @ViewModels::<model_instance.class.name>@ instance: @view_model = view_model_for model_instance@
+
+Renders the 'example' partial in view_models/model/class: @view_model.render_as :example@
+Note: Renders a format depending on the request. ../index.text will render example.text.erb.
+
+Renders the 'example.text.erb' partial in view_models/model/class: @view_model.render_as :example, :format => :text@
+Note: If the partial cannot be found, it will traverse the view model hierarchy upwards to find a partial template.
+
+Locals can be passed through as usual: @view_model.render_as :example, :format => :text, :locals => { :name => value }@
+
+h3. Rails Helpers in ViewModels
+
+Use @helper@ as you would in the controller.
+@helper ActionView::Helpers::UrlHelper@
+@helper ApplicationHelper@
+Note: It is helpful to create a superclass to all view models in the project with generally used helpers.
+We use @ViewModels::Project@ a lot, for example. See example below.
+
+h3. Controller Delegate Methods
+
+Use @controller_method(*args)@.
+
+Delegates current_user and logger on the view_model to the controller: @controller_method :current_user, :logger@
+
+h2. The Generator
+
+Generates view model class, spec, and views. Use as follows:
+
+@script/generate view_models <view model class name>@
+@script/generate view_models User@
+
+@script/generate view_models <view model class name> <partials for render_as, separated by space>@
+@script/generate view_models User compact extensive list_item table_item@
+
+h2. One Big Fat Example
+
+The following classes all have specs of course ;) But are not shown since they don't help the example.
+
+@ViewModels@ superclass for this project.
+
+We include all of Rails' helpers for the view models in this project.
+Also, we include the @ApplicationHelper@.
+
+We delegate @logger@ and @current_user@ calls in the view models to the active controller.
+
+<pre>
+<code>
+class ViewModels::Project < ViewModels::Base
+  
+  # Our ApplicationHelper.
+  #
+  helper ApplicationHelper
+  
+  # We want to be able to call view_model_for in our view_models.
+  #
+  helper ViewModels::Helpers::Rails
+  
+  # Include all common view helpers.
+  #
+  helper ViewModels::Helpers::View
+  
+  # We want to be able to use id, dom_id, to_param on the view model.
+  #
+  # Note: Overrides the standard dom_id method from the RecordIdentificationHelper.
+  #
+  include ViewModels::Extensions::ActiveRecord
+  
+  controller_method :logger, :current_user
+  
+end
+
+# All items have a description that needs to be filtered by textilize.
+#
+class ViewModels::Item < ViewModels::Project
+  model_reader :description, :filter_through => :textilize
+  # Use price in the view as follows:
+  # = view_model.price - will display e.g. 16.57 CHF, since it is filtered first through localize_currency
+  model_reader :price, :filter_through => :localize_currency
+  
+  # Converts a database price tag to the users chosen value, with the users preferred currency appended.
+  # If the user is Swiss, localize_currency will convert 10 Euros to "16.57 CHF" 
+  #
+  def localize_currency(price_in_euros)
+    converted_price = current_user.convert_price(price_in_euros)
+    "#{converted_price} #{current_user.currency.to_s}"
+  end
+end
+
+# This class also has partial templates in the directory
+#   app/views/view_models/book
+# that are called
+#   _cart_item.html.haml
+#   _cart_item.text.erb
+#
+# Call view_model_for on a book in the view or controller to get this view_model.
+#
+class ViewModels::Book < ViewModels::Item
+  model_reader :author, :title, :pages
+  model_reader :excerpt, :filter_through => :textilize
+  
+  def header
+    content_tag(:h1, "#{author} – #{title}")
+  end
+  
+  def full_description
+    content_tag(:p, "#{excerpt} #{description}", :class => 'description full')
+  end
+end
+
+# This class also has partial templates in the directory
+#   app/views/view_models/toy
+# that are called
+#   _cart_item.html.haml
+#   _cart_item.text.erb
+#
+# Call view_model_for on a toy in the view or controller to get this view_model.
+#
+class ViewModels::Toy < ViewModels::Item
+  model_reader :starting_age, :small_dangerous_parts
+  
+  def obligatory_parental_warning
+    "Warning, this toy can only be used by kids ages #{starting_age} and up. Your department of health. Thank you."
+  end
+  
+end
+</code>
+</pre>

data/Rakefile

@@ -0,0 +1,47 @@
+def require_if task, name
+  require name if ARGV[0] =~ %r{^#{task}}
+end
+
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+require 'spec/rake/spectask'
+require 'spec/rake/verify_rcov'
+
+require_if :metrics, 'metric_fu'
+
+task :default => :spec
+
+# run with rake spec
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.spec_opts = %w{--colour --format progress --loadby mtime --reverse}
+  t.spec_files = Dir.glob('spec/**/*_spec.rb')
+  t.warning = false
+end
+
+# run with rake rcov
+Spec::Rake::SpecTask.new(:rcov) do |t|
+  t.spec_opts = %w{--colour --format progress --loadby mtime --reverse}
+  t.spec_files = Dir.glob('spec/**/*_spec.rb')
+  t.warning = false
+  t.rcov = true
+  puts "Open coverage/index.html for the rcov results."
+end
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gemspec|
+    gemspec.name = "view_models"
+    gemspec.summary = "A model proxy for Rails views. Helps you keep the representation of a model and the model itself separate."
+    gemspec.email = "florian.hanke@gmail.com"
+    gemspec.homepage = "http://floere.github.com/view_models"
+    gemspec.description = "The view models gem adds the missing R (Representation) to Rails' MVC. It provides simple proxy functionality for your models and thus helps you keep the model and view representations of a model separate, as it should be. Also, you can define helper methods on the (view) model instead of globally to keep them focused, more quickly understood and more easily testable. View Models also introduce hierarchical rendering for your hierarchical models. If the account view is not defined for the subclass FemaleUser, it checks if it is defined for User, for example, to see when there is no specific view, if there is a general view. So, in other words: Polymorphism not just in the model, but also in the view."
+    gemspec.authors = ["Florian Hanke", "Kaspar Schiess", "Niko Dittmann", "Andreas Schacke"]
+    gemspec.rdoc_options = ["--inline-source", "--charset=UTF-8"]
+    gemspec.files = FileList["[A-Z]*", "{generators,lib,rails,spec}/**/*"]
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError => e
+  puts "Jeweler not available (#{e}). Install it with: sudo gem install technicalpickles-jeweler -s http://gems.github.com"
+end

data/VERSION.yml

@@ -0,0 +1,4 @@
+--- 
+:major: 1
+:minor: 5
+:patch: 2

data/generators/view_models/USAGE

@@ -0,0 +1,6 @@
+Usage:
+  script/generate view_models <view model class name>
+  script/generate view_models User
+  
+  script/generate view_models <view model class name> <partials for render_as, separated by space>
+  script/generate view_models User compact extensive list_item table_item

data/generators/view_models/templates/README

@@ -0,0 +1 @@
+View Model generated. Have fun!

data/generators/view_models/templates/spec/view_model_spec.rb

@@ -0,0 +1,7 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe ViewModels::<%= class_name %> do
+  
+  
+  
+end

data/generators/view_models/templates/view_models/view_model.rb

@@ -0,0 +1,5 @@
+class ViewModels::<%= class_name %> < ViewModels::Project
+  
+  # model_reader :icon, :filter_through => [:h]
+  
+end

data/generators/view_models/templates/views/view_models/collection/_collection.html.erb

@@ -0,0 +1 @@
+<ul class="collection"><%- collection.each do |item| -%><%- view_model = view_model_for item -%><li><%- options = template_format ? { :format => template_format } : {} -%><%= view_model.render_as template_name, options -%></li><%= separator unless item == collection.last %><%- end -%></ul>

data/generators/view_models/templates/views/view_models/collection/_collection.html.haml

@@ -0,0 +1,8 @@
+%ul.collection
+  - collection.each do |item|
+    - view_model = view_model_for item
+    %li
+      - options = (template_format ? { :format => template_format } : {})
+      = view_model.render_as template_name, options
+    = separator unless item == collection.entries.last
+        

data/generators/view_models/templates/views/view_models/collection/_collection.text.erb

@@ -0,0 +1,6 @@
+<%- collection.each do |item| -%>
+<%- view_model = view_model_for item -%>
+<%- options = (template_format ? { :format => template_format } : {}) -%>
+<%= view_model.render_as template_name, options -%>
+<%= separator unless item == collection.entries.last -%>
+<%- end -%>

data/generators/view_models/templates/views/view_models/collection/_list.html.erb

@@ -0,0 +1 @@
+<ol class="collection"><%- collection.each do |item| -%><%- view_model = view_model_for item -%><li><%- options = (template_format ? { :format => template_format } : {}) -%><%= view_model.render_as template_name, options -%></li><%= separator unless item == collection.last %><%- end -%></ol>

data/generators/view_models/templates/views/view_models/collection/_list.html.haml

@@ -0,0 +1,7 @@
+%ol.collection
+  - collection.each do |item|
+    - view_model = view_model_for item
+    %li
+      - options = (template_format ? { :format => template_format } : {})
+      = view_model.render_as template_name, options
+    = separator unless item == collection.last

data/generators/view_models/templates/views/view_models/collection/_list.text.erb

@@ -0,0 +1,6 @@
+<% collection.each do |item| -%>
+<% view_model = view_model_for item -%>
+<%- options = (template_format ? { :format => template_format } : {}) -%>
+<%= view_model.render_as template_name, options -%>
+<%= separator || '\n' unless item == collection.entries.last -%>
+<% end -%>

data/generators/view_models/templates/views/view_models/collection/_pagination.html.haml

@@ -0,0 +1,12 @@
+- if collection.page_count > 1
+  %p
+    - if collection.previous_page?
+      = link_to 'zurückblättern', :page => collection.page-1
+    - 1.upto(collection.page_count) do |page|
+      - if page == collection.page
+        = page.to_s
+      - else
+        = link_to page, :page => page
+      = separator unless collection.last_page?
+    - if collection.next_page?
+      = link_to 'vorblättern', :page => collection.page+1

data/generators/view_models/templates/views/view_models/collection/_pagination.text.erb

@@ -0,0 +1,3 @@
+<%- if collection.page_count > 1 -%>
+  <%= "Page #{collection.page} of #{collection.page_count}." -%>
+<%- end -%>

data/generators/view_models/templates/views/view_models/collection/_table.html.haml

@@ -0,0 +1,5 @@
+%table.collection
+  - collection.each do |item|
+    %tr
+      - view_model = view_model_for item
+      = view_model.render_as template_name

data/generators/view_models/templates/views/view_models/collection/_table.text.erb

@@ -0,0 +1,10 @@
+<%- width = 66 -%>
+<%= '-'*width %>
+<% collection.each do |item| -%>
+<% view_model = view_model_for(item, self) -%>
+<%- result = view_model.render_as(template_name) -%>
+<%= '|' + "%-#{width}s"%(result[0,width]) + '|' -%>
+<%- p ('|' + "%-#{width}s"%(result[0,width]) + '|') %>
+<%= separator || ">#{'-'*(width-2)}<" unless item == collection.entries.last %>
+<% end -%>
+<%= '-'*width %>

data/generators/view_models/view_models_generator.rb

@@ -0,0 +1,47 @@
+class ViewModelsGenerator < Rails::Generator::NamedBase
+  def manifest
+    record do |m|
+      
+      # Check for class naming collisions.
+      #
+      m.class_collisions "ViewModels::#{class_name}"
+      
+      # ViewModels
+      #
+      m.directory 'app/view_models'
+      m.template "view_models/view_model.rb", "app/view_models/#{file_name}.rb"
+      
+      # Specs
+      #
+      m.directory "spec/app/view_models"
+      m.template "spec/view_model_spec.rb", "spec/app/view_models/#{file_name}_spec.rb"
+      
+      # Views
+      #
+      m.directory "app/views/view_models"
+      m.directory "app/views/view_models/#{file_name}"
+      actions << 'list_item' if actions.empty?
+      actions.each do |action|
+        m.template "views/_empty.html.haml", "app/views/view_models/#{file_name}/_#{action}.html.haml"
+      end
+      
+      # Copy collection views.
+      #
+      m.directory "app/views/view_models/collection"
+      m.file "views/view_models/collection/_collection.html.haml", "app/views/view_models/collection/_collection.html.haml"
+      m.file "views/view_models/collection/_collection.text.erb",  "app/views/view_models/collection/_collection.text.erb"
+      m.file "views/view_models/collection/_list.html.haml",       "app/views/view_models/collection/_list.html.haml"
+      m.file "views/view_models/collection/_list.text.erb",        "app/views/view_models/collection/_list.text.erb"
+      m.file "views/view_models/collection/_pagination.html.haml", "app/views/view_models/collection/_pagination.html.haml"
+      m.file "views/view_models/collection/_pagination.text.erb",  "app/views/view_models/collection/_pagination.text.erb"
+      m.file "views/view_models/collection/_table.html.haml",      "app/views/view_models/collection/_table.html.haml"
+      m.file "views/view_models/collection/_table.text.erb",       "app/views/view_models/collection/_table.text.erb"
+      
+      # Show README.
+      #
+      m.readme "README"
+      
+    end
+  end
+
+end

data/lib/extensions/active_record.rb

@@ -0,0 +1,19 @@
+# Makes certain AR Model methods available to the view model.
+#
+# Useful when the model is an AR Model.
+#
+module ViewModels
+  module Extensions
+    module ActiveRecord
+      
+      delegate :id, :to_param, :to => :model
+      
+      # Delegate to the action controller record identifier.
+      #
+      def dom_id
+        ActionController::RecordIdentifier.dom_id model
+      end
+      
+    end
+  end
+end

data/lib/extensions/model_reader.rb

@@ -0,0 +1,115 @@
+# Makes model reader installation, including filtering in-between possible.
+#
+#
+module ViewModels
+  module Extensions
+    module ModelReader
+      
+      # Define a reader for a model attribute. Acts as a filtered delegation to the model. 
+      #
+      # You may specify a :filter_through option that is either a symbol or an array of symbols. The return value
+      # from the model will be filtered through the functions (arity 1) and then passed back to the receiver. 
+      #
+      # Example: 
+      #
+      #   model_reader :foobar                                        # same as delegate :foobar, :to => :model
+      #   model_reader :foobar, :filter_through => :h                 # html escape foobar 
+      #   model_reader :foobar, :filter_through => [:textilize, :h]   # first textilize, then html escape
+      #
+      def model_reader *attributes_and_options
+        options = Options.new *attributes_and_options
+        FilteredDelegationInstaller.new(self, options).install
+      end
+      
+      # Bundles the model reader options and extracts the relevant structured data.
+      #
+      class Options
+        
+        attr_reader :attributes, :filters
+        
+        def initialize *attributes_and_options
+          split attributes_and_options
+        end
+        
+        # Extract filter_through options from the options hash if there are any.
+        #
+        def split options
+          @filters = if options.last.kind_of?(Hash)
+            [*(options.pop[:filter_through])].reverse
+          else
+            []
+          end
+          @attributes = options
+        end
+        
+        def to_a
+          [attributes, filters]
+        end
+        
+      end
+      
+      # The filtered delegation installer installs delegators on the target
+      # that are filtered.
+      #
+      class FilteredDelegationInstaller
+        
+        attr_reader :target, :attributes, :filters
+        
+        def initialize target, options
+          @target, @attributes, @filters = target, *options
+        end
+        
+        # Install install
+        #
+        def install
+          attributes.each { |attribute| install_reader(attribute) }
+        end
+        
+        # Install a reader for the given name with the given filters.
+        #
+        # Example:
+        # # Installs a reader for model.attribute
+        # #
+        # * install_reader :attribute
+        #
+        def install_reader attribute
+          target.class_eval reader_definition_for(attribute)
+        end
+        
+        # Defines a reader for the given model attribute and filtering
+        # through the given filters.
+        # 
+        # Note: The filters are applied from last to first element.
+        #
+        def reader_definition_for attribute
+          "def #{attribute}; #{filtered_left_parentheses}model.#{attribute}#{right_parentheses}; end"
+        end
+        
+        # Combines left parentheses and filters.
+        #
+        def filtered_left_parentheses
+          filters.zip(left_parentheses).to_s
+        end
+        
+        # Generates the needed amount of parentheses to match the left parentheses.
+        #
+        def right_parentheses
+          ')' * filters.size
+        end
+        
+        # Generates an array of left parentheses with
+        # length <amount of filters>
+        # Example:
+        # # 4 Filters
+        # # 
+        # left_parentheses # => ['(', '(', '(', '(']
+        #
+        def left_parentheses
+          ['('] * filters.size
+        end
+        
+      end
+      
+    end
+  end
+end

data/lib/extensions/view.rb

@@ -0,0 +1,24 @@
+# Not used at the moment
+#
+# Extends a standard ActionView::Base view with methods
+# needed by the view models.
+#
+module ViewModels
+  module Extensions
+    module View
+      
+      #
+      #
+      def render_with options
+        render options.to_render_options
+      end
+
+      # Finds the template in the view paths at the given path, with its format.
+      #
+      def find_template path
+        view_paths.find_template path, template_format rescue nil
+      end
+      
+    end
+  end
+end