paginator 1.1.1 → 1.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 412dd437adc3fd2e1f4346d8f4a1625922b61a51
+  data.tar.gz: e73eb679ec867386d7fca8b010da284e5bb0fa29
+SHA512:
+  metadata.gz: c2552a2b8740b47ace8e8d45d7b1ec31dc1141224abf1a68d849d6fad64beda5d6834d736305aeac921ccb14ba6e12f13eb0ac8472d7ed8be88a2704c29a8941
+  data.tar.gz: 5483016b70e70910c977c30b59a75d05c9029fefbde45a3aab2c3ca7036d236a930aff0c383d2f015d0c400c6f7e1fb3dfdb910fdfebfb3f958a9a9ca4531e96

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.ruby-version

@@ -0,0 +1 @@
+2.0.0-p247

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in paginator.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2006-2013 Bruce Williams
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,64 @@
+Paginator
+=========
+
+Paginator is a simple pagination class that provides a generic interface suitable
+for use in any Ruby program.
+
+Paginator doesn't make any assumptions as to how data is retrieved; you just
+have to provide it with the total number of objects and a way to pull a specific
+set of objects based on the offset and number of objects per page.
+
+Examples
+--------
+
+In both of these examples I'm using a `PER_PAGE` constant (the number of
+items per page), but it's merely for labeling purposes.
+
+You could, of course, just pass in the number of items per page
+directly to the initializer without assigning it somewhere beforehand.
+
+### In Plain Ruby
+
+```ruby
+bunch_o_data = (1..60).to_a
+pager = Paginator.create(bunch_o_data.size, PER_PAGE) do |offset, per_page|
+  bunch_o_data[offset,per_page]
+end
+pager.each do |page|
+  puts "Page ##{page.number}"
+  page.each do |item|
+    puts item
+  end
+end
+```
+
+### In Rails
+
+Nothing changes with Paginator; you just use ActiveRecord from within
+the block you provide.
+
+A controller action:
+
+```ruby
+def index
+  @pager = Paginator.create(Foo.count, PER_PAGE) do |offset, per_page|
+    Foo.limit(per_page).offset(offset)
+  end
+  @page = @pager.page(params[:page])
+end
+```
+
+In your view:
+
+```erb
+<% @page.each do |foo| %>
+  <%# Show something for each item %>
+<% end %>
+<%= @page.number %>
+<%= link_to("Prev", foos_url(page: @page.prev.number)) if @page.prev? %>
+<%= link_to("Next", foos_url(page: @page.next.number)) if @page.next? %>
+```
+
+### License
+
+See `LICENSE.txt`.

data/Rakefile

@@ -1,21 +1,11 @@
-# -*- ruby -*-
+require "bundler/gem_tasks"
 
-require 'rubygems'
-require 'hoe'
-require './lib/paginator.rb'
+require 'rake/testtask'
 
-Hoe.new('paginator', Paginator::VERSION) do |p|
-  p.rubyforge_name = 'paginator'
-  p.summary = 'A generic paginator object for use in any Ruby program'
-  p.description =<<EOD
-Paginator doesn't make any assumptions as to how data is retrieved; you just
-have to provide it with the total number of objects and a way to pull a specific
-set of objects based on the offset and number of objects per page.  
-EOD
-  p.url = "http://paginator.rubyforge.org"
-  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
-  p.email = %q{bruce@codefluency.com}
-  p.author = ["Bruce Williams"]
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.test_files = FileList['spec/*_spec.rb']
+  t.verbose = true
 end
 
-# vim: syntax=Ruby
+task :default => :test

data/lib/paginator.rb

@@ -1,143 +1,14 @@
-require 'forwardable'
-
-class Paginator
-  
-  VERSION = '1.1.1'
-  
-  include Enumerable
+module Paginator
 
   class ArgumentError < ::ArgumentError; end
   class MissingCountError < ArgumentError; end
