Change environment cache key construction

Changing from a tuple of the loader ID and template name to a weakref
to the loader and the template name should avoid situations whereby
the loader has changed, yet the cached templates are returned. This
would occur if the id of the new loader matches the old. A weakref is
preferred over a direct reference so that the loader can be garbaged
collected.

Merge branch 'pgjones-master'

Changelog for #583

Change cache key definitiion in environment

In 6671b973e6de5abc46829a27fd3bbb989d68ca3a the load_template method
was altered to use a cache key other than the template name. The key
chosen was the abs path as returned from the loader get_source
method. Unless there is no path in which case the name is
used. Unfortunately this introduced a performance regression, #485, as
the get_source method (in the FileStoreLoader) loads the template
(causing IO).

The purpose of #332 was to allow the loader to change whilst ensuring
the correct template was loaded, i.e. to fix this case

    env.loader = loader1
    env.get_template('index.html') # return loader1/index.html
    env.loader = loader2
    env.get_template('index.html') # also return loader1/index.html because of cache

This commit changes the cache key to be a tuple of the id(loader) and
the template name. Therefore fixing the above case without calling the
get_source method and thereby avoiding the IO load.

A test has been added to ensure the above case works as expected, this
required a minor refactor of the caching tests.

README - fixes (#578)

* Add syntax highlighting
* Fix build table which doesn't display on Github RST renderer

use double ticks for code in rst

Merge pull request #577 from boidolr/documentation_fixes

Small documentation fixes

Remove `sudo` command from documentation (fixes #543).

Installations should be in a virtualenv.

Use constant name in doc (fixes #544)

Merge pull request #570 from mr-m/patch-1

Fix the typo in templates.rst

Fix the typo

Suggest installing via Pip (#569)

Merge pull request #439 from jgmize/title-filter-capitalize-inside-parens

Make title filter capitalize words inside parens and other brackets

Merge pull request #473 from snoack/redundant-sorting

Got rid of redundant sorting in groupby filter

Merge pull request #470 from snoack/partial-next

Use partial(next, ...) instead get_next()

Merge pull request #567 from gpanther/update-gae-example-in-faq

Update GAE example code

Update GAE example code

Update the Google App Engine example code to be compatible with the latest google app engine devserver.

Merge pull request #500 from snoack/setup-py-versions

Added Python 3.4 and 3.5 to the classifiers in setup.py

Merge branch '2.8-maintenance'

Changelog for #466

Merge branch 'snoack-issue-466' into 2.8-maintenance

Fix #467
Fix #466

Fixed int() filter for non-string objects #466

standard tox/travis config
fix pytest warning, don't prefix non-testcase classes with Test

Fixed typo/grammar error (#532)

Use container-based travis infrastructure (#496)

Fix typo (#531)

link fix (#527)

Change links for Babel to new docs location. (#562)

Escape target attribute in the urlize function in utils.py. (#507)

change from @mitsuhiko to pallets project

Merge pull request #526 from ioab/master

docs: Integration link fix

docs: Integration link fix

Merge pull request #523 from alimony/patch-1

Fix typo.

Fix typo.

Merge branch '2.8-maintenance'

Fixed for_qs for urlencode. This fixes #515

This is 2.8.1-dev

Merge pull request #513 from spookylukey/patch-1

Fixed a few spelling mistakes in a docstring

Fixed a few spelling mistakes in a docstring

Added Python 3.4 and 3.5 to the classifiers in setup.py

Merge pull request #497 from snoack/pypy

Added pypy to the list of Python versions tested by Travis CI

Added pypy to the list of Python versions tested by Travis CI

Don't pin to .0 version

Merge pull request #495 from snoack/py35

Added Python 3.5 to tox and Travis configuration

Added Python 3.5 to tox and Travis configuration

Use partial(next, ...) instead get_next()

Got rid of redundant sorting in groupby filter

Merge pull request #472 from pydanny/pydanny-update-django-switch-docs

Remove conditions segment of Django section

Removed outdated condition section on Django

Merge pull request #471 from snoack/metaclass-improvement

Improve with_metaclass()

Improve with_metaclass()

Improve release script to support new format and wheels.

This is 2.9.dev

Bump version number to 2.8

Hardcode version in setup.py again.

Release date is today.

Merge pull request #425 from highlyunavailable/master

Fix literal \ characters at the end of a string

Merge pull request #461 from StevenMaude/patch-1

Fix typo: "the iterates" > "that iterates"

Fix typo: "the iterates" > "that iterates"

In filters.py.

Fix syntax error

Update FAQ about unsupported Python versions

Thanks to @ThomasWaldmann for the original patch. His fork is gone so I
can't apply the original commits.

Add Python classifiers for all supported versions

Thanks to @ThomasWaldmann for the original patch. His fork is gone so I
can't apply the original commits.

Changelog for #447

Merge pull request #447 from bentimms/int-filter-base

Add 'base' parameter to 'int' filter

Merge pull request #450 from jenisys/fixdoc.extension_example

FIX DOC-EXAMPLE: cache_extension.py

Sort filters, remove dupes

Fix #454

Merge branch 'merwok-patch-1'

Fix #455

Fix typo

Escape slashes in query strings.  This fixes #445

Merge branch 'pr/451'

Added decorator support for finalize.  This fixes #431

Amend to #453

Merge pull request #453 from jeffwidman/patch-1

Fix typos and grammar in Readme

Fix typos and grammar in Readme

fix the fancy tracebacks on Python 3

FIX EXAMPLE:
No longer working with current code base
since the TokenStream.next() method was removed.

Add 'base' parameter to 'int' filter

Make title filter capitalize words in (),{},[],<>

Merge branch 'override-codegen-context'

Add changelog for #404

Let the Environment override the Context

closes #404

Let the Environment override the CodeGenerator

see #404

Merge pull request #437 from alexwlchan/master

Fix a few small typos in the docs

Fix a few small typos in the docs

Merge branch '2.7-maintenance'

Fix syntax error

Merge branch '2.7-maintenance'

Fix #433

Actually don't run doctests

Fix travis

Add build badges

change py2 print statements to py3

Fix doctests

Fix #427

Merge branch 'lkarthee-pytest_migration'

Exclude examples

Use tox in travis

Rename testsuite to tests and suggestions

Remove  py.test from setup.py install_requires
Rename testsuite folder to tests.

Moving testsuite directory to root folder

fixing errors due to removal of init.py from test suite

Adding pytest references and dependencies in setup.py and Makefile