https://github.com/Lukasa/hyper

HTTP/2 for Python.
https://github.com/Lukasa/hyper

Last synced: about 1 month ago
JSON representation

HTTP/2 for Python.

• Host: GitHub
• URL: https://github.com/Lukasa/hyper
• Owner: python-hyper
• License: mit
• Archived: true
• Created: 2014-01-23T07:53:47.000Z (almost 11 years ago)
• Default Branch: development
• Last Pushed: 2021-04-29T13:03:32.000Z (over 3 years ago)
• Last Synced: 2024-05-19T07:39:57.748Z (7 months ago)
• Language: Python
• Homepage: http://hyper.rtfd.org/en/latest/
• Size: 11.6 MB
• Stars: 1,045
• Watchers: 44
• Forks: 187
• Open Issues: 101
• Metadata Files:
  • Readme: README.rst
  • Changelog: HISTORY.rst
  • License: LICENSE

Awesome Lists containing this project

• starred-awesome - hyper - HTTP/2 for Python. (Python)

README

        
===============================

Hyper: HTTP/2 Client for Python

===============================

**This project is no longer maintained!**

Please use an alternative, such as `HTTPX`_ or others.

.. _HTTPX: https://www.python-httpx.org/

We will not publish further updates for ``hyper``.

Potential security issues will not be addressed.

----

**So long, and thanks for all the fish!**

----

.. image:: https://raw.github.com/Lukasa/hyper/development/docs/source/images/hyper.png

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('nghttp2.org:443')

    conn.request('GET', '/httpbin/get')

    resp = conn.get_response()

    print(resp.read())

Simple.

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.

Versions

========

``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.

Compatibility

=============

``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``.

Documentation

=============

Looking to learn more? Documentation for ``hyper`` can be found on `Read the Docs`_.

.. _Read the Docs: http://hyper.readthedocs.io/en/latest/

Contributing

============

``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`_.

.. _read the contribution guidelines: http://hyper.readthedocs.org/en/development/contributing.html

License

=======

``hyper`` is made available under the MIT License. For more details, see the

``LICENSE`` file in the repository.

Authors

=======

``hyper`` is maintained by Cory Benfield, with contributions from others. For

more details about the contributors, please see ``CONTRIBUTORS.rst``.