-  class MissingSelectError < ArgumentError; end  
-  
-  attr_reader :per_page, :count 
-  
-  # Instantiate a new Paginator object
-  #
-  # Provide:
-  # * A total count of the number of objects to paginate
-  # * The number of objects in each page
-  # * A block that returns the array of items
-  #   * The block is passed the item offset 
-  #     (and the number of items to show per page, for
-  #     convenience, if the arity is 2)
-  def initialize(count, per_page, &select)
-    @count, @per_page = count, per_page
-    unless select
-      raise MissingSelectError, "Must provide block to select data for each page"
-    end
-    @select = select
-  end
-  
-  # Total number of pages
-  def number_of_pages
-     (@count / @per_page).to_i + (@count % @per_page > 0 ? 1 : 0)
-  end
-  
-  # First page object
-  def first
-    page 1
-  end
-  
-  # Last page object
-  def last
-    page number_of_pages
-  end
-  
-  def each
-    1.upto(number_of_pages) do |number|
-      yield page(number)
-    end
-  end
-  
-  # Retrieve page object by number
-  def page(number)
-    number = (n = number.to_i) > 0 ? n : 1
-    Page.new(self, number, lambda { 
-      offset = (number - 1) * @per_page
-      args = [offset]
-      args << @per_page if @select.arity == 2
-      @select.call(*args)
-    })
-  end
-  
-  # Page object
-  #
-  # Retrieves items for a page and provides metadata about the position
-  # of the page in the paginator
-  class Page
-    
-    include Enumerable
-        
-    attr_reader :number, :pager
-    
-    def initialize(pager, number, select) #:nodoc:
-      @pager, @number = pager, number
-      @offset = (number - 1) * pager.per_page
-      @select = select
-    end
-    
-    # Retrieve the items for this page
-    # * Caches
-    def items
-      @items ||= @select.call
-    end
-    
-    # Does this page have any items?
-    def empty?
-      items.empty?
-    end
-    
-    # Checks to see if there's a page before this one
-    def prev?
-      @number > 1
-    end
-    
- #   # Get previous page (if possible)
-   def prev
-     @pager.page(@number - 1) if prev?
-   end
-    
-    # Checks to see if there's a page after this one
-    def next?
-      @number < @pager.number_of_pages
-    end
-    
-    # Get next page (if possible)
-   def next
-     @pager.page(@number + 1) if next?
-   end
-    
-    # The "item number" of the first item on this page
-    def first_item_number
-      1 + @offset
-    end
-    
-    # The "item number" of the last item on this page
-    def last_item_number
-      if next?
-        @offset + @pager.per_page
-      else
-        @pager.count
-      end
-    end
-    
-    def ==(other) #:nodoc:
-      @pager == other.pager && self.number == other.number
-    end
-    
-    def each(&block)
-      items.each(&block)
-    end
-    
-    def method_missing(meth, *args, &block) #:nodoc:
-      if @pager.respond_to?(meth)
-        @pager.__send__(meth, *args, &block)
-      else
-        super
-      end
-    end
-    
+  class MissingSelectError < ArgumentError; end
+
+  autoload :Pager, 'paginator/pager'
+  autoload :Page,  'paginator/page'
+
+  def self.create(count, per_page, &select)
+    Pager.new(count, per_page, &select)
   end
-  
-end
+
+end

data/lib/paginator/page.rb

@@ -0,0 +1,82 @@
+module Paginator
+
+  # Page object
+  #
+  # Retrieves items for a page and provides metadata about the position
+  # of the page in the paginator
+  class Page
+
+    include Enumerable
+
+    attr_reader :number, :pager
+
+    def initialize(pager, number, select) #:nodoc:
+      @pager, @number = pager, number
+      @offset = (number - 1) * pager.per_page
+      @select = select
+    end
+
+    # Retrieve the items for this page
+    # * Caches
+    def items
+      @items ||= @select.call
+    end
+
+    # Does this page have any items?
+    def empty?
+      items.empty?
+    end
+
+    # Checks to see if there's a page before this one
+    def prev?
+      @number > 1
+    end
+
+    # Get previous page (if possible)
+    def prev
+      @pager.page(@number - 1) if prev?
+    end
+
+    # Checks to see if there's a page after this one
+    def next?
+      @number < @pager.number_of_pages
+    end
+
+    # Get next page (if possible)
+    def next
+      @pager.page(@number + 1) if next?
+    end
+
+    # The "item number" of the first item on this page
+    def first_item_number
+      1 + @offset
+    end
+
+    # The "item number" of the last item on this page
+    def last_item_number
+      if next?
+        @offset + @pager.per_page
+      else
+        @pager.count
+      end
+    end
+
+    def ==(other) #:nodoc:
+      @pager == other.pager && self.number == other.number
+    end
+
+    def each(&block)
+      items.each(&block)
+    end
+
+    def method_missing(meth, *args, &block) #:nodoc:
+      if @pager.respond_to?(meth)
+        @pager.__send__(meth, *args, &block)
+      else
+        super
+      end
+    end
+
+  end
+
+end

data/lib/paginator/pager.rb

