Expand description

§Parse docker/OCI Image References

This library is extensively tested against the authoritative image reference implementation, https://github.com/distribution/reference.


  • Parsers for digest algorithms and encoded digest values
  • Domain: host and an optional port
  • Error types
  • Image names: optional domain and a required path
  • Path parsing
  • Tag parsing


  • A canonical image reference includes a domain, a path/repo name, and digest. It may also include a tag.
  • A reference to a container image. All references contain at least a name.