gopkg.in/docker/docker.v20@v20.10.27/client/image_list.go (about)

     1  package client // import "github.com/docker/docker/client"
     2  
     3  import (
     4  	"context"
     5  	"encoding/json"
     6  	"net/url"
     7  
     8  	"github.com/docker/docker/api/types"
     9  	"github.com/docker/docker/api/types/filters"
    10  	"github.com/docker/docker/api/types/versions"
    11  )
    12  
    13  // ImageList returns a list of images in the docker host.
    14  func (cli *Client) ImageList(ctx context.Context, options types.ImageListOptions) ([]types.ImageSummary, error) {
    15  	var images []types.ImageSummary
    16  	query := url.Values{}
    17  
    18  	optionFilters := options.Filters
    19  	referenceFilters := optionFilters.Get("reference")
    20  	if versions.LessThan(cli.version, "1.25") && len(referenceFilters) > 0 {
    21  		query.Set("filter", referenceFilters[0])
    22  		for _, filterValue := range referenceFilters {
    23  			optionFilters.Del("reference", filterValue)
    24  		}
    25  	}
    26  	if optionFilters.Len() > 0 {
    27  		//nolint:staticcheck // ignore SA1019 for old code
    28  		filterJSON, err := filters.ToParamWithVersion(cli.version, optionFilters)
    29  		if err != nil {
    30  			return images, err
    31  		}
    32  		query.Set("filters", filterJSON)
    33  	}
    34  	if options.All {
    35  		query.Set("all", "1")
    36  	}
    37  
    38  	serverResp, err := cli.get(ctx, "/images/json", query, nil)
    39  	defer ensureReaderClosed(serverResp)
    40  	if err != nil {
    41  		return images, err
    42  	}
    43  
    44  	err = json.NewDecoder(serverResp.body).Decode(&images)
    45  	return images, err
    46  }