cells 3.8.8 → 3.9.0

metadata

@@ -1,144 +1,113 @@
 --- !ruby/object:Gem::Specification
 name: cells
 version: !ruby/object:Gem::Version
-  version: 3.8.8
-  prerelease: 
+  version: 3.9.0
 platform: ruby
 authors:
 - Nick Sutterer
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-10 00:00:00.000000000 Z
+date: 2013-10-22 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actionpack
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '3.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '3.0'
 - !ruby/object:Gem::Dependency
   name: railties
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '3.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '3.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: haml
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: slim
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: simple_form
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: tzinfo
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: 2.8.1
+        version: 4.7.5
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: 2.8.1
+        version: 4.7.5
 description: Cells are view components for Rails. They are lightweight controllers,
   can be rendered in views and thus provide an elegant and fast way for encapsulation
   and component-orientation.
@@ -152,20 +121,23 @@ files:
 - .travis.yml
 - CHANGES.textile
 - Gemfile
-- README.rdoc
+- README.md
 - Rakefile
-- about.yml
 - cells.gemspec
 - gemfiles/Gemfile.rails3-0
 - gemfiles/Gemfile.rails3-1
 - gemfiles/Gemfile.rails3-2
+- gemfiles/Gemfile.rails4-0
+- lib/cell.rb
 - lib/cell/base.rb
 - lib/cell/builder.rb
 - lib/cell/caching.rb
 - lib/cell/deprecations.rb
+- lib/cell/dsl.rb
 - lib/cell/rack.rb
 - lib/cell/rails.rb
 - lib/cell/rails/helper_api.rb
+- lib/cell/rails/view_model.rb
 - lib/cell/rails3_0_strategy.rb
 - lib/cell/rails3_1_strategy.rb
 - lib/cell/rails4_0_strategy.rb
@@ -215,15 +187,22 @@ files:
 - test/app/cells/club_security/medic_cell.rb
 - test/app/cells/layouts/b.erb
 - test/app/cells/layouts/metal.html.erb
-- test/app/cells/producer/capture.html.erb
-- test/app/cells/producer/content_for.html.erb
 - test/app/cells/rails_helper_api_test/bassist/edit.html.erb
 - test/app/cells/shouter/sing.html.erb
+- test/app/cells/song/dashboard.haml
+- test/app/cells/song/details.html.haml
+- test/app/cells/song/info.html.haml
+- test/app/cells/song/lyrics.html.haml
+- test/app/cells/song/plays.haml
+- test/app/cells/song/show.html.haml
+- test/app/cells/song/title.html.haml
 - test/app/cells/trumpeter/promote.html.erb
 - test/app/cells/trumpeter_cell.rb
+- test/app/cells/view_model_test/comments/show.haml
 - test/app/views/shared/_dong.html.erb
 - test/cell_generator_test.rb
 - test/cell_module_test.rb
+- test/cell_test.rb
 - test/cells_module_test.rb
 - test/deprecations_test.rb
 - test/dummy/Rakefile
@@ -234,6 +213,7 @@ files:
 - test/dummy/app/views/musician/featured.html.erb
 - test/dummy/app/views/musician/featured_with_block.html.erb
 - test/dummy/app/views/musician/hamlet.html.haml
+- test/dummy/app/views/musician/title.erb
 - test/dummy/config.ru
 - test/dummy/config/application.rb
 - test/dummy/config/boot.rb
@@ -256,37 +236,37 @@ files:
 - test/helper_test.rb
 - test/rack_test.rb
 - test/rails/caching_test.rb
-- test/rails/capture_test.rb
 - test/rails/cells_test.rb
 - test/rails/integration_test.rb
 - test/rails/render_test.rb
 - test/rails/router_test.rb
+- test/rails/view_model_test.rb
 - test/rails/view_test.rb
 - test/rails_helper_api_test.rb
 - test/test_case_test.rb
 - test/test_helper.rb
 homepage: http://cells.rubyforge.org
-licenses: []
+licenses:
+- MIT
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.24
+rubygems_version: 2.0.3
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: View Components for Rails.
 test_files: []

data/README.rdoc

