Skip to main content

HTTP/2 Client for Python

Project description

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('')
conn.request('GET', '/get')
resp = conn.get_response()



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.


hyper supports the final draft of the HTTP/2 specification: additionally, it provides support for drafts 14, 15, and 16 of the HTTP/2 specification. It also supports the final draft of the HPACK specification.


hyper is intended to be a drop-in replacement for http.client, with a similar API. However, hyper intentionally does not name its classes the same way http.client does. This is because most servers do not support HTTP/2 at this time: I don’t want you accidentally using hyper when you wanted http.client.


hyper welcomes contributions from anyone! Unlike many other projects we are happy to accept cosmetic contributions and small contributions, in addition to large feature requests and changes.

Before you contribute (either by opening an issue or filing a pull request), please read the contribution guidelines.


hyper is made available under the MIT License. For more details, see the LICENSE file in the repository.


hyper is maintained by Cory Benfield, with contributions from others. For more details about the contributors, please see CONTRIBUTORS.rst.

Release History

0.5.0 (2015-10-11)

Feature Enhancement

  • Pay attention to max frame length changes from remote peers. Thanks to @jdecuyper!


  • Prevent hyper from emitting oversized frames. Thanks to @jdecuyper!

  • Prevent hyper from emitting RST_STREAM frames whenever it finishes consuming a stream.

  • Prevent hyper from emitting lots of RST_STREAM frames.

  • Hyper CLI tool now correctly uses TLS for any https-schemed URL.

  • Hyper CLI tool no longer attempts to decode bytes, instead writing them straight to the terminal.

  • Added new --h2 flag to the Hyper CLI tool, which allows straight HTTP/2 in plaintext, rather than attempting to upgrade from HTTP/1.1.

  • Allow arguments and keyword arguments in abstract version of get_response.

Software Updates

  • Updated hyperframe to version 2.1.0

0.4.0 (2015-06-21)