@@ -0,0 +1,59 @@
+module Paginator
+
+  class Pager
+    include Enumerable
+
+    attr_reader :per_page, :count
+
+    # Instantiate a new Paginator object
+    #
+    # Provide:
+    # * A total count of the number of objects to paginate
+    # * The number of objects in each page
+    # * A block that returns the array of items
+    #   * The block is passed the item offset
+    #     (and the number of items to show per page, for
+    #     convenience, if the arity is 2)
+    def initialize(count, per_page, &select)
+      @count, @per_page = count, per_page
+      unless select
+        raise MissingSelectError, "Must provide block to select data for each page"
+      end
+      @select = select
+    end
+
+    # Total number of pages
+    def number_of_pages
+      (@count / @per_page).to_i + (@count % @per_page > 0 ? 1 : 0)
+    end
+
+    # First page object
+    def first
+      page 1
+    end
+
+    # Last page object
+    def last
+      page number_of_pages
+    end
+
+    def each(&block)
+      return enum_for(:each) unless block_given?
+      1.upto(number_of_pages) do |number|
+        yield page(number)
+      end
+    end
+
+    # Retrieve page object by number
+    def page(number)
+      number = (n = number.to_i) > 0 ? n : 1
+      Page.new(self, number, lambda {
+                 offset = (number - 1) * @per_page
+                 args = [offset]
+                 args << @per_page if @select.arity == 2
+                 @select.call(*args)
+               })
+    end
+  end
+
+end

data/lib/paginator/version.rb

@@ -0,0 +1,3 @@
+module Paginator
+  VERSION = '1.2.0'
+end

data/paginator.gemspec

@@ -0,0 +1,22 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'paginator/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "paginator"
+  spec.version       = Paginator::VERSION
+  spec.authors       = ["Bruce Williams"]
+  spec.email         = ["bruce.williams@livingsocial.com"]
+  spec.summary       = 'A generic paginator object for use in any Ruby program'
+  spec.description   = "Paginator doesn't make any assumptions as to how data is retrieved; you just have to provide it with tee total number of objects and a way to pull a specific set of objects based on the offset and number of objects per page."
+  spec.homepage      = "http://github.com/bruce/paginator"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.3"
+end

data/{test/test_paginator.rb → spec/paginator_spec.rb}

@@ -1,66 +1,68 @@
-require 'test/unit'
+require 'minitest/autorun'
+require 'minitest/spec'
 require 'paginator'
 
-class PaginatorTest < Test::Unit::TestCase
+PER_PAGE = 10
 
-  PER_PAGE = 10
+describe Paginator do
 
-  def setup
+  before do
     @data = (0..43).to_a
-    @pager = Paginator.new(@data.size, PER_PAGE) do |offset,per_page|
-      @data[offset,per_page]
+    @pager = Paginator.create(@data.size, PER_PAGE) do |offset, per_page|
+      @data[offset, per_page]
     end
   end
-  
-  def test_initializing_paginator_raises_exception
+
+  it "needs a block" do
     assert_raises(Paginator::MissingSelectError) do
-      @pager = Paginator.new(@data.size, PER_PAGE)
+      @pager = Paginator.create(@data.size, PER_PAGE)
     end
-  end  
-  
-  def test_can_get_last_page_from_page_object
-    assert_equal @pager.last, @pager.page(2).last
   end
-  
-  def test_can_get_first_page_from_page_object
-    assert_equal @pager.first, @pager.page(2).first    
+
+  it "can get the last page" do
+    assert_equal @pager.last, @pager.page(5)
   end
 
-  def test_does_not_exceed_per_page
+  it "can get the first page" do
+    assert_equal @pager.first, @pager.page(1)
+  end
+
+  it "does not exceed per_page" do
     @pager.each do |page|
       assert page.items.size <= PER_PAGE
     end
   end
-  
-  def test_only_last_page_has_less_items
+
+  it "only has less items on the last page" do
     @pager.each do |page|
       if page != @pager.last
         assert page.items.size <= PER_PAGE
       else
         assert page.items.size < PER_PAGE
       end
-    end    
+    end
   end
-  
-  def test_returns_correct_first_page
+
+  it "returns the correct first page" do
     assert_equal @pager.page(1).number, @pager.first.number
   end
-  
-  def test_returns_correct_last_page
+
+
+  it "returns the correct last page" do
     assert_equal @pager.page(5).number, @pager.last.number
   end
-  
-  def test_last_page_has_no_next_page
+
+  it "has no next page when on the last page" do
     assert !@pager.last.next?
     assert !@pager.last.next
   end
 
-  def test_first_page_has_no_prev_page
+  it "has no previous page on the first page" do
     assert !@pager.first.prev?
     assert !@pager.first.prev
   end
-  
-  def test_page_enumerable
+
+  it "is enumerable" do
     @pager.each do |page|
       assert page
       page.each do |item|
