cells 3.4.0.beta3 → 3.4.0

data/README.rdoc

@@ -18,11 +18,11 @@ It's a gem!
 
 Rails 3:
 
-  gem install cells --pre
+  gem install cells
 
 Rails 2.3:
 
-  gem install cells
+  gem install cells -v 3.3.4
 
 
 == Generate
@@ -84,6 +84,15 @@ Yes, Cells have helpers just like controllers. If you need some specific helper,
 
 and it will be around in your cart views.
 
+=== Partials?
+
+Yeah, we do support rendering partials in views. Nevertheless, we discourage _partials_ at all.
+
+The distinction between partials and views is making things more complex, so why should we have two kinds of view types? Use ordinary views instead, they're fine.
+
+  %p
+    = render :view => 'items'
+
 
 == Caching
 
@@ -135,4 +144,4 @@ Copyright (c) 2007-2010, Nick Sutterer
 
 Copyright (c) 2007-2008, Solide ICT by Peter Bex and Bob Leers
 
-Released under the MIT License.
+Released under the MIT License.

data/Rakefile

@@ -1,4 +1,3 @@
-# encoding: utf-8
 require 'rake'
 require 'rake/testtask'
 require 'rake/rdoctask'
@@ -11,44 +10,10 @@ task :default => :test
 desc 'Test the cells plugin.'
 Rake::TestTask.new(:test) do |test|
   test.libs << 'test'
-  test.test_files = FileList['test/*_test.rb', 'test/rails/*_test.rb']
+  test.test_files = FileList['test/*_test.rb', 'test/rails/*_test.rb'] - ['test/rails/capture_test.rb']
   test.verbose = true
 end
 
-desc 'Generate documentation for the cells plugin.'
-Rake::RDocTask.new(:rdoc) do |rdoc|
-  rdoc.rdoc_dir = 'rdoc'
-  rdoc.title    = 'Cells Documentation'
-  rdoc.options << '--line-numbers' << '--inline-source'
-  rdoc.rdoc_files.include('README.rdoc')
-  rdoc.rdoc_files.include('init.rb')
-  rdoc.rdoc_files.include('lib/**/*.rb')
-end
-
-# rdoc -m "README.rdoc" init.rb lib/ generators/ README.rdoc
-
-# Gem managment tasks.
-#
-# == Bump gem version (any):
-#
-#   rake version:bump:major
-#   rake version:bump:minor
-#   rake version:bump:patch
-#
-# == Generate gemspec, build & install locally:
-#
-#   rake gemspec
-#   rake build
-#   sudo rake install
-#
-# == Git tag & push to origin/master
-#
-#   rake release
-#
-# == Release to Gemcutter.org:
-#
-#   rake gemcutter:release
-#
 begin
   gem 'jeweler'
   require 'jeweler'
@@ -56,8 +21,8 @@ begin
   Jeweler::Tasks.new do |spec|
     spec.name         = "cells"
     spec.version      = ::Cells::VERSION
-    spec.summary      = %{Cells are lightweight controllers for Rails and can be rendered in controllers and views, providing an elegant and fast way for encapsulation and component-orientation.}
-    spec.description  = spec.summary
+    spec.summary      = %{View Components for Rails.}
+    spec.description  = %{Cells are lightweight controllers for Rails and can be rendered in views, providing an elegant and fast way for encapsulation and component-orientation.}
     spec.homepage     = "http://cells.rubyforge.org"
     spec.authors      = ["Nick Sutterer"]
     spec.email        = "apotonick@gmail.com"

data/lib/cell.rb

@@ -1,8 +1,46 @@
-# encoding: utf-8
-
 module Cell
-  #autoload :Base, 'cell/base'
-  autoload :View, 'cell/view'
-  autoload :Caching, 'cell/caching'
-  autoload :ActiveHelper, 'cell/active_helper'
-end
+  autoload :Caching,      'cell/caching'
+  
+  extend ActiveSupport::Concern
+    
+  module ClassMethods
+    def render_cell_for(controller, name, state, opts={})
+      create_cell_for(controller, name, opts).render_state(state)
+    end
+    
+    # Creates a cell instance.
+    def create_cell_for(controller, name, opts={})
+      class_from_cell_name(name).new(controller, opts)
+    end
+    
+    # Return the default view path for +state+. Override this if you cell has a differing naming style.
+    def view_for_state(state)
+      "#{cell_name}/#{state}"
+    end
+
+    # Returns all possible view paths for +state+ by invoking #view_for_state on all classes up
+    # the inheritance chain.
+    def find_class_view_for_state(state)
+      return [view_for_state(state)] unless superclass.respond_to?(:find_class_view_for_state)
+
+      superclass.find_class_view_for_state(state) << view_for_state(state)
+    end
+
+    # The cell name, underscored with +_cell+ removed.
+    def cell_name
+      name.underscore.sub(/_cell$/, '')
+    end
+    
+    # The cell class constant for +cell_name+.
+    def class_from_cell_name(cell_name)
+      "#{cell_name}_cell".classify.constantize
+    end
+  end
+    
+  module InstanceMethods
+    # Computes all possible paths for +state+ by traversing up the inheritance chain.
+    def possible_paths_for_state(state)
+      self.class.find_class_view_for_state(state).reverse!
+    end
+  end
+end

