kaminari 0.1.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format=d

data/Gemfile

@@ -0,0 +1,21 @@
+source 'http://rubygems.org'
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem 'rspec', '>= 2.4.0'
+  gem 'rr', '>= 1.0.2'
+  gem 'bundler', '>= 1.0.0'
+  gem 'jeweler', '>= 1.5.2'
+  gem 'rcov', '>= 0'
+  gem 'rails', :git => 'git://github.com/rails/rails.git'
+#   gem 'rails', '>= 3.0.3'
+  gem 'rack', :git => 'git://github.com/rack/rack.git'
+  gem 'arel', :git => 'git://github.com/rails/arel.git'
+  gem 'rspec-rails', :git => 'git://github.com/rspec/rspec-rails.git'# 2.4.1 needed
+  gem 'sqlite3', '>= 1.3.3'
+  gem 'ruby-debug'
+end

data/Gemfile.lock

@@ -0,0 +1,136 @@
+GIT
+  remote: git://github.com/rack/rack.git
+  revision: 1c2715778d3753dce4d8df19e3d3cc698aed20c6
+  specs:
+    rack (1.2.1)
+
+GIT
+  remote: git://github.com/rails/arel.git
+  revision: 4d92a6b33476a5b324188bd86dfa5b5d3f4dcd3a
+  specs:
+    arel (2.0.7.beta.20110121165657)
+
+GIT
+  remote: git://github.com/rails/rails.git
+  revision: 59f7780a3454a14054d1d33d9b6e31192ab2e58b
+  specs:
+    actionmailer (3.1.0.beta)
+      actionpack (= 3.1.0.beta)
+      mail (~> 2.2.15)
+    actionpack (3.1.0.beta)
+      activemodel (= 3.1.0.beta)
+      activesupport (= 3.1.0.beta)
+      builder (~> 3.0.0)
+      erubis (~> 2.6.6)
+      i18n (~> 0.5.0)
+      rack (~> 1.2.1)
+      rack-cache (~> 1.0.0)
+      rack-mount (~> 0.6.13)
+      rack-test (~> 0.5.7)
+      tzinfo (~> 0.3.23)
+    activemodel (3.1.0.beta)
+      activesupport (= 3.1.0.beta)
+      bcrypt-ruby (~> 2.1.4)
+      builder (~> 3.0.0)
+      i18n (~> 0.5.0)
+    activerecord (3.1.0.beta)
+      activemodel (= 3.1.0.beta)
+      activesupport (= 3.1.0.beta)
+      arel (~> 2.0.2)
+      tzinfo (~> 0.3.23)
+    activeresource (3.1.0.beta)
+      activemodel (= 3.1.0.beta)
+      activesupport (= 3.1.0.beta)
+    activesupport (3.1.0.beta)
+    rails (3.1.0.beta)
+      actionmailer (= 3.1.0.beta)
+      actionpack (= 3.1.0.beta)
+      activerecord (= 3.1.0.beta)
+      activeresource (= 3.1.0.beta)
+      activesupport (= 3.1.0.beta)
+      bundler (~> 1.0)
+      railties (= 3.1.0.beta)
+    railties (3.1.0.beta)
+      actionpack (= 3.1.0.beta)
+      activesupport (= 3.1.0.beta)
+      rake (>= 0.8.7)
+      thor (~> 0.14.4)
+
+GIT
+  remote: git://github.com/rspec/rspec-rails.git
+  revision: 3b279c63397975ef95219ecdb53b497ebc8dc9f0
+  specs:
+    rspec-rails (2.4.1)
+      actionpack (~> 3.0)
+      activesupport (~> 3.0)
+      railties (~> 3.0)
+      rspec (~> 2.4.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    abstract (1.0.0)
+    bcrypt-ruby (2.1.4)
+    builder (3.0.0)
+    columnize (0.3.2)
+    diff-lcs (1.1.2)
+    erubis (2.6.6)
+      abstract (>= 1.0.0)
+    git (1.2.5)
+    i18n (0.5.0)
+    jeweler (1.5.2)
+      bundler (~> 1.0.0)
+      git (>= 1.2.5)
+      rake
+      ruby-debug
+    linecache (0.43)
+    mail (2.2.15)
+      activesupport (>= 2.3.6)
+      i18n (>= 0.4.0)
+      mime-types (~> 1.16)
+      treetop (~> 1.4.8)
+    mime-types (1.16)
+    polyglot (0.3.1)
+    rack-cache (1.0)
+      rack (>= 0.4)
+    rack-mount (0.6.13)
+      rack (>= 1.0.0)
+    rack-test (0.5.7)
+      rack (>= 1.0)
+    rake (0.8.7)
+    rcov (0.9.9)
+    rr (1.0.2)
+    rspec (2.4.0)
+      rspec-core (~> 2.4.0)
+      rspec-expectations (~> 2.4.0)
+      rspec-mocks (~> 2.4.0)
+    rspec-core (2.4.0)
+    rspec-expectations (2.4.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.4.0)
+    ruby-debug (0.10.4)
+      columnize (>= 0.1)
+      ruby-debug-base (~> 0.10.4.0)
+    ruby-debug-base (0.10.4)
+      linecache (>= 0.3)
+    sqlite3 (1.3.3)
+    thor (0.14.6)
+    treetop (1.4.9)
+      polyglot (>= 0.3.1)
+    tzinfo (0.3.24)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  arel!
+  bundler (>= 1.0.0)
+  jeweler (>= 1.5.2)
+  rack!
+  rails!
+  rcov
+  rr (>= 1.0.2)
+  rspec (>= 2.4.0)
+  rspec-rails!
+  ruby-debug
+  sqlite3 (>= 1.3.3)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Akira Matsuda
+
+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.rdoc

@@ -0,0 +1,81 @@
+= Kaminari
+
+A Scope & Engine based clean and powerful and customizable and sophisticated paginator for Rails 3
+
+
+== Features
+
+* Clean
+Does not globally pollute Array, Hash, Object or AR::Base.
+
+* Easy to use
+Just bundle the gem, then your models are ready to be paginated. No configuration. Don't have to define anything in your models or helpers.
+
+* Scope based simple API
+Everything is method chainable. No Hash for the query. You know, that's the Rails 3 way.
+No special collection class or something for the paginated values but uses a general AR::Relation instance. So, of course you can chain any other conditions before or after the paginator scope.
+
+* Engine based customizable helper
+As the whole pagination helper is basically just a collection of links and non-links, Kaminari renders each of them through its own partial template inside the Engine. So, you can easily modify their behaviour or style or whatever by overriding partial templates.
+
+
+== Rails versions
+
+3.0.x and 3.1
+
+
+== Install
+
+Put this line in your Gemfile:
+  gem 'kaminari'
+
+Then bundle:
+  % bundle
+
+
+== Usage
+
+* Fetch the 7th page of the users (per_page = 10 by default)
+
+  @users = User.page(7)
+
+* Show a lot more users per each page (change the per_page value)
+
+  @users = User.page(7).per(30)
+
+* Typically, your controller code will look like this:
+
+  @users = User.page params[:page]
+
+* In your view
+
+  <%= paginate @users %>
+
+* Specify the "window" size
+
+  # "inner window" (4 by default)
+
+  <%= paginate @users, :window => 3 %>
+
+  # "outer window" (1 by default)
+
+  <%= paginate @users, :outer_window => 3 %>
+
+  # outer window can be separetely specified by "left", "right" (1 by default)
+
+  <%= paginate @users, :left => 0, :right => 2 %>
+
+* Customize the pagination helper
+
+  % rails g kaminari:views
+Then edit the partials in your app's app/views/kaminari/ directory.
+
+
+== Contributing to Kaminari
+
+* Fork, fix, then send me a pull request.
+
+
+== Copyright
+
+Copyright (c) 2011 Akira Matsuda. See LICENSE.txt for further details.

data/Rakefile

@@ -0,0 +1,52 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "kaminari"
+  gem.homepage = "http://github.com/amatsuda/kaminari"
+  gem.license = "MIT"
+  gem.summary = 'A pagnation engine plugin for Rails 3'
+  gem.description = 'Kaminari is a Scope & Engine based clean and powerful and customizable and sophisticated paginator for Rails 3'
+  gem.email = "ronnie@dio.jp"
+  gem.authors = ["Akira Matsuda"]
+  # Include your dependencies below. Runtime dependencies are required when using your gem,
+  # and development dependencies are only needed for development (ie running rake tasks, tests, etc)
+   gem.add_runtime_dependency 'rails', '>= 3.0.0'
+  #  gem.add_development_dependency 'rspec', '> 1.2.3'
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "kaminari #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/TODO.txt

@@ -0,0 +1,11 @@
+* partialize the outer div
+
+* suppress logging when rendering each partial
+
+* add generator option to copy particular template
+
+* add Haml generator
+
+* add Ajax generator
+
+* I18n?

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/app/views/kaminari/_current_page.html.erb

@@ -0,0 +1 @@
+<span class="page current"><%= page %></span>

data/app/views/kaminari/_first_page_link.html.erb

@@ -0,0 +1,3 @@
+<span class="page first">
+  <%= link_to page, page_url %>
+</span>

data/app/views/kaminari/_last_page_link.html.erb

@@ -0,0 +1,3 @@
+<span class="page last">
+  <%= link_to page, page_url %>
+</span>

data/app/views/kaminari/_next_link.html.erb

@@ -0,0 +1,3 @@
+<span class="next">
+  <%= link_to_if (current_page < num_pages), raw('Next &raquo;'), next_url, :class => 'next', :rel => 'next' %>
+</span>

data/app/views/kaminari/_next_span.html.erb

@@ -0,0 +1 @@
+<span class="next"></span>

data/app/views/kaminari/_page_link.html.erb

@@ -0,0 +1,3 @@
+<span class="page">
+  <%= link_to page, page_url %>
+</span>

data/app/views/kaminari/_prev_link.html.erb

@@ -0,0 +1,3 @@
+<span class="prev">
+  <%= link_to_if (current_page > 1), raw('&laquo; Prev'), prev_url, :class => 'prev', :rel => 'prev' %>
+</span>

data/app/views/kaminari/_prev_span.html.erb

@@ -0,0 +1 @@
+<span class="prev"></span>

data/app/views/kaminari/_truncated_span.html.erb

@@ -0,0 +1 @@
+<span class="page">...</span>

data/kaminari.gemspec

@@ -0,0 +1,113 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{kaminari}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Akira Matsuda"]
+  s.date = %q{2011-02-06}
+  s.description = %q{Kaminari is a Scope & Engine based clean and powerful and customizable and sophisticated paginator for Rails 3}
+  s.email = %q{ronnie@dio.jp}
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "TODO.txt",
+    "VERSION",
+    "app/views/kaminari/_current_page.html.erb",
+    "app/views/kaminari/_first_page_link.html.erb",
+    "app/views/kaminari/_last_page_link.html.erb",
+    "app/views/kaminari/_next_link.html.erb",
+    "app/views/kaminari/_next_span.html.erb",
+    "app/views/kaminari/_page_link.html.erb",
+    "app/views/kaminari/_prev_link.html.erb",
+    "app/views/kaminari/_prev_span.html.erb",
+    "app/views/kaminari/_truncated_span.html.erb",
+    "kaminari.gemspec",
+    "lib/generators/kaminari/views_generator.rb",
+    "lib/kaminari.rb",
+    "lib/kaminari/active_record.rb",
+    "lib/kaminari/engine.rb",
+    "lib/kaminari/helpers.rb",
+    "lib/kaminari/railtie.rb",
+    "spec/controllers/application_helper_spec.rb",
+    "spec/helpers/helpers_spec.rb",
+    "spec/models/scopes_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/support/20110128122508_create_users.rb",
+    "spec/support/matchers.rb",
+    "spec/support/user.rb"
+  ]
+  s.homepage = %q{http://github.com/amatsuda/kaminari}
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.4.2}
+  s.summary = %q{A pagnation engine plugin for Rails 3}
+  s.test_files = [
+    "spec/controllers/application_helper_spec.rb",
+    "spec/helpers/helpers_spec.rb",
+    "spec/models/scopes_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/support/20110128122508_create_users.rb",
+    "spec/support/matchers.rb",
+    "spec/support/user.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 2.4.0"])
+      s.add_development_dependency(%q<rr>, [">= 1.0.2"])
+      s.add_development_dependency(%q<bundler>, [">= 1.0.0"])
+      s.add_development_dependency(%q<jeweler>, [">= 1.5.2"])
+      s.add_development_dependency(%q<rcov>, [">= 0"])
+      s.add_development_dependency(%q<rails>, [">= 0"])
+      s.add_development_dependency(%q<rack>, [">= 0"])
+      s.add_development_dependency(%q<arel>, [">= 0"])
+      s.add_development_dependency(%q<rspec-rails>, [">= 0"])
+      s.add_development_dependency(%q<sqlite3>, [">= 1.3.3"])
+      s.add_development_dependency(%q<ruby-debug>, [">= 0"])
+      s.add_runtime_dependency(%q<rails>, [">= 3.0.0"])
+    else
+      s.add_dependency(%q<rspec>, [">= 2.4.0"])
+      s.add_dependency(%q<rr>, [">= 1.0.2"])
+      s.add_dependency(%q<bundler>, [">= 1.0.0"])
+      s.add_dependency(%q<jeweler>, [">= 1.5.2"])
+      s.add_dependency(%q<rcov>, [">= 0"])
+      s.add_dependency(%q<rails>, [">= 0"])
+      s.add_dependency(%q<rack>, [">= 0"])
+      s.add_dependency(%q<arel>, [">= 0"])
+      s.add_dependency(%q<rspec-rails>, [">= 0"])
+      s.add_dependency(%q<sqlite3>, [">= 1.3.3"])
+      s.add_dependency(%q<ruby-debug>, [">= 0"])
+      s.add_dependency(%q<rails>, [">= 3.0.0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 2.4.0"])
+    s.add_dependency(%q<rr>, [">= 1.0.2"])
+    s.add_dependency(%q<bundler>, [">= 1.0.0"])
+    s.add_dependency(%q<jeweler>, [">= 1.5.2"])
+    s.add_dependency(%q<rcov>, [">= 0"])
+    s.add_dependency(%q<rails>, [">= 0"])
+    s.add_dependency(%q<rack>, [">= 0"])
+    s.add_dependency(%q<arel>, [">= 0"])
+    s.add_dependency(%q<rspec-rails>, [">= 0"])
+    s.add_dependency(%q<sqlite3>, [">= 1.3.3"])
+    s.add_dependency(%q<ruby-debug>, [">= 0"])
+    s.add_dependency(%q<rails>, [">= 3.0.0"])
+  end
+end
+

