client.go

package dockergo

import (
	"context"
	"net"
	"net/http"
	"time"
)

// Client is the SDK entry point.
type Client struct {
	HTTP       *http.Client
	SocketPath string // e.g. /var/run/docker.sock
	HostURL    string // e.g. http://localhost (used as base for requests)
	timeout    time.Duration
}

// NewClient returns a client connected to the local Docker UNIX socket.
// If socketPath is empty, defaults to /var/run/docker.sock.
func NewClient(socketPath string) *Client {
	if socketPath == "" {
		socketPath = "/var/run/docker.sock"
	}
	transport := &http.Transport{
		// DialContext to use unix domain socket
		DialContext: func(ctx context.Context, _, _ string) (net.Conn, error) {
			d := net.Dialer{Timeout: 5 * time.Second}
			return d.DialContext(ctx, "unix", socketPath)
		},
	}
	httpClient := &http.Client{
		Transport: transport,
		Timeout:   15 * time.Second,
	}

	return &Client{
		HTTP:       httpClient,
		SocketPath: socketPath,
		HostURL:    "http://localhost", // used as host in request URL (socket transport ignores host)
		timeout:    15 * time.Second,
	}
}