data/lib/cell/caching.rb

@@ -113,7 +113,7 @@ module Cell
     end
 
     def cache_key(state, args = {}) #:nodoc:
-      self.class.cache_key_for(self.cell_name, state, args)
+      self.class.cache_key_for(self.class.cell_name, state, args)
     end
 
     def state_cached?(state)

data/lib/cell/rails.rb

@@ -1,22 +1,12 @@
 require 'abstract_controller'
-require 'action_controller'
 
 module Cell
-  class Rails < ActionController::Metal
-    include BaseMethods
+  class Rails < AbstractController::Base
+    include Cell
     include AbstractController
-    include Rendering, Layouts, Helpers, Callbacks, Translation
+    include Rendering, Layouts, Helpers, Callbacks, Translation, Logger
     include ActionController::RequestForgeryProtection
     
-    module Rendering
-      def render_state(state)
-        rack_response = dispatch(state, parent_controller.request)
-        
-        str = ''      # copied from Response#body.
-        rack_response[2].each { |part| str << part.to_s }
-        str.html_safe # in fact, i'd love to return a real OutputBuffer here.
-      end
-    end
     
     class View < ActionView::Base
       def render(options = {}, locals = {}, &block)
@@ -28,27 +18,48 @@ module Cell
       end
     end
     
+    
+    module Rendering
+      # Invoke the state method for +state+ which usually renders something nice.
+      def render_state(state)
+        dispatch(state, parent_controller.request)
+      end
+    end
+    
+    
+    module Metal
+      def dispatch(name, request)
+        @_request = request
+        @_env = request.env
+        @_env['action_controller.instance'] = self
+        process(name)
+      end
+      
+      def params
+        @_params ||= request.parameters # DISCUSS: let rails helper access @controller.params!
+      end
+      
+      delegate :request,  :to => :parent_controller
+      delegate :config,   :to => :parent_controller
+      delegate :session,  :to => :parent_controller
+    end 
+    
+    
+    include Metal
     include Rendering
     include Caching
     
-    #include AbstractController::Logger
-    
     
-    #include Cell::ActiveHelper
     cattr_accessor :url_helpers ### TODO: discuss if we really need that or can handle that in cells.rb already.
+    attr_reader :parent_controller
     
     abstract!
     
-    ### DISCUSS: should we pass the parent_controller here?
-    def initialize(parent_controller=nil, options={})  ### FIXME: move to BaseMethods.
+    
+    def initialize(parent_controller=nil, options={})
       @parent_controller  = parent_controller
       @opts = @options    = options
     end
-    attr_reader :parent_controller
-    
-    
-    def log(*args); end
-    
     
     def self.view_context_class
       controller = self
@@ -66,120 +77,97 @@ module Cell
     def self.controller_path
       @controller_path ||= name.sub(/Cell$/, '').underscore unless anonymous?
     end
-    
-    def process(*)  # defined in AC::Metal.
-      self.response_body = super
-    end
-    
-    delegate :request, :to => :parent_controller
-    delegate :config, :to => :parent_controller # DISCUSS: what if a cell has its own config (eg for assets, cells/bassist/images)?
-    # DISCUSS: let @controller point to @parent_controller in views, and @cell is the actual real controller?
 
