Django does this in more recent versions of its remote user middleware
and it makes sense to do the same here.

Since the README was changed from `.md` to `.rst` pip install no longer works.

And reformat to reStructuredText

* test Django 1.10, Django 1.11, and Python 3.6

* don't test any django versions except 1.11 on python 3.6

* add TEMPLATES setting and remove admin app

* change order of user.set_unusable_password()

setting a password for user needs to be before auth.login() 
because get_session_auth_hash() returns the salted_hmac value of salt and password.
If it remains after the auth.login() it will return a different auth_hash 
than what's stored in session "request.session[HASH_SESSION_KEY]".
Also we don't need to update the user's password every time he logs in.

* moved setting password from middle-ware to backend @ initial user-creation.

* moved setting password from middle-ware to backend @ initial user-creation.

* Fix some PEP-8 formatting issues (four spaces), update to 1.8+ style of URL patterns.

* Switch to v1.8 style TEMPLATE settings.

* Small spacing issue.

* Tabs to spaces for code blocks.

* Finalize PEP-8 for middleware docs.

* Add permission group mapping

* Fixed typos in documentation

* add a .gitattributes file to make all files use LF

* normalize all the line endings

* remove an unused function; whitespace changes

* Always set user attributes from shibboleth parameters

* Converted parse_attributes() method to static method

* Only write user object when shib_meta changed

* Added test for ensure shibboleth metadata

Replace url pattern in urls.py for Django 1.10 compatibility

set version to 0.8-dev for new development

set version to 0.7 in setup.py

we can always call django.setup() now, because we only support django…

bump version to 0.6-dev, update contact info

Remove django 1.6 and 1.7 from testing, since they're EOL, and remove…

Remove django 1.6 and 1.7 from testing, since they're EOL, and remove python 2.6 since django 1.8 requires python 2.7

Tests

Made create_unknown_user an optional setting in the django config.

Fixed the import of app_settings for python 3.4.

nothing is set, it defaults to True.