New Features

  • HTTP/1.1 and HTTP/2 abstraction layer. Don’t specify what version you want to use, just automatically get the best version the server supports!

  • Support for upgrading plaintext HTTP/1.1 to plaintext HTTP/2, with thanks to @fredthomsen! (Issue #28)

  • HTTP11Connection and HTTPConnection objects are now both context managers.

  • Added support for ALPN negotiation when using PyOpenSSL. (Issue #31)

  • Added support for user-provided SSLContext objects, with thanks to @jdecuyper! (Issue #8)

  • Better support for HTTP/2 error codes, with thanks to @jdecuyper! (Issue #119)

  • More gracefully close connections, with thanks to @jdecuyper! (Issue #15)

Structural Changes

  • The framing and HPACK layers were stripped out into their own libraries.


  • Properly verify hostnames when using PyOpenSSL.

0.3.1 (2015-04-03)


0.3.0 (2015-04-03)

New Features

  • HTTP/1.1 support! See the documentation for more. (Issue #75)

  • Implementation of a HTTPHeaderMap data structure that provides dictionary style lookups while retaining all the semantic information of HTTP headers.

Major Changes

  • Various changes in the HTTP/2 APIs:

    • The getheader, getheaders, gettrailer, and gettrailers methods on the response object have been removed, replaced instead with simple .headers and .trailers properties that contain HTTPHeaderMap structures.

    • Headers and trailers are now bytestrings, rather than unicode strings.

    • An iter_chunked() method was added to response objects that allows iterating over data in units of individual data frames.

    • Changed the name of getresponse() to get_response(), because getresponse() was a terrible name forced upon me by httplib.

0.2.2 (2015-04-03)


  • Hyper now correctly handles ‘never indexed’ header fields. (Issue #110)

0.2.1 (2015-03-29)

New Features

  • There is now a hyper command-line client that supports making HTTP/2 requests directly from the command-line.

Major Changes

  • Support for the final drafts of HTTP/2 and HPACK. Updated to offer the ‘h2’ ALPN token.

Minor Changes

  • We not only remove the Connection header but all headers it refers to.

0.2.0 (2015-02-07)

Major Changes

  • Python 2.7.9 is now fully supported.

0.1.2 (2015-02-07)

Minor Changes

  • We now remove the Connection header if it’s given to us, as that header is not valid in HTTP/2.


  • Adds workaround for HTTPie to make our responses look more like urllib3 responses.

0.1.1 (2015-02-06)

Minor Changes

  • Support for HTTP/2 draft 15, and 16. No drop of support for draft 14.

  • Updated bundled certificate file.


  • Fixed AttributeError being raised when a PING frame was received, thanks to @t2y. (Issue #79)

  • Fixed bug where large frames could be incorrectly truncated by the buffered socket implementation, thanks to @t2y. (Issue #80)

0.1.0 (2014-08-16)

Regressions and Known Bugs

  • Support for Python 3.3 has been temporarily dropped due to features missing from the Python 3.3 ssl module. PyOpenSSL has been identified as a replacement, but until NPN support is merged it cannot be used. Python 3.3 support will be re-added when a suitable release of PyOpenSSL is shipped.

  • Technically this release also includes support for PyPy and Python 2.7. That support is also blocked behind a suitable PyOpenSSL release.

For more information on these regressions, please see Issue #37.

Major Changes

  • Support for HPACK draft 9.

  • Support for HTTP/2 draft 14.

  • Support for Sever Push, thanks to @alekstorm. (Issue #40)

  • Use a buffered socket to avoid unnecessary syscalls. (Issue #56)

  • If nghttp2 is present, use its HPACK encoder for improved speed and compression efficiency. (Issue #60)

  • Add HTTP20Response.gettrailer() and HTTP20Response.gettrailers(), supporting downloading and examining HTTP trailers. (Discussed in part in Issue #71.)


  • HTTP20Response objects are context managers. (Issue #24)

  • Pluggable window managers are now correctly informed about the document size. (Issue #26)

  • Header blocks can no longer be corrupted if read in a different order to the one in which they were sent. (Issue #39)

  • Default window manager is now smarter about sending WINDOWUPDATE frames. (Issue #41 and Issue #52)

  • Fixed inverted window sizes. (Issue #27)

  • Correct reply to PING frames. (Issue #48)

  • Made the wheel universal, befitting a pure-Python package. (Issue #46)

  • HPACK encoder correctly encodes header sets with duplicate headers. (Issue #50)

0.0.4 (2014-03-08)

  • Add logic for pluggable objects to manage the flow-control window for both connections and streams.

  • Raise new HPACKDecodingError when we’re unable to validly map a Huffman-encoded string.

  • Correctly respect the HPACK EOS character.

0.0.3 (2014-02-26)

  • Use bundled SSL certificates in addition to the OS ones, which have limited platform availability. (Issue #9)

  • Connection objects reset to their basic state when they’re closed, enabling them to be reused. Note that they may not be reused if exceptions are thrown when they’re in use: you must open a new connection in that situation.

  • Connection objects are now context managers. (Issue #13)

  • The HTTP20Adapter correctly reuses connections.

  • Stop sending WINDOWUPDATE frames with a zero-size window increment.

  • Provide basic functionality for gracelessly closing streams.

  • Exhausted streams are now disposed of. (Issue #14)

0.0.2 (2014-02-20)

  • Implemented logging. (Issue #12)

  • Stopped HTTP/2.0 special headers appearing in the response headers. (Issue #16)

  • HTTP20Connection objects are now context managers. (Issue #13)

  • Response bodies are automatically decompressed. (Issue #20)

  • Provide a requests transport adapter. (Issue #19)

  • Fix the build status indicator. (Issue #22)

0.0.1 (2014-02-11)

  • Initial Release

  • Support for HTTP/2.0 draft 09.

  • Support for HPACK draft 05.

  • Support for HTTP/2.0 flow control.

  • Verifies TLS certificates.

  • Support for streaming uploads.

  • Support for streaming downloads.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hyper-0.5.0.tar.gz (255.6 kB view hashes)

Uploaded Source

Built Distribution

hyper-0.5.0-py2.py3-none-any.whl (267.8 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page