data/lib/generators/kaminari/views_generator.rb

@@ -0,0 +1,12 @@
+module Kaminari
+  module Generators
+    class ViewsGenerator < Rails::Generators::Base
+      source_root File.expand_path('../../../../app/views', __FILE__)
+
+      desc 'Copies all paginator partials to your application.'
+      def copy_views
+        directory 'kaminari', 'app/views/kaminari'
+      end
+    end
+  end
+end

data/lib/kaminari.rb

@@ -0,0 +1,2 @@
+require File.join(File.dirname(__FILE__), 'kaminari/railtie')
+require File.join(File.dirname(__FILE__), 'kaminari/engine')

data/lib/kaminari/active_record.rb

@@ -0,0 +1,37 @@
+module Kaminari
+  module ActiveRecord
+    extend ActiveSupport::Concern
+    PER_PAGE = 10
+
+    included do
+      def self.inherited(kls)
+        # TERRIBLE HORRIBLE NO GOOD VERY BAD HACK: inheritable_attributes is not yet set here on AR 3.0
+        unless kls.default_scoping
+          new_inheritable_attributes = Hash[inheritable_attributes.map do |key, value|
+            [key, value.duplicable? ? value.dup : value]
+          end]
+          kls.instance_variable_set('@inheritable_attributes', new_inheritable_attributes)
+        end
+        kls.class_eval do
+          # page(5)
+          scope :page, lambda {|num|
+            offset(PER_PAGE * ([num.to_i, 1].max - 1)).limit(PER_PAGE)
+          } do
+            # page(3).per(20)
+            def per(num)
+              offset(offset_value / limit_value * num).limit(num)
+            end
+
+            def num_pages
+              (except(:offset, :limit).count.to_f / limit_value).ceil
+            end
+
+            def current_page
+              (offset_value / limit_value) + 1
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/kaminari/engine.rb

