Corrected erroneous caching example

[rebcabin]

I had a misunderstanding of sharing of instance variables in my last pull request. This one corrects the misunderstanding and adds clarified examples, plus it has all the other commits I've made to date to get the unit tests to run.

[azazel75]

Some of this stuff may be indteresting, but it needs to be updated for python3