dekorator 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e632f3f499971f15713b16354a960d3c0c2e42436694a040d5a77c8627baec7a
+  data.tar.gz: 1318630635b3406f2336d0d144d1651c0b66bb013e4f5e342c726314ba145b30
+SHA512:
+  metadata.gz: c51f4aa3459a64007d77e6f33361e2fdacceb56893f05cfef773c2bd0401ea92cb021bd6fc8153ff8b679fcff52de642fe7338d8cefe448b59595edc36e1ed19
+  data.tar.gz: 453e6c9a109f4b0c791a211365284adac236496dd7e7f7280103066f074e867c103f9d1c298b5096f3228e9bc4627f73713da659c38e62e5e20af5b0eaa74909

data/.github/workflows/test.yml

@@ -0,0 +1,51 @@
+name: Tests
+
+on: [push, pull_request]
+
+jobs:
+  test:
+    name: Ruby ${{ matrix.versions.ruby }}, Rails ${{ matrix.versions.rails }}
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        versions:
+          - { ruby: "2.4.x", rails: "5.0.x" }
+          - { ruby: "2.5.x", rails: "5.0.x" }
+          - { ruby: "2.6.x", rails: "5.0.x" }
+          - { ruby: "2.4.x", rails: "5.1.x" }
+          - { ruby: "2.5.x", rails: "5.1.x" }
+          - { ruby: "2.6.x", rails: "5.1.x" }
+          - { ruby: "2.4.x", rails: "5.2.x" }
+          - { ruby: "2.5.x", rails: "5.2.x" }
+          - { ruby: "2.6.x", rails: "5.2.x" }
+          - { ruby: "2.5.x", rails: "6.0.x" }
+          - { ruby: "2.6.x", rails: "6.0.x" }
+
+    steps:
+    - uses: actions/checkout@v1
+
+    - uses: actions/cache@v1
+      id: cache
+      with:
+        path: gemfiles/vendor/bundle
+        key: ruby-${{ matrix.versions.ruby }}-rails-${{ matrix.versions.rails }}
+
+    - name: Set up Ruby
+      uses: actions/setup-ruby@v1
+      with:
+        ruby-version: ${{ matrix.versions.ruby }}
+
+    - name: Set up bundler
+      run: |
+        echo 'gem: --no-document' >> ~/.gemrc
+        gem install bundler
+        bundle config --global gemfile gemfiles/rails_${{ matrix.versions.rails }}.gemfile
+        bundle config --global path vendor/bundle
+
+    - name: Install gems
+      run: |
+        bundle install --jobs $(nproc) --retry 3
+
+    - name: Test with Rake
+      run: |
+        bundle exec rake test:all_with_coverage

data/CHANGELOG.md