@@ -0,0 +1,4 @@
+module Kaminari
+  class Engine < ::Rails::Engine
+  end
+end

data/lib/kaminari/helpers.rb

@@ -0,0 +1,105 @@
+module Kaminari
+  module Helpers
+    class Tag
+      def initialize(renderer, options = {})
+        @renderer, @options = renderer, renderer.options.merge(options)
+      end
+
+      def to_s(locals = {})
+        @renderer.render :partial => "kaminari/#{self.class.name.demodulize.underscore}", :locals => @options.merge(locals)
+      end
+
+      private
+      def page_url_for(page)
+        @renderer.url_for @renderer.params.merge(:page => (page <= 1 ? nil : page))
+      end
+    end
+
+    class PrevSpan < Tag
+    end
+
+    class PrevLink < Tag
+      def to_s
+        super :prev_url => page_url_for(@options[:current_page] - 1)
+      end
+    end
+
+    class NextSpan < Tag
+    end
+
+    class NextLink < Tag
+      def to_s
+        super :next_url => page_url_for(@options[:current_page] + 1)
+      end
+    end
+
+    class PageLink < Tag
+      def to_s
+        super :page_url => page_url_for(@options[:page])
+      end
+    end
+
+    class CurrentPage < Tag
+      def to_s
+        super :page_url => page_url_for(@options[:page])
+      end
+    end
+
+    class FirstPageLink < PageLink
+    end
+
+    class LastPageLink < PageLink
+    end
+
+    class TruncatedSpan < Tag
+    end
+
+    class PaginationRenderer
+      attr_reader :options
+
+      def initialize(template, options)
+        @template, @options = template, options
+        @left, @window, @right = (options[:left] || options[:outer_window] || 1), (options[:window] || options[:inner_window] || 4), (options[:right] || options[:outer_window] || 1)
+      end
+
+      def to_s
+        @template.content_tag :div, :class => 'pagination' do
+          tagify.join("\n").html_safe
+        end
+      end
+
+      def tagify
+        num_pages, current_page, left, window, right = @options[:num_pages], @options[:current_page], @left, @window, @right
+
+        tags = []
+        tags << (current_page > 1 ? PrevLink.new(self) : PrevSpan.new(self))
+        1.upto(num_pages) do |i|
+          if i == current_page
+            tags << CurrentPage.new(self, :page => i)
+          elsif (i <= left + 1) || ((num_pages - i) <= right) || ((i - current_page).abs <= window)
+            case i
+            when 1
+              tags << FirstPageLink.new(self, :page => i)
+            when num_pages
+              tags << LastPageLink.new(self, :page => i)
+            else
+              tags << PageLink.new(self, :page => i)
+            end
+          else
+            tags << TruncatedSpan.new(self) unless tags.last.is_a? TruncatedSpan
+          end
+        end
+        tags << (num_pages > current_page ? NextLink.new(self) : NextSpan.new(self))
+      end
+
+      private
+      def method_missing(meth, *args, &blk)
+        @template.send meth, *args, &blk
+      end
+    end
+
+    def paginate(scope, options = {}, &block)
+      PaginationRenderer.new self, options.reverse_merge(:current_page => scope.current_page, :num_pages => scope.num_pages)
+    end
+  end
+end

