Any plans for this library to support parsing image references with both tag and digest?

[davidxia]

I want to use some Golang library to parse container image names. Specifically, I want this library to parse an image reference string into its name, tag (if it exists), and digest (if it exists). I'd like the library to be able to handle an image reference with both tag and digest so I can do something like this.

imageWithTagAndDigest = "docker.io/library/ubuntu:v1@sha256:cc8ce713f3b4be3c72cca1f63ee78e3733bc7283472ecae367b47a128f7e4478"

ref, _ := Parse(imageWithTagAndDigest)

fmt.Println(ref.Name()) // docker.io/library/ubuntu
fmt.Println(ref.Tag()) // v1
fmt.Println(ref.Digest()) // sha256:cc8ce713f3b4be3c72cca1f63ee78e3733bc7283472ecae367b47a128f7e4478

imageWithTagOnly = "docker.io/library/ubuntu:v1"

ref, _ := Parse(imageWithTagOnly)

fmt.Println(ref.Name()) // docker.io/library/ubuntu
fmt.Println(ref.Tag()) // v1
fmt.Println(ref.Digest()) // "" or nil

imageWithDigestOnly = "docker.io/library/ubuntu@sha256:cc8ce713f3b4be3c72cca1f63ee78e3733bc7283472ecae367b47a128f7e4478"

ref, _ := Parse(imageWithDigestOnly)

fmt.Println(ref.Name()) // docker.io/library/ubuntu
fmt.Println(ref.Tag()) // "" or nil
fmt.Println(ref.Digest()) // sha256:cc8ce713f3b4be3c72cca1f63ee78e3733bc7283472ecae367b47a128f7e4478

Is there an official library that does this already? If not and this is the official library where this functionality would be added, is there any update on this issue or are contributions welcome for this change?

[davidxia]

@mtrmac in your comment here, are you referring to this file https://github.com/containers/image/blob/main/docker/reference/reference.go? I think I'll need some more info or a usage example if you have time.

[mtrmac]

There are plenty of uses in the codebase. The entry point is typically ParseNormalizedNamed.

[davidxia]

I don't think that returns a struct with separate tag and digest fields? ParseNormalizedNamed only returns Named that only has a Name string and Reference string, right?