--------------------------
Paginate has prior been maintained as webhelpers.paginate in the _webhelpers_ packages.
This version is a standalone version that should be useful outside of the webhelpers'
context.
Changes:
- Python 3 compatibility.
- SQLAlchemyObject and SQLAlchemyQuery collections are not automatically detected any more.
Instead you can use the respective Page class from the paginate_sqlalchemy module also
available on PyPi.
- presliced_list parameter no longer supported
- 'page_nr' and 'current_page' had been deprecated already and are now removed. Please use 'page'
instead.
- No automatic URL generation. You need to pass a 'url' argument to the Page.pager() method
containing a $page placeholder where you want the page number to be put in. Beware that the URL
is not quote-escaped any further.
- The Page.pager() does not automatically add CSS classes any more. If you want the old
behavior you need to pass these parameters explicitly:
link_attr={'class':'pager_link'}
curpage_attr={'class':'pager_curpage'}
dotdot_attr={'class':'pager_dotdot'}
- The partial_param parameter from Page.pager() is gone. You should use your own URLs for
AJAX/partial updates in the 'url' parameter.
- The page_param parameter from Page.pager() is also gone as URL generation has been severely
simplified.
- The string returned from Page.pager() consists of escaped HTML already. So you need to tell
your web framework to use the string verbatim and without further escaping.
The parameters symbol_first, symbol_last, symbol_previous and symbol_next use
< and > instead of "<" and ">" now.
- Page.__repr__ now returns a brief representation. E.g. <paginate.Page: 1 of 1>
Page.__str__ returns the verbose view you may be used to.