data/lib/kaminari/railtie.rb

@@ -0,0 +1,14 @@
+require 'rails'
+require 'active_record'
+require 'action_view'
+require File.join(File.dirname(__FILE__), 'active_record')
+require File.join(File.dirname(__FILE__), 'helpers')
+
+module Kaminari
+  class Railtie < ::Rails::Railtie
+    initializer 'paginatablize' do |app|
+      ::ActiveRecord::Base.send :include, Kaminari::ActiveRecord
+      ::ActionView::Base.send :include, Kaminari::Helpers
+    end
+  end
+end

data/spec/controllers/application_helper_spec.rb

@@ -0,0 +1,21 @@
+require File.expand_path(File.dirname(__FILE__) + '/../spec_helper')
+
+class ApplicationController < ActionController::Base; end
+class UsersController < ApplicationController
+  def index
+    @users = User.page params[:page]
+    render :inline => '<%= paginate @users %>'
+  end
+end
+
+describe UsersController, 'pagination' do
+  render_views
+  before do
+    1.upto(30) {|i| User.create! :name => "user#{'%02d' % i}" }
+  end
+
+  it 'renders' do
+    get :index
+    response.body.should =~ /pagination/
+  end
+end

data/spec/helpers/helpers_spec.rb

@@ -0,0 +1,109 @@
+require File.expand_path('../spec_helper', File.dirname(__FILE__))
+include Kaminari::Helpers
+
+describe 'Kaminari::Helpers::PaginationRenderer' do
+  let :renderer do
+    stub(r = Object.new) do
+      render.with_any_args
+      params { {} }
+      url_for {|h| "/foo?page=#{h[:page]}"}
+    end
+    r
+  end
+  describe '#tagify' do
+    def tags_with(options)
+      PaginationRenderer.new(renderer, options).tagify
+    end
+
+    context 'first page' do
+      subject { tags_with :num_pages => 10, :current_page => 1 }
+      it { should_not contain_tag PrevLink }
+      it { should contain_tag PrevSpan }
+      it { should contain_tag CurrentPage }
+      it { should_not contain_tag FirstPageLink }
+      it { should contain_tag LastPageLink }
+      it { should contain_tag PageLink }
+      it { should contain_tag NextLink }
+      it { should_not contain_tag NextSpan }
+      it { should contain_tag TruncatedSpan }
+    end
+
+    context 'second page' do
+      subject { tags_with :num_pages => 10, :current_page => 2 }
+      it { should contain_tag PrevLink }
+      it { should_not contain_tag PrevSpan }
+      it { should contain_tag CurrentPage }
+      it { should contain_tag FirstPageLink }
+      it { should contain_tag LastPageLink }
+      it { should contain_tag PageLink }
+      it { should contain_tag NextLink }
+      it { should_not contain_tag NextSpan }
+      it { should contain_tag TruncatedSpan }
+    end
+
+    context 'third page' do
+      subject { tags_with :num_pages => 10, :current_page => 3 }
+      it { should contain_tag PrevLink }
+      it { should_not contain_tag PrevSpan }
+      it { should contain_tag CurrentPage }
+      it { should contain_tag FirstPageLink }
+      it { should contain_tag LastPageLink }
+      it { should contain_tag PageLink }
+      it { should contain_tag NextLink }
+      it { should_not contain_tag NextSpan }
+      it { should contain_tag TruncatedSpan }
+    end
+
+    context 'fourth page(no truncation)' do
+      subject { tags_with :num_pages => 10, :current_page => 4 }
+      it { should contain_tag PrevLink }
+      it { should_not contain_tag PrevSpan }
+      it { should contain_tag CurrentPage }
+      it { should contain_tag FirstPageLink }
+      it { should contain_tag LastPageLink }
+      it { should contain_tag PageLink }
+      it { should contain_tag NextLink }
+      it { should_not contain_tag NextSpan }
+      it { should_not contain_tag TruncatedSpan }
+    end
+
+    context 'seventh page(no truncation)' do
+      subject { tags_with :num_pages => 10, :current_page => 7 }
+      it { should contain_tag PrevLink }
+      it { should_not contain_tag PrevSpan }
+      it { should contain_tag CurrentPage }
+      it { should contain_tag FirstPageLink }
+      it { should contain_tag LastPageLink }
+      it { should contain_tag PageLink }
+      it { should contain_tag NextLink }
+      it { should_not contain_tag NextSpan }
+      it { should_not contain_tag TruncatedSpan }
+    end
+
+    context 'eighth page' do
+      subject { tags_with :num_pages => 10, :current_page => 8 }
+      it { should contain_tag PrevLink }
+      it { should_not contain_tag PrevSpan }
+      it { should contain_tag CurrentPage }
+      it { should contain_tag FirstPageLink }
+      it { should contain_tag LastPageLink }
+      it { should contain_tag PageLink }
+      it { should contain_tag NextLink }
+      it { should_not contain_tag NextSpan }
+      it { should contain_tag TruncatedSpan }
+    end
+
+    context 'last page' do
+      subject { tags_with :num_pages => 10, :current_page => 10 }
+      it { should contain_tag PrevLink }
+      it { should_not contain_tag PrevSpan }
+      it { should contain_tag CurrentPage }
+      it { should contain_tag FirstPageLink }
+      it { should_not contain_tag LastPageLink }
+      it { should contain_tag PageLink }
+      it { should_not contain_tag NextLink }
+      it { should contain_tag NextSpan }
+      it { should contain_tag TruncatedSpan }
+    end
+  end
+end

