add orphans support for object_list pagination

[shadfc]

When the new Paginator support was added to the object_list generic view, support for the orphans feature was left out. This could be enabled simply by including the orphans key in the dictionary passed to the view. It would, of course, only be used when the view is paginated.

info_dict = {
    'queryset' : Model.objects.all(),
    'paginate_by' : 10,
    'orphans' : 3,
}

Given this example, up to 13 objects would be included on a page, instead of only a hard limit of 10.

[shadfc]

patch against rev 7412 adding orphans support to object_list

[shadfc]

orphan support for object_list, and documentation updates for generic views and paginator

[shadfc]

Added a patch with documentation against rev 8147. This patch adds the orphans support to the object_list generic view and updates the documentation for it. It also updates the paginator documentation to include information about orphans.

I couldn't find any tests regarding object_list to update, and while that's not an excuse...

[(none)]

Milestone post-1.0 deleted

[Dmitry Dzhus]

Why this patch still hasn't been accepted upstream?

[Chris Beaven]

If you feel passionate about it, feel free to bring it up in the django-dev google group.

A quick review says this looks near ready for checkin if it is considered worthy. My only point would be that for full backwards compatibility, the new argument should be added to the end of the generic view definition. And yeah, no current tests isn't a good excuse ;)

As an aside, the docs in the patch regarding Paginator orphans are good and should be committed either way. If someone was motivated to separate this to a different ticket, that would be good.

[Russell Keith-Magee]

Also need to be updated for class-based views.

[Aymeric Augustin]

Change UI/UX from NULL to False.

[Aymeric Augustin]

Change Easy pickings from NULL to False.

[Aymeric Augustin]

The patch needs to be updated for the class-based generic views.

[anonymous]

updated for class based views

​https://github.com/django/django/pull/270

[Marc Tamlyn]

Seems to me it may be better to implement this in the context of CBVs as get_paginator_kwargs, a bit like get_form_kwargs rather than a separate method for each variable. Obviously we've got most of them already which we couldn't get rid of without backwards compat, but it's much more future proof.

[Chris Beaven <smileychris@…>]

In 48e8b5e9446f5f9a0667fccbb0ecbd987a27078b:

Add orphans support to MultipleObjectMixin

Fixes #7005