draper 0.18.0 → 1.0.0

data/.gitignore

@@ -6,8 +6,11 @@ pkg/*
 coverage.data
 coverage/*
 .yardoc
+doc/*
 tmp
 vendor/bundle
 *.swp
 *.swo
 *.DS_Store
+spec/dummy/log/*
+spec/dummy/db/*.sqlite3

data/.travis.yml

@@ -1,4 +1,15 @@
+language: ruby
 rvm:
   - 1.9.3
   - rbx-19mode
   - jruby-19mode
+  - ruby-head
+env:
+  - "RAILS_VERSION=3.2"
+  - "RAILS_VERSION=3.1"
+  - "RAILS_VERSION=3.0"
+  - "RAILS_VERSION=master"
+matrix:
+  allow_failures:
+    - rvm: ruby-head
+    - env: "RAILS_VERSION=master"

data/.yardopts

@@ -1 +1 @@
-yardoc 'lib/draper/**/*.rb' -m markdown
+yardoc 'lib/draper/**/*.rb' -m markdown --no-private

data/CHANGELOG.md

@@ -0,0 +1,161 @@
+# Draper Changelog
+
+## 1.0.0
+
+* Infer collection decorators. [https://github.com/drapergem/draper/commit/e8253df7dc6c90a542444c0f4ef289909fce4f90](https://github.com/drapergem/draper/commit/e8253df7dc6c90a542444c0f4ef289909fce4f90)
+
+* Prevent calls to `scoped` on decorated associations. [https://github.com/drapergem/draper/commit/5dcc6c31ecf408753158d15fed9fb23fbfdc3734](https://github.com/drapergem/draper/commit/5dcc6c31ecf408753158d15fed9fb23fbfdc3734)
+
+* Add `helper` method to tests. [https://github.com/drapergem/draper/commit/551961e72ee92355bc9c848bedfcc573856d12b0](https://github.com/drapergem/draper/commit/551961e72ee92355bc9c848bedfcc573856d12b0)
+
+* Inherit method security. [https://github.com/drapergem/draper/commit/1865ed3e3b2b34853689a60b59b8ce9145674d1d](https://github.com/drapergem/draper/commit/1865ed3e3b2b34853689a60b59b8ce9145674d1d)
+
+* Test against all versions of Rails 3. [https://github.com/drapergem/draper/commit/1865ed3e3b2b34853689a60b59b8ce9145674d1d](https://github.com/drapergem/draper/commit/1865ed3e3b2b34853689a60b59b8ce9145674d1d)
+
+* Pretend to be `instance_of?(source.class)` [https://github.com/drapergem/draper/commit/30d209f990847e84b221ac798e84b976f5775cc0](https://github.com/drapergem/draper/commit/30d209f990847e84b221ac798e84b976f5775cc0)
+
+* Remove security from `Decorator`. Do manual delegation with `:delegate`. [https://github.com/drapergem/draper/commit/c6f8aaa2b2bd4679738050aede2503aa8e9db130](https://github.com/drapergem/draper/commit/c6f8aaa2b2bd4679738050aede2503aa8e9db130)
+
+* Add generators for MiniTest. [https://github.com/drapergem/draper/commit/1fac02b65b15e32f06e8292cb858c97cb1c1da2c](https://github.com/drapergem/draper/commit/1fac02b65b15e32f06e8292cb858c97cb1c1da2c)
+
+* Test against edge rails. [https://github.com/drapergem/draper/commit/e9b71e3cf55a800b48c083ff257a7c1cbe1b601b](https://github.com/drapergem/draper/commit/e9b71e3cf55a800b48c083ff257a7c1cbe1b601b)
+
+## 1.0.0.beta6
+
+* Fix up README to include changes made. [https://github.com/drapergem/draper/commit/5e6e4d11b1e0c07c12b6b1e87053bc3f50ef2ab6](https://github.com/drapergem/draper/commit/5e6e4d11b1e0c07c12b6b1e87053bc3f50ef2ab6)
+
+* `CollectionDecorator` no longer freezes its collection: direct access is discouraged by making access private [https://github.com/drapergem/draper/commit/c6d60e6577ed396385f3f1151c3f188fe47e9a57](https://github.com/drapergem/draper/commit/c6d60e6577ed396385f3f1151c3f188fe47e9a57)
+
+* A fix for `Decoratable#==` [https://github.com/drapergem/draper/commit/e4fa239d84e8e9d6a490d785abb3953acc28fa65](https://github.com/drapergem/draper/commit/e4fa239d84e8e9d6a490d785abb3953acc28fa65)
+
+* Ensure we coerce to an array in the right place. [https://github.com/drapergem/draper/commit/9eb9fc909c372ea1c2392d05594fa75a5c08b095](https://github.com/drapergem/draper/commit/9eb9fc909c372ea1c2392d05594fa75a5c08b095)
+
+## 1.0.0.beta5
+
+* Change CollectionDecorator to freeze its collection [https://github.com/drapergem/draper/commit/04d779615c43580409083a71661489e1bbf91ad4](https://github.com/drapergem/draper/commit/04d779615c43580409083a71661489e1bbf91ad4)
+
+* Bugfix on `CollectionDecorator#to_s` [https://github.com/drapergem/draper/commit/eefd7d09cac97d531b9235246378c3746d153f08](https://github.com/drapergem/draper/commit/eefd7d09cac97d531b9235246378c3746d153f08)
+
+* Upgrade `request_store` dependency to take advantage of a bugfix [https://github.com/drapergem/draper/commit/9f17212fd1fb656ef1314327d60fe45e0acf60a2](https://github.com/drapergem/draper/commit/9f17212fd1fb656ef1314327d60fe45e0acf60a2)
+
+## 1.0.0.beta4
+
+* Fixed a race condition with capybara integration. [https://github.com/drapergem/draper/commit/e79464931e7b98c85ed5d78ed9ca38d51f43006e](https://github.com/drapergem/draper/commit/e79464931e7b98c85ed5d78ed9ca38d51f43006e)
+
+* `[]` can be decorated again. [https://github.com/drapergem/draper/commit/597fbdf0c80583f5ea6df9f7350fefeaa0cca989](https://github.com/drapergem/draper/commit/597fbdf0c80583f5ea6df9f7350fefeaa0cca989)
+
+* `model == decorator` as well as `decorator == model`. [https://github.com/drapergem/draper/commit/46f8a6823c50c13e5c9ab3c07723f335c4e291bc](https://github.com/drapergem/draper/commit/46f8a6823c50c13e5c9ab3c07723f335c4e291bc)
+
+* Preliminary Mongoid integration. [https://github.com/drapergem/draper/commit/892d1954202c61fd082a07213c8d4a23560687bc](https://github.com/drapergem/draper/commit/892d1954202c61fd082a07213c8d4a23560687bc)
+
+* Add a helper method `sign_in` for devise in decorator specs. [https://github.com/drapergem/draper/commit/66a30093ed4207d02d8fa60bda4df2da091d85a3](https://github.com/drapergem/draper/commit/66a30093ed4207d02d8fa60bda4df2da091d85a3)
+
+* Brought back `context`. [https://github.com/drapergem/draper/commit/9609156b997b3a469386eef3a5f043b24d8a2fba](https://github.com/drapergem/draper/commit/9609156b997b3a469386eef3a5f043b24d8a2fba)
+
+* Fixed issue where classes were incorrectly being looked up. [https://github.com/drapergem/draper/commit/ee2a015514ff87dfd2158926457e988c2fc3fd79](https://github.com/drapergem/draper/commit/ee2a015514ff87dfd2158926457e988c2fc3fd79)
+
+* Integrate RequestStore for per-request storage. [https://github.com/drapergem/draper/commit/fde1cde9adfb856750c1f616d8b62d221ef97fc6](https://github.com/drapergem/draper/commit/fde1cde9adfb856750c1f616d8b62d221ef97fc6)
+
+## 1.0.0.beta3
+
+* Relaxed Rails version requirement to 3.0. Support for < 3.2 should be
+  considered experimental. Please file bug reports.
+
+## 1.0.0.beta2
+
+* `has_finders` is now `decorates_finders`. [https://github.com/drapergem/draper/commit/33f18aa062e0d3848443dbd81047f20d5665579f](https://github.com/drapergem/draper/commit/33f18aa062e0d3848443dbd81047f20d5665579f)
+
+* If a finder method is used, and the source class is not set and cannot be inferred, an `UninferrableSourceError` is raised. [https://github.com/drapergem/draper/commit/8ef5bf2f02f7033e3cd4f1f5de7397b02c984fe3](https://github.com/drapergem/draper/commit/8ef5bf2f02f7033e3cd4f1f5de7397b02c984fe3)
+
+* Class methods are now properly delegated again. [https://github.com/drapergem/draper/commit/731995a5feac4cd06cf9328d2892c0eca9992db6](https://github.com/drapergem/draper/commit/731995a5feac4cd06cf9328d2892c0eca9992db6)
+
+* We no longer `respond_to?` private methods on the source. [https://github.com/drapergem/draper/commit/18ebac81533a6413aa20a3c26f23e91d0b12b031](https://github.com/drapergem/draper/commit/18ebac81533a6413aa20a3c26f23e91d0b12b031)
+
+* Rails versioning relaxed to support Rails 4 [https://github.com/drapergem/draper/commit/8bfd393b5baa7aa1488076a5e2cb88648efaa815](https://github.com/drapergem/draper/commit/8bfd393b5baa7aa1488076a5e2cb88648efaa815)
+
+## 1.0.0.beta1
+
+* Renaming `Draper::Base` to `Draper::Decorator`. This is the most significant
+  change you'll need to upgrade your application. [https://github.com/drapergem/draper/commit/025742cb3b295d259cf0ecf3669c24817d6f2df1](https://github.com/drapergem/draper/commit/025742cb3b295d259cf0ecf3669c24817d6f2df1)
+* Added an internal Rails application for integration tests. This won't affect
+  your application, but we're now running a set of Cucumber tests inside of a
+  Rails app in both development and production mode to help ensure that we
+  don't make changes that break Draper. [https://github.com/drapergem/draper/commit/90a4859085cab158658d23d77cd3108b6037e36f](https://github.com/drapergem/draper/commit/90a4859085cab158658d23d77cd3108b6037e36f)
+* Add `#decorated?` method. This gives us a free RSpec matcher,
+  `be_decorated`. [https://github.com/drapergem/draper/commit/834a6fd1f24b5646c333a04a99fe9846a58965d6](https://github.com/drapergem/draper/commit/834a6fd1f24b5646c333a04a99fe9846a58965d6)
+* `#decorates` is no longer needed inside your models, and should be removed.
+  Decorators automatically infer the class they decorate. [https://github.com/drapergem/draper/commit/e1214d97b62f2cab45227cc650029734160dcdfe](https://github.com/drapergem/draper/commit/e1214d97b62f2cab45227cc650029734160dcdfe)
+* Decorators do not automatically come with 'finders' by default. If you'd like
+  to use `SomeDecorator.find(1)`, for example, simply add `#has_finders` to
+  the decorator to include them. [https://github.com/drapergem/draper/commit/42b6f78fda4f51845dab4d35da68880f1989d178](https://github.com/drapergem/draper/commit/42b6f78fda4f51845dab4d35da68880f1989d178)
+* To refer to the object being decorated, `#source` is now the preferred
+  method. [https://github.com/drapergem/draper/commit/1e84fcb4a0eab0d12f5feda6886ce1caa239cb16](https://github.com/drapergem/draper/commit/1e84fcb4a0eab0d12f5feda6886ce1caa239cb16)
+* `ActiveModel::Serialization` is included in Decorators if you've requred
+  `ActiveModel::Serializers`, so that decorators can be serialized. [https://github.com/drapergem/draper/commit/c4b352799067506849abcbf14963ea36abda301c](https://github.com/drapergem/draper/commit/c4b352799067506849abcbf14963ea36abda301c)
+* Properly support Test::Unit [https://github.com/drapergem/draper/commit/087e134ed0885ec11325ffabe8ab2bebef77a33a](https://github.com/drapergem/draper/commit/087e134ed0885ec11325ffabe8ab2bebef77a33a)
+
+And many small bug fixes and refactorings.
+
+## 0.18.0
+
+* [Adds the ability to decorate an enumerable proxy](https://github.com/drapergem/draper/commit/67c7125192740a7586a3a635acd735ae01b97837)
+
+* Many bug fixes.
+
+* Last version of Draper in the 0.x series.
+
+## 0.17.0
+
+* [Fix earlier fix of `view_context` priming](https://github.com/drapergem/draper/commit/5da44336)
+* [Add `denies_all`](https://github.com/drapergem/draper/commit/148e732)
+* [Properly proxy associations with regard to `find`](https://github.com/drapergem/draper/commit/d46d19205e)
+
+## 0.16.0
+
+* [Automatically prime `view_context`](https://github.com/drapergem/draper/commit/057ab4e8)
+* [Fixed bug where rspec eq matchers didn't work]((https://github.com/drapergem/draper/commit/57617b)
+* [Sequel ORM support](https://github.com/drapergem/draper/commit/7d4942)
+* Fixed issues with newer minitest
+* [Changed the way the `view_context` gets set](https://github.com/drapergem/draper/commit/0b03d9c)
+
+## 0.15.0
+
+* Proper minitest integration
+* [We can properly decorate scoped associations](https://github.com/drapergem/draper/issues/223)
+* [Fixed awkward eager loading](https://github.com/drapergem/draper/commit/7dc3510b)
+
+## 0.14.0
+
+* [Properly prime the view context in Rails Console](https://github.com/drapergem/draper/commit/738074f)
+* Make more gems development requirements only
+
+## 0.13.0
+
+* Upgraded all dependencies
+* Dropped support for Rubies < 1.9.3
+* `#to_model` has been renamed to `#wrapped_object`
+* Allow proper overriding of special `ActiveModel` methods
+
+## 0.12.3
+
+* [Fix i18n issue](https://github.com/drapergem/draper/issues/202)
+
+## 0.12.2
+
+* Fix bug with initializing ammeter
+* Some gems are now development only in the gemspec
+* Fix bug where generated models were still inheriting from `ApplicationDecorator`
+
+## 0.12.0
+
+* Added Changelog
+* [Prevented double decoration](https://github.com/drapergem/draper/issues/173)
+* [`ActiveModel::Errors` support](https://github.com/drapergem/draper/commit/19496f0c)
+* [Fixed autoloading issue](https://github.com/drapergem/draper/issues/188)
+* [Re-did generators](https://github.com/drapergem/draper/commit/9155e58f)
+* [Added capybara integration](https://github.com/drapergem/draper/commit/57c8678e)
+* Fixed a few bugs with the `DecoratedEnumerableProxy`
+
+## 0.11.1
+
+* [Fixed regression, we don't want to introduce a hard dependency on Rails](https://github.com/drapergem/draper/issues/107)

data/CONTRIBUTING.md

@@ -0,0 +1,11 @@
+# Contributing to Draper
+
+So you want to help us out... thanks! Here's a quick how-to:
+
+1. [Fork the project](https://help.github.com/articles/fork-a-repo).
+2. Create a branch - `git checkout -b adding_magic`
+3. Make your changes, and add some tests!
+4. Check that the tests pass - `bundle exec rake`
+5. Commit your changes - `git commit -am "Added some magic"`
+6. Push the branch to Github - `git push origin adding_magic`
+7. Send us a [pull request](https://help.github.com/articles/using-pull-requests)!

data/Gemfile

@@ -1,3 +1,23 @@
 source :rubygems
 
 gemspec
+
+platforms :ruby do
+  gem "sqlite3"
+end
+
+platforms :jruby do
+  gem "minitest", ">= 3.0"
+  gem "activerecord-jdbcsqlite3-adapter", "~> 1.2.2.1"
+end
+
+case ENV["RAILS_VERSION"]
+when "master"
+  gem "rails", github: "rails/rails"
+when "3.2", nil
+  gem "rails", "~> 3.2.0"
+when "3.1"
+  gem "rails", "~> 3.1.0"
+when "3.0"
+  gem "rails", "~> 3.0.0"
+end

data/LICENSE

@@ -0,0 +1,7 @@
+(The MIT License)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the ‘Software’), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED ‘AS IS’, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,324 @@
+# Draper: View Models for Rails
+
+[![TravisCI Build Status](https://secure.travis-ci.org/drapergem/draper.png?branch=master)](http://travis-ci.org/drapergem/draper)
+[![Code Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/drapergem/draper)
+
+Draper adds a nicely-separated object-oriented layer of presentation logic to your Rails apps. Previously, this logic might have been tangled up in procedural helpers, or contributing to your fat models' weight problems. Now, you can wrap your models up in decorators to organise - and test - this layer of your app much more effectively.
+
+
+## Overview
+
+With Draper, your `Article` model has a corresponding `ArticleDecorator`. The decorator wraps the model, and deals only with presentational concerns. In the controller, you simply decorate your article before handing it off to the view.
+
+```ruby
+# app/controllers/articles_controller.rb
+def show
+  @article = Article.find(params[:id]).decorate
+end
+```
+
+In the view, you can use the decorator in exactly the same way as you would have used the model. The difference is, any time you find yourself needing to write a helper, you can implement a method on the decorator instead. For example, this helper:
+
+```ruby
+# app/helpers/articles_helper.rb
+def publication_status(article)
+  if article.published?
+    "Published at #{article.published_at.strftime('%A, %B %e')}"
+  else
+    "Unpublished"
+  end
+end
+```
+
+could be better written as:
+
+```ruby
+# app/decorators/article_decorator.rb
+class ArticleDecorator < Draper::Decorator
+  delegate_all
+
+  def publication_status
+    if published?
+      "Published at #{published_at}"
+    else
+      "Unpublished"
+    end
+  end
+
+  def published_at
+    source.published_at.strftime("%A, %B %e")
+  end
+end
+```
+
+Notice that the `published?` method can be called even though `ArticleDecorator` doesn't define it - thanks to `delegate_all`, the decorator delegates missing methods to the source model. However, we can override methods like `published_at` to add presentation-specific formatting, in which case we access the underlying model using the `source` method.
+
+You might have heard this sort of decorator called a "presenter", an "exhibit", a "view model", or even just a "view" (in that nomenclature, what Rails calls "views" are actually "templates"). Whatever you call it, it's a great way to replace procedural helpers like the one above with "real" object-oriented programming.
+
+Decorators are the ideal place to:
+* format dates and times using `strftime`,
+* define commonly-used representations of an object, like a `name` method that combines `first_name` and `last_name` attributes,
+* mark up attributes with a little semantic HTML, like turning a `url` field into a hyperlink.
+
+
+## Installation
+
+Add Draper to your Gemfile:
+
+```ruby
+gem 'draper', '~> 1.0.0.beta6'
+```
+
+And run `bundle install` within your app's directory.
+
+
+## Writing decorators
+
+Decorators inherit from `Draper::Decorator`, live in your `app/decorators` directory, and are named for the model that they decorate:
+
+```ruby
+# app/decorators/article_decorator.rb
+class ArticleDecorator < Draper::Decorator
+# ...
+end
+```
+
+### Generators
+
+When you generate a resource with `rails generate resource Article`, you get a decorator for free! But if the `Article` model already exists, you can run `rails generate decorator Article` to create the `ArticleDecorator`.
+
+### Accessing helpers
+
+Procedural helpers are still useful for generic tasks like generating HTML, and as such you can access all this goodness (both built-in Rails helpers, and your own) through the `helpers` method:
+
+```ruby
+class ArticleDecorator < Draper::Decorator
+  def emphatic
+    helpers.content_tag(:strong, "Awesome")
+  end
+end
+```
+
+To save your typing fingers it's aliased to `h`. If that's still too much effort, just pop `include Draper::LazyHelpers` at the top of your decorator class - you'll mix in a bazillion methods and never have to type `h.` again... [if that's your sort of thing](https://github.com/garybernhardt/base).
+
+### Accessing the model
+
+Decorators will delegate methods to the model where possible, which means in most cases you can replace a model with a decorator and your view won't notice the difference. When you need to get your hands on the underlying model the `source` method is your friend (and its aliases `model` and `to_source`):
+
+```ruby
+class ArticleDecorator < Draper::Decorator
+  delegate_all
+
+  def published_at
+    source.published_at.strftime("%A, %B %e")
+  end
+end
+```
+
+
+## Decorating
+
+### Single objects
+
+Ok, so you've written a sweet decorator, now you're going to want to put it in action! A simple option is to call the `decorate` method on your model:
+
+```ruby
+@article = Article.first.decorate
+```
+
+This infers the decorator from the object being decorated. If you want more control - say you want to decorate a `Widget` with a more general `ProductDecorator` - then you can instantiate a decorator directly:
+
+```ruby
+@widget = ProductDecorator.new(Widget.first)
+# or, equivalently
+@widget = ProductDecorator.decorate(Widget.first)
+```
+
+### Collections
+
+If you have a whole bunch of objects, you can decorate them all in one fell swoop:
+
+```ruby
+@articles = ArticleDecorator.decorate_collection(Article.all)
+# or, for scopes (but not `all`)
+@articles = Article.popular.decorate
+```
+
+If you want to add methods to your decorated collection (for example, for pagination), you can subclass `Draper::CollectionDecorator`:
+
+```ruby
+# app/decorators/articles_decorator.rb
+class ArticlesDecorator < Draper::CollectionDecorator
+  def page_number
+    42
+  end
+end
+
+# elsewhere...
+@articles = ArticlesDecorator.new(Article.all)
+# or, equivalently
+@articles = ArticlesDecorator.decorate(Article.all)
+```
+
+Draper guesses the decorator used for each item from the name of the collection decorator (`ArticlesDecorator` becomes `ArticleDecorator`). If that fails, it falls back to using each item's `decorate` method. Alternatively, you can specify a decorator by overriding the collection decorator's `decorator_class` method.
+
+Some pagination gems add methods to `ActiveRecord::Relation`. For example, [Kaminari](https://github.com/amatsuda/kaminari)'s `paginate` helper method requires the collection to implement `current_page`, `total_pages`, and `limit_value`. To expose these on a collection decorator, you can simply delegate to the `source`:
+
+```ruby
+class PaginatingDecorator < Draper::CollectionDecorator
+  delegate :current_page, :total_pages, :limit_value
+end
+```
+
+The `delegate` method used here is the same as that added by [Active Support](http://api.rubyonrails.org/classes/Module.html#method-i-delegate), except that the `:to` option is not required; it defaults to `:source` when omitted.
+
+### Handy shortcuts
+
+You can automatically decorate associated models:
+
+```ruby
+class ArticleDecorator < Draper::Decorator
+  decorates_association :author
+end
+```
+
+And, if you want, you can add decorated finder methods:
+
+```ruby
+class ArticleDecorator < Draper::Decorator
+  decorates_finders
+end
+```
+
+so that you can do:
+
+```ruby
+@article = ArticleDecorator.find(params[:id])
+```
+
+
+## Testing
+
+Draper supports RSpec, MiniTest::Rails, and Test::Unit, and will add the appropriate tests when you generate a decorator.
+
+### RSpec
+
+Your specs should live in `spec/decorators` (if not, you need to tag them with `type: :decorator`).
+
+In controller specs, you might want to check whether your instance variables are being decorated properly. You can use the handy predicate matchers:
+
+```ruby
+assigns(:article).should be_decorated
+# or, if you want to be more specific
+assigns(:article).should be_decorated_with ArticleDecorator
+```
+
+Note that `model.decorate == model`, so your existing specs shouldn't break when you add the decoration.
+
+Spork users should `require 'draper/test/rspec_integration'` in the `Spork.prefork` block.
+
+
+## Advanced usage
+
+### `ApplicationDecorator`
+
+If you need common methods in your decorators, you can create an `ApplicationDecorator`:
+
+```ruby
+# app/decorators/application_decorator.rb
+class ApplicationDecorator < Draper::Decorator
+# ...
+end
+```
+
+and inherit from it instead of directly from `Draper::Decorator`.
+
+### Enforcing an interface between controllers and views
+
+The `delegate_all` call at the top of your decorator means that all missing methods will delegated to the source. If you want to strictly control which methods are called in your views, you can choose to only delegate certain methods.
+
+```ruby
+class ArticleDecorator < Draper::Decorator
+  delegate :title, :author
+end
+```
+
+As mentioned above for `CollectionDecorator`, the `delegate` method defaults to using `:source` if the `:to` option is omitted.
+
+
+### Adding context
+
+If you need to pass extra data to your decorators, you can use a `context` hash. Methods that create decorators take it as an option, for example
+
+```ruby
+Article.first.decorate(context: {role: :admin})
+```
+
+The value passed to the `:context` option is then available in the decorator through the `context` method.
+
+If you use `decorates_association`, the context of the parent decorator is passed to the associated decorators. You can override this with the `:context` option:
+
+```ruby
+class ArticleDecorator < Draper::Decorator
+  decorates_association :author, context: {foo: "bar"}
+end
+```
+
+or, if you simply want to modify the parent's context, use a lambda that takes a hash and returns a new hash:
+
+```ruby
+class ArticleDecorator < Draper::Decorator
+  decorates_association :author,
+    context: ->(parent_context){ parent_context.merge(foo: "bar") }
+end
+```
+
+### Specifying decorators
+
+When you're using `decorates_association`, Draper uses the `decorate` method on the associated record (or each associated record, in the case of a collection association) to perform the decoration. If you want use a specific decorator, you can use the `:with` option:
+
+```ruby
+class ArticleDecorator < Draper::Decorator
+  decorates_association :author, with: FancyPersonDecorator
+end
+```
+
+For a collection association, you can specify a `CollectionDecorator` subclass, which is applied to the whole collection, or a singular `Decorator` subclass, which is applied to each item individually.
+
+### Scoping associations
+
+If you want your decorated association to be ordered, limited, or otherwise scoped, you can pass a `:scope` option to `decorates_association`, which will be applied to the collection before decoration:
+
+```ruby
+class ArticleDecorator < Draper::Decorator
+  decorates_association :comments, scope: :recent
+end
+```
+
+### Breaking with convention
+
+If, as well as instance methods, you want to proxy class methods to the model through the decorator (including when using `decorates_finders`), Draper needs to know the model class. By default, it assumes that your decorators are named `SomeModelDecorator`, and then attempts to proxy unknown class methods to `SomeModel`. If your model name can't be inferred from your decorator name in this way, you need to use the `decorates` method:
+
+```ruby
+class MySpecialArticleDecorator < Draper::Decorator
+  decorates :article
+end
+```
+
+You don't need to worry about this if you don't want to proxy class methods.
+
+### Making models decoratable
+
+Models get their `decorate` method from the `Draper::Decoratable` module, which is included in `ActiveRecord::Base` and `Mongoid::Document` by default. If you're using another ORM, or want to decorate plain old Ruby objects, you can include this module manually.
+
+
+## Contributors
+
+Draper was conceived by Jeff Casimir and heavily refined by Steve Klabnik and a great community of open source [contributors](https://github.com/drapergem/draper/contributors).
+
+### Core Team
+
+* Jeff Casimir (jeff@jumpstartlab.com)
+* Steve Klabnik (steve@jumpstartlab.com)
+* Vasiliy Ermolovich
+* Andrew Haines

data/Rakefile

@@ -1,47 +1,68 @@
-require 'bundler/gem_tasks'
 require 'rake'
+require 'bundler/gem_tasks'
 require 'rspec/core/rake_task'
 
-RCOV = RUBY_VERSION.to_f == 1.8
+def run_in_dummy_app(command)
+  success = system("cd spec/dummy && #{command}")
+  raise "#{command} failed" unless success
+end
+
+task "default" => "ci"
+
+desc "Run all tests for CI"
+task "ci" => "spec"
 
-namespace :spec do
+desc "Run all specs"
+task "spec" => "spec:all"
 
-  RSpec::Core::RakeTask.new(:coverage) do |t|
-    t.pattern = 'spec/**/*_spec.rb'
+namespace "spec" do
+  task "all" => ["draper", "generators", "integration"]
 
-    if RCOV
-      t.rcov = true
-      t.rcov_opts = '--exclude osx\/objc,spec,gems\/'
+  def spec_task(name)
+    desc "Run #{name} specs"
+    RSpec::Core::RakeTask.new(name) do |t|
+      t.pattern = "spec/#{name}/**/*_spec.rb"
     end
   end
 
-  RSpec::Core::RakeTask.new(:normal) do |t|
-    t.pattern ='spec/**/*_spec.rb'
-    t.rcov = false
-  end
+  spec_task "draper"
+  spec_task "generators"
 
-  namespace :coverage do
-    desc "Cleanup coverage data"
-    task :cleanup do
-      rm_rf 'coverage.data'
-      rm_rf 'coverage'
-    end
+  desc "Run integration specs"
+  task "integration" => ["db:setup", "integration:all"]
 
-    desc "Browse the code coverage report."
-    task :report => ["spec:coverage:cleanup", "spec:coverage"] do
-      if RCOV
-        require "launchy"
-        Launchy.open("coverage/index.html")
-      else
-        require 'cover_me'
-        CoverMe.complete!
+  namespace "integration" do
+    task "all" => ["development", "production", "test"]
+
+    ["development", "production"].each do |environment|
+      task environment do
+        Rake::Task["spec:integration:run"].execute environment
       end
     end
-  end
 
-end
+    task "run" do |t, environment|
+      puts "Running integration specs in #{environment}"
+
+      ENV["RAILS_ENV"] = environment
+      success = system("rspec spec/integration")
 
-desc "RSpec tests"
-task "spec" => "spec:normal"
+      raise "Integration specs failed in #{environment}" unless success
+    end
 
-task "default" => "spec"
+    task "test" do
+      puts "Running rake in dummy app"
+      ENV["RAILS_ENV"] = "test"
+      run_in_dummy_app "rake"
+    end
+  end
+end
+
+namespace "db" do
+  desc "Set up databases for integration testing"
+  task "setup" do
+    run_in_dummy_app "rm -f db/*.sqlite3"
+    run_in_dummy_app "RAILS_ENV=development rake db:schema:load db:seed"
+    run_in_dummy_app "RAILS_ENV=production rake db:schema:load db:seed"
+    run_in_dummy_app "RAILS_ENV=test rake db:schema:load"
+  end
+end