-      # Renders the view for the current state and returns the markup for the component.
-      # Usually called and returned at the end of a state method.
-      #
-      # ==== Options
-      # * <tt>:view</tt> - Specifies the name of the view file to render. Defaults to the current state name.
-      # * <tt>:template_format</tt> - Allows using a format different to <tt>:html</tt>.
-      # * <tt>:layout</tt> - If set to a valid filename inside your cell's view_paths, the current state view will be rendered inside the layout (as known from controller actions). Layouts should reside in <tt>app/cells/layouts</tt>.
-      # * <tt>:locals</tt> - Makes the named parameters available as variables in the view.
-      # * <tt>:text</tt> - Just renders plain text.
-      # * <tt>:inline</tt> - Renders an inline template as state view. See ActionView::Base#render for details.
-      # * <tt>:file</tt> - Specifies the name of the file template to render.
-      # * <tt>:nothing</tt> - Will make the component kinda invisible and doesn't invoke the rendering cycle.
-      # * <tt>:state</tt> - Instantly invokes another rendering cycle for the passed state and returns.
-      # Example:
-      #  class MyCell < ::Cell::Base
-      #    def my_first_state
-      #      # ... do something
-      #      render
-      #    end
-      #
-      # will just render the view <tt>my_first_state.html</tt>.
-      #
-      #    def my_first_state
-      #      # ... do something
-      #      render :view => :my_first_state, :layout => 'metal'
-      #    end
-      #
-      # will also use the view <tt>my_first_state.html</tt> as template and even put it in the layout
-      # <tt>metal</tt> that's located at <tt>$RAILS_ROOT/app/cells/layouts/metal.html.erb</tt>.
-      #
-      #    def say_your_name
-      #      render :locals => {:name => "Nick"}
-      #    end
-      #
-      # will make the variable +name+ available in the view <tt>say_your_name.html</tt>.
-      #
-      #    def say_your_name
-      #      render :nothing => true
-      #    end
-      #
-      # will render an empty string thus keeping your name a secret.
-      #
-      #
-      # ==== Where have all the partials gone?
-      #
-      # In Cells we abandoned the term 'partial' in favor of plain 'views' - we don't need to distinguish
-      # between both terms. A cell view is both, a view and a kind of partial as it represents only a small
-      # part of the page.
-      # Just use <tt>:view</tt> and enjoy.
-      def render(opts={})
-        render_view_for(opts, self.action_name)
-      end
-
-      
+    # Renders the view for the current state and returns the markup.
+    # Don't forget to return the markup itself from the state method.
+    #
+    # === Options
+    # +:view+::   Specifies the name of the view file to render. Defaults to the current state name.
+    # +:layout+:: Renders the state wrapped in the layout. Layouts reside in <tt>app/cells/layouts</tt>.
+    # +:locals+:: Makes the named parameters available as variables in the view.
+    # +:text+::   Just renders plain text.
+    # +:inline+:: Renders an inline template as state view. See ActionView::Base#render for details.
+    # +:file+::   Specifies the name of the file template to render.
+    # +:nothing+:: Doesn't invoke the rendering process.
+    # +:state+::  Instantly invokes another rendering cycle for the passed state and returns.
+    #
+    # Example:
+    #  class MusicianCell < ::Cell::Base
+    #    def sing
+    #      # ... laalaa
+    #      render
+    #    end
+    #
+    # renders the view <tt>musician/sing.html</tt>.
+    #
+    #    def sing
+    #      # ... laalaa
+    #      render :view => :shout, :layout => 'metal'
+    #    end
+    #
+    # renders <tt>musician/shout.html</tt> and wrap it in <tt>app/cells/layouts/metal.html.erb</tt>.
+    #
+    # === #render is explicit!
+    # You can also alter the markup from #render. Just remember to return it.
+    #
+    #   def sing
+    #     render + render + render
+    #   end
+    #
+    # will render three concated views.
+    #
+    # === Partials?
+    #
+    # In Cells we abandoned the term 'partial' in favor of plain 'views' - we don't need to distinguish
+    # between both terms. A cell view is both, a view and a kind of partial as it represents only a fragment
+    # of the page.
+    #
+    # Just use <tt>:view</tt> and enjoy.
+    def render(opts={})
+      render_view_for(opts, self.action_name)
+    end
 
-      # Climbs up the inheritance hierarchy of the Cell, looking for a view for the current +state+ in each level.
-      def find_family_view_for_state(state)
-        missing_template_exception = nil
+    # Climbs up the inheritance chain, looking for a view for the current +state+.
+    def find_family_view_for_state(state)
+      missing_template_exception = nil
 
-        possible_paths_for_state(state).each do |template_path|
-          begin
-            template = find_template(template_path)
-            return template if template
-          rescue ::ActionView::MissingTemplate => missing_template_exception
-          end
+      possible_paths_for_state(state).each do |template_path|
+        begin
+          template = find_template(template_path)
+          return template if template
+        rescue ::ActionView::MissingTemplate => missing_template_exception
         end
-        
-        raise missing_template_exception
       end
       
-      # Render the view belonging to the given state. Will raise ActionView::MissingTemplate
-      # if it can not find one of the requested view template. Note that this behaviour was
-      # introduced in cells 2.3 and replaces the former warning message.
-      def render_view_for(opts, state)
-        return '' if opts[:nothing]
-
-        ### TODO: dispatch dynamically:
-        if    opts[:text]   ### FIXME: generic option?
-        elsif opts[:inline]
-        elsif opts[:file]
-        elsif opts[:state]  ### FIXME: generic option
-          opts[:text] = render_state(opts[:state])
-        else
-          # handle :layout, :template_format, :view
-          opts = defaultize_render_options_for(opts, state)
-
-          #template    = find_family_view_for_state_with_caching(opts[:view], action_view)
-          template    = find_family_view_for_state(opts[:view])
-          opts[:template] = template
-        end
-
-        opts = sanitize_render_options(opts)
-        
-        render_to_string(opts)
-      end
-
-      # Defaultize the passed options from #render.
-      def defaultize_render_options_for(opts, state)
-        opts[:template_format]  ||= self.class.default_template_format
-        opts[:view]             ||= state
-        opts
-      end
+      raise missing_template_exception
+    end
+    
+    # Renders the view belonging to the given state. Will raise ActionView::MissingTemplate
+    # if it can't find a view.
+    def render_view_for(opts, state)
+      return "" if opts[:nothing]
       
