Deprecate undocumented QuerySetPaginator

[Nick Pope]

QuerySetPaginator was ​merged into Paginator over 10 years ago before the release of Django 1.0, at which point it was undocumented but aliased for backward compatibility.

I would have suggested just removing it, but curiously it seems that people are ​still using it quite a lot. We should formalize the deprecation.

[Nick Pope]

​PR

[Tim Graham]

I don't think it's worth the churn. A one line alias isn't adding any maintenance overhead or clutter.

[Jon Dufresne]

I think having an undocumented alias would only lead to confusion if it were used. Removing it better follows the zen of Python "There should be one-- and preferably only one --obvious way to do it.".

+1 for deprecating and removing.

[Carlton Gibson]

We should formalize the deprecation.

Is there any way of estimating of those search results how many are still being updated? (I suspect a lot are not...)

Question: given that it's 10 years old and the fix would just be a search and replace operation, could we not just remove it and mark it as a breaking change?

[Tim Graham]

Django has been criticized for "needless deprecations" in the past, that's why I'm skeptical. I don't care much though.

[Tim Graham <timograham@…>]

In ed4bfac:

Fixed #29703 -- Deprecated QuerySetPaginator alias.

Unused since 4406d283e13819b04556df21044089b7d119edb0.

[Mariusz Felisiak <felisiak.mariusz@…>]

In 81993b47:

Refs #29703 -- Removed QuerySetPaginator alias per deprecation timeline.