ActiveRecordSorting

Simple gem to sort your records keeping model clean

Installation

Add this line to your application's Gemfile:

gem 'active_record_sorting'

And then execute:

$ bundle

Or install it yourself as:

$ gem install active_record_sorting

Why?

Usually when your application grows your models become a mess of different kind of logic (scopes, auth, everything). And usually you need to provide an API for sorting. Of course you add some magic Concerns and use it like this User.sort(order) and add custom orders' logic right in your model class. But if you care about you code being clean and follow single responsibility principle then you need this gem to extract sorting logic out of the model.

Usage

1. Create sorting class:

   # app/sortings
   require 'active_record_sorting/base'
   
   class UserSorting < ActiveRecordSorting::Base
     named_sorting_orders :full_name
   
     def full_name(order)
       scope.order(first_name: order, last_name: order)
     end   
   end
   

2. In your controller:

   def index
    @users = UserSorting.sort(User, params[:sort]).page(params[:page])
   end
   

   Possible values of sort param: 'id_asc', 'created_at_desc', 'relation.column_asc', 'named_order_asc'

You can also define basic sorting class if you don't want to create it for each model:

# app/sorting/sorting

require 'active_record_sorting/base'

class Sorting < ActiveRecordSorting::Base
end

Usage:

Sorting.sort(User, params[:sort])

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request