NAME

       Protocol::HTTP2 - HTTP/2 protocol implementation (RFC 7540)

SYNOPSIS

           use Protocol::HTTP2;

           # get protocol identification string for secure connections
           print Protocol::HTTP2::ident_tls;           # h2

           # get protocol identification string for non-secure connections
           print Protocol::HTTP2::ident_plain;         # h2c

DESCRIPTION

       Protocol::HTTP2 is HTTP/2 protocol implementation (RFC 7540) with stateful decoders/encoders of HTTP/2
       frames. You may use this module to implement your own HTTP/2 client/server/intermediate on top of your
       favorite event loop over plain or tls socket (see examples).

STATUS

       Current status - beta. Structures, module names and methods seems like stable.  I've started this project
       to understand internals of HTTP/2 and may be it will never become production, but at least it works.

           | Spec                    |      status     |
           | ----------------------- | --------------- |
           | Negotiation             |   ALPN, NPN,    |
           |                         | Upgrade, direct |
           | Preface                 |        +        |
           | Headers (de)compression |        +        |
           | Stream states           |        +        |
           | Flow control            |        X        |
           | Stream priority         |        X        |
           | Server push             |        +        |
           | Connect method          |        -        |

           | Frame           | encoder | decoder |
           | --------------- |:-------:|:-------:|
           | DATA            |    X    |    +    |
           | HEADERS         |    +    |    +    |
           | PRIORITY        |    +    |    +    |
           | RST_STREAM      |    +    |    +    |
           | SETTINGS        |    +    |    +    |
           | PUSH_PROMISE    |    +    |    +    |
           | PING            |    +    |    +    |
           | GOAWAY          |    +    |    +    |
           | WINDOW_UPDATE   |    +    |    +    |
           | CONTINUATION    |    X    |    +    |

       - -- not implemeted
       X -- incomplete
       + -- implemented (may even work)

MODULES

   Protocol::HTTP2::Client
       Client protocol decoder/encoder with constructor of requests

   Protocol::HTTP2::Server
       Server protocol decoder/encoder with constructor of responses/pushes

   Protocol::HTTP2::Connection
       Main  low  level  module  for  protocol  logic  and  state  processing.  Connection  object is a mixin of
       Protocol::HTTP2::Frame  (frame  encoding/decoding),  Protocol::HTTP2::Stream  (stream   operations)   and
       Protocol::HTTP2::Upgrade (HTTP/1.1 Upgrade support)

   Protocol::HTTP2::HeaderCompression
       Module      implements      HPACK     -     Header     Compression     for     HTTP/2     (RFC     7541).
       <https://tools.ietf.org/html/rfc7541>

   Protocol::HTTP2::Constants
       Module contains all defined in HTTP/2 protocol constants and default values

   Protocol::HTTP2::Trace
       Module for debugging. You can setup HTTP2_DEBUG environment variable to change verbosity  of  the  module
       (output to STDOUT). Default level is error.

           $ export HTTP2_DEBUG=debug
           $ perl ./http2_program

SEE ALSO

       <https://github.com/vlet/p5-Protocol-HTTP2/wiki> - Protocol::HTTP2 wiki

       <http://http2.github.io/> - official HTTP/2 specification site

       <http://daniel.haxx.se/http2/> - http2 explained

LICENSE

       Copyright (C) Vladimir Lettiev.

       This  library  is  free  software;  you can redistribute it and/or modify it under the same terms as Perl
       itself.

AUTHOR

       Vladimir Lettiev <thecrux@gmail.com>

perl v5.24.1                                       2017-02-06                               Protocol::HTTP2(3pm)