0.02
No commit activity in last 3 years
No release in over 3 years
Light pattern Decorator for Rails from Light Ruby
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 2.1
~> 1.12
~> 2.7.0
~> 0.5.4
~> 2.2.0
~> 10.0
~> 3.0
~> 0.11.2
~> 1.3.11

Runtime

>= 4.0.0
 Project Readme

Light Decorator

Build Status Code Climate Test Coverage

Easiest and fast way to decorate Ruby on Rails models. Compatible with Rails 5.0 and 4.2, 4.1, 4.0.

Decorator Pattern – What is it? Check it here:

Installation

Add this line to your application's Gemfile:

gem 'light-decorator', '~> 1.0.1'

Create base class ApplicationDecorator in folder app/decorators/application_decorator.rb

rails g light:decorator:install

Usage

Create decorator for your model. For example we will use the User model. We can manually create file:

# app/decorators/user_decorator.rb
class UserDecorator < ApplicationDecorator
  def full_name
    "#{object.first_name} #{object.last_name}"
  end
end

Or we can just use command to create this file:

rails g decorator User

Decorate your model in controller or anywhere.

# Single record
User.find(params[:id]).decorate
User.find_and_decorate(params[:id])
User.decorate.find(params[:id])

# Collection
User.all.decorate
User.decorate
User.limit(10).decorate
User.decorate.limit(10)

# Options
User.find_and_decorate(params[:id], with: AnotherUserDecorator)

# Associations will be decorated automatically
user = User.find_and_decorate(params[:id])
user.decorated? # true
user.comments.decorated? # true
user.comments.first.decorated? # true

Example of Decorator

class UserDecorator < ApplicationDecorator
  def full_name
    "#{object.first_name} #{object.last_name}"
    # or
    "#{o.first_name} #{o.last_name}"
  end
  
  def full_name_link
    helpers.link_to full_name, user_path(object)
    # or
    h.link_to full_name, user_path(o)
  end
end

Next steps

  • Create installation generator
  • Create decorator generator
  • Create configuration file

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/light-ruby/light-decorator. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

License

The gem is available as open source under the terms of the MIT License.