django-paginator-plus 0.2.0

django-paginator-plus ===

Want to save the url params and get a format page_range?

This package save extra data to django paginator. Useful when url has params.

If you want to get page rang like below, then Use RequestPaginator.

Previous 1 … 2 3 4 5 … 3000 Next Previous 1 2 3 4 5 … 3000 Next 1 2 3 4 5 … 3000 Next

RequestPaginator will give you a list to deal with you paginator logic.

[{‘current’: True, ‘clickable’: False, ‘url_params’: ‘/questions?a=1&page=1’, ‘text’: 1}, {‘current’: False, ‘clickable’: True, ‘url_params’: ‘/questions?a=1&page=2’, ‘text’: 2}, {‘current’: False, ‘clickable’: True, ‘url_params’: ‘/questions?a=1&page=3’, ‘text’: 3}, {‘current’: False, ‘clickable’: True, ‘url_params’: ‘/questions?a=1&page=4’, ‘text’: 4}, {‘current’: False, ‘clickable’: True, ‘url_params’: ‘/questions?a=1&page=5’, ‘text’: 5}, {‘current’: False, ‘clickable’: True, ‘url_params’: ‘/questions?a=1&page=6’, ‘text’: 6}, {‘current’: False, ‘clickable’: False, ‘url_params’: ‘’, ‘text’: ‘…’}, {‘current’: False, ‘clickable’: True, ‘url_params’: ‘/questions?a=1&page=54’, ‘text’: 54}, {‘current’: False, ‘clickable’: True, ‘url_params’: ‘/questions?a=1&page=2’, ‘text’: u’Next’}]

Install —

pip install django-paginator-plus

Document —

Paginator — Like django default Paginator, it rewrite page_range, and page.

init params:

all Django Paginator params curr_page – paginator current page num. display_pages – if have 100 page, display_pages will only display the pages in page_range method.

rewrite method or property:

page_range

Default Django Paginator will return 1 to max page. [1..100] Here will use curr_page and display_pages to return the page_range. If max page is 100, display_pages is 5, curr_page is 10, the page_range will be [8, 9, 10, 11, 12]. This is useful when handler front end paginator(or you can use a js lib).

page

In default Django Paginator page is a method. Here page is a property, it use curr_page to return Default Django page.

RequestPaginator —

If you want to get page rang like, then Use RequestPaginator.

Previous 1 … 2 3 4 5 … 3000 Next Previous 1 2 3 4 5 … 3000 Next 1 2 3 4 5 … 3000 Next

Like Paginator, but in take some extra params to get the querystring page_params_range.

page_params_range: will return a list, each element is a dict, has those params:

current: is current page or not clickable: can clickable url_params: /questions?a=1&page=1 text: showing text

[{‘current’: True, ‘clickable’: False, ‘url_params’: ‘/questions?a=1&page=1’, ‘text’: 1}, {‘current’: False, ‘clickable’: True, ‘url_params’: ‘/questions?a=1&page=2’, ‘text’: 2}, {‘current’: False, ‘clickable’: True, ‘url_params’: ‘/questions?a=1&page=3’, ‘text’: 3}, {‘current’: False, ‘clickable’: True, ‘url_params’: ‘/questions?a=1&page=4’, ‘text’: 4}, {‘current’: False, ‘clickable’: True, ‘url_params’: ‘/questions?a=1&page=5’, ‘text’: 5}, {‘current’: False, ‘clickable’: True, ‘url_params’: ‘/questions?a=1&page=6’, ‘text’: 6}, {‘current’: False, ‘clickable’: False, ‘url_params’: ‘’, ‘text’: ‘…’}, {‘current’: False, ‘clickable’: True, ‘url_params’: ‘/questions?a=1&page=54’, ‘text’: 54}, {‘current’: False, ‘clickable’: True, ‘url_params’: ‘/questions?a=1&page=2’, ‘text’: u’Next’}]

Simple Usage —

from django.contrib.auth.models import User from paginator_plus.paginator import Paginator

users = User.objects.all() print len(users) p = Paginator(users, per_page=2, curr_page=10) print p.page_range print

p1 = Paginator(users, per_page=2, curr_page=20, display_pages=5) print p1.page_range print

from django.http.request import HttpRequest, QueryDict

r = HttpRequest() r.path_info = ‘/questions’ r.GET = QueryDict(‘a=1’)

print print ‘=========================’ print

from paginator_plus.paginator import RequestPaginator rp = RequestPaginator(users, per_page=2, curr_page=20, display_pages=5, request=r) print print ‘rp = RequestPaginator(users, per_page=2, curr_page=20, display_pages=5, request=r)’ print rp.page_range print rp.page_params_range, print

rp1 = RequestPaginator(users, per_page=2, curr_page=20000, display_pages=5, request=r) print print ‘rp1 = RequestPaginator(users, per_page=2, curr_page=20000, display_pages=5, request=r)’ print rp1.page_range print rp.page_params_range, print

rp3 = RequestPaginator(users, per_page=2, curr_page=1, display_pages=5, request=r) print print ‘rp3 = RequestPaginator(users, per_page=2, curr_page=1, display_pages=5, request=r)’ print rp3.page_range print rp3.page_params_range, print

rp4 = RequestPaginator(users, per_page=2, curr_page=2, display_pages=5, request=r) print print ‘rp4 = RequestPaginator(users, per_page=2, curr_page=2, display_pages=5, request=r)’ print rp4.page_range print rp4.page_params_range, print

rp5 = RequestPaginator(users, per_page=2, curr_page=2, display_pages=5, request=r, show_prev=False, show_next=False) print print ‘rp5 = RequestPaginator(users, per_page=2, curr_page=2, display_pages=5, request=r, show_prev=False, show_next=False)’ print rp5.page_range print rp5.page_params_range, print

rp6 = RequestPaginator(users, per_page=2, curr_page=1, display_pages=6, request=r, auto_hide_prev=True) print print ‘rp6 = RequestPaginator(users, per_page=2, curr_page=1, display_pages=6, request=r, auto_hide_prev=True)’ print rp6.page_range print rp6.page_params_range, print

rp7 = RequestPaginator(users, per_page=2, curr_page=2, display_pages=7, request=r, auto_hide_prev=True) print print ‘rp7 = RequestPaginator(users, per_page=2, curr_page=2, display_pages=7, request=r, auto_hide_prev=True)’ print rp7.page_range print rp7.page_params_range, print