@@ -72,14 +74,14 @@ class PaginatorTest < Test::Unit::TestCase
       assert_equal page.items, page.inject([]) {|list, item| list << item }
     end
   end
-  
-  def test_each_with_index
+
+  it "supports each.with_index" do
     page_offset = 0
-    @pager.each_with_index do |page, page_index|
+    @pager.each.with_index do |page, page_index|
       assert page
       assert_equal page_offset, page_index
       item_offset = 0
-      page.each_with_index do |item, item_index|
+      page.each.with_index do |item, item_index|
         assert item
         assert_equal item_offset, item_index
         item_offset += 1
@@ -87,28 +89,28 @@ class PaginatorTest < Test::Unit::TestCase
       page_offset += 1
     end
   end
-  
-  def test_number_of_pages
+
+  it "has the correct number of pages" do
     assert_equal 5, @pager.number_of_pages
   end
-  
-  def test_passing_block_to_initializer_with_arity_of_two_yields_per_page
-    pager = Paginator.new(20,2) do |offset,per_page|
+
+  it "yields per_page for a block with an arity of 2" do
+    pager = Paginator.create(20, 2) do |offset, per_page|
       assert_equal 2, per_page
     end
     pager.page(1).items
   end
 
-  def test_passing_block_to_initializer_with_arity_of_one_does_not_yield_per_page
-    pager = Paginator.new(20,2) do |offset|
+  it "does not yield per_page for a block of arity 1" do
+    pager = Paginator.create(20, 2) do |offset|
       assert_equal 0, offset
     end
     pager.page(1).items
   end
-  
-  def test_page_object_knows_first_and_last_item_numbers
+
+  it "has pages that know the first and last page numbers" do
     items = (1..11).to_a
-    pager = Paginator.new(items.size,3) do |offset, per_page|
+    pager = Paginator.create(items.size,3) do |offset, per_page|
       items[offset, per_page]
     end
     page = pager.page(1)
@@ -119,19 +121,10 @@ class PaginatorTest < Test::Unit::TestCase
     assert_equal 6, page.last_item_number
     page = pager.page(3)
     assert_equal 7, page.first_item_number
-    assert_equal 9, page.last_item_number    
+    assert_equal 9, page.last_item_number
     page = pager.page(4)
     assert_equal 10, page.first_item_number
-    assert_equal 11, page.last_item_number    
+    assert_equal 11, page.last_item_number
   end
 
 end
-
-class PaginatorTestWithMathN < PaginatorTest
-  
-  def setup
-    require 'mathn'
-    super
-  end
-  
-end

metadata

@@ -1,71 +1,73 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: paginator
-version: !ruby/object:Gem::Version 
-  version: 1.1.1
+version: !ruby/object:Gem::Version
+  version: 1.2.0
 platform: ruby
-authors: 
+authors:
 - Bruce Williams
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2008-06-25 00:00:00 -05:00
-default_executable: 
-dependencies: 
-- !ruby/object:Gem::Dependency 
-  name: hoe
-  type: :runtime
-  version_requirement: 
-  version_requirements: !ruby/object:Gem::Requirement 
-    requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 1.6.0
-    version: 
-description: Paginator doesn't make any assumptions as to how data is retrieved; you just have to provide it with the total number of objects and a way to pull a specific set of objects based on the offset and number of objects per page.
-email: bruce@codefluency.com
-executables: 
-- paginator
+date: 2013-07-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+description: Paginator doesn't make any assumptions as to how data is retrieved; you
+  just have to provide it with tee total number of objects and a way to pull a specific
+  set of objects based on the offset and number of objects per page.
+email:
+- bruce.williams@livingsocial.com
+executables: []
 extensions: []
-
-extra_rdoc_files: 
-- History.txt
-- Manifest.txt
-- README.txt
-files: 
-- History.txt
-- Manifest.txt
-- README.txt
+extra_rdoc_files: []
+files:
+- .gitignore
+- .ruby-version
+- Gemfile
+- LICENSE.txt
+- README.md
 - Rakefile
-- bin/paginator
 - lib/paginator.rb
-- test/test_paginator.rb
-has_rdoc: true
-homepage: http://paginator.rubyforge.org
+- lib/paginator/page.rb
+- lib/paginator/pager.rb
+- lib/paginator/version.rb
+- paginator.gemspec
+- spec/paginator_spec.rb
+homepage: http://github.com/bruce/paginator
+licenses:
+- MIT
+metadata: {}
 post_install_message: 