-      def sanitize_render_options(opts)
-        opts.except!(:view, :state)
+      rails_options = [:text, :inline, :file]
+      if (opts.keys & rails_options).present?
+      elsif opts[:state]
+        opts[:text] = render_state(opts[:state])
+      else
+        opts            = defaultize_render_options_for(opts, state)
+        template        = find_family_view_for_state(opts[:view])
+        opts[:template] = template
       end
-		end
-end
+
+      opts = sanitize_render_options(opts)
+      render_to_string(opts)
+    end
+
+    # Defaultize the passed options from #render.
+    def defaultize_render_options_for(opts, state)
+      opts.reverse_merge!(:view => state)
+    end
+    
+    def sanitize_render_options(opts)
+      opts.except!(:view, :state)
+    end
+  end
+end

data/lib/cells.rb

@@ -1,17 +1,69 @@
-# encoding: utf-8
-
-require 'active_support'
+# = Cells
+#
+# Cells are view components for Rails. Being lightweight controllers with actions and views, cells are the
+# answer to <tt>DoubleRenderError</tt>s and the long awaited ability to render actions within actions.
+# 
+# == Directory structure
+#
+# Cells live in +app/cells/+ and have a similar file layout as controllers.
+#
+#   app/
+#     cells/
+#       shopping_cart_cell.rb
+#       shopping_cart/
+#         status.html.erb
+#         product_list.haml
+#       layouts/
+#         box.html.erb
+#
+# == Cell nesting
+# 
+# Is is good practice to split up complex cell views into multiple states or views. Remember, you can always use
+# <tt>render :view => ...</tt> and <tt>render :state => ...</tt> in your views.
+#
+# Following this, you stick to encapsulation and save your code from getting inscrutable, as it happens in most
+# controller views, partials, and so called "helpers".
+#
+# Given the following setup:
+#
+#   class ShoppingCartCell < Cell::Base
+#     def cart
+#       @items = items_in_cart
+#       render
+#     end
+#
+#     def order_button
+#       render
+#     end
+#
+# You could now render the "Order!" button in the +cart.haml+ view.
+#
+#   - for item in @items
+#     = @item.title
+#
+#   render :state => :order_button
+# 
+# which is more than just a partial, as you may execute additional code in the state method.
+#
+# == View inheritance
+#
+# Unlike controllers, Cells can form a class hierarchy. Even Views are inherited, which is pretty useful
+# when overriding only small parts of the view.
+#
+# So if you'd need a special "Order!" button with sparkling stars on christmas, your cell would go like this.
+#
+#   class XmasCartCell < ShoppingCartCell
+#   end
+#
+# Beside your new class you'd provide a star-sprangled button view in +xmas_cart/order_button.haml+.
+# When rendering the +cart+ state, the states as well as the "missing" views are inherited from ancesting cells,
+# this is pretty DRY and object-oriented, isn't it?
 require 'action_controller'
 
-
-require 'cell/base_methods'
-
 require 'cell'
-require 'cells/rails' # helper.
+require 'cells/rails'
 require 'cell/rails'
 
-require 'cells/helpers'
-
 
 module Cells
   # Any config should be placed here using +mattr_accessor+.
@@ -70,4 +122,4 @@ class Cells::Railtie < Rails::Railtie
     #ActiveSupport::Dependencies.load_paths << Rails.root.join(*%w[app cells])
     ### DISCUSS: how are cell classes found by Rails?
   end
-end
+end

data/lib/cells/rails.rb

@@ -1,5 +1,3 @@
-# encoding: utf-8
-
 # These Methods are automatically added to all Controllers and Views when
 # the cells plugin is loaded.
 module Cells
@@ -62,7 +60,6 @@ module Cells
       end
     end
 
-    
   end
 end
 

data/lib/cells/version.rb

@@ -1,5 +1,3 @@
-# encoding: utf-8
-
 module Cells
-  VERSION = '3.4.0.beta3'
+  VERSION = '3.4.0'
 end

data/test/active_helper_test.rb

@@ -1,4 +1,4 @@
-require File.join(File.dirname(__FILE__), 'test_helper')
+require 'test_helper'
 
 ### DISCUSS: how can we limit that test to systems where ActiveHelper's around?
 
@@ -54,4 +54,4 @@ class ActiveHelperTest < ActiveSupport::TestCase
       end
     end
   end
-end
+end

data/test/assertions_helper_test.rb