@@ -1,279 +0,0 @@
-= Cells
-
-<em>View Components for Rails.</em>
-
-{<img src="https://secure.travis-ci.org/apotonick/cells.png" />}[http://travis-ci.org/apotonick/cells]
-
-== Overview
-
-Say you're writing a Rails online shop - the shopping cart is reappearing again and again in every view. You're thinking about a clean solution for that part. A mixture of controller code, before-filters, partials and helpers?
-
-No. That sucks. Take Cells.
-
-Cells are View Components for Rails. They look and feel like controllers. They don't have no +DoubleRenderError+. They can be rendered everywhere in your controllers or views. They are cacheable, testable, fast and wonderful. They bring back OOP to your view and improve your software design.
-
-And the best: You can have as many cells in your page as you need!
-
-== Installation
-
-It's a gem!
-
-Rails >= 3.0:
-
-  gem install cells
-
-Rails 2.3:
-
-  gem install cells -v 3.3.9
-
-
-== Generate
-
-Creating a cell is nothing more than
-
-  $ rails generate cell cart show -e haml
-    create  app/cells/
-    create  app/cells/cart
-    create  app/cells/cart_cell.rb
-    create  app/cells/cart/show.html.haml
-    create  test/cells/cart_test.rb
-
-That looks very familiar.
-
-== Render the cell
-
-Now, render your cart. Why not put it in <tt>layouts/application.html.erb</tt> for now?
-
-  <div id="header">
-    <%= render_cell :cart, :show, :user => @current_user %>
-
-Feels like rendering a controller action. For good encapsulation we pass the current +user+ from outside into the cell - a dependency injection.
-
-== Code
-
-Time to improve our cell code. Let's start with <tt>app/cells/cart_cell.rb</tt>:
-
-  class CartCell < Cell::Rails
-    def show(args)
-      user    = args[:user]
-      @items  = user.items_in_cart
-
-      render  # renders show.html.haml
-    end
-  end
-
-Is that a controller? Hell, yeah. We even got a +#render+ method as we know it from the good ol' +ActionController+.
-
-
-== Views
-
-Since a plain call to +#render+ will start rendering <tt>app/cells/cart/show.html.haml</tt> we should put some meaningful markup there.
-
-  #cart
-    You have #{@items.size} items in your shopping cart.
-
-=== ERB? Haml? Builder?
-
-Yes, Cells support all template types that are supported by Rails itself. Remember- it's a controller!
-
-=== Helpers
-
-Yes, Cells have helpers just like controllers. If you need some specific helper, do
-
-  class CartCell < Cell::Rails
-    helper MyExtraHelper
-
-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'
-
-=== Rendering Global Partials
-
-Sometimes you need to render a global partial from <tt>app/views</tt> within a cell. For instance, the +gmaps4rails+ helper depends on a global partial. While this breaks encapsulation it's still possible in cells - just add the global view path.
-
-  class MapCell < Cell::Rails
-    append_view_path "app/views"
-
-
-== View Inheritance
-
-This is where OOP comes back to your view.
-
-* <b>Inherit code</b> into your cells by deriving more abstract cells.
-* <b>Inherit views</b> from parent cells.
-
-=== Builders
-
-Let +render_cell+ take care of creating the right cell. Just configure your super-cell properly.
-
-  class LoginCell < Cell::Rails
-    build do
-      UnauthorizedUserCell unless logged_in?
-    end
-
-A call to
-
-  render_cell(:login, :box)
-
-will render the configured +UnauthorizedUserCell+ instead of the original +LoginCell+ if the login test fails.
-
-
-== Caching
-
-Cells do strict view caching. No cluttered fragment caching. Add
-
-  class CartCell < Cell::Rails
-    cache :show, :expires_in => 10.minutes
-
-and your cart will be re-rendered after 10 minutes.
-
-You can expand the state's cache key - why not use a versioner block to do just this?
-
-  class CartCell < Cell::Rails
-    cache :show do |cell, options|
-      options[:items].md5
-    end
-
-The block's return value is appended to the state key: <tt>"cells/cart/show/0ecb1360644ce665a4ef"</tt>.
-
-Check the {API to learn more}[http://rdoc.info/gems/cells/Cell/Caching/ClassMethods#cache-instance_method].
-
-== Testing
-
-Another big advantage compared to monolithic controller/helper/partial piles is the ability to test your cells isolated.
-
-=== Test::Unit
-
-So what if you wanna test the cart cell? Use the generated <tt>test/cells/cart_cell_test.rb</tt> test.
-
-  class CartCellTest < Cell::TestCase
-    test "show" do
-      invoke :show, :user => @user_fixture
-      assert_select "#cart", "You have 3 items in your shopping cart."
-    end
-
-Don't forget to put <tt>require 'cell/test_case'</tt> in your project's <tt>test/test_helper.rb</tt> file.
-
-Then, run your tests with
-
-  $ rake test:cells
-
-That's easy, clean and strongly improves your component-driven software quality. How'd you do that with partials?
-
-
-=== RSpec
-
-If you prefer RSpec examples, use the {rspec-cells}[http://github.com/apotonick/rspec-cells] gem for specing.
-
-  it "should render the posts count" do
-    render_cell(:posts, :count).should have_selector("p", :content => "4 posts!")
-  end
-
-To run your specs we got a rake task, too!
-
-  $ rake spec:cells
-
-
-== Mountable Cells
-
-Cells 3.8 got rid of the ActionController dependency. This essentially means you can mount Cells to routes or use them like a Rack middleware. All you need to do is derive from Cell::Base.
-
-  class PostCell < Cell::Base
-  	..
-
-In your <tt>routes.rb</tt> file, mount the cell like a Rack app.
-
-  match "/posts" => proc { |env|
-    [ 200, {}, [ Cell::Base.render_cell_for(:post, :show) ]]
-  }
-
-=== Cells in ActionMailer
-
-ActionMailer doesn't have request object, so if you inherit from Cell::Rails you will receive an error. Cell::Base will fix that problem, but you will not be able to use any of routes inside your cells.
-
-You can fix that with {actionmailer_with_request}[https://github.com/weppos/actionmailer_with_request] which (suprise!) brings request object to the ActionMailer.
-
-== Using Rails Gems Like simple_form Outside Of Rails
-
-Cells can be used outside of Rails. A new module brought in 3.8.5 provides the Rails view "API" making it possible to use gems like  the popular {simple_form}[https://github.com/plataformatec/simple_form] outside Rails!
-
-All you need to do is providing the cell with some helpers, usually it's the polymorphic routing paths required by the gems.
-
-  module RoutingHelpers
-    def musician_path(model)
-      "/musicians/#{model.id}"
-    end
-  end
-
-Then, use the Cell::Rails::HelperAPI module and it should work fine (depending on the quality of the gem you're desiring to use).
-
-  require 'cell/base'
-  require "cell/rails/helper_api"
-  require "simple_form"
-
-  class BassistCell < Cell::Base
-    include Cell::Rails::HelperAPI
-
-    self._helpers = RoutingHelpers
-
-    def show
-      @musician = Musician.find(:first)
-    end
-  end
-
-Your views can now use the gem's helpers.
-
-  <%= simple_form_for @musician do |f| %>
-    <%= f.input :name %>
-    <%= f.button :submit %>
-  <% end %>
-
-Note that this currently "only" works with Rails 3.2-4.0.
-
-== Cells is Rails::Engine aware!
-
-Now <tt>Rails::Engine</tt>s can contribute to Cells view paths. By default, any 'app/cells' found inside any Engine is automatically included into Cells view paths. If you need to, you can customize the view paths changing/appending to the <tt>'app/cell_views'</tt> path configuration. See the @Cell::EngineIntegration@ for more details.
-
-== Generators
-
-By default, generated cells inherit from <code>Cell::Rails</code>. If you want to change this, specify your new class name in <code>config/application.rb</code>:
-
-    module MyApp
-      class Application < Rails::Application
-        config.generators do |g|
-          g.base_cell_class "ApplicationCell"
-        end
-      end
-    end
-
-== Rails 2.3 note
-
-In order to copy the cells rake tasks to your app, run
-
-  $ script/generate cells_install
-
-
-== More features
-
-Cells can do more.
-
-<b>No Limits</b>::  Have as many cells in your page as you need - no limitation to your +render_cell+ calls.
-<b>Cell Nesting</b>:: Have complex cell hierarchies as you can call +render_cell+ within cells, too.
-
-Go for it, you'll love it!
-
-
-== LICENSE
-
-Copyright (c) 2007-2011, Nick Sutterer
-
-Copyright (c) 2007-2008, Solide ICT by Peter Bex and Bob Leers
-
-Released under the MIT License.