-rdoc_options: 
-- --main
-- README.txt
-require_paths: 
+rdoc_options: []
+require_paths:
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-  version: 
-required_rubygems_version: !ruby/object:Gem::Requirement 
-  requirements: 
-  - - ">="
-    - !ruby/object:Gem::Version 
-      version: "0"
-  version: 
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
-rubyforge_project: paginator
-rubygems_version: 1.2.0
+rubyforge_project: 
+rubygems_version: 2.0.3
 signing_key: 
-specification_version: 2
+specification_version: 4
 summary: A generic paginator object for use in any Ruby program
-test_files: 
-- test/test_paginator.rb
+test_files:
+- spec/paginator_spec.rb

data/History.txt

@@ -1,43 +0,0 @@
-== 1.1.0 / 2007-10-12
-
-* Paginator now mixes in Enumerable (supporting inject, etc, on pages)
-* Page now mixes in Enumerable (supporting inject, etc, on items)
-
-== 1.0.9 / 2007-02-17
-
-* Modified Pager#number_of_pages to support mathn's monkeypatching of Fixnum#/
-  * Thanks, Paul King!
-
-== 1.0.8 / 2006-11-02
-
-* Added <tt>Page#first_item_number</tt> and <tt>Page#last_item_number</tt>
-  * Thanks, Quannon Au!
-
-== 1.0.6 / 2006-11-02
-
-* Added each_with_index to Paginator and Page classes
-
-== 1.0.5 / 2006-10-27
-
-* Fix to Rakefile (addresses #6304)
-
-== 1.0.4 / 2006-10-27
-
-* Documentation fix
-
-== 1.0.3 / 2006-10-26
-
-* Documentation fix
-
-== 1.0.2 / 2006-10-25
-
-* If the block passed during Paginator has an arity of 1, the number
-  of items per page will not be yielded to the block.
-
-== 1.0.1 / 2006-10-24
-
-* Made Paginator#page more accepting, and set it to default to 1
-
-== 1.0.0 / 2006-10-23
-
-* Initial release

data/Manifest.txt

@@ -1,7 +0,0 @@
-History.txt
-Manifest.txt
-README.txt
-Rakefile
-bin/paginator
-lib/paginator.rb
-test/test_paginator.rb

data/README.txt

@@ -1,84 +0,0 @@
-paginator
-    by Bruce Williams
-    http://codefluency.com
-
-== DESCRIPTION:
-  
-Paginator is a simple pagination class that provides a generic interface suitable
-for use in any Ruby program.
-
-== FEATURES/PROBLEMS:
-  
-Paginator doesn't make any assumptions as to how data is retrieved; you just
-have to provide it with the total number of objects and a way to pull a specific
-set of objects based on the offset and number of objects per page.
-
-== SYNOPSIS:
-
-In both of these examples I'm using a PER_PAGE constant (the number of items per page), but it's merely for labeling purposes.
-
-You could, of course, just pass in the number of items per page directly to the initializer without assigning it somewhere beforehand.
-
-=== In a Rails Application
-
-  def index
-    @pager = ::Paginator.new(Foo.count, PER_PAGE) do |offset, per_page|
-      Foo.find(:all, :limit => per_page, :offset => offset)
-    end
-    @page = @pager.page(params[:page])
-    # respond_to here if you want it
-  end
-
-  # In your view
-  <% @page.each do |foo| %>
-    <%# Show something for each item %>
-  <% end %>
-  <%= @page.number %>
-  <%= link_to("Prev", foos_url(:page => @page.prev.number)) if @page.prev? %>
-  <%= link_to("Next", foos_url(:page => @page.next.number)) if @page.next? %>
-
-=== Anything else
-
-  bunch_o_data = (1..60).to_a
-  pager = Paginator.new(bunch_o_data.size, PER_PAGE) do |offset, per_page|
-    bunch_o_data[offset,per_page]
-  end
-  pager.each do |page|
-    puts "Page ##{page.number}"
-    page.each do |item|
-      puts item
-    end
-  end
-
-== REQUIREMENTS:
-
-None.
-
-== INSTALL:
-
-No special instructions.
-
-== LICENSE:
-
-(The MIT License)
-
-Copyright (c) 2006-2007 Bruce Williams (http://codefluency.com)
-
-Permission is hereby granted, free of charge, to any person obtaining
-a copy of this software and associated documentation files (the
-'Software'), to deal in the Software without restriction, including
-without limitation the rights to use, copy, modify, merge, publish,
-distribute, sublicense, and/or sell copies of the Software, and to
-permit persons to whom the Software is furnished to do so, subject to
-the following conditions:
-
-The above copyright notice and this permission notice shall be
-included in all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
-EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
-MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
-CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
-TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
-SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.