index.rst (1223B)
1 .. hyper-h2 documentation master file, created by 2 sphinx-quickstart on Thu Sep 17 10:06:02 2015. 3 You can adapt this file completely to your liking, but it should at least 4 contain the root `toctree` directive. 5 6 h2: A pure-Python HTTP/2 protocol stack 7 ======================================= 8 9 h2 is a HTTP/2 protocol stack, written entirely in Python. The goal of 10 h2 is to be a common HTTP/2 stack for the Python ecosystem, 11 usable in all programs regardless of concurrency model or environment. 12 13 To achieve this, h2 is entirely self-contained: it does no I/O of any 14 kind, leaving that up to a wrapper library to control. This ensures that it can 15 seamlessly work in all kinds of environments, from single-threaded code to 16 Twisted. 17 18 Its goal is to be 100% compatible with RFC 7540, implementing a complete HTTP/2 19 protocol stack build on a set of finite state machines. Its secondary goals are 20 to be fast, clear, and efficient. 21 22 For usage examples, see :doc:`basic-usage` or consult the examples in the 23 repository. 24 25 Contents 26 -------- 27 28 .. toctree:: 29 :maxdepth: 2 30 31 installation 32 basic-usage 33 negotiating-http2 34 examples 35 advanced-usage 36 low-level 37 api 38 testimonials 39 release-process 40 release-notes