Method LookupByCommand

pkg/toolinstall/registry.go:231–254

LookupByCommand searches for a package providing a binary matching the command name. First checks repo names, then files[].name across all packages.

(ctx context.Context, command string)

// LookupByCommand searches for a package providing a binary matching the command name.
// First checks repo names, then files[].name across all packages.
func (r *Registry) LookupByCommand(ctx context.Context, command string) (*Package, error) {
	index, err := r.fetchIndex(ctx)
	if err != nil {
		return nil, fmt.Errorf("fetching registry index: %w", err)
	}

	// Single pass: prefer repo name match, but track the first file-name match.
	var fileMatch *Package
	for i := range index.Packages {
		p := &index.Packages[i]
		if p.RepoName == command {
			return p, nil
		}
		if fileMatch == nil && providesCommand(p, command) {
			fileMatch = p
		}
	}

	if fileMatch != nil {
		return fileMatch, nil
	}

	return nil, fmt.Errorf("no aqua package found providing command %q", command)
}

// providesCommand returns true if any of the package's files entries has
// a binary matching the given command name.