@@ -1,5 +1,4 @@
-# encoding: utf-8
-require File.join(File.dirname(__FILE__), 'test_helper')
+require 'test_helper'
 
 class AssertionsHelperTest < ActionController::TestCase
   context "A TestCase" do
@@ -30,4 +29,4 @@ class AssertionsHelperTest < ActionController::TestCase
       assert_equal({:topic => :peace}, cell(:bassist, :topic => :peace) { def opts; @opts; end }.opts)
     end
   end
-end
+end

data/test/cell_generator_test.rb

@@ -1,4 +1,4 @@
-require File.join(File.dirname(__FILE__), 'test_helper')
+require 'test_helper'
 
 require 'generators/cells/cell_generator'
 
@@ -50,4 +50,4 @@ class CellGeneratorTest < Rails::Generators::TestCase
       end
     end
   end
-end
+end

data/test/cell_module_test.rb

@@ -0,0 +1,30 @@
+require 'test_helper'
+
+class CellModuleTest < ActiveSupport::TestCase
+  context "Cell::Base" do
+    
+    should "provide AbstractBase.render_cell_for" do
+      assert_equal "Doo", Cell::Base.render_cell_for(@controller, :bassist, :play)
+    end
+    
+    should "provide possible_paths_for_state" do
+      assert_equal ["bad_guitarist/play", "bassist/play", "cell/rails/play"], cell(:bad_guitarist).possible_paths_for_state(:play)
+    end
+    
+    should "provide Cell.cell_name" do
+      assert_equal 'bassist', cell(:bassist).class.cell_name
+    end
+    
+    should "provide cell_name for modules, too" do
+      class SingerCell < Cell::Base
+      end
+      
+      assert_equal "cell_module_test/singer", CellModuleTest::SingerCell.cell_name
+    end
+    
+    
+    should "provide class_from_cell_name" do
+      assert_equal BassistCell, ::Cell::Base.class_from_cell_name('bassist')
+    end
+  end
+end

data/test/helper_test.rb

@@ -1,5 +1,4 @@
-# encoding: utf-8
-require File.join(File.dirname(__FILE__), 'test_helper')
+require 'test_helper'
 
 module StringHelper
   def pick; "plong"; end

data/test/rails/caching_test.rb

@@ -1,5 +1,4 @@
-# encoding: utf-8
-require File.join(File.dirname(__FILE__), '..', 'test_helper')
+require 'test_helper'
 
 class DirectorCell < Cell::Rails
   cache :count

data/test/rails/capture_test.rb

@@ -1,5 +1,4 @@
-# encoding: utf-8
-require File.join(File.dirname(__FILE__), '/../test_helper')
+require 'test_helper'
 
 class ProducerCell < Cell::Base
   helper ::Cells::Helpers::CaptureHelper
@@ -49,4 +48,4 @@ class RailsCaptureTest < ActionController::TestCase
       assert_equal "\n<pre>DummDooDiiDoo</pre>", @response.body
     end
   end
-end
+end

data/test/rails/cells_test.rb

@@ -1,5 +1,4 @@
-require File.join(File.dirname(__FILE__), '/../test_helper')
-
+require 'test_helper'
 
 class RailsCellsTest < ActiveSupport::TestCase
   context "A rails cell" do
@@ -16,11 +15,8 @@ class RailsCellsTest < ActiveSupport::TestCase
     
     context "invoking defaultize_render_options_for" do
       should "set default values" do
-        cell(:bassist).class.default_template_format = :html  ### FIXME: remove and get it working.
-        
         options = cell(:bassist).defaultize_render_options_for({}, :play)
         
-        assert_equal :html, options[:template_format]
         assert_equal :play, options[:view]
       end
       
@@ -61,7 +57,6 @@ class RailsCellsTest < ActiveSupport::TestCase
         @request = ActionController::TestRequest.new 
         @request.env["action_dispatch.request.request_parameters"] = {:song => "Creatures"}
         @cell = cell(:bassist)
-        @cell.request= @request
       end
       
       should_eventually "delegate log" do
@@ -85,4 +80,4 @@ class RailsCellsTest < ActiveSupport::TestCase
     end
     
   end   
-end
+end

data/test/rails/integration_test.rb

@@ -1,4 +1,4 @@
-require File.join(File.dirname(__FILE__), '/../test_helper')
+require 'test_helper'
 
 class RailsIntegrationTest < ActionController::TestCase
   tests MusicianController
@@ -36,4 +36,4 @@ class RailsIntegrationTest < ActionController::TestCase
     end
   end
   
-end
+end

data/test/rails/render_test.rb

@@ -1,4 +1,4 @@
-require File.join(File.dirname(__FILE__), '/../test_helper')
+require 'test_helper'
 require 'builder'
 
 class RailsRenderTest < ActiveSupport::TestCase
