Permalink
6b97aca Apr 11, 2015
3 contributors

Users who have contributed to this file

@Lukasa @alekstorm @collinanderson
91 lines (59 sloc) 2.08 KB

Hyper: HTTP/2 Client for Python

Release v|version|.

HTTP is changing under our feet. HTTP/1.1, our old friend, is being supplemented by the brand new HTTP/2 standard. HTTP/2 provides many benefits: improved speed, lower bandwidth usage, better connection management, and more.

hyper provides these benefits to your Python code. How? Like this:

from hyper import HTTPConnection

conn = HTTPConnection('http2bin.org:443')
conn.request('GET', '/get')
resp = conn.get_response()

print(resp.read())

Simple. hyper is written in 100% pure Python, which means no C extensions. For recent versions of Python (3.4 and onward, and 2.7.9 and onward) it's entirely self-contained with no external dependencies.

hyper supports Python 3.4 and Python 2.7.9, and can speak HTTP/2 and HTTP/1.1.

Caveat Emptor!

Please be warned: hyper is in a very early alpha. You will encounter bugs when using it. In addition, there are very many rough edges. With that said, please try it out in your applications: I need your feedback to fix the bugs and file down the rough edges.

Get Stuck In

The quickstart documentation will help get you going with hyper.

.. toctree::
   :maxdepth: 2

   quickstart

Advanced Documentation

More advanced topics are covered here.

.. toctree::
   :maxdepth: 2

   advanced
   CLI

Contributing

Want to contribute? Awesome! This guide goes into detail about how to contribute, and provides guidelines for project contributions.

.. toctree::
   :maxdepth: 2

   contributing

Frequently Asked Questions

Got a question? I might have answered it already! Take a look.

.. toctree::
   :maxdepth: 2

   faq

API Documentation

The hyper API is documented in these pages.

.. toctree::
   :maxdepth: 2

   api