client

package

v0.4.0 Latest Latest Go to latest Published: Jun 26, 2026 License: MPL-2.0 Imports: 8 Imported by: 0

Details

This section is empty.

This section is empty.

This section is empty.

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

Client is a small context-aware HTTP client for Open Data Hub API calls.

func New(timeout time.Duration) *Client

New creates a client with the provided timeout and default retries.

func NewWithHTTPClient(httpClient *http.Client, userAgent string) *Client

NewWithHTTPClient creates a client around an injected HTTP client.

func (c *Client) Get(ctx context.Context, url string) (Response, error)

Get performs an HTTP GET and returns the response body for 2xx responses.

func (c *Client) GetCached(ctx context.Context, url string, ttl time.Duration) (Response, error)

GetCached performs an HTTP GET with local file caching.

func (c *Client) GetWithLimit(ctx context.Context, url string, limitBytes int64) (Response, error)

GetWithLimit performs an HTTP GET and reads at most limitBytes bytes.

func (c *Client) WithRetryPolicy(maxRetries int, baseDelay time.Duration) *Client

WithRetryPolicy returns a copy of the client with custom retry behavior.

func (c *Client) WithTimeout(timeout time.Duration) *Client

WithTimeout returns a copy of the client with a different HTTP timeout.

func (c *Client) WithTransport(transport http.RoundTripper) *Client

WithTransport returns a copy of the client using a specific RoundTripper.

type HTTPError struct {
	URL         string
	StatusCode  int
	ContentType string
	Body        string
}

HTTPError captures a non-2xx response.

func (e *HTTPError) Error() string

type Response struct {
	URL         string
	StatusCode  int
	ContentType string
	Body        []byte
	FromCache   bool
}

Response contains the raw response body and selected metadata.