httpc

README

httpc

A Go library for creating and customizing HTTP clients. It provides:

• A pluggable Transport that lets you attach multiple middlewares to process requests and responses.
• A Middleware interface for adding reusable handlers like logging or caching.
• Built-in caching middlewares, with options for various backends (e.g. redis, badger, text file).
• An easy way to add request/response hooks for debugging or logging.

See example_test.go for usage examples.

Documentation

Overview

Example (Badgercache)

Output:

Request: 0
start
cache miss
response from server
Response: Hello, 0
---
Request: 1
start
Response: Hello, 0
---
Request: 2
start
Response: Hello, 0
---

Example (Rediscache)

Output:

Request: 0
start
cache miss
response from server
Response: Hello, 0
---
Request: 1
start
Response: Hello, 0
---
Request: 2
start
Response: Hello, 0
---

Example (Textcache)

Output:

Request: 0
start
cache miss
response from server
Response: Hello, 0
---
Request: 1
start
Response: Hello, 0
---
Request: 2
start
Response: Hello, 0
---

Index

• type Middleware
• type MiddlewareFunc
  • func DumpMiddleware(w io.Writer) MiddlewareFunc
  • func PrintMiddleware(before, after string) MiddlewareFunc
  • func (f MiddlewareFunc) RoundTripper(next http.RoundTripper) http.RoundTripper
• type Option
  • func WithBaseTransport(rt http.RoundTripper) Option
• type RoundTripperFunc
  • func (f RoundTripperFunc) RoundTrip(req *http.Request) (*http.Response, error)
• type Transport
  • func NewTransport(opts ...Option) *Transport
  • func (t *Transport) RoundTrip(req *http.Request) (*http.Response, error)
  • func (t *Transport) Use(middleware ...Middleware) *Transport

Examples

• Package (Badgercache)
• Package (Rediscache)
• Package (Textcache)

Types

type Middleware

type Middleware interface {
	RoundTripper(next http.RoundTripper) http.RoundTripper
}

type MiddlewareFunc

type MiddlewareFunc func(next http.RoundTripper) http.RoundTripper

func DumpMiddleware

func DumpMiddleware(w io.Writer) MiddlewareFunc

DumpMiddleware returns a MiddlewareFunc that logs HTTP requests and responses to the provided io.Writer.

func PrintMiddleware

func PrintMiddleware(before, after string) MiddlewareFunc

PrintMiddleware returns a MiddlewareFunc that prints the specified strings before and after the HTTP request is processed by the next RoundTripper in the chain.

func (MiddlewareFunc) RoundTripper

func (f MiddlewareFunc) RoundTripper(next http.RoundTripper) http.RoundTripper

type Option

type Option func(*Transport)

Option is a functional option for configuring the CustomTransport.

func WithBaseTransport

func WithBaseTransport(rt http.RoundTripper) Option

WithBaseTransport sets the base RoundTripper for the CustomTransport.

type RoundTripperFunc

type RoundTripperFunc func(req *http.Request) (*http.Response, error)

func (RoundTripperFunc) RoundTrip

func (f RoundTripperFunc) RoundTrip(req *http.Request) (*http.Response, error)

type Transport

type Transport struct {
	// contains filtered or unexported fields
}

func NewTransport

func NewTransport(opts ...Option) *Transport

NewTransport creates a new instance of CustomTransport.

func (*Transport) RoundTrip

func (t *Transport) RoundTrip(req *http.Request) (*http.Response, error)

RoundTrip executes a single HTTP transaction, as defined by http.RoundTripper.

func (*Transport) Use

func (t *Transport) Use(middleware ...Middleware) *Transport

Use adds the provided middleware functions to the CustomTransport's middleware chain.