Use async/await in the readme example

[twm]

Fixes #382.

[twm]

Thank you for the review @adiroiban!

I would love to have it integrated in twisted/twisted

There are certainly parts of it that could live in twisted/twisted:

• RequestTraversalAgent (I've often taken a treq dep just for this)
• The body helpers in treq.content
• A better version of treq.auth
• MultiPartProducer (if its bugs were fixed)

Some parts that are iffy:

• HTTPClient
  • the interface is large, which makes it annoying to wrap (contrast with Agent)
  • all the methods here have heavily-overloaded arguments which is a very different style from Twisted proper (and parameter types are nearly incomprehensible because of that overloading)

• The "augmented" _Response type duplicates treq.content API surface and also buffers the response by default

Finally there some parts that I'd never put in twisted/twisted:

• Functions with global state (treq.request(), treq.get(), etc.)
• The requests dependency
• Treating header values as UTF-8 is simply wrong
• StubTreq (this should be a helper function that returns an appropriately-configured HTTPClient)

[twm]

Thanks again Adi!

[adiroiban]

Thanks for the info related to having treq code in twisted/twisted

I think merging parts of treq into twisted/twisted is a better approach.