@@ -129,12 +129,10 @@ class RailsRenderTest < ActiveSupport::TestCase
       
       @request.env["action_dispatch.request.request_parameters"] = {:what => 'get'}
       @cell = cell(:bassist)
-      @cell.request = @request  ### FIXME.
       
       assert_equal "Come and get me!", @cell.render_state(:pose)
     end
     
     
   end
-  
-end
+end

data/test/rails/router_test.rb

@@ -28,4 +28,4 @@ module ApplicationTests
       end 
     end
   end
-end
+end

data/test/rails/view_test.rb

@@ -1,5 +1,4 @@
-# encoding: utf-8
-require File.join(File.dirname(__FILE__), '../test_helper')
+require 'test_helper'
 
 class RailsViewTest < ActiveSupport::TestCase
   context "A cell view" do
@@ -18,7 +17,6 @@ class RailsViewTest < ActiveSupport::TestCase
         assert_equal "Dumm Dooom", render_cell(:bassist, :compose)
       end
     end
-  
     
   end
-end
+end

metadata

@@ -1,14 +1,12 @@
 --- !ruby/object:Gem::Specification 
 name: cells
 version: !ruby/object:Gem::Version 
-  hash: 964335479
-  prerelease: true
+  prerelease: false
   segments: 
   - 3
   - 4
   - 0
-  - beta3
-  version: 3.4.0.beta3
+  version: 3.4.0
 platform: ruby
 authors: 
 - Nick Sutterer
@@ -16,11 +14,11 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-09-15 00:00:00 +02:00
+date: 2010-09-29 00:00:00 +02:00
 default_executable: 
 dependencies: []
 
-description: Cells are lightweight controllers for Rails and can be rendered in controllers and views, providing an elegant and fast way for encapsulation and component-orientation.
+description: Cells are lightweight controllers for Rails and can be rendered in views, providing an elegant and fast way for encapsulation and component-orientation.
 email: apotonick@gmail.com
 executables: []
 
@@ -38,7 +36,6 @@ files:
 - lib/cell.rb
 - lib/cell/active_helper.rb
 - lib/cell/base.rb
-- lib/cell/base_methods.rb
 - lib/cell/caching.rb
 - lib/cell/rails.rb
 - lib/cells.rb
@@ -53,45 +50,42 @@ files:
 - lib/generators/cells/templates/cell_test.rb
 - lib/generators/cells/templates/view.erb
 - lib/generators/cells/templates/view.haml
-- lib/generators/cells_install/USAGE
-- lib/generators/cells_install/cells_install_generator.rb
-- lib/generators/cells_install/templates/initializer.rb
+- test/active_helper_test.rb
 - test/assertions_helper_test.rb
+- test/rails/router_test.rb
+- test/rails/view_test.rb
+- test/rails/capture_test.rb
+- test/rails/integration_test.rb
+- test/rails/render_test.rb
+- test/rails/cells_test.rb
+- test/rails/caching_test.rb
+- test/cell_generator_test.rb
 - test/test_helper.rb
-- test/app/cells/bad_guitarist_cell.rb
-- test/app/cells/bassist_cell.rb
-- test/app/cells/test_cell.rb
-- test/app/helpers/helper_using_cell_helper.rb
-- test/app/helpers/application_helper.rb
-- test/dummy/app/controllers/application_controller.rb
-- test/dummy/app/controllers/musician_controller.rb
-- test/dummy/app/helpers/application_helper.rb
-- test/dummy/config/environments/test.rb
-- test/dummy/config/environments/production.rb
-- test/dummy/config/environments/development.rb
-- test/dummy/config/boot.rb
-- test/dummy/config/environment.rb
-- test/dummy/config/initializers/secret_token.rb
-- test/dummy/config/initializers/backtrace_silencers.rb
+- test/support/internal_assertions_helper.rb
+- test/dummy/config/application.rb
 - test/dummy/config/initializers/session_store.rb
 - test/dummy/config/initializers/mime_types.rb
+- test/dummy/config/initializers/secret_token.rb
 - test/dummy/config/initializers/inflections.rb
-- test/dummy/config/application.rb
+- test/dummy/config/initializers/backtrace_silencers.rb
 - test/dummy/config/routes.rb
-- test/dummy/tmp/app/cells/blog_cell.rb
+- test/dummy/config/boot.rb
+- test/dummy/config/environment.rb
+- test/dummy/config/environments/production.rb
+- test/dummy/config/environments/test.rb
+- test/dummy/config/environments/development.rb
 - test/dummy/tmp/test/cells/blog_cell_test.rb
-- test/base_methods_test.rb
-- test/active_helper_test.rb
-- test/support/internal_assertions_helper.rb
-- test/rails/render_test.rb
-- test/rails/view_test.rb
-- test/rails/caching_test.rb
-- test/rails/cells_test.rb
-- test/rails/integration_test.rb
-- test/rails/router_test.rb
-- test/rails/capture_test.rb
+- test/dummy/tmp/app/cells/blog_cell.rb
+- test/dummy/app/controllers/musician_controller.rb
+- test/dummy/app/controllers/application_controller.rb
+- test/dummy/app/helpers/application_helper.rb
 - test/helper_test.rb
