docker-lstags.sh - list tags for docker image

README.md

docker-lstags.sh - list tags for docker image

Usage

Usage: docker-lstags.sh [<namespace>/]<repository>

Requires

• hhs.bash
• fetch.sh
• jq: Command-line JSON processor

The MIT license.

References

• docker docs / Docker HUB API (beta) # List repository tags

docker-lstags.sh

#!/usr/bin/env bash
#
# docker-lstags.sh - List tags for docker image
# Copyright (c) 2023 Koichi OKADA. All rights reserved.
# This script is distributed under the MIT license.
#

source hhs.bash 0.2.0

function format ()
{
  case "$OPT_FORMAT" in
  raw) cat ;;
  json) jq '.' ;;
  name) jq -r '.results[].name' ;;
  digest) jq -r '.results[]|[.digest,.name]|@tsv' ;;
  *) error "unsupported format: $OPT_FORMAT" ;;
  esac
}

function optparse_docker_lstags ()
{
  case "$1" in
  -f|--format) # {raw|json|name|digest}
    # output format (default: name)
    nparams 1
    optset FORMAT "$2"
    [[ "$2" =~ ^(raw|json|name|digest)$ ]] || { error "unknown format: $2"; exit 1; }
    ;;
  -r|--reload) #
    # force reload
    nparams 0
    optset RELOAD "-f"
    ;;
  *)
    return 1
    ;;
  esac
}

function init_docker_lstags ()
{
  OPT_FORMAT=name
}

function docker_lstags () # [<namespace>/]<repository>
#   List tags for <namespace>/<repository>.
{
  local lines
  local namespace="${1%/*}"; [[ ! "$1" =~ / ]] && namespace="library"
  local repository="${1#*/}"
  local next="https://hub.docker.com/v2/namespaces/$namespace/repositories/$repository/tags"
  while [ -n "$next" ]; do
    fetch.sh -q "${OPT_RELOAD[@]}" "$next"
    read next < <(fetch.sh -q "${OPT_RELOAD[@]}" "$next" | jq -r '.next'); [ "$next" = "null" ] && next=""
  done | format
}

invoke_command "$@"