Raymond: I made a single diff for easier review.  I’m not 100% sure I should change 'r' to 'rb' in logging: It’s unrelated to with, and the rest of the file has not been checked for similar errors.  I prefer to do commits that don’t mix things.

Eli:
> which whitespace change do you refer to. I changed to 4-spaces
> indentation in the code sample to conform to PEP-8. Shouldn't I have?
PEP 8 only applies to Python code.  http://docs.python.org/dev/documenting/style applies to the docs.