[lovelydinosaur]

• HTTP/2 is off by default.
• Client(http2=True) to enable
• Added HTTP/2 docs.

Closes #582

Still TODO:

• Interlink to the HTTP/2 section.
• Link to https://http2-explained.haxx.se/content/en/ as a comprehensive HTTP/2 guide.

API changes for http_version=... to http_2=[True|False], so we should leave this to a 0.9 release.

[florimondmanca]

Took a glance at the docs and found a few typos.

I like this change!

I suppose this moves us forward relative to minimal dependencies, eg we’ll now be able to not require h2 unless users want to use HTTP/2?

[lovelydinosaur]

I suppose this moves us forward relative to minimal dependencies, eg we’ll now be able to not require h2 unless users want to use HTTP/2?

Ah yeah I'd forgotten about that. We can also make that switch here, yup.
I guess we would drop h2 out of our default install, and into extra_requires, so...

pip install httpx[h2]

And a check on the client for "if http_2 is True and h2 is not installed then error".

[florimondmanca]

We can also make that switch here, yup.

I’d rather we deal with it later, this PR is quite a big chunk already. :-)

[lovelydinosaur]

Good call.

[lovelydinosaur]

Should we use httpx.Client(http_2=True) or httpx.Client(http2=True)?

I think the later is probably neater, right?

[florimondmanca]

Just remembered we had a "Minimal installs" issue here — #496.