data/spec/models/scopes_spec.rb

@@ -0,0 +1,82 @@
+require File.expand_path('../spec_helper', File.dirname(__FILE__))
+
+describe Kaminari::ActiveRecord do
+  before :all do
+    User.delete_all
+    1.upto(20) {|i| User.create! :name => "user#{'%02d' % i}" }
+  end
+
+  describe '#page' do
+    shared_examples_for 'the first page' do
+      it { should have(10).users }
+      its('first.name') { should == 'user01' }
+    end
+
+    shared_examples_for 'blank page' do
+      it { should have(0).users }
+    end
+
+    context 'page 1' do
+      subject { User.page 1 }
+      it_should_behave_like 'the first page'
+    end
+
+    context 'page 2' do
+      subject { User.page 2 }
+      it { should have(10).users }
+      its('first.name') { should == 'user11' }
+    end
+
+    context 'page without an argument' do
+      subject { User.page }
+      it_should_behave_like 'the first page'
+    end
+
+    context 'page < 1' do
+      subject { User.page 0 }
+      it_should_behave_like 'the first page'
+    end
+
+    context 'page > max page' do
+      subject { User.page 3 }
+      it_should_behave_like 'blank page'
+    end
+  end
+
+  describe '#per' do
+    context 'page 1 per 5' do
+      subject { User.page(1).per(5) }
+      it { should have(5).users }
+      its('first.name') { should == 'user01' }
+    end
+  end
+
+  describe '#num_pages' do
+    context 'per 10' do
+      subject { User.page.num_pages }
+      it { should == 2 }
+    end
+
+    context 'per 7' do
+      subject { User.page(2).per(7).num_pages }
+      it { should == 3 }
+    end
+
+    context 'per 65536' do
+      subject { User.page(50).per(65536).num_pages }
+      it { should == 1 }
+    end
+  end
+
+  describe '#current_page' do
+    context 'page 1' do
+      subject { User.page.current_page }
+      it { should == 1 }
+    end
+
+    context 'page 2' do
+      subject { User.page(2).per(3).current_page }
+      it { should == 2 }
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,37 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'active_support/all'
+require 'active_record'
+require 'rails'
+require 'action_controller/railtie'
+require 'action_view/railtie'
+require 'rspec/rails'
+
+ActiveRecord::Base.configurations = {'test' => {:adapter => 'sqlite3', :database => ':memory:'}}
+ActiveRecord::Base.establish_connection('test')
+
+require 'kaminari'
+
+app = Class.new(Rails::Application)
+app.config.secret_token = "3b7cd727ee24e8444053437c36cc66c4"
+app.config.session_store :cookie_store, :key => "_myapp_session"
+app.config.active_support.deprecation = :log
+app.initialize!
+
+app.routes.draw do
+  resources :users
+end
+
+Object.const_set(:ApplicationHelper, Module.new)
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+RSpec.configure do |config|
+  config.mock_with :rr
+  config.before :all do
+#     ActiveRecord::Base.connection.execute 'CREATE TABLE "users" ("id" INTEGER PRIMARY KEY AUTOINCREMENT NOT NULL, "name" varchar(255))' unless ActiveRecord::Base.connection.table_exists? 'users'
+    CreateUsers.up unless ActiveRecord::Base.connection.table_exists? 'users'
+  end
+end

