meteoritt / p5-Protocol-HTTP2

HTTP/2 protocol (draft 17) implementation

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

NAME

Protocol::HTTP2 - HTTP/2 protocol (draft 17) implementation

SYNOPSIS

use Protocol::HTTP2;

# get current draft version
print $Protocol::HTTP2::draft;          # 17

# get current interoperate draft version (compatible with current draft
# protocol version for interoperability with over implementations)
print $Protocol::HTTP2::draft_interop;  # 14

# get protocol identification string for secure connections
print Protocol::HTTP2::ident_tls;           # h2-17
print Protocol::HTTP2::ident_interop_tls;   # h2-14

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

DESCRIPTION

Protocol::HTTP2 is HTTP/2 protocol (draft 17) implementation 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 - alpha. Structures, module names and methods may change vastly. I've started this project to understand internals of HTTP/2 and may be it will never become production or even finished.

| 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 implemeted
  • ± -- incomplete
    • -- implemented (may even work)

MODULES

Client protocol decoder/encoder with constructor of requests

Server protocol decoder/encoder with constructor of responses/pushes

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)

Module implements HPACK (draft 11) - Header Compression for HTTP/2. http://tools.ietf.org/html/draft-ietf-httpbis-header-compression-11

Module contain all defined in HTTP/2 protocol constants and default values

Module for debugging. (Ab)used Log::Dispatch internally, may be removed soon.

SEE ALSO

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

About

HTTP/2 protocol (draft 17) implementation

License:Other


Languages

Language:Perl 87.7%Language:Perl 6 12.3%