-- test/cell_generator_test.rb
+- test/cell_module_test.rb
+- test/app/cells/bassist_cell.rb
+- test/app/cells/test_cell.rb
+- test/app/cells/bad_guitarist_cell.rb
+- test/app/helpers/application_helper.rb
+- test/app/helpers/helper_using_cell_helper.rb
 has_rdoc: true
 homepage: http://cells.rubyforge.org
 licenses: []
@@ -106,62 +100,58 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
       segments: 
       - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
   requirements: 
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version 
-      hash: 25
       segments: 
-      - 1
-      - 3
-      - 1
-      version: 1.3.1
+      - 0
+      version: "0"
 requirements: []
 
 rubyforge_project: 
 rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
-summary: Cells are lightweight controllers for Rails and can be rendered in controllers and views, providing an elegant and fast way for encapsulation and component-orientation.
+summary: View Components for Rails.
 test_files: 
+- test/active_helper_test.rb
 - test/assertions_helper_test.rb
+- test/rails/router_test.rb
+- test/rails/view_test.rb
+- test/rails/capture_test.rb
+- test/rails/integration_test.rb
+- test/rails/render_test.rb
+- test/rails/cells_test.rb
+- test/rails/caching_test.rb
+- test/cell_generator_test.rb
 - test/test_helper.rb
-- test/app/cells/bad_guitarist_cell.rb
-- test/app/cells/bassist_cell.rb
-- test/app/cells/test_cell.rb
-- test/app/helpers/helper_using_cell_helper.rb
-- test/app/helpers/application_helper.rb
-- test/dummy/app/controllers/application_controller.rb
-- test/dummy/app/controllers/musician_controller.rb
-- test/dummy/app/helpers/application_helper.rb
-- test/dummy/config/environments/test.rb
-- test/dummy/config/environments/production.rb
-- test/dummy/config/environments/development.rb
-- test/dummy/config/boot.rb
-- test/dummy/config/environment.rb
-- test/dummy/config/initializers/secret_token.rb
-- test/dummy/config/initializers/backtrace_silencers.rb
+- test/support/internal_assertions_helper.rb
+- test/dummy/config/application.rb
 - test/dummy/config/initializers/session_store.rb
 - test/dummy/config/initializers/mime_types.rb
+- test/dummy/config/initializers/secret_token.rb
 - test/dummy/config/initializers/inflections.rb
-- test/dummy/config/application.rb
+- test/dummy/config/initializers/backtrace_silencers.rb
 - test/dummy/config/routes.rb
-- test/dummy/tmp/app/cells/blog_cell.rb
+- test/dummy/config/boot.rb
+- test/dummy/config/environment.rb
+- test/dummy/config/environments/production.rb
+- test/dummy/config/environments/test.rb
+- test/dummy/config/environments/development.rb
 - test/dummy/tmp/test/cells/blog_cell_test.rb
-- test/base_methods_test.rb
-- test/active_helper_test.rb
-- test/support/internal_assertions_helper.rb
-- test/rails/render_test.rb
-- test/rails/view_test.rb
-- test/rails/caching_test.rb
-- test/rails/cells_test.rb
-- test/rails/integration_test.rb
-- test/rails/router_test.rb
-- test/rails/capture_test.rb
+- test/dummy/tmp/app/cells/blog_cell.rb
+- test/dummy/app/controllers/musician_controller.rb
+- test/dummy/app/controllers/application_controller.rb
+- test/dummy/app/helpers/application_helper.rb
 - test/helper_test.rb
-- test/cell_generator_test.rb
+- test/cell_module_test.rb
+- test/app/cells/bassist_cell.rb
+- test/app/cells/test_cell.rb
+- test/app/cells/bad_guitarist_cell.rb
+- test/app/helpers/application_helper.rb
+- test/app/helpers/helper_using_cell_helper.rb

data/lib/cell/base_methods.rb

