flare.http.proto.h2_config

struct Http2Config

Tunable HTTP/2 SETTINGS and limits for an :class:Http2Connection.

Protocol fields map to RFC 9113 §6.5.2 SETTINGS identifiers (including the RFC 7541 HPACK header-table size). Defaults are the production-shape numbers flare's reactor wiring uses for both the inline test driver in :mod:tests.test_h2_server and the reactor-attached driver.

The allow_huffman_decode flag gates HPACK Huffman decoding on the inbound HEADERS path. Default True, and it should stay that way. RFC 7541 sec 5.2 lets the encoder choose whether a literal is Huffman-coded and signals it with the H bit; a decoder does not get the same choice. curl, every browser, and h2load Huffman-code by default, so a server that rejects H=1 cannot talk to them -- it answers the client's first HEADERS frame by tearing down the connection. This defaulted to False through v0.9, which is why flare's h2 interop was only ever exercised against flare's own client (which emits H=0).

Set it to False only to reproduce the legacy raw-literal wire for a specific peer.

The allow_huffman_encode flag is the emit-side twin and legitimately defaults to False: what a server sends is its own choice, H=0 output is CRIME-class-side-channel-free by construction, and every compliant client accepts it. Set it True to pick the shorter of raw vs Huffman per literal.

Example:

from flare.http2 import Http2Connection, Http2Config

var cfg = Http2Config(
    max_concurrent_streams=200,
    max_body_size=10 * 1024 * 1024,
    initial_window_size=131072,
    max_frame_size=32768,
    max_header_list_size=16384,
    header_table_size=8192,
    allow_huffman_decode=True,
    allow_huffman_encode=False,
    enable_connect_protocol=False,
)
var conn = Http2Connection.with_config(cfg)

Fields: max_concurrent_streams: SETTINGS_MAX_CONCURRENT_STREAMS (RFC 9113 §6.5.2). Bounds the per-connection live-stream count. 0 is not "unlimited": the server then refuses every new request stream with REFUSED_STREAM. max_body_size: Maximum buffered request bytes per stream, default 10 MiB. Exceeding the limit resets the stream and frees its body. Zero permits only empty bodies; this is not a SETTINGS value. initial_window_size: SETTINGS_INITIAL_WINDOW_SIZE (RFC 9113 §6.5.2). Per-stream flow-control receive window the server advertises on inbound connections. Must be <= 2^31 - 1 per RFC 9113 §6.9.2. max_frame_size: SETTINGS_MAX_FRAME_SIZE (RFC 9113 §6.5.2). Largest frame payload the server is willing to accept. Must be in [16384, 16777215] per RFC 9113 §6.5.2. max_header_list_size: SETTINGS_MAX_HEADER_LIST_SIZE (RFC 9113 §6.5.2). Header-list size cap (uncompressed, including 32-byte per-entry overhead). header_table_size: SETTINGS_HEADER_TABLE_SIZE (RFC 7541 §4.2). HPACK dynamic-table size budget. It is advertised and caps the peer's table-size update; the decoder stays at the 4096 default until that update arrives. allow_huffman_decode: When True, the HPACK decoder accepts H=1 literals (Huffman-encoded) via the RFC 7541 Appendix B codec. Defaults to False -- reject-by-default until soak data justifies flipping it on. allow_huffman_encode: When True, the HPACK encoder picks the shorter of raw vs Huffman per emitted literal (size-only optimisation; H=1 frames remain CRIME-safe because the encoder dynamic table stays empty). Defaults to False -- H=0-only wire output until peers and soak data confirm interop.

def __init__(out self)

def __init__(out self, max_concurrent_streams: Int, initial_window_size: Int, max_frame_size: Int, max_header_list_size: Int, header_table_size: Int, allow_huffman_decode: Bool, allow_huffman_encode: Bool, enable_connect_protocol: Bool, max_body_size: Int = Int(10485760))

def validate(self)