allow ContentsManager methods to return Futures

mainly adding `@gen.coroutine` and `yield gen.maybe_future` all over the place.

No FileContentsManager methods are actually async at this point.
use gen.Return for Python 2
Merge pull request #7253 from minrk/async-contents-handlers

allow ContentsManager methods to return Futures