wire 1.0.1

Wire

High-performance, zero-allocation HTTP parser for D.

Built on llhttp, the HTTP parser that powers Node.js.

Overview

Wire provides a @nogc nothrow HTTP/1.x parser with zero heap allocations. All string data is accessed via StringView slices into the original request buffer.

Key characteristics:

• Zero GC allocations during parsing
• Complete @nogc nothrow API
• 64-byte aligned structures for cache efficiency
• Thread-local parser pool with automatic reuse

Installation

Add to your dub.json:

"dependencies": {
    "wire": "~>1.0.0"
}

Or with dub.sdl:

dependency "wire" version="~>1.0.0"

Building from Source

git clone https://github.com/federikowsky/Wire.git
cd Wire
make        # Build and run tests
make lib    # Build static library only

Quick Start

import wire;

void handleRequest(const(ubyte)[] data) @nogc nothrow {
    auto req = parseHTTP(data);
    
    if (!req) return;  // Parse error
    
    auto method = req.getMethod();     // "GET"
    auto path = req.getPath();         // "/api/users"
    auto host = req.getHeader("Host"); // "example.com"
    
    auto page = req.getQueryParam("page");
    
    if (req.shouldKeepAlive()) {
        // Reuse connection
    }
}

API Reference

Parsing

auto parseHTTP(const(ubyte)[] data) @nogc nothrow;

Returns a ParserWrapper with RAII cleanup. The parser is automatically returned to the thread-local pool on scope exit.

Request Methods

All methods are @nogc nothrow and return zero-copy views.

Header Iteration

foreach (header; req.getHeaders()) {
    writeln(header.name, ": ", header.value);
}

Performance

Benchmarked on Apple M2 with LDC 1.41:

Memory usage:

• Per thread: ~1 KB (parser pool)
• Per request: 0 bytes (zero allocation)
• Header limit: 64 headers

Building

Requirements

• D Compiler: LDC 1.35+ (recommended) or DMD 2.105+
• C Compiler: clang or gcc (C99)

Make Targets

Documentation

• Technical Specifications — Complete API reference
• llhttp — Underlying parser

Contributing

Contributions are welcome. Please ensure:

1. All code maintains @nogc nothrow compatibility
2. Tests pass (make test)
3. Code follows D style guidelines

License

MIT License — see LICENSE for details.