data/spec/support/20110128122508_create_users.rb

@@ -0,0 +1,8 @@
+class CreateUsers < ActiveRecord::Migration
+  def self.up
+    create_table :users do |t|
+      t.string :name
+      t.timestamps
+    end
+  end
+end

data/spec/support/matchers.rb

@@ -0,0 +1,40 @@
+RSpec::Matchers.define :contain_tag do |klass|
+  match do |collection|
+    if @num.blank?
+      collection.any? {|tag| tag.is_a? klass}
+    else
+      (@count = collection.count {|tag| tag.is_a? klass}) == @num
+    end
+  end
+
+  def count(num)
+    @num = num
+    self
+  end
+
+  description do
+    "contain #{@num || 'any'} instance(s) of #{klass.name}"
+  end
+  failure_message_for_should do |collection|
+    "expected #{@num || 'any'} instance(s) of #{klass.name} but was #{@count}"
+  end
+end
+
+RSpec::Matchers.define :contain_tag_old do |count|
+  match do |collection|
+    (@count = collection.count {|tag| tag.is_a? @klass}) == count
+  end
+
+  def instance_of(klass)
+    @klass = klass
+    self
+  end
+  alias :instances_of :instance_of
+
+  description do
+    "contain #{count || 'any'} instance(s) of #{@klass.name}"
+  end
+  failure_message_for_should do |collection|
+    "expected #{count || 'any'} instance(s) of #{@klass.name} but was #{@count}"
+  end
+end