@@ -1,100 +0,0 @@
-module Cell
-  module BaseMethods
-    def self.included(base)
-      base.extend ClassMethods
-      
-      ### DISCUSS: move that to Rails?
-      base.class_attribute :default_template_format
-      base.default_template_format = :html
-    end
-    
-    module ClassMethods
-      def render_cell_for(controller, name, state, opts={})
-        create_cell_for(controller, name, opts).render_state(state) # FIXME: don't let BaseMethods know about controller's API.
-      end
-      
-      # Creates a cell instance of the class <tt>name</tt>Cell, passing through
-      # <tt>opts</tt>.
-      def create_cell_for(controller, name, opts={})
-        #class_from_cell_name(name).new(controller, opts)
-        class_from_cell_name(name).new(controller, opts)
-      end
-      
-      # Return the default view for the given state on this cell subclass.
-      # This is a file with the name of the state under a directory with the
-      # name of the cell followed by a template extension.
-      def view_for_state(state)
-        "#{cell_name}/#{state}"
-      end
-
-      # Find a possible template for a cell's current state.  It tries to find a
-      # template file with the name of the state under a subdirectory
-      # with the name of the cell under the <tt>app/cells</tt> directory.
-      # If this file cannot be found, it will try to call this method on
-      # the superclass.  This way you only have to write a state template
-      # once when a more specific cell does not need to change anything in
-      # that view.
-      def find_class_view_for_state(state)
-        return [view_for_state(state)] unless superclass.respond_to?(:find_class_view_for_state)
-
-        superclass.find_class_view_for_state(state) << view_for_state(state)
-      end
-
-      # Get the name of this cell's class as an underscored string,
-      # with _cell removed.
-      #
-      # Example:
-      #  UserCell.cell_name
-      #  => "user"
-      def cell_name
-        name.underscore.sub(/_cell$/, '')
-      end
-      
-      def class_from_cell_name(cell_name)
-        "#{cell_name}_cell".classify.constantize
-      end
-    end
-    
-    
-    
-    
-    
-    attr_accessor :controller
-    attr_reader   :state_name
-
-    def initialize(options={})
-      #@controller = controller
-      @opts       = options
-    end
-
-    def cell_name
-      self.class.cell_name
-    end
-
-    # Invoke the state method and render the given state.
-    def render_state(state, controller=nil)
-      @cell       = self
-      @state_name = state
-
-      dispatch_state(state)
-    end
-
-    # Call the state method.
-    def dispatch_state(state)
-      send(state)
-    end
-    
-    # Find possible files that belong to the state.  This first tries the cell's
-    # <tt>#view_for_state</tt> method and if that returns a true value, it
-    # will accept that value as a string and interpret it as a pathname for
-    # the view file. If it returns a falsy value, it will call the Cell's class
-    # method find_class_view_for_state to determine the file to check.
-    #
-    # You can override the ::Cell::Base#view_for_state method for a particular
-    # cell if you wish to make it decide dynamically what file to render.
-    def possible_paths_for_state(state)
-      self.class.find_class_view_for_state(state).reverse!
-    end
-      
-  end
-end

data/lib/generators/cells_install/USAGE

@@ -1,3 +0,0 @@
-To copy a Cells initializer to your current Rails app - with some configuration values - just do:
-
-    script/generate cells_install

data/lib/generators/cells_install/cells_install_generator.rb

@@ -1,12 +0,0 @@
-# encoding: utf-8
-
-class CellsInstallGenerator < Rails::Generator::Base
-
-  def manifest
-    record do |m|
-      m.directory File.join('config', 'initializers')
-      m.template  'initializer.rb', File.join('config', 'initializers', 'cells.rb')
-    end
-  end
-
-end

data/lib/generators/cells_install/templates/initializer.rb

@@ -1,9 +0,0 @@
-# encoding: utf-8
-
-if defined?(Cells)
-  # Use this hook to configure Cells.
-  Cells.setup do |config|
-    # Configure view paths that Cells should scan for cell views.
-    # config.view_paths << Rails.root.join('app', 'views')
-  end
-end

data/test/base_methods_test.rb

@@ -1,40 +0,0 @@
-require File.join(File.dirname(__FILE__), 'test_helper')
-
-class BaseMethodsTest < ActiveSupport::TestCase
-  context "Cell::Base" do
-    
-    should "provide AbstractBase.render_cell_for" do
-      assert_equal "Doo", Cell::Base.render_cell_for(@controller, :bassist, :play)
-    end
-    
-    should "provide possible_paths_for_state" do
-      assert_equal ["bad_guitarist/play", "bassist/play", "cell/rails/play"], cell(:bad_guitarist).possible_paths_for_state(:play)
-    end
-    
-    should "provide cell_name" do
-      assert_equal 'bassist', cell(:bassist).cell_name
-      assert_equal cell(:bassist).cell_name, BassistCell.cell_name
-    end
-    
-    should "provide cell_name for modules, too" do
-      class SingerCell
-        include Cell::BaseMethods
-      end
-      
-      assert_equal "base_methods_test/singer", BaseMethodsTest::SingerCell.cell_name
-    end
-    
-    
-    should "provide class_from_cell_name" do
-      assert_equal BassistCell, ::Cell::Base.class_from_cell_name('bassist')
-    end
-    
-    should "provide AbstractBase.default_template_format" do
-      cell(:bassist).class.default_template_format = :js
-      
-      assert_equal :html, ::Cell::Base.default_template_format
-      assert_equal :js, cell(:bassist).class.default_template_format
-    end
-    
-  end
-end