PageAdams

ActiveRecord model pagination made easy.

Usage

Include PageAdams in every model you want to paginate

class Article < ApplicationRecord
  include PageAdams
end

That's it. Now you can call Article.page 5 to get the fifth page of paginated results.

page returns a hash of the following structure:

> Article.page 0
=> {:records=>#<ActiveRecord::Relation [#<Article id: 1>]>, :current_page=>1, :total_pages=>4}

in wich

the :records key holds an array of instances (or empty) (ActiveRecord::Relation)
the :current_page key holds the current retrieved page (Integer)
the :total_pages key holds the total number of instances pages (Integer)

Add this line to your application's Gemfile:

gem 'page_adams'

And then execute:

$ bundle install

Or install it yourself as:

$ gem install page_adams

A basic suite of tests has been included into the gem, using RSpec. Clone the project, enter the folder and run rspec.

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