Skip to main content

A port of ericflo/django-pagination to Python 3 and beyond!

Project description

django-pagination-py3

Python Compatibility PyPi Version CI badge codecov License

A port of ericflo/django-pagination to Python 3. Updated to be compatible with Django 4.x and 5.0.

For versions compatible with Django 3.x and Python 2.7+ please install or download version 1.2.0 from Releases or Pypi.

Features

  • Really easy to use at template level.
  • It preserves all request's querystring parameters.
  • Settings to customize behavior.
  • Translated to fr, de, es, pt, pl and pt_BR.
  • A fully working example project.

Installation

Install using pip command:

pip install django-pagination-py3

...or clone the repo and install it using pip:

git clone git://github.com/matagus/django-pagination-py3.git
cd django-pagination-py3
pip install -e .

Add pagination INSTALLED_APPS to your settings.py:

INSTALLED_APPS = (
    # ...
    "pagination",
)

Add the middleware:

   MIDDLEWARE_CLASSES = (
       # ...
       'pagination.middleware.PaginationMiddleware',
   )

Add this line at the top of your template to load the pagination tags:

  {% load pagination_tags %}

Decide on a variable that you would like to paginate, and use the autopaginate tag on that variable before iterating over it. This could take one of two forms (using the canonical object_list as an example variable):

  {% autopaginate object_list %}

This assumes that you would like to have the default 20 results per page. If you would like to specify your own amount of results per page, you can specify that like so:

  {% autopaginate object_list 10 %}

Note that this replaces object_list with the list for the current page, so you can iterate over the object_list like you normally would.

Now you want to display the current page and the available pages, so somewhere after having used autopaginate, use the paginate inclusion tag:

  {% paginate %}

This does not take any arguments, but does assume that you have already called autopaginate, so make sure to do so first.

That's it! You have now paginated object_list and given users of the site a way to navigate between the different pages--all without touching your views.

Running Tests

hatch run test:test will run the tests in every Python + Django versions combination.

hatch run test.py3.12-5.0:test: will run them for python 3.12 and Django 5.0. Please see possible combinations using hatch env show ("test" matrix).

License

django-pagination-py3 is released under an BSD License - see the LICENSE file for more information.

Acknowledgements

Develop & built using Hatch project linting - Ruff code style - black

Posts I learned from:

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django_pagination_py3-2.1.0.tar.gz (10.7 kB view details)

Uploaded Source

Built Distribution

django_pagination_py3-2.1.0-py2.py3-none-any.whl (18.8 kB view details)

Uploaded Python 2 Python 3

File details

Details for the file django_pagination_py3-2.1.0.tar.gz.

File metadata

  • Download URL: django_pagination_py3-2.1.0.tar.gz
  • Upload date:
  • Size: 10.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.12.7

File hashes

Hashes for django_pagination_py3-2.1.0.tar.gz
Algorithm Hash digest
SHA256 8e96f7194f2a476054c09afd3e0d4a4333a4893f65e9f376ab8bb35248cf22dd
MD5 ce1ccaecafa1f2c12982e1918f4bde1f
BLAKE2b-256 b934f60fb80232d7640dd9e431af68d4e5d599480050ef85d8e6cff4aab6d817

See more details on using hashes here.

File details

Details for the file django_pagination_py3-2.1.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for django_pagination_py3-2.1.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 8489047ea2da64e8d7701138dd2117b88696e62d7802b76c806ad04a8e687c6a
MD5 c41ceee3b5679cb2d05fe77e1583fe9a
BLAKE2b-256 5dbe2de597be5f7228ba967b1c2177f00fdb483b41428dd5772008a85c89e573

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page