Add a paginate class method

lib/dimples/pager.rb

@@ -1,14 +1,19 @@
 # frozen_string_literal: true
 
 module Dimples
+  # A class for paginating over a group of posts.
   class Pager
     PER_PAGE = 5
 
     include Enumerable
 
     attr_reader :current_page, :previous_page, :next_page, :page_count
 
-    def initialize(url, posts, options = {})
+    def self.paginate(url:, posts:, options: {}, &block)
+      new(url: url, posts: posts, options: options).each(&block)
+    end
+
+    def initialize(url:, posts:, options: {})
       @url = url
       @posts = posts
       @per_page = options.fetch(:per_page, PER_PAGE)
@@ -18,8 +23,8 @@ def initialize(url, posts, options = {})
       step_to(1)
     end
 
-    def each(&block)
-      (1..@page_count).each { |index| block.yield step_to(index) }
+    def each
+      (1..@page_count).each { |index| yield step_to(index) }
     end
 
     def step_to(page)