httpclient

http-client

Fluent, streaming‑first HTTP client for Go — zero external dependencies.

Features

• Fluent API (method chaining)
• Path variables /users/{id}
• Efficient streaming via io.Pipe (no full buffering)
• Multipart/form-data with streamed file parts
• JSON / raw / form / query / headers / cookies helpers
• Type-safe parameter setters:
  • Path: PathParam, PathInt, PathBool, PathFloat
  • Query (standard requests): Param, Int, Bool, Float
  • Multipart form: Param, Int, Bool, Float, File
• Middleware: retry, rate limit, circuit breaker, logging
• Context, timeouts, cancellation baked in
• No third‑party deps

Install

go get github.com/nativebpm/http-client

Quick Start

client, _ := httpclient.NewClient(http.Client{}, "https://api.example.com")

resp, err := client.GET(ctx, "/users").Send()

resp, err = client.GET(ctx, "/users/{id}").
    PathInt("id", 123).
    Send()

resp, err = client.POST(ctx, "/users").
    JSON(map[string]string{"name": "John"}).
    Send()

resp, err = client.Multipart(ctx, "/upload").
    File("document", "file.pdf", fileReader).
    Send()

// With cookies
resp, err = client.GET(ctx, "/profile").
    Cookie("session", "abc123").
    Send()

Streaming (end‑to‑end)

Move data between servers without loading the whole file in memory:

src, err := http.Get("http://server1/file")
if err != nil { /* handle */ }
defer src.Body.Close()

dst, err := client.Multipart(ctx, "/upload").
    File("file", "data.txt", src.Body).
    Send()
if err != nil { /* handle */ }
defer dst.Body.Close()

Middleware Example

resp, err := client.GET(ctx, "/reports").
    Retry(3).
    RateLimit(10).
    CircuitBreaker("reports", 5, time.Minute).
    Send()

Examples

See the examples/ directory.

• Streaming multipart
• Standard library comparison

When to Use

Pick this when you need streaming, concise request building, minimal allocations, and built‑in resilience patterns. If you want absolute low‑level control, stick with net/http directly.

License

MIT