Documentation out-of-date: django.contrib.auth.utils no longer exists.

[Michael B. Trausch]

​https://docs.djangoproject.com/en/dev/topics/auth/ in the “Manually managing a user’s password” section, a reference is made to the django.contrib.auth.utils module, but this module does not exist. It was created in response to #14390 in SVN r16456 (or git a51a059899) in June 2011) but then six months later in SVN r17254 (or git 0516dc6741) it was moved to the django.contrib.auth.hashers module.

The documentation shows that this was added for “the development release”, which I assume means the Django 1.4 development cycle, so it should not affect older versions of Django or its documentation.

I _may_ be able to provide a simple patch in a git tree later, depending on how my schedule for today goes, but I wanted to get this reported so that it was known before the Django 1.4 series enters the next iteration of its release process.

I am marking this as a release blocker based on the rationale that:

• this is not a regression and is a defect in documentation for the new release; and
• it is a relatively easy defect to fix; and
• the outdated documentation can easily cost someone an hour of time tracking down a “problem” that does not exist.

[Claude Paroz]

Thanks for the precise description of the problem. Patch welcome!

[Michael B. Trausch]

I am working on it now and should have a patch for the documentation ready soon.

[Michael B. Trausch]

I have a pull request on GitHub:

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

This update to the documentation fixes the problem reported in this ticket as well as one other minor problem (lacking a "new in..." notification around before one of the functions). Someone who has the ability to get this merged in should be able to do so at this point. Please let me know, of course, if there are any problems that need addressed, but the patch is relatively simple and straightforward, so I do not expect that to happen unless I did something blatantly wrong. :-)

[Michael B. Trausch]

Commit 1 - fix #17764 by updating documentation

[Michael B. Trausch]

Commit 2 - Add a versionadded tag for function missing it in new hashers module

[Michael B. Trausch]

I have also added the commits as individual patch files here, in the event that someone wants to incorporate them into SVN directly (I don’t know for sure which tool Django is using as its primary, so I am doing it both ways).

[Dougal Matthews]

In a related issue that probably isn't worth its own ticket; The release notes for Django 1.4 also mention django.contrib.auth.utils.

The django.contrib.auth.models.check_password() function has been 
moved to the django.contrib.auth.utils module. Importing it from the 
old location will still work, but you should update your imports.

[Paul McMillan]

Closed in r17620. Thanks for the patch! For future reference, we can accept either svn or git style diffs. The most convenient way is to attach a unified diff to the tracker issue rather than individual commits.