Skip to main content

Pure-Python HPACK header compression

Project description

https://raw.github.com/Lukasa/hyper/development/docs/source/images/hyper.png https://travis-ci.org/Lukasa/hpack.png?branch=master

This module contains a pure-Python HTTP/2 header encoding (HPACK) logic for use in Python programs that implement HTTP/2. It also contains a compatibility layer that automatically enables the use of nghttp2 if it’s available.

Contributing

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

License

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

Authors

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

Release History

2.2.0 (2016-04-20)

API Changes (Backward Compatible)

  • Added HeaderTuple and NeverIndexedHeaderTuple classes that signal whether a given header field may ever be indexed in HTTP/2 header compression.

  • Changed Decoder.decode() to return the newly added HeaderTuple class and subclass. These objects behave like two-tuples, so this change does not break working code.

Bugfixes

  • Improve Huffman decoding speed by 4x using an approach borrowed from nghttp2.

  • Improve HPACK decoding speed by 10% by caching header table sizes.

2.1.1 (2016-03-16)

Bugfixes

  • When passing a dictionary or dictionary subclass to Encoder.encode, HPACK now ensures that HTTP/2 special headers (headers whose names begin with : characters) appear first in the header block.

2.1.0 (2016-02-02)

API Changes (Backward Compatible)

  • Added new InvalidTableIndex exception, a subclass of HPACKDecodingError.

  • Instead of throwing IndexError when encountering invalid encoded integers HPACK now throws HPACKDecodingError.

  • Instead of throwing UnicodeDecodeError when encountering headers that are not UTF-8 encoded, HPACK now throws HPACKDecodingError.

  • Instead of throwing IndexError when encountering invalid table offsets, HPACK now throws InvalidTableIndex.

  • Added raw flag to decode, allowing decode to return bytes instead of attempting to decode the headers as UTF-8.

Bugfixes

  • memoryview objects are now used when decoding HPACK, improving the performance by avoiding unnecessary data copies.

2.0.1 (2015-11-09)

  • Fixed a bug where the Python HPACK implementation would only emit header table size changes for the total change between one header block and another, rather than for the entire sequence of changes.

2.0.0 (2015-10-12)

  • Remove unused HPACKEncodingError.

  • Add the shortcut ability to import the public API (Encoder, Decoder, HPACKError, HPACKDecodingError) directly, rather than from hpack.hpack.

1.1.0 (2015-07-07)

  • Add support for emitting ‘never indexed’ header fields, by using an optional third element in the header tuple. With thanks to @jimcarreer!

1.0.1 (2015-04-19)

  • Header fields that have names matching header table entries are now added to the header table. This improves compression efficiency at the cost of slightly more table operations. With thanks to Tatsuhiro Tsujikawa.

1.0.0 (2015-04-13)

  • Initial fork of the code from hyper.

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

hpack-2.2.0.tar.gz (40.3 kB view details)

Uploaded Source

Built Distribution

hpack-2.2.0-py2.py3-none-any.whl (35.6 kB view details)

Uploaded Python 2Python 3

File details

Details for the file hpack-2.2.0.tar.gz.

File metadata

  • Download URL: hpack-2.2.0.tar.gz
  • Upload date:
  • Size: 40.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for hpack-2.2.0.tar.gz
Algorithm Hash digest
SHA256 f2917b3f003c7c76c1aa17e89c1fc27a80d2175d6283131890253609f5f370ef
MD5 b9df089cf5a47298a9166e89f06cc30c
BLAKE2b-256 b636d9b4d3b5802002d38cc6ce0586509ea8f24a2f256d3fa9bc23b9c50d00be

See more details on using hashes here.

File details

Details for the file hpack-2.2.0-py2.py3-none-any.whl.

File metadata

File hashes

Hashes for hpack-2.2.0-py2.py3-none-any.whl
Algorithm Hash digest
SHA256 4905a267cfcab4a8106d9ec72a60c301475c2a6d4f08fc1d0571b88e3c6d34f0
MD5 2e774294f5900356a6503ff25059c26b
BLAKE2b-256 0a4e8b5590107131a117e73a495deb90c98b81d7532c7a472af58d8766aa230c

See more details on using hashes here.

Supported by

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