Added support for array in paginator

spec/paginator/backend_helpers_spec.cr

@@ -27,6 +27,10 @@ class Paginatable
     paginate(FakeUser::BaseQuery.new)
   end
 
+  def call_array
+    paginate_array([1]*50)
+  end
+
   def params
     Params.new(@page)
   end
@@ -78,6 +82,33 @@ describe Lucky::Paginator::BackendHelpers do
     records.query.limit.should eq(25)
   end
 
+  it "accept array with default" do
+    pages, records = Paginatable.new.call_array
+
+    pages.page.should eq(1)
+    pages.per_page.should eq(25)
+    pages.total.should eq(2)
+    records.size.should eq(25)
+  end
+
+  it "uses array with the 'page' param if given" do
+    pages, records = Paginatable.new(page: "2").call_array
+
+    pages.page.should eq(2)
+    pages.per_page.should eq(25)
+    pages.total.should eq(2)
+    records.size.should eq(25)
+  end
+
+  it "return empty array if page is set above array size" do
+    pages, records = Paginatable.new(page: "3").call_array
+
+    pages.page.should eq(3)
+    pages.per_page.should eq(25)
+    pages.total.should eq(2)
+    records.size.should eq(0)
+  end
+
   it "allows overriding 'paginator_page' and 'paginator_per_page'" do
     pages, records = PaginatableWithOverriddenMethods.new.call
 

src/lucky/paginator/backend_helpers.cr

@@ -40,6 +40,48 @@ module Lucky::Paginator::BackendHelpers
     {pages, updated_query}
   end
 
+  # Call this in your actions to paginate an array.
+  #
+  # This method will return a `Lucky::Paginator` object and the requested page
+  # of items.
+  #
+  # ## Examples
+  #
+  # ```crystal
+  # class ListItems::Index < BrowserAction
+  #   get "/items" do
+  #     # The 'Array' will just show items for the requested page
+  #     pages, items = paginate_array([1, 2, 3])
+  #     render IndexPage, pages: pages, items: items
+  #   end
+  # end
+  #
+  # class Users::IndexPage < MainLayout
+  #   needs pages : Lucky::Paginator
+  #   needs items : Array(Int32)
+  #
+  #   def content
+  #     # Render pagination links for the 'items' Array
+  #     mount Lucky::Paginator::SimpleNav.new(@pages)
+  #   end
+  # end
+  # ```
+  def paginate_array(
+    items : Array(T),
+    per_page : Int32 = paginator_per_page
+  ) : Tuple(Paginator, Array(T)) forall T
+    pages = Paginator.new \
+      page: paginator_page,
+      per_page: per_page,
+      item_count: items.size,
+      full_path: context.request.resource
+
+    return {pages, Array(T).new} if pages.offset > items.size
+
+    updated_items = items[pages.offset...pages.offset + pages.per_page]
+    {pages, updated_items}
+  end
+
   # Returns the page that was request, or `1`
   #
   # By default this method looks for a `page` param. It can be given as a