neat-pages 0.1.7 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +7 -0
- data/.gitignore +9 -0
- data/.travis.yml +4 -0
- data/Gemfile +2 -0
- data/LICENSE +1 -1
- data/README.md +58 -22
- data/app/assets/javascripts/neat_pages/base.coffee +8 -1
- data/lib/.reek +12 -0
- data/lib/neat-pages.rb +2 -1
- data/lib/neat_pages/base.rb +5 -7
- data/lib/neat_pages/engine.rb +3 -1
- data/lib/neat_pages/errors.rb +9 -0
- data/lib/neat_pages/helpers.rb +8 -10
- data/lib/neat_pages/helpers/builder.rb +26 -16
- data/lib/neat_pages/helpers/navigation.rb +39 -27
- data/lib/neat_pages/helpers/status.rb +14 -0
- data/lib/neat_pages/implants/action_controller_implant.rb +3 -0
- data/lib/neat_pages/implants/mongoid_implant.rb +12 -10
- data/lib/neat_pages/{implants/railtie.rb → railtie.rb} +7 -4
- data/neat-pages.gemspec +23 -0
- data/spec/controllers/application_controller_spec.rb +24 -0
- data/spec/dummy/Rakefile +6 -0
- data/spec/dummy/app/controllers/application_controller.rb +3 -0
- data/spec/dummy/app/controllers/examples_controller.rb +11 -0
- data/spec/dummy/app/helpers/application_helper.rb +2 -0
- data/spec/dummy/app/views/layouts/application.html.erb +14 -0
- data/spec/dummy/bin/bundle +3 -0
- data/spec/dummy/bin/rails +4 -0
- data/spec/dummy/bin/rake +4 -0
- data/spec/dummy/config.ru +4 -0
- data/spec/dummy/config/application.rb +18 -0
- data/spec/dummy/config/boot.rb +5 -0
- data/spec/dummy/config/database.yml +5 -0
- data/spec/dummy/config/environment.rb +5 -0
- data/spec/dummy/config/environments/development.rb +29 -0
- data/spec/dummy/config/environments/production.rb +80 -0
- data/spec/dummy/config/environments/test.rb +36 -0
- data/spec/dummy/config/initializers/standard_rails_initializers.rb +9 -0
- data/spec/dummy/config/locales/en.yml +5 -0
- data/spec/dummy/config/routes.rb +3 -0
- data/spec/dummy/db/test.sqlite3 +0 -0
- data/spec/neat_pages/base_spec.rb +31 -5
- data/spec/neat_pages/helpers/builder_spec.rb +109 -0
- data/spec/neat_pages/helpers/navigation_spec.rb +105 -0
- data/spec/neat_pages/helpers/status_spec.rb +65 -0
- data/spec/neat_pages/helpers_spec.rb +67 -0
- data/spec/neat_pages/implants/mongoid_implant_spec.rb +43 -0
- data/spec/spec_helper.rb +21 -6
- data/spec/support/views_helper.rb +16 -0
- data/vendor/assets/javascripts/jquery.hashchange.min.js +1 -1
- metadata +134 -42
- data/lib/neat_pages/implants.rb +0 -12
@@ -1,4 +1,16 @@
|
|
1
|
+
#*************************************************************************************
|
2
|
+
# Status take care of generating the html code that show the results position and the
|
3
|
+
# total results.
|
4
|
+
#
|
5
|
+
# Output Example
|
6
|
+
#
|
7
|
+
# 30 to 40 / 300
|
8
|
+
#*************************************************************************************
|
1
9
|
class NeatPages::Helpers::Status < NeatPages::Helpers::Builder
|
10
|
+
delegate :empty?, to: :pagination
|
11
|
+
delegate :offset, to: :pagination
|
12
|
+
delegate :out_of_bound?, to: :pagination
|
13
|
+
|
2
14
|
def generate
|
3
15
|
return '' if empty? or out_of_bound?
|
4
16
|
|
@@ -7,6 +19,8 @@ class NeatPages::Helpers::Status < NeatPages::Helpers::Builder
|
|
7
19
|
return build_status from, to
|
8
20
|
end
|
9
21
|
|
22
|
+
private
|
23
|
+
|
10
24
|
def build_status(from, to)
|
11
25
|
reset_builder
|
12
26
|
|
@@ -1,3 +1,6 @@
|
|
1
|
+
#*************************************************************************************
|
2
|
+
# Insert methods in the Action Controller of a Rails project.
|
3
|
+
#*************************************************************************************
|
1
4
|
module NeatPages::Implants::ActionControllerImplant
|
2
5
|
extend ActiveSupport::Concern
|
3
6
|
|
@@ -1,15 +1,17 @@
|
|
1
|
-
|
2
|
-
|
3
|
-
|
4
|
-
|
5
|
-
|
1
|
+
#*************************************************************************************
|
2
|
+
# Insert the method paginate in a Mongoid model. This method will be use the limit
|
3
|
+
# the number of results returned by a query.
|
4
|
+
#*************************************************************************************
|
5
|
+
module NeatPages::Implants::MongoidCriteriaImplant
|
6
|
+
def paginate(current)
|
7
|
+
if current
|
8
|
+
current.set_total_items self.count
|
6
9
|
|
7
|
-
|
10
|
+
raise NeatPages::OutOfBound if current.out_of_bound?
|
8
11
|
|
9
|
-
|
10
|
-
|
11
|
-
|
12
|
-
end
|
12
|
+
return self.offset(current.offset).limit(current.limit)
|
13
|
+
else
|
14
|
+
raise NeatPages::Uninitalized, 'You need to initialize the pagination'
|
13
15
|
end
|
14
16
|
end
|
15
17
|
end
|
@@ -1,6 +1,4 @@
|
|
1
|
-
|
2
|
-
|
3
|
-
module NeatPages::Implants
|
1
|
+
module NeatPages
|
4
2
|
class Railtie < Rails::Railtie
|
5
3
|
initializer "neat-pages" do |app|
|
6
4
|
ActiveSupport.on_load :action_controller do
|
@@ -14,9 +12,14 @@ module NeatPages::Implants
|
|
14
12
|
Mime::Type.register "text/html", :neatpage if not Mime::Type.lookup_by_extension :neatpage
|
15
13
|
end
|
16
14
|
end
|
15
|
+
|
16
|
+
module Implants
|
17
|
+
end
|
17
18
|
end
|
18
19
|
|
19
20
|
dir = File.expand_path(File.dirname(__FILE__))
|
20
21
|
|
21
|
-
I18n.load_path << File.join(dir, '
|
22
|
+
I18n.load_path << File.join(dir, '../../config/locales', 'fr.yml')
|
22
23
|
|
24
|
+
require 'neat_pages/implants/action_controller_implant'
|
25
|
+
require 'neat_pages/implants/mongoid_implant'
|
data/neat-pages.gemspec
ADDED
@@ -0,0 +1,23 @@
|
|
1
|
+
Gem::Specification.new do |gem|
|
2
|
+
gem.name = "neat-pages"
|
3
|
+
gem.description = "A simple pagination API to paginate Mongoid Models."
|
4
|
+
gem.summary = "A simple pagination API to paginate Mongoid Models."
|
5
|
+
gem.homepage = "https://github.com/demarque/neat-pages"
|
6
|
+
gem.version = "1.0.0"
|
7
|
+
gem.licenses = ["MIT"]
|
8
|
+
|
9
|
+
gem.authors = ["Sebastien Rosa"]
|
10
|
+
gem.email = ["srosa@alchimik.com"]
|
11
|
+
|
12
|
+
gem.files = `git ls-files`.split($\)
|
13
|
+
gem.executables = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
|
14
|
+
gem.test_files = gem.files.grep(%r{^(test|spec|features)/})
|
15
|
+
gem.require_paths = ["lib"]
|
16
|
+
|
17
|
+
gem.add_dependency "rails", ['>= 4.0']
|
18
|
+
gem.add_development_dependency "sqlite3"
|
19
|
+
gem.add_development_dependency "rspec-rails"
|
20
|
+
gem.add_development_dependency "simplecov"
|
21
|
+
gem.add_development_dependency "simplecov-rcov-text"
|
22
|
+
gem.add_development_dependency "coveralls"
|
23
|
+
end
|
@@ -0,0 +1,24 @@
|
|
1
|
+
require "spec_helper"
|
2
|
+
|
3
|
+
describe ApplicationController do
|
4
|
+
controller do
|
5
|
+
def index
|
6
|
+
paginate per_page: 20
|
7
|
+
|
8
|
+
set_pagination_header
|
9
|
+
|
10
|
+
raise NeatPages::OutOfBound
|
11
|
+
end
|
12
|
+
end
|
13
|
+
|
14
|
+
describe "#index" do
|
15
|
+
it 'is out of bound' do
|
16
|
+
get :index
|
17
|
+
|
18
|
+
expect(response.status).to eq(404)
|
19
|
+
expect(response.body).to eq "out_of_bound"
|
20
|
+
controller.pagination.per_page.should eql 20
|
21
|
+
response.headers["X-Per-Page"].should eql "20"
|
22
|
+
end
|
23
|
+
end
|
24
|
+
end
|
data/spec/dummy/Rakefile
ADDED
@@ -0,0 +1,14 @@
|
|
1
|
+
<!DOCTYPE html>
|
2
|
+
<html>
|
3
|
+
<head>
|
4
|
+
<title>Dummy</title>
|
5
|
+
<%= stylesheet_link_tag "application", media: "all", "data-turbolinks-track" => true %>
|
6
|
+
<%= javascript_include_tag "application", "data-turbolinks-track" => true %>
|
7
|
+
<%= csrf_meta_tags %>
|
8
|
+
</head>
|
9
|
+
<body>
|
10
|
+
|
11
|
+
<%= yield %>
|
12
|
+
|
13
|
+
</body>
|
14
|
+
</html>
|
data/spec/dummy/bin/rake
ADDED
@@ -0,0 +1,18 @@
|
|
1
|
+
require File.expand_path('../boot', __FILE__)
|
2
|
+
|
3
|
+
# Pick the frameworks you want:
|
4
|
+
require "active_record/railtie"
|
5
|
+
require "action_controller/railtie"
|
6
|
+
require "action_mailer/railtie"
|
7
|
+
require "sprockets/railtie"
|
8
|
+
# require "rails/test_unit/railtie"
|
9
|
+
|
10
|
+
Bundler.require(*Rails.groups)
|
11
|
+
|
12
|
+
require "neat-pages"
|
13
|
+
|
14
|
+
module Dummy
|
15
|
+
class Application < Rails::Application
|
16
|
+
end
|
17
|
+
end
|
18
|
+
|
@@ -0,0 +1,29 @@
|
|
1
|
+
Dummy::Application.configure do
|
2
|
+
# Settings specified here will take precedence over those in config/application.rb.
|
3
|
+
|
4
|
+
# In the development environment your application's code is reloaded on
|
5
|
+
# every request. This slows down response time but is perfect for development
|
6
|
+
# since you don't have to restart the web server when you make code changes.
|
7
|
+
config.cache_classes = false
|
8
|
+
|
9
|
+
# Do not eager load code on boot.
|
10
|
+
config.eager_load = false
|
11
|
+
|
12
|
+
# Show full error reports and disable caching.
|
13
|
+
config.consider_all_requests_local = true
|
14
|
+
config.action_controller.perform_caching = false
|
15
|
+
|
16
|
+
# Don't care if the mailer can't send.
|
17
|
+
config.action_mailer.raise_delivery_errors = false
|
18
|
+
|
19
|
+
# Print deprecation notices to the Rails logger.
|
20
|
+
config.active_support.deprecation = :log
|
21
|
+
|
22
|
+
# Raise an error on page load if there are pending migrations
|
23
|
+
config.active_record.migration_error = :page_load
|
24
|
+
|
25
|
+
# Debug mode disables concatenation and preprocessing of assets.
|
26
|
+
# This option may cause significant delays in view rendering with a large
|
27
|
+
# number of complex assets.
|
28
|
+
config.assets.debug = true
|
29
|
+
end
|
@@ -0,0 +1,80 @@
|
|
1
|
+
Dummy::Application.configure do
|
2
|
+
# Settings specified here will take precedence over those in config/application.rb.
|
3
|
+
|
4
|
+
# Code is not reloaded between requests.
|
5
|
+
config.cache_classes = true
|
6
|
+
|
7
|
+
# Eager load code on boot. This eager loads most of Rails and
|
8
|
+
# your application in memory, allowing both thread web servers
|
9
|
+
# and those relying on copy on write to perform better.
|
10
|
+
# Rake tasks automatically ignore this option for performance.
|
11
|
+
config.eager_load = true
|
12
|
+
|
13
|
+
# Full error reports are disabled and caching is turned on.
|
14
|
+
config.consider_all_requests_local = false
|
15
|
+
config.action_controller.perform_caching = true
|
16
|
+
|
17
|
+
# Enable Rack::Cache to put a simple HTTP cache in front of your application
|
18
|
+
# Add `rack-cache` to your Gemfile before enabling this.
|
19
|
+
# For large-scale production use, consider using a caching reverse proxy like nginx, varnish or squid.
|
20
|
+
# config.action_dispatch.rack_cache = true
|
21
|
+
|
22
|
+
# Disable Rails's static asset server (Apache or nginx will already do this).
|
23
|
+
config.serve_static_assets = false
|
24
|
+
|
25
|
+
# Compress JavaScripts and CSS.
|
26
|
+
config.assets.js_compressor = :uglifier
|
27
|
+
# config.assets.css_compressor = :sass
|
28
|
+
|
29
|
+
# Do not fallback to assets pipeline if a precompiled asset is missed.
|
30
|
+
config.assets.compile = false
|
31
|
+
|
32
|
+
# Generate digests for assets URLs.
|
33
|
+
config.assets.digest = true
|
34
|
+
|
35
|
+
# Version of your assets, change this if you want to expire all your assets.
|
36
|
+
config.assets.version = '1.0'
|
37
|
+
|
38
|
+
# Specifies the header that your server uses for sending files.
|
39
|
+
# config.action_dispatch.x_sendfile_header = "X-Sendfile" # for apache
|
40
|
+
# config.action_dispatch.x_sendfile_header = 'X-Accel-Redirect' # for nginx
|
41
|
+
|
42
|
+
# Force all access to the app over SSL, use Strict-Transport-Security, and use secure cookies.
|
43
|
+
# config.force_ssl = true
|
44
|
+
|
45
|
+
# Set to :debug to see everything in the log.
|
46
|
+
config.log_level = :info
|
47
|
+
|
48
|
+
# Prepend all log lines with the following tags.
|
49
|
+
# config.log_tags = [ :subdomain, :uuid ]
|
50
|
+
|
51
|
+
# Use a different logger for distributed setups.
|
52
|
+
# config.logger = ActiveSupport::TaggedLogging.new(SyslogLogger.new)
|
53
|
+
|
54
|
+
# Use a different cache store in production.
|
55
|
+
# config.cache_store = :mem_cache_store
|
56
|
+
|
57
|
+
# Enable serving of images, stylesheets, and JavaScripts from an asset server.
|
58
|
+
# config.action_controller.asset_host = "http://assets.example.com"
|
59
|
+
|
60
|
+
# Precompile additional assets.
|
61
|
+
# application.js, application.css, and all non-JS/CSS in app/assets folder are already added.
|
62
|
+
# config.assets.precompile += %w( search.js )
|
63
|
+
|
64
|
+
# Ignore bad email addresses and do not raise email delivery errors.
|
65
|
+
# Set this to true and configure the email server for immediate delivery to raise delivery errors.
|
66
|
+
# config.action_mailer.raise_delivery_errors = false
|
67
|
+
|
68
|
+
# Enable locale fallbacks for I18n (makes lookups for any locale fall back to
|
69
|
+
# the I18n.default_locale when a translation can not be found).
|
70
|
+
config.i18n.fallbacks = true
|
71
|
+
|
72
|
+
# Send deprecation notices to registered listeners.
|
73
|
+
config.active_support.deprecation = :notify
|
74
|
+
|
75
|
+
# Disable automatic flushing of the log to improve performance.
|
76
|
+
# config.autoflush_log = false
|
77
|
+
|
78
|
+
# Use default logging formatter so that PID and timestamp are not suppressed.
|
79
|
+
config.log_formatter = ::Logger::Formatter.new
|
80
|
+
end
|
@@ -0,0 +1,36 @@
|
|
1
|
+
Dummy::Application.configure do
|
2
|
+
# Settings specified here will take precedence over those in config/application.rb.
|
3
|
+
|
4
|
+
# The test environment is used exclusively to run your application's
|
5
|
+
# test suite. You never need to work with it otherwise. Remember that
|
6
|
+
# your test database is "scratch space" for the test suite and is wiped
|
7
|
+
# and recreated between test runs. Don't rely on the data there!
|
8
|
+
config.cache_classes = true
|
9
|
+
|
10
|
+
# Do not eager load code on boot. This avoids loading your whole application
|
11
|
+
# just for the purpose of running a single test. If you are using a tool that
|
12
|
+
# preloads Rails for running tests, you may have to set it to true.
|
13
|
+
config.eager_load = false
|
14
|
+
|
15
|
+
# Configure static asset server for tests with Cache-Control for performance.
|
16
|
+
config.serve_static_assets = true
|
17
|
+
config.static_cache_control = "public, max-age=3600"
|
18
|
+
|
19
|
+
# Show full error reports and disable caching.
|
20
|
+
config.consider_all_requests_local = true
|
21
|
+
config.action_controller.perform_caching = false
|
22
|
+
|
23
|
+
# Raise exceptions instead of rendering exception templates.
|
24
|
+
config.action_dispatch.show_exceptions = false
|
25
|
+
|
26
|
+
# Disable request forgery protection in test environment.
|
27
|
+
config.action_controller.allow_forgery_protection = false
|
28
|
+
|
29
|
+
# Tell Action Mailer not to deliver emails to the real world.
|
30
|
+
# The :test delivery method accumulates sent emails in the
|
31
|
+
# ActionMailer::Base.deliveries array.
|
32
|
+
config.action_mailer.delivery_method = :test
|
33
|
+
|
34
|
+
# Print deprecation notices to the stderr.
|
35
|
+
config.active_support.deprecation = :stderr
|
36
|
+
end
|
@@ -0,0 +1,9 @@
|
|
1
|
+
Rails.application.config.filter_parameters += [:password]
|
2
|
+
|
3
|
+
Dummy::Application.config.secret_key_base = 'ae3cad0b2a7fe9cf1620b58b362sdfsdf9d5236ba303b9821fb22ac023c9dc1b07ef16f27b74e96c4294f1e02c5bfc83f2dc89c02c9fc24d1b3974f6d7c14701'
|
4
|
+
|
5
|
+
Dummy::Application.config.session_store :cookie_store, key: '_dummy_session'
|
6
|
+
|
7
|
+
ActiveSupport.on_load(:action_controller) do
|
8
|
+
wrap_parameters format: [:json] if respond_to?(:wrap_parameters)
|
9
|
+
end
|
File without changes
|
@@ -1,9 +1,6 @@
|
|
1
1
|
require 'spec_helper'
|
2
2
|
|
3
3
|
describe NeatPages::Base do
|
4
|
-
#*************************************************************************************
|
5
|
-
# PUBLIC INSTANCE METHODS
|
6
|
-
#*************************************************************************************
|
7
4
|
describe "#empty?" do
|
8
5
|
context "with a 20 items pagination" do
|
9
6
|
specify { NeatPages::Base.new(0, total_items: 20).should_not be_empty }
|
@@ -14,6 +11,12 @@ describe NeatPages::Base do
|
|
14
11
|
end
|
15
12
|
end
|
16
13
|
|
14
|
+
describe "#limit" do
|
15
|
+
context "with a 100 items pagination starting at 0 and having 10 items per page" do
|
16
|
+
specify { NeatPages::Base.new(0, per_page: 10, total_items: 100).limit.should eql 10 }
|
17
|
+
end
|
18
|
+
end
|
19
|
+
|
17
20
|
describe "#next_page" do
|
18
21
|
context "with a 100 items pagination starting at 0 and having 10 items per page" do
|
19
22
|
specify { NeatPages::Base.new(0, per_page: 10, total_items: 100).next_page.should eql 2 }
|
@@ -62,6 +65,16 @@ describe NeatPages::Base do
|
|
62
65
|
end
|
63
66
|
end
|
64
67
|
|
68
|
+
describe "#paginated?" do
|
69
|
+
context "with a 20 items pagination starting at page 1 and having 10 items per page" do
|
70
|
+
specify { NeatPages::Base.new(1, per_page: 10, total_items: 20).should be_paginated }
|
71
|
+
end
|
72
|
+
|
73
|
+
context "with a 5 items pagination starting at page 1 and having 10 items per page" do
|
74
|
+
specify { NeatPages::Base.new(1, per_page: 10, total_items: 5).should_not be_paginated }
|
75
|
+
end
|
76
|
+
end
|
77
|
+
|
65
78
|
describe "#previous_page" do
|
66
79
|
context "with a 100 items pagination starting at page 5 and having 10 items per page" do
|
67
80
|
specify { NeatPages::Base.new(5, per_page: 10, total_items: 100).previous_page.should eql 4 }
|
@@ -95,7 +108,7 @@ describe NeatPages::Base do
|
|
95
108
|
specify { NeatPages::Base.new(2, per_page: 10, total_items: 100).should be_previous }
|
96
109
|
end
|
97
110
|
|
98
|
-
context "with a 5 items pagination starting at 0 and having 10 items per page" do
|
111
|
+
context "with a 5 items pagination starting at page 0 and having 10 items per page" do
|
99
112
|
specify { NeatPages::Base.new(0, per_page: 10, total_items: 5).should_not be_previous }
|
100
113
|
end
|
101
114
|
end
|
@@ -107,11 +120,24 @@ describe NeatPages::Base do
|
|
107
120
|
its(:length) { should eql 4 }
|
108
121
|
its(['X-Total-Items']) { should eql '200' }
|
109
122
|
its(['X-Total-Pages']) { should eql '20' }
|
110
|
-
its(['X-Per-Page']) { should eql '10' }
|
123
|
+
its(['X-Per-Page']) { should eql '10' }
|
111
124
|
its(['X-Current-Page']) { should eql '1' }
|
112
125
|
end
|
113
126
|
end
|
114
127
|
|
128
|
+
describe "#set_total_items" do
|
129
|
+
context "with a 100 items pagination starting at page 2 and having 10 items per page" do
|
130
|
+
let(:pagination) { NeatPages::Base.new(2, per_page: 10, total_items: 100) }
|
131
|
+
|
132
|
+
context "when changing the total items to 5" do
|
133
|
+
before { pagination.set_total_items 5 }
|
134
|
+
|
135
|
+
specify { pagination.should be_out_of_bound }
|
136
|
+
specify { pagination.total_items.should eql 5 }
|
137
|
+
end
|
138
|
+
end
|
139
|
+
end
|
140
|
+
|
115
141
|
describe "#total_pages" do
|
116
142
|
context "with a 100 items pagination and having 10 items per page" do
|
117
143
|
specify { NeatPages::Base.new(0, per_page: 10, total_items: 100).total_pages.should eql 10 }
|