data/spec/support/user.rb

@@ -0,0 +1,3 @@
+class User < ActiveRecord::Base
+  default_scope order('name')
+end

metadata

@@ -0,0 +1,284 @@
+--- !ruby/object:Gem::Specification 
+name: kaminari
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Akira Matsuda
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-06 00:00:00 +09:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  type: :development
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 31
+        segments: 
+        - 2
+        - 4
+        - 0
+        version: 2.4.0
+  requirement: *id001
+  prerelease: false
+  name: rspec
+- !ruby/object:Gem::Dependency 
+  type: :development
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 19
+        segments: 
+        - 1
+        - 0
+        - 2
+        version: 1.0.2
+  requirement: *id002
+  prerelease: false
+  name: rr
+- !ruby/object:Gem::Dependency 
+  type: :development
+  version_requirements: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 23
+        segments: 
+        - 1
+        - 0
+        - 0
+        version: 1.0.0
+  requirement: *id003
+  prerelease: false
+  name: bundler
+- !ruby/object:Gem::Dependency 
+  type: :development
+  version_requirements: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 1
+        - 5
+        - 2
+        version: 1.5.2
+  requirement: *id004
+  prerelease: false
+  name: jeweler
+- !ruby/object:Gem::Dependency 
+  type: :development
+  version_requirements: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id005
+  prerelease: false
+  name: rcov
+- !ruby/object:Gem::Dependency 
+  type: :development
+  version_requirements: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id006
+  prerelease: false
+  name: rails
+- !ruby/object:Gem::Dependency 
+  type: :development
+  version_requirements: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id007
+  prerelease: false
+  name: rack
+- !ruby/object:Gem::Dependency 
+  type: :development
+  version_requirements: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id008
+  prerelease: false
+  name: arel
+- !ruby/object:Gem::Dependency 
+  type: :development
+  version_requirements: &id009 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id009
+  prerelease: false
+  name: rspec-rails
+- !ruby/object:Gem::Dependency 
+  type: :development
+  version_requirements: &id010 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 29
+        segments: 
+        - 1
+        - 3
+        - 3
+        version: 1.3.3
+  requirement: *id010
+  prerelease: false
+  name: sqlite3
+- !ruby/object:Gem::Dependency 
+  type: :development
+  version_requirements: &id011 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id011
+  prerelease: false
+  name: ruby-debug
+- !ruby/object:Gem::Dependency 
+  type: :runtime
+  version_requirements: &id012 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 3
+        - 0
+        - 0
+        version: 3.0.0
+  requirement: *id012
+  prerelease: false
+  name: rails
+description: Kaminari is a Scope & Engine based clean and powerful and customizable and sophisticated paginator for Rails 3
+email: ronnie@dio.jp
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE.txt
+- README.rdoc
+files: 
+- .document
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- TODO.txt
+- VERSION
+- app/views/kaminari/_current_page.html.erb
+- app/views/kaminari/_first_page_link.html.erb
+- app/views/kaminari/_last_page_link.html.erb
+- app/views/kaminari/_next_link.html.erb
+- app/views/kaminari/_next_span.html.erb
+- app/views/kaminari/_page_link.html.erb
+- app/views/kaminari/_prev_link.html.erb
+- app/views/kaminari/_prev_span.html.erb
+- app/views/kaminari/_truncated_span.html.erb
+- kaminari.gemspec
+- lib/generators/kaminari/views_generator.rb
+- lib/kaminari.rb
+- lib/kaminari/active_record.rb
+- lib/kaminari/engine.rb
+- lib/kaminari/helpers.rb
+- lib/kaminari/railtie.rb
+- spec/controllers/application_helper_spec.rb
+- spec/helpers/helpers_spec.rb
+- spec/models/scopes_spec.rb
+- spec/spec_helper.rb
+- spec/support/20110128122508_create_users.rb
+- spec/support/matchers.rb
+- spec/support/user.rb
+has_rdoc: true
+homepage: http://github.com/amatsuda/kaminari
+licenses: 
+- MIT
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.4.2
+signing_key: 
+specification_version: 3
+summary: A pagnation engine plugin for Rails 3
+test_files: 
+- spec/controllers/application_helper_spec.rb
+- spec/helpers/helpers_spec.rb
+- spec/models/scopes_spec.rb
+- spec/spec_helper.rb
+- spec/support/20110128122508_create_users.rb
+- spec/support/matchers.rb
+- spec/support/user.rb