seancribbs / chatterbox

HTTP/2 Server for Erlang. Boy, that guy was a real chatterbox waddn't he? I didn't think he was ever going to stop with the story.

chatterbox

Chatterbox is an HTTP/2 library for Erlang. Use as much of it as you want, but the goal is to implement as much of [https://tools.ietf.org/html/rfc7540][RFC-7540] as possible, 100% of the time.

It already pulls in [https://github.com/joedevivo/hpack][joedevivo/hpack] for the implementation of [https://tools.ietf.org/html/rfc7541][RFC-7541]/

Rebar3

Chatterbox is a rebar3 jam. Get into it! rebar3.org

Setting up Firefox go to the URL about:config and search for the

setting network.http.spdy.enforce.tls.profile and toggle it to false

HTTP/2 Connections

Chatterbox provides a module http2_connection which models (you guessed it!) an HTTP/2 connection. This gen_fsm can represent either side of an HTTP/2 connection (i.e. a client or server). Really, the only difference is in how you start the connection.

Server Side Connections

A server side connection can be started with [https://github.com/ninenines/ranch][ninenines/ranch] using the included chatterbox_ranch_protocol like this:

%% Set up the socket options:
Options = [
        {port, 8080},
        %% you can find certs to play with in ./config
        {certfile,   "localhost.crt"},
        {keyfile,    "localhost.key"},
        {honor_cipher_order, false},
        {versions, ['tlsv1.2']},
        {next_protocols_advertised, [<<"h2">>]}
],

%% You'll also have to set the content root for the chatterbox static
%% content handler

RootDir = "/path/to/content",

application:set_env(
        chatterbox,
        {chatterbox_static_content_hander, [{root_dir, RootDir}]}),

{ok, _RanchPid} =
    ranch:start_listener(
      chatterbox_ranch_protocol,
      10,
      ranch_ssl,
      Options,
      chatterbox_ranch_protocol,
      []),

You can do this in a rebar3 shell or in your application.

You don't have to use ranch. You can use see chatterbox_sup for an alternative.

Serving up the EUC 2015 Deck

clone chatterbox and [https://github.com/joedevivo/euc2015][euc2015]

then set the RootDir above to the checkout of euc2015.

Then it should be as easy as pointing Firefox to https://localhost:8080/.

Client Side Connections

We'll start up http2_connection a little differently. http2_client:start_link/* will take care of the differences.

Here's how to use it!

{ok, Pid} = http2_client:start_link().

Headers = [
           {<<":method">>, <<"GET">>},
           {<<":path">>, <<"/index.html">>},
           {<<":scheme">>, <<"http">>},
           {<<":authority">>, <<"localhost:8080">>},
           {<<"accept">>, <<"*/*">>},
           {<<"accept-encoding">>, <<"gzip, deflate">>},
           {<<"user-agent">>, <<"nghttp2/0.7.7">>}
          ].

{ok, StreamId} = http2_client:send_request(Pid, Headers, <<>>).

{ok, {Headers, Body}} = http2_client:get_response(Pid, StreamId).

There still needs to be some way of detecting that a promise has been pushed from the server, either actively or passively. In theory, if you knew the StreamId, you could check for a response on that stream and it would be there.

Author(s)

• Joe DeVivo

Copyright

Copyright (c) 2015,16 Joe DeVivo, dat MIT License tho.