Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

client

package

Go to main page

Versions in this module

v0

v0.46.0

Aug 27, 2026

v0.45.0

Aug 26, 2026

Changes in this version

type Client

+ func (c *Client) Sync(ctx context.Context, opts plugins.SyncOptions) (*plugins.SyncResult, error)

+ func (c *Client) Upgrade(ctx context.Context, opts plugins.UpgradeOptions) (*plugins.UpgradeResult, error)

v0.44.0

Aug 18, 2026

v0.43.0

Aug 14, 2026

v0.42.1

Aug 10, 2026

Changes in this version

+ var ErrRequestTimeout = errors.New("the ToolHive API server did not respond within the client timeout")

v0.42.0

Aug 5, 2026

Changes in this version

+ var ErrServerUnreachable = errors.New("could not reach ToolHive API server — is 'thv serve' running?")

+ type Client struct

+ func NewClient(baseURL string, opts ...Option) *Client

+ func NewDefaultClient(ctx context.Context, opts ...Option) *Client

+ func (c *Client) Build(ctx context.Context, opts plugins.BuildOptions) (*plugins.BuildResult, error)

+ func (c *Client) DeleteBuild(ctx context.Context, tag string) error

+ func (c *Client) GetContent(ctx context.Context, opts plugins.ContentOptions) (*plugins.PluginContent, error)

+ func (c *Client) Info(ctx context.Context, opts plugins.InfoOptions) (*plugins.PluginInfo, error)

+ func (c *Client) Install(ctx context.Context, opts plugins.InstallOptions) (*plugins.InstallResult, error)

+ func (c *Client) List(ctx context.Context, opts plugins.ListOptions) ([]plugins.InstalledPlugin, error)

+ func (c *Client) ListBuilds(ctx context.Context) ([]plugins.LocalBuild, error)

+ func (c *Client) Push(ctx context.Context, opts plugins.PushOptions) error

+ func (c *Client) Uninstall(ctx context.Context, opts plugins.UninstallOptions) error

+ func (c *Client) Validate(ctx context.Context, path string) (*plugins.ValidationResult, error)

+ type Option func(*Client)

+ func WithHTTPClient(hc *http.Client) Option

+ func WithTimeout(d time.Duration) Option