1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
|
# 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](https://tools.ietf.org/html/rfc7540)) 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 | ± |
| Stream priority | ± |
| Server push | + |
| Connect method | - |
| Frame | encoder | decoder |
| --------------- |:-------:|:-------:|
| DATA | ± | + |
| HEADERS | + | + |
| PRIORITY | + | + |
| RST_STREAM | + | + |
| SETTINGS | + | + |
| PUSH_PROMISE | + | + |
| PING | + | + |
| GOAWAY | + | + |
| WINDOW_UPDATE | + | + |
| CONTINUATION | ± | + |
- - -- not implemented
- ± -- incomplete
- + -- implemented (may even work)
# MODULES
## [Protocol::HTTP2::Client](https://metacpan.org/pod/Protocol%3A%3AHTTP2%3A%3AClient)
Client protocol decoder/encoder with constructor of requests
## [Protocol::HTTP2::Server](https://metacpan.org/pod/Protocol%3A%3AHTTP2%3A%3AServer)
Server protocol decoder/encoder with constructor of responses/pushes
## [Protocol::HTTP2::Connection](https://metacpan.org/pod/Protocol%3A%3AHTTP2%3A%3AConnection)
Main low level module for protocol logic and state processing. Connection
object is a mixin of [Protocol::HTTP2::Frame](https://metacpan.org/pod/Protocol%3A%3AHTTP2%3A%3AFrame) (frame encoding/decoding),
[Protocol::HTTP2::Stream](https://metacpan.org/pod/Protocol%3A%3AHTTP2%3A%3AStream) (stream operations) and [Protocol::HTTP2::Upgrade](https://metacpan.org/pod/Protocol%3A%3AHTTP2%3A%3AUpgrade)
(HTTP/1.1 Upgrade support)
## [Protocol::HTTP2::HeaderCompression](https://metacpan.org/pod/Protocol%3A%3AHTTP2%3A%3AHeaderCompression)
Module implements HPACK - Header Compression for HTTP/2 ([RFC 7541](https://tools.ietf.org/html/rfc7541)).
## [Protocol::HTTP2::Constants](https://metacpan.org/pod/Protocol%3A%3AHTTP2%3A%3AConstants)
Module contains all defined in HTTP/2 protocol constants and default values
## [Protocol::HTTP2::Trace](https://metacpan.org/pod/Protocol%3A%3AHTTP2%3A%3ATrace)
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](https://github.com/vlet/p5-Protocol-HTTP2/wiki) - Protocol::HTTP2 wiki
[http://http2.github.io/](http://http2.github.io/) - official HTTP/2 specification site
[http://daniel.haxx.se/http2/](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>
|