@@ -0,0 +1,32 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+Nothing yet
+
+## [1.0.0] - 2019-12-02
+### Added
+- Avoid deep decoration ([#25](https://github.com/komposable/dekorator/pull/25))
+- Make `decorate` accessible in ApplicationController ([#29](https://github.com/komposable/dekorator/pull/29))
+
+### Changed
+- Moved to Komposable organization ([#13](https://github.com/komposable/dekorator/pull/13))
+- Replace Travis CI by Github Actions and remove ruby 2.3 support ([#23](https://github.com/komposable/dekorator/pull/23))
+- Update railtie to prevent triggering initialization autoloaded constant deprecation warning ([#30](https://github.com/komposable/dekorator/pull/30))
+- Improve generators ([#31](https://github.com/komposable/dekorator/pull/31))
+
+### Fixes
+- Fix DecoratedEnumerableProxy for Rails 6 ([5a656333](https://github.com/komposable/dekorator/commit/5a656333e9ca6321d0474f0e54de4332219b88d0))
+
+## 1.0.0.pre.1 - 2019-01-30
+### Added
+- Create Dekorator::Base the base of decorators ([a2a36d66](https://github.com/komposable/dekorator/commit/a2a36d66c6de6cb0a00f783794cd29f899bc04b6))
+- Create `dekorator:install` generator ([a2a36d66](https://github.com/komposable/dekorator/commit/a2a36d66c6de6cb0a00f783794cd29f899bc04b6))
+- Create `decorator` generator ([a2a36d66](https://github.com/komposable/dekorator/commit/a2a36d66c6de6cb0a00f783794cd29f899bc04b6))
+
+[Unreleased]: https://github.com/komposable/dekorator/compare/v1.0.0...master
+[1.0.0]: https://github.com/komposable/dekorator/compare/v1.0.0...1.0.0.pre.1

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,74 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, gender identity and expression, level of experience,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+* Using welcoming and inclusive language
+* Being respectful of differing viewpoints and experiences
+* Gracefully accepting constructive criticism
+* Focusing on what is best for the community
+* Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+* The use of sexualized language or imagery and unwelcome sexual attention or
+advances
+* Trolling, insulting/derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at oss@pantographe.studio. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at [http://contributor-covenant.org/version/1/4][version]
+
+[homepage]: http://contributor-covenant.org
+[version]: http://contributor-covenant.org/version/1/4/

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019 Pantographe
+
+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,245 @@
+# Dekorator
+
+[![Tests](https://github.com/komposable/dekorator/workflows/Tests/badge.svg)](https://github.com/komposable/dekorator/actions)
+[![Gem Version](https://badge.fury.io/rb/dekorator.svg)](https://rubygems.org/gems/dekorator)
+[![Maintainability](https://api.codeclimate.com/v1/badges/f7ab08512ead00da34c0/maintainability)](https://codeclimate.com/github/komposable/dekorator/maintainability)
+[![Coverage Status](https://coveralls.io/repos/github/komposable/dekorator/badge.svg)](https://coveralls.io/github/komposable/dekorator)
+[![Inch CI](https://inch-ci.org/github/komposable/dekorator.svg?branch=master)](https://inch-ci.org/github/komposable/dekorator)
+[![Yardoc](https://img.shields.io/badge/doc-yardoc-blue.svg)](https://www.rubydoc.info/github/komposable/dekorator/master)
+
+**Dekorator** is a lightweight library to implement _presenters_ and/or _decorators_ in your Rails app. It has less features than [`draper`](https://github.com/drapergem/draper) and aims at having a lower memory footprint.
+
+This gem has been inspired by our Rails development practices at [Pantographe](https://pantographe.studio), and the [Ruby memory, ActiveRecord and Draper](https://medium.com/appaloosa-store-engineering/ruby-memory-activerecord-and-draper-64f06abeeb34) talk by [Benoit Tigeot](https://github.com/benoittgt).
+
+## Compatibility
+
+* Ruby 2.4+
+* Rails 5.0+
+
+## Installation
+
+Add this line to your application `Gemfile`:
+
+```ruby
+gem "dekorator"
+```
+
+And then execute:
+
+    $ bundle
+
+## Getting started
+
+Run the following command to set up your project:
+
+    $ rails generate dekorator:install
+
+This command will create an `ApplicationDecorator` file.
+
+## Usage
+
+Generate a new decorator with the `decorator` generator:
+
+    $ rails generate decorator user
+
+This command will generate the following file:
+
+```ruby
+class UserDecorator < ApplicationDecorator
+  include ActionView::Helpers::TextHelper
+  
+  decorates_association :posts
+  
+  def full_name
+    [first_name, last_name].join(" ")
+  end
+  
+  def biography_summary
+    truncate(biography, length: 170)
+  end
+end
+```
+
+### Decorate from a controller
+
+```ruby
+class UsersController < ApplicationController
+  def index
+    @users = decorate User.all
+  end
+
+  def show
+    @user = decorate User.find(params[:id])
+  end
+end
+```
+
+### Decorate from a view
+
+```erb
+# app/views/users/index.html.erb
+
+<ul>
+  <% decorate(@users).each do |user| %>
+    <li><%= user.full_name %></li>
+  <% end %>
+</ul>
+```
+
+### Decorate outside a controller/view
+
+```ruby
+UserDecorate.decorate(User.first) # => UserDecorator
+```
+
+### Associations
+
+If you want to automatically decorate an association for a decorated object,
+you have to use `#decorates_association` as following:
+
+```ruby
+class UserDecorator < ApplicationDecorator
+  decorates_association :posts
+
+  ...
+end
+
+class PostDecorator < ApplicationDecorator
+  ...
+end
+```
+
+In this example, `UserDecorator#posts` will be decorated.
+
+```ruby
+decorated_user = decorate(User.first)
+decorated_user # => UserDecorator
+decorated_user.posts.first # => PostDecorator
+```
+
+### Custom decorator
+
+By default, Dekorator searches for the decorator class by adding `Decorator` at the end.  
+For `User`, Dekorator looks for the `UserDecorator` class, and for `User::Profile`
+it looks for `User::ProfileDecorator`.
+
+If you want to create a specific decorator or sub-decorator, you can simply
+specify the decorator class that should be used.
+
+```ruby
+class AdminDecorator < ApplicationDecorator
+  ...
+end
+
+decorated_user = decorate(User.first, with: AdminDecorator)
+decorated_user # => AdminDecorator
+```
+
+You can also specify the decorator for associations:
+
+```ruby
+class UserDecorator < ApplicationDecorator
+  decorates_association :posts, with: ArticleDecorator
+
+  ...
+end
+
+class ArticleDecorator < ApplicationDecorator
+end
+
+decorated_user = decorate(User.first)
+decorated_user # => UserDecorator
+decorated_user.posts.first # => ArticleDecorator
+```
+
+## Compatibility
+
+### ActiveAdmin
+
+This gem is compatible with [`activeadmin`][activeadmin].
+
+Simply use `#decorate_with`
+
+```ruby
+# app/admin/post.rb
+ActiveAdmin.register Post do
+  decorate_with PostDecorator
+
+  index do
+    column :title
+    column :image
+    actions
+  end
+end
+```
+
+### Devise
+
+If you use the [`Devise`][devise] gem you may have an issue if you decorate your
+`User` model.
+
+You must define `#devise_scope` as following. Devise needs to manage with the
+`User` model (https://github.com/plataformatec/devise/blob/369ba267efaa10d01c8dba59b09c3b94dd9e5551/lib/devise/mapping.rb#L35).
+
+```ruby
+class UserDecorator < ApplicationDecorator
+  ...
+
+  def devise_scope
+    __getobj__
+  end
+end
+```
+
+## Testing
+
+`rails generate decorator user` also generates a testing file based on your
+configuration.
+
+You can test a decorator the same way you do for helpers.
+
+### RSpec
+
+```ruby
+describe UserDecorator, type: :decorator do
+  let(:object) { User.new(first_name: "John", last_name: "Doe") }
+  let(:decorated_user) { described_class.new(object) }
+
+  describe "#full_name" do
+    it { expect(decorated_user.full_name).to eq("John Doe") }
+  end
+end
+```
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run
+`rake spec` to run the tests. You can also run `bin/console` for an interactive
+prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`.
+To release a new version, update the version number in `version.rb`, then
+run `bundle exec rake release`, which will create a git tag for the version,
+push git commits and tags, and push the `.gem` file to [rubygems.org].
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at
+https://github.com/komposable/dekorator. This project is intended to be a safe,
+welcoming space for collaboration, and contributors are expected to adhere to
+the [Contributor Covenant](http://contributor-covenant.org) code of conduct.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License].
+
+## Code of Conduct
+
+Everyone interacting in the Dekorator project codebases, issue trackers,
+chat rooms and mailing lists is expected to follow the [code of conduct].
+
+[activeadmin]: https://activeadmin.info/11-decorators.html
+[devise]: https://github.com/plataformatec/devise/
+[rubygems.org]: https://rubygems.org
+[MIT License]: https://opensource.org/licenses/MIT
+[code of conduct]: https://github.com/komposable/dekorator/blob/master/CODE_OF_CONDUCT.md

data/Rakefile

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rubocop/rake_task"
+require "rspec/core/rake_task"
+require "coveralls/rake/task"
+
+namespace :test do
+  task all: %i[rubocop spec]
+  task all_with_coverage: %i[all coveralls:push]
+
+  RuboCop::RakeTask.new
+
+  RSpec::Core::RakeTask.new(:spec)
+
+  Coveralls::RakeTask.new
+end
+
+task test: :"test:all"
+
+task default: :test

data/benchmarks/README.md

@@ -0,0 +1,7 @@
+# Benchmarks
+
+## Run benchmarks
+
+```sh
+$ ruby benchmark.rb
+```

data/benchmarks/benchmark.rb

@@ -0,0 +1,135 @@
+# frozen_string_literal: true
+
+require "bundler/inline"
+
+gemfile(true) do
+  source "https://rubygems.org"
+
+  git_source(:github) { |repo| "https://github.com/#{repo}.git" }
+
+  gem "rails", "6.0.1"
+  gem "sqlite3"
+  gem "benchmark-ips"
+  gem "benchmark-memory"
+
+  gem "dekorator", path: "../", require: false
+  gem "draper", require: false
+end
+
+require "active_record"
+require "logger"
+
+ActiveRecord::Base.establish_connection(adapter: "sqlite3", database: ":memory:")
+ActiveRecord::Base.logger = nil # Logger.new(STDOUT)
+
+ActiveRecord::Schema.define do
+  create_table :posts, force: true do |t|
+    t.string :title
+    t.text :body
+  end
+
+  create_table :comments, force: true do |t|
+    t.integer :post_id
+    t.string :author
+    t.text :body
+  end
+end
+
+# Models
+class Post < ActiveRecord::Base
+  has_many :comments
+
+  def summary
+    @summary ||= body&.truncate(170)
+  end
+end
+
+class Comment < ActiveRecord::Base
+  belongs_to :post
+end
+
+# Data
+comments = 100.times.map { Comment.new(author: "John D.", body: "Great article") }
+10.times.each { Post.create!(title: "Our first article!", body: "", comments: comments) }
+
+# Decorators
+require "dekorator"
+
+class PostDecorator < Dekorator::Base
+  decorates_association :comments
+
+  def summary
+    @summary ||= body&.truncate(170)
+  end
+end
+
+class CommentDecorator < Dekorator::Base
+end
+
+require "draper"
+
+class CommentDraperDecorator < Draper::Decorator
+end
+
+class PostDraperDecorator < Draper::Decorator
+  decorates_association :comments, with: CommentDraperDecorator
+
+  def summary
+    @summary ||= object.body&.truncate(170)
+  end
+end
+
+require "delegate"
+
+class PostDelegator < SimpleDelegator
+  def summary
+    @summary ||= body&.truncate(170)
+  end
+
+  def comments
+    @comments = __getobj__.comments.map { |comment| CommentDelegator.new(CommentDelegator) }
+  end
+end
+
+class CommentDelegator < SimpleDelegator
+end
+
+# Benchmark
+SCENARIOS = {
+  "#summary"        => :summary,
+  "#comments"       => :comments,
+}
+
+SCENARIOS.each_pair do |name, method|
+  puts
+  puts " #{name} ".center(80, "=")
+  puts
+
+  model = Post.all
+
+  puts " ips ".center(80, "-")
+  puts
+
+  Benchmark.ips do |x|
+    x.report("In model")  { model.first.public_send(method) }
+    x.report("Dekorator") { PostDecorator.decorate(model).first.public_send(method) }
+    x.report("Dekorator.new") { PostDecorator.decorate(model).first.public_send(method) }
+    x.report("Draper") { PostDraperDecorator.decorate_collection(model).first.public_send(method) }
+    x.report("SimpleDelegator") { PostDelegator.new(model.first).public_send(method) }
+
+    x.compare!
+  end
+
+  puts " memory ".center(80, "-")
+  puts
+
+  Benchmark.memory do |x|
+    x.report("In model")  { model.first.public_send(method) }
+    x.report("Dekorator") { PostDecorator.decorate(model).first.public_send(method) }
+    x.report("Dekorator.new") { PostDecorator.decorate(model).first.public_send(method) }
+    x.report("Draper") { PostDraperDecorator.decorate_collection(model).first.public_send(method) }
+    x.report("SimpleDelegator") { PostDelegator.new(model.first).public_send(method) }
+
+    x.compare!
+  end
+end

data/dekorator.gemspec

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+lib = File.expand_path("lib", __dir__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require "dekorator/version"
+
+Gem::Specification.new do |spec|
+  spec.name        = "dekorator"
+  spec.version     = Dekorator::VERSION
+  spec.authors     = ["Pantographe"]
+  spec.email       = ["oss@pantographe.studio"]
+
+  spec.summary     = "An opinionated way of organizing model-view code in Ruby on Rails, based on decorators"
+  spec.description = "An opinionated way of organizing model-view code in Ruby on Rails, based on decorators"
+  spec.homepage    = "http://komponent.io"
+  spec.license     = "MIT"
+
+  spec.metadata    = {
+    "homepage_uri"    => "https://github.com/komposable/dekorator",
+    "changelog_uri"   => "https://github.com/komposable/dekorator/blob/master/CHANGELOG.md",
+    "source_code_uri" => "https://github.com/komposable/dekorator",
+    "bug_tracker_uri" => "https://github.com/komposable/dekorator/issues",
+}
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files       = Dir.chdir(File.expand_path('..', __FILE__)) do
+    `git ls-files -z`.split("\x0")
+      .reject do |f|
+        f.match(%r{^(test|spec|features|gemfiles|bin)/}) \
+        || %w[.editorconfig .gitignore .inch.yml .rspec .rubocop.yml .simplecov .travis.yml
+          .yardots Appraisals Gemfile Gemfile.lock].include?(f)
+      end
+  end
+
+  spec.require_paths = ["lib"]
+
+  spec.required_ruby_version = ">= 2.3"
+
+  spec.add_runtime_dependency "actionview", ">= 5.0", "< 6.1"
+  spec.add_runtime_dependency "activesupport", ">= 5.0", "< 6.1"
+  spec.add_runtime_dependency "railties", ">= 5.0", "< 6.1"
+
+  spec.add_development_dependency "bundler", "~> 2.0"
+  spec.add_development_dependency "rake", "~> 10.0"
+  spec.add_development_dependency "rspec", "~> 3.0"
+end

data/lib/dekorator.rb

@@ -0,0 +1,151 @@
+# frozen_string_literal: true
+
+require "dekorator/version"
+require "delegate"
+
+# :nodoc
+module Dekorator
+  # @api private
+  module Generators; end
+
+  class DecoratorNotFound < ArgumentError; end
+
+  # Base decorator.
+  class Base < SimpleDelegator
+    class << self
+      # Decorate an object with a decorator.
+      #
+      # @param object_or_collection [Object, Enumerable] the object or collection to decorate.
+      # @option opts [Class] :with the decorator class to use. If empty a decorator will be guessed.
+      #
+      # @return [Dekorator::Base, ActiveRecord::Relation, Enumerable] the obect or collection decorated.
+      #
+      # @raise [DecoratorNotFound] if decorator is not found.
+      def decorate(object_or_collection, with: nil)
+        return object_or_collection if decorable_object?(object_or_collection)
+
+        with ||= self if with != :__guess__ && self != Dekorator::Base
+        with = _guess_decorator(object_or_collection) if with.nil? || with == :__guess__
+
+        object_or_collection = _decorate(object_or_collection, with: with)
+
+        if block_given?
+          yield object_or_collection
+        else
+          object_or_collection
+        end
+      end
+
+      # Define that an association must be decorated.
+      #
+      # @param relation_name [String, Symbol] the association name to decorate.
+      # @option opts [Class] :with the decorator class to use. If empty a decorator will be guessed.
+      #
+      # @example Define an association to decorate
+      #   class UserDecorator < Dekorator::Base
+      #     decorates_association :posts
+      #   end
+      #
+      #   # A decorator could be precise
+      #   class UserDecorator < Dekorator::Base
+      #     decorates_association :posts, PostDecorator
+      #   end
+      def decorates_association(relation_name, with: :__guess__)
+        relation_name = relation_name.to_sym
+
+        define_method(relation_name) do
+          @decorated_associations[relation_name] ||= decorate(__getobj__.public_send(relation_name), with: with)
+        end
+      end
+
+      # Guess and returns the decorated object class.
+      #
+      # @return [Class] the decorated object class.
+      def base_class
+        _safe_constantize(name.gsub("Decorator", ""))
+      end
+
+      private
+
+      def _decorate(object_or_enumerable, with:)
+        if !object_or_enumerable.is_a? Enumerable
+          with.new(object_or_enumerable)
+        else
+          if defined?(ActiveRecord::Relation) && object_or_enumerable.is_a?(ActiveRecord::Relation)
+            Dekorator::DecoratedEnumerableProxy.new(with, object_or_enumerable)
+          else object_or_enumerable.is_a? Enumerable
+            object_or_enumerable.map { |object| _decorate(object, with: with) }
+          end
+        end
+      end
+
+      def _guess_decorator(object_or_enumerable)
+        object_or_enumerable = object_or_enumerable.first if object_or_enumerable.is_a? Enumerable
+
+        _safe_constantize("#{object_or_enumerable.class}Decorator") \
+          || raise(DecoratorNotFound, "Can't guess decorator for #{object_or_enumerable.class.name} object")
+      end
+
+      def decorable_object?(object_or_collection)
+        (object_or_collection.respond_to?(:empty?) && object_or_collection.empty?) \
+          || !object_or_collection \
+          || object_or_collection.is_a?(Dekorator::Base) \
+          || (defined?(ActiveRecord::Relation) && object_or_collection.is_a?(Dekorator::DecoratedEnumerableProxy))
+      end
+
+      def _safe_constantize(class_name)
+        Object.const_get(class_name)
+      rescue NameError => _e
+        nil
+      end
+    end
+
+    # :nodoc
+    def initialize(object)
+      @decorated_associations = {}
+
+      super(object)
+    end
+
+    # :nodoc
+    def decorate(object_or_collection, with: :__guess__)
+      self.class.decorate(object_or_collection, with: with)
+    end
+
+    # Returns the decorated object.
+    #
+    # @return [Object] the decorated object.
+    def object
+      __getobj__
+    end
+  end
+
+  if defined?(ActiveRecord::Relation)
+    # DecoratedEnumerableProxy is strongly inspired from
+    # https://github.com/kiote/activeadmin-poro-decorator/blob/master/lib/activeadmin-poro-decorator.rb#L65
+    class DecoratedEnumerableProxy < DelegateClass(ActiveRecord::Relation)
+      include Enumerable
+
+      delegate :as_json, :collect, :map, :each, :[], :all?, :include?,
+               :first, :last, :shift, to: :decorated_collection
+      delegate :each, to: :to_ary
+
+      def initialize(decorator_class, collection)
+        super(collection)
+
+        @decorator_class = decorator_class
+      end
+
+      def wrapped_collection
+        __getobj__
+      end
+
+      def decorated_collection
+        @decorated_collection ||= wrapped_collection.collect { |member| @decorator_class.new(member) }
+      end
+      alias to_ary decorated_collection
+    end
+  end
+end
+
+require "dekorator/railtie" if defined?(Rails)

data/lib/dekorator/rails/controller.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require "active_support/concern"
+
+module Dekorator
+  module Controller
+    extend ActiveSupport::Concern
+
+    included do
+      helper_method :decorate
+    end
+
+    def decorate(object_or_collection, with: nil)
+      Dekorator::Base.decorate(object_or_collection, with: with)
+    end
+  end
+end

data/lib/dekorator/railtie.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Dekorator
+  require "dekorator/rails/controller"
+
+  class Railtie < ::Rails::Railtie
+    config.to_prepare do |_app|
+      ActionController::Base.include Dekorator::Controller
+    end
+
+    config.after_initialize do |app|
+      app.config.paths.add "app/decorators", eager_load: true
+    end
+  end
+end

data/lib/dekorator/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Dekorator
+  VERSION = "1.0.0".freeze
+end

data/lib/generators/decorator_generator.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+class DecoratorGenerator < ::Rails::Generators::NamedBase
+  invoke "dekorator:decorator"
+end

data/lib/generators/dekorator/decorator/USAGE

@@ -0,0 +1,9 @@
+Description:
+  Generate a fresh new decorator
+
+Example:
+    `rails generate dekorator:decorator User`
+
+    User decorator.
+        Decorator: app/decorators/user_decorator.rb
+        Test:      test/decorators/user_decorator_test.rb

data/lib/generators/dekorator/decorator/decorator_generator.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module Dekorator
+  module Generators
+    class DecoratorGenerator < ::Rails::Generators::NamedBase
+      source_root File.expand_path("templates", __dir__)
+
+      def create_decorator
+        template "decorator.rb", File.join("app/decorators", class_path, "#{file_name}_decorator.rb")
+      end
+
+      hook_for :test_framework
+    end
+  end
+end

data/lib/generators/dekorator/decorator/templates/decorator.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+<% module_namespacing do -%>
+class <%= class_name %>Decorator < ApplicationDecorator
+  # include ActionView::Helpers::TextHelper
+  #
+  # decorates_association :posts
+  #
+  # def full_name
+  #   [first_name, last_name].join(" ")
+  # end
+  #
+  # def biography_summary
+  #   truncate(biography, length: 170)
+  # end
+end
+<% end -%>

data/lib/generators/dekorator/install/install_generator.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module Dekorator
+  module Generators
+    class InstallGenerator < ::Rails::Generators::Base
+
+      def create_root_directory
+        empty_directory(dekorator_root_directory)
+
+        concerns_directory = dekorator_root_directory.join("concerns")
+        empty_directory(concerns_directory)
+        create_file("#{concerns_directory}/.keep")
+      end
+
+      def create_application_decorator
+        create_file application_decorator_path, <<-RUBY
+# frozen_string_literal: true
+
+class ApplicationDecorator < Dekorator::Base
+end
+        RUBY
+      end
+
+      protected
+
+      def dekorator_root_directory
+        Rails.root.join("app/decorators")
+      end
+
+      def application_decorator_path
+        dekorator_root_directory.join("application_decorator.rb")
+      end
+    end
+  end
+end

data/lib/generators/rspec/decorator_generator.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module Rspec
+  module Generators
+    class DecoratorGenerator < ::Rails::Generators::NamedBase
+      source_root File.expand_path("templates", __dir__)
+
+      def create_decorator_spec
+        template "decorator_spec.rb", File.join("spec/decorators", class_path, "#{file_name}_decorator_spec.rb")
+      end
+    end
+  end
+end

data/lib/generators/rspec/templates/decorator_spec.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+require '<%= File.exists?("spec/rails_helper.rb") ? "rails_helper" : "spec_helper" %>'
+
+# Example:
+#
+# describe <%= class_name %>Decorator, type: :decorator do
+#   let(:object) { User.new(first_name: "John", last_name: "Doe") }
+#   let(:decorated_user) { described_class.new(object) }
+#
+#   describe "#full_name" do
+#     it { expect(decorated_user.full_name).to eq("John Doe") }
+#   end
+# end
+RSpec.describe <%= class_name %>Decorator, type: :decorator do
+  pending "add some examples to (or delete) #{__FILE__}"
+end

data/lib/generators/test_unit/decorator_generator.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module TestUnit
+  module Generators
+    class DecoratorGenerator < ::Rails::Generators::NamedBase
+      source_root File.expand_path("templates", __dir__)
+
+      def create_decorator_test
+        template "decorator_test.rb", File.join("test/decorators", class_path, "#{file_name}_decorator_test.rb")
+      end
+    end
+  end
+end

data/lib/generators/test_unit/templates/decorator_test.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require 'test_helper'
+
+class <%= class_name %>DecoratorTest < ActiveSupport::TestCase
+end

metadata

@@ -0,0 +1,173 @@
+--- !ruby/object:Gem::Specification
+name: dekorator
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Pantographe
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-12-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: actionview
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: railties
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '5.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '6.1'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: An opinionated way of organizing model-view code in Ruby on Rails, based
+  on decorators
+email:
+- oss@pantographe.studio
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".github/workflows/test.yml"
+- CHANGELOG.md
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- benchmarks/README.md
+- benchmarks/benchmark.rb
+- dekorator.gemspec
+- lib/dekorator.rb
+- lib/dekorator/rails/controller.rb
+- lib/dekorator/railtie.rb
+- lib/dekorator/version.rb
+- lib/generators/decorator_generator.rb
+- lib/generators/dekorator/decorator/USAGE
+- lib/generators/dekorator/decorator/decorator_generator.rb
+- lib/generators/dekorator/decorator/templates/decorator.rb
+- lib/generators/dekorator/install/install_generator.rb
+- lib/generators/rspec/decorator_generator.rb
+- lib/generators/rspec/templates/decorator_spec.rb
+- lib/generators/test_unit/decorator_generator.rb
+- lib/generators/test_unit/templates/decorator_test.rb
+homepage: http://komponent.io
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/komposable/dekorator
+  changelog_uri: https://github.com/komposable/dekorator/blob/master/CHANGELOG.md
+  source_code_uri: https://github.com/komposable/dekorator
+  bug_tracker_uri: https://github.com/komposable/dekorator/issues
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '2.3'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.6
+signing_key: 
+specification_version: 4
+summary: An opinionated way of organizing model-view code in Ruby on Rails, based
+  on decorators
+test_files: []