It's worth noting that I delegated clean-up to system_tests/datastore.py::tearDownModule. This is because (in my experimenting) I discovered that the sphinx.ext.doctest directive testcleanup doesn't run when the thing being tested fails. (FWIW, I think it'd be fairly easy for one of us to send a PR to the Sphinx project and fix that behavior, but that was outside the scope of this PR.)

To make dev a little faster I did the following:

$ tox -e system-tests --recreate --notest
$ source .tox/system-tests/bin/activate
$ GOOGLE_CLOUD_DISABLE_GRPC=true \
> .tox/system-tests/bin/py.test system_tests/datastore.py \
> -k TestDoctest -s -vv

and every time I made a change I just re-installed into the env

$ .tox/system-tests/bin/pip install --upgrade datastore/

Might be worth turning this into a script someday? But I don't want to design it before we know how we'll use it. Just putting it here for posterity.

There is a code-block snippet in datastore._http but that module is non-public so I left it alone.

This package could use some more snippets, but for now at least they are all covered.