h2_frame

An HTTP/2 frame encoder and decoder for Gleam.

Handles all standard HTTP/2 frame types as defined in RFC 9113: DATA, HEADERS, PRIORITY, RST_STREAM, SETTINGS, PUSH_PROMISE, PING, GOAWAY, WINDOW_UPDATE, and CONTINUATION. Unknown frame types are preserved rather than rejected.

Installation

gleam add h2_frame

Usage

Parsing

Parse a full frame (header + payload) in one step:

import h2_frame

let assert Ok(#(frame_header, payload, rest)) = h2_frame.parse(data)

Or parse the header and payload separately for more control:

import h2_frame/header

let assert Ok(#(frame_header, rest)) = header.parse_header(data)
let assert Ok(#(payload, rest)) = h2_frame.parse_payload(frame_header, rest)

Encoding

// Encode a settings frame
let assert Ok(frame) =
  h2_frame.encode_settings(ack: False, settings: [
    h2_frame.MaxConcurrentStreams(100),
    h2_frame.InitialWindowSize(65535),
  ])

// Encode a ping frame
let assert Ok(frame) =
  h2_frame.encode_ping(ack: False, data: <<1, 2, 3, 4, 5, 6, 7, 8>>)

Documentation

Full API documentation is available at https://hexdocs.pm/h2_frame.