Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security Policy
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

reference

package

Go to main page

Versions in this module

v1

v1.5.1

Mar 21, 2019

Changes in this version

+ const NameTotalLengthMax

+ var DigestRegexp = match(`[A-Za-z][A-Za-z0-9]*(?:[-_+.][A-Za-z][A-Za-z0-9]*)*[:][[:xdigit:]]{32,}`)

+ var ErrDigestInvalidFormat = errors.New("invalid digest format")

+ var ErrNameContainsUppercase = errors.New("repository name must be lowercase")

+ var ErrNameEmpty = errors.New("repository name must have at least one component")

+ var ErrNameNotCanonical = errors.New("repository name must be canonical")

+ var ErrNameTooLong = fmt.Errorf("repository name must not be more than %v characters", NameTotalLengthMax)

+ var ErrReferenceInvalidFormat = errors.New("invalid reference format")

+ var ErrTagInvalidFormat = errors.New("invalid tag format")

+ var IdentifierRegexp = match(`([a-f0-9]{64})`)

+ var NameRegexp = expression(optional(domainRegexp, literal(`/`)), nameComponentRegexp, ...)

+ var ReferenceRegexp = anchored(capture(NameRegexp), optional(literal(":"), capture(TagRegexp)), ...)

+ var ShortIdentifierRegexp = match(`([a-f0-9]{6,64})`)

+ var TagRegexp = match(`[\w][\w.-]{0,127}`)

+ func Domain(named Named) string

+ func FamiliarMatch(pattern string, ref Reference) (bool, error)

+ func FamiliarName(ref Named) string

+ func FamiliarString(ref Reference) string

+ func IsNameOnly(ref Named) bool

+ func Path(named Named) (name string)

+ func SplitHostname(named Named) (string, string)

+ type Canonical interface

+ Digest func() digest.Digest

+ func WithDigest(name Named, digest digest.Digest) (Canonical, error)

+ type Digested interface

+ Digest func() digest.Digest

+ type Field struct

+ func AsField(reference Reference) Field

+ func (f *Field) UnmarshalText(p []byte) error

+ func (f Field) MarshalText() (p []byte, err error)

+ func (f Field) Reference() Reference

+ type Named interface

+ Name func() string

+ func ParseNamed(s string) (Named, error)

+ func ParseNormalizedNamed(s string) (Named, error)

+ func TagNameOnly(ref Named) Named

+ func TrimNamed(ref Named) Named

+ func WithName(name string) (Named, error)

+ type NamedTagged interface

+ Tag func() string

+ func WithTag(name Named, tag string) (NamedTagged, error)

+ type Reference interface

+ String func() string

+ func Parse(s string) (Reference, error)

+ func ParseAnyReference(ref string) (Reference, error)

+ type Tagged interface

+ Tag func() string

Incompatible versions in this module

v3.0.2+incompatible

Aug 7, 2019

v3.0.1+incompatible

Aug 5, 2019

v3.0.0+incompatible

Aug 2, 2019

v2.0.1+incompatible

Jul 18, 2019

v2.0.0+incompatible

Jun 13, 2019