httptransport

Overview ¶

Package httptransport provides a configurable cURL-style logging RoundTripper for HTTP-based ChatModel clients. It logs the real outbound HTTP request (as a cURL command) and the inbound HTTP response. Streaming responses (SSE or NDJSON) can be logged chunk-by-chunk without breaking the stream.

Quick usage:

client := &http.Client{Transport: httptransport.NewCurlRT(
    http.DefaultTransport,
    httptransport.WithLogger(log.Default()),
    // Or pass a context-aware logger to extract request IDs:
    httptransport.WithCtxLogger(httptransport.IDCtxLogger{L: log.Default()}),
    // Security controls:
    httptransport.WithPrintAuth(false),                     // mask Authorization
    httptransport.WithMaskHeaders([]string{"X-API-KEY"}),  // mask custom headers
    // Streaming controls:
    httptransport.WithStreamLogging(true),
    httptransport.WithMaxStreamLogBytes(8192),
)}
cm, _ := openai.NewChatModel(ctx, &openai.ChatModelConfig{ HTTPClient: client, ... })

Notes:

• WithCtxLogger is preferred when you carry a request/log ID in context.
• WithPrintAuth controls whether the Authorization header is printed.
• WithMaskHeaders and WithMaskFunc allow masking arbitrary headers.
• When stream logging is enabled, headers are logged once, and chunks are emitted as they are read. With a plain Logger, a capped summary is printed on Close(); with a CtxLogger, each chunk is logged directly.