goinfo

Documentation

Index

• Variables
• func CmpInt(x, y string) int
• func CompareSemVer(v, w string) int
• func CompareVersion(x, y string) int
• func FindGoModDir(dir string) (string, error)
• func FromToolchain(name string) string
• func GetGoVersionOutput(goBinary string) (string, error)
• func GetModPath(dir string) (string, error)
• func IsValidSemVer(v string) bool
• func IsValidVersion(x string) bool
• func ListPackages(dir string, mod string, args []string) ([]string, error)
• func ModCompare(path string, x, y string) int
• func ResolveMainModule(dir string) (subPaths []string, mainModule string, err error)
• type GoVersion
  • func ParseGoVersion(s string) (*GoVersion, error)
  • func ParseGoVersionNumber(version string) (*GoVersion, error)
  • func (c *GoVersion) String() string
• type ModVersion
• type VendorInfo
  • func ParseVendor(dirOrFile string) (*VendorInfo, error)
  • func ParseVendorContent(content string) *VendorInfo
• type Version
  • func ParseVersion(x string) Version

Variables

var ErrGoModDoesNotHaveModule = errors.New("go.mod does not have module")

var ErrGoModNotFound = errors.New("go.mod not found")

Functions

func CmpInt

func CmpInt(x, y string) int

func CompareSemVer

func CompareSemVer(v, w string) int

func CompareVersion

func CompareVersion(x, y string) int

func FindGoModDir

func FindGoModDir(dir string) (string, error)

func FromToolchain

func FromToolchain(name string) string

func GetGoVersionOutput

func GetGoVersionOutput(goBinary string) (string, error)

func GetModPath

func GetModPath(dir string) (string, error)

func IsValidSemVer

func IsValidSemVer(v string) bool

func IsValidVersion

func IsValidVersion(x string) bool

func ListPackages

func ListPackages(dir string, mod string, args []string) ([]string, error)

go list ./pkg

func ModCompare

func ModCompare(path string, x, y string) int

func ResolveMainModule

func ResolveMainModule(dir string) (subPaths []string, mainModule string, err error)

Types

type GoVersion

type GoVersion struct {
	Major int // 1
	Minor int // 17
	Patch int // 5

	OS   string
	Arch string
}

func ParseGoVersion

func ParseGoVersion(s string) (*GoVersion, error)

func ParseGoVersionNumber

func ParseGoVersionNumber(version string) (*GoVersion, error)

func (*GoVersion) String

func (c *GoVersion) String() string

type ModVersion

type ModVersion struct {
	Path    string
	Version string
}

type VendorInfo

type VendorInfo struct {
	VendorList      []ModVersion          // modules that contribute packages to the build, in order of appearance
	VendorReplaced  []ModVersion          // all replaced modules; may or may not also contribute packages
	VendorVersion   map[string]string     // module path → selected version (if known)
	VendorPkgModule map[string]ModVersion // package → containing module
	VendorMeta      map[ModVersion]vendorMetadata
	// contains filtered or unexported fields
}

func ParseVendor

func ParseVendor(dirOrFile string) (*VendorInfo, error)

ParseVendor reads the list of vendored modules from vendor/modules.txt.

func ParseVendorContent

func ParseVendorContent(content string) *VendorInfo

type Version

type Version struct {
	Major string // decimal
	Minor string // decimal or ""
	Patch string // decimal or ""
	Kind  string // "", "alpha", "beta", "rc"
	Pre   string // decimal or ""
}

see: https://cs.opensource.google/go/go/+/master:src/internal/gover/gover.go

func ParseVersion

func ParseVersion(x string) Version