mongoid-pagination 0.1.0

data/.gitignore

@@ -0,0 +1,3 @@
+.rspec
+Gemfile.lock
+pkg

data/.travis.yml

@@ -0,0 +1,6 @@
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - ree
+  - ruby-head
+  - rbx

data/Gemfile

@@ -0,0 +1,10 @@
+source :rubygems
+
+gemspec
+
+gem 'bson_ext'
+gem 'rake'
+
+group :test do
+  gem 'rspec'
+end

data/MIT-LICENSE

@@ -0,0 +1,21 @@
+Copyright (c) 2012 Alex Sharp
+
+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,15 @@
+## What
+
+Adds pagination scopes to your mongoid models.
+
+## Usage
+
+```ruby
+class Person
+  include Mongoid::Document
+  include Mongoid::Pagination
+end
+
+Person.paginate(:page => 2, :limit => 25) # limit and offset
+Person.per_page(25) # just does a limit
+```

data/Rakefile

@@ -0,0 +1,5 @@
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/lib/mongoid-pagination.rb

@@ -0,0 +1,2 @@
+require 'mongoid'
+require 'mongoid/pagination'

data/lib/mongoid/pagination.rb

@@ -0,0 +1,38 @@
+module Mongoid
+  module Pagination
+    extend ActiveSupport::Concern
+
+    module ClassMethods
+
+      # Paginate the results
+      #
+      # @param [Hash] opts
+      # @option [Integer] :page (default: 1)
+      # @option [Integer] :limit (default: 25)
+      #
+      # @return [Mongoid::Criteria]
+      def paginate(opts = {})
+        return criteria if opts[:limit].nil? and opts[:page].nil?
+
+        limit = (opts[:limit] || 25).to_i
+        page  = (opts[:page]  || 1).to_i
+
+        if page > 1
+          offset = (page - 1) * limit
+        else
+          offset = 0
+        end
+
+        per_page(limit).offset(offset)
+      end
+
+      # Limit the result set
+      #
+      # @param [Integer] page_limit the max number of results to return
+      # @return [Mongoid::Criteria]
+      def per_page(page_limit = 25)
+        limit(page_limit.to_i)
+      end
+    end
+  end
+end

data/lib/mongoid/pagination/version.rb

@@ -0,0 +1,5 @@
+module Mongoid
+  module Pagination
+    VERSION = '0.1.0'
+  end
+end

data/mongoid-pagination.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "mongoid/pagination/version"
+
+Gem::Specification.new do |s|
+  s.name        = "mongoid-pagination"
+  s.version     = Mongoid::Pagination::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Alex Sharp"]
+  s.email       = ["ajsharp@gmail.com"]
+  s.homepage    = "https://github.com/ajsharp/mongoid-pagination"
+  s.summary     = %q{A simple pagination module for Mongoid}
+  s.description = %q{A simple pagination module for Mongoid}
+
+  s.rubyforge_project = s.name
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency 'mongoid'
+end

data/spec/pagination_spec.rb

@@ -0,0 +1,112 @@
+require 'spec_helper'
+
+describe Mongoid::Pagination do
+  class Person
+    include Mongoid::Document
+    include Mongoid::Pagination
+  end
+
+  describe ".paginate" do
+    let!(:one)   { Person.create! }
+    let!(:two)   { Person.create! }
+    let!(:three) { Person.create! }
+    let!(:four)  { Person.create! }
+
+    context "parameter defaults and massaging" do
+      describe "when no params are passed in" do
+        subject { Person.paginate }
+
+        it "does not set the skip param by default" do
+          subject.options[:skip].should be_nil
+        end
+
+        it "defaults the limit param to 25" do
+          subject.options[:limit].should be_nil
+        end
+
+        it "returns the criteria unmodified if the limit param is not passed in" do
+          criteria = Person.where(:name => 'someone')
+          expect {
+            criteria.paginate
+          }.not_to change { criteria.options }
+        end
+      end
+
+      describe "when passed a page param but no limit" do
+        subject { Person.paginate(:page => 1) }
+
+        it "defaults the limit to 25" do
+          subject.options[:limit].should == 25
+        end
+
+        it "sets the offset to 0" do
+          subject.options[:skip].should == 0
+        end
+      end
+
+      describe "when passed a limit param but no page" do
+        subject { Person.paginate(:limit => 100) }
+
+        it "defaults the page to 0" do
+          subject.options[:skip].should == 0
+        end
+
+        it "sets the limit to 100" do
+          subject.options[:limit].should == 100
+        end
+      end
+
+      it "sets the skip param to 0 if passed 0" do
+        Person.paginate(:page => 0).options[:skip].should == 0
+      end
+
+      it "sets the skip param to 0 if passed a string of 0" do
+        Person.paginate(:page => '0').options[:skip].should == 0
+      end
+
+      it "sets the skip param to 0 if the passed a string of 1" do
+        Person.paginate(:page => '1').options[:skip].should == 0
+      end
+
+      it "limits when passed a string param" do
+        Person.paginate(:limit => '1').to_a.size.should == 1
+      end
+
+      it "correctly sets criteria options" do
+        Person.paginate(:limit => 10, :page => 3).options.should == {:limit => 10, :skip => 20}
+      end
+    end
+
+    context "results" do
+      it "paginates correctly on the first page" do
+        Person.paginate(:page => 1, :limit => 2).to_a.should == [one, two]
+      end
+
+      it "paginates correctly on the second page" do
+        Person.paginate(:page => 2, :limit => 2).to_a.should == [three, four]
+      end
+    end
+
+    it "paginates the result set based on the limit and page params" do
+      # Person.
+    end
+  end
+
+  describe ".per_page" do
+    before do
+      2.times { Person.create! }
+    end
+
+    it "limits the results by the per page param" do
+      Person.per_page(1).to_a.size.should == 1
+    end
+
+    it "works for string params" do
+      Person.per_page('1').to_a.size.should == 1
+    end
+
+    it "defaults to 25" do
+      Person.per_page.options[:limit].should == 25
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,16 @@
+require 'rubygems'
+require 'bundler'
+
+Bundler.setup :default, :test
+Bundler.require :default, :test
+
+$:.push(File.expand_path(File.dirname(__FILE__)))
+require './lib/mongoid-pagination'
+
+Mongoid.database = Mongo::Connection.new.db('mongoid-pagination_test')
+
+RSpec.configure do |c|
+  c.before(:each) do
+    Mongoid.database.collections.each { |c| c.drop unless c.name =~ /system\.indexes$/}
+  end
+end

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification
+name: mongoid-pagination
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Alex Sharp
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-02-21 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mongoid
+  requirement: &70283948946940 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70283948946940
+description: A simple pagination module for Mongoid
+email:
+- ajsharp@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- MIT-LICENSE
+- README.md
+- Rakefile
+- lib/mongoid-pagination.rb
+- lib/mongoid/pagination.rb
+- lib/mongoid/pagination/version.rb
+- mongoid-pagination.gemspec
+- spec/pagination_spec.rb
+- spec/spec_helper.rb
+homepage: https://github.com/ajsharp/mongoid-pagination
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: mongoid-pagination
+rubygems_version: 1.8.15
+signing_key: 
+specification_version: 3
+summary: A simple pagination module for Mongoid
+test_files:
+- spec/pagination_spec.rb
+- spec/spec_helper.rb