Repo brief: mislav/will_paginate

Generated by RepoPilot · document generated 2026-09-16 · concise human review Evidence snapshot · analyzed 2026-09-16T07:47:46.698Z · commit 50017c3eb071

Verdict

Mixed — Slowing — last commit 6mo ago

• Last commit 6mo ago
• 9 active contributors
• MIT licensed
• CI configured
• 1 more receipt on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

will_paginate is a Ruby pagination library that adds .paginate() and .page() methods to Active Record queries, arrays, and other data sources to cleanly split large datasets into numbered pages. It handles the core problem of rendering paginated result sets with automatic link generation, working across Rails, Sinatra, Hanami, and Sequel ORM without boilerplate. Modular architecture: lib/will_paginate/core_ext.rb and lib/will_paginate/collection.rb provide the base pagination logic, lib/will_paginate/active_record.rb wraps Active Record, lib/will_paginate/sequel.rb and lib/will_paginate/mongoid.rb provide ORM adapters, and lib/will_paginate/view_helpers/ (with submodules for…

Start here

Open these first:

• lib/will_paginate.rb — Entry point that loads all core modules and initializes the pagination library.
• lib/will_paginate/collection.rb — Core abstraction for paginated collections; defines the WillPaginate::Collection class used by all adapters.
• lib/will_paginate/active_record.rb — Primary ORM integration that patches ActiveRecord with paginate() and page() methods.
• lib/will_paginate/view_helpers/link_renderer_base.rb — Base class for rendering pagination links; foundation for all view rendering logic.
• lib/will_paginate/per_page.rb — Manages per_page configuration across global and per-model scopes.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/mislav/will_paginate.git
cd will_paginate
script/bootstrap  # installs dependencies (uses bundler from Gemfile)
bundle exec rspec spec/  # runs test suite

Daily commands:

There is no 'dev server' — this is a library. Run the test suite:

bundle exec rspec spec/
# or for non-Rails adapters:
bundle exec rspec spec-non-rails/
# or the full CI matrix:
script/test_all

For Docker: docker-compose up (configuration in docker-compose.yml).

Key cautions & unknowns

• Slowing — last commit 6mo ago
• Single-maintainer risk — top contributor 83% of recent commits
• Monkey-patching: will_paginate extends Array, Relation, and Hash at load time via core_ext.rb; conflicts possible with other gems using similar extensions. Per-page scoping: WillPaginate.per_page is global;…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.