cmdutils

type AndMatcher[T any] []Matcher[T]

type Base64Value struct {
	// contains filtered or unexported fields
}

type ChainableMatcher[T any] interface {
	Matcher[T]
	// Or concat given matchers with OR operator
	Or(matcher ...Matcher[T]) ChainableMatcher[T]
	// And concat given matchers with AND operator
	And(matcher ...Matcher[T]) ChainableMatcher[T]
}

type GenericMatcher[T any] struct {
	Description string
	MatchFunc   func(context.Context, T) (bool, error)
}

type GitFileMatcher func(path string) bool

type GitUtils struct {
	// contains filtered or unexported fields
}

type Global struct {
	WorkingDir string `flag:"workspace,w" desc:"working directory containing 'go.mod'. All non-absolute paths are relative to this directory"`
	TmpDir     string `flag:"tmp-dir" desc:"temporary directory."`
	OutputDir  string `flag:"output,o" desc:"output directory. All non-absolute paths for output are relative to this directory"`
	Verbose    bool   `flag:"debug" desc:"show debug information"`
}

type GoCmdOptions func(goCmd *string)

type GoMod struct {
	Module  Module
	Go      string
	Require []Require
	Exclude []Module
	Replace []Replace
	Retract []Retract
}

type GoModule struct {
	Path      string         // module path
	Version   string         // module version
	Versions  []string       // available module versions (with -versions)
	Replace   *GoModule      // replaced by this module
	Time      *time.Time     // time version was created
	Update    *GoModule      // available update, if any (with -u)
	Main      bool           // is this the main module?
	Indirect  bool           // is this module only an indirect dependency of main module?
	Dir       string         // directory holding files for this module, if any
	GoMod     string         // path to go.mod file used when loading this module, if any
	GoVersion string         // go version used in module
	Retracted string         // retraction information, if any (with -retracted or -u)
	Error     *GoModuleError // error loading module
}

type GoModuleError struct {
	Err string // the error itself
}

type GoPackage struct {
	Dir           string    // directory containing package sources
	ImportPath    string    // import path of package in dir
	ImportComment string    // path in import comment on package statement
	Name          string    // package name
	Doc           string    // package documentation string
	Target        string    // install path
	Shlib         string    // the shared library that contains this package (only set when -linkshared)
	Goroot        bool      // is this package in the Go root?
	Standard      bool      // is this package part of the standard Go library?
	Stale         bool      // would 'go install' do anything for this package?
	StaleReason   string    // explanation for Stale==true
	Root          string    // Go root or Go path dir containing this package
	ConflictDir   string    // this directory shadows Dir in $GOPATH
	BinaryOnly    bool      // binary-only package (no longer supported)
	ForTest       string    // package is only for use in named test
	Export        string    // file containing export data (when using -export)
	BuildID       string    // build ID of the compiled package (when using -export)
	Module        *GoModule // info about package's containing module, if any (can be nil)
	Match         []string  // command-line patterns matching this package
	DepOnly       bool      // package is only a dependency, not explicitly listed

	// Source files
	GoFiles           []string // .go source files (excluding CgoFiles, TestGoFiles, XTestGoFiles)
	CgoFiles          []string // .go source files that import "C"
	CompiledGoFiles   []string // .go files presented to compiler (when using -compiled)
	IgnoredGoFiles    []string // .go source files ignored due to build constraints
	IgnoredOtherFiles []string // non-.go source files ignored due to build constraints
	CFiles            []string // .c source files
	CXXFiles          []string // .cc, .cxx and .cpp source files
	MFiles            []string // .m source files
	HFiles            []string // .h, .hh, .hpp and .hxx source files
	FFiles            []string // .f, .F, .for and .f90 Fortran source files
	SFiles            []string // .s source files
	SwigFiles         []string // .swig files
	SwigCXXFiles      []string // .swigcxx files
	SysoFiles         []string // .syso object files to add to archive
	TestGoFiles       []string // _test.go files in package
	XTestGoFiles      []string // _test.go files outside package

	// Embedded files
	EmbedPatterns      []string // //go:embed patterns
	EmbedFiles         []string // files matched by EmbedPatterns
	TestEmbedPatterns  []string // //go:embed patterns in TestGoFiles
	TestEmbedFiles     []string // files matched by TestEmbedPatterns
	XTestEmbedPatterns []string // //go:embed patterns in XTestGoFiles
	XTestEmbedFiles    []string // files matched by XTestEmbedPatterns

	// Cgo directives
	CgoCFLAGS    []string // cgo: flags for C compiler
	CgoCPPFLAGS  []string // cgo: flags for C preprocessor
	CgoCXXFLAGS  []string // cgo: flags for C++ compiler
	CgoFFLAGS    []string // cgo: flags for Fortran compiler
	CgoLDFLAGS   []string // cgo: flags for linker
	CgoPkgConfig []string // cgo: pkg-config names

	// Dependency information
	Imports      []string          // import paths used by this package
	ImportMap    map[string]string // map from source import to ImportPath (identity entries omitted)
	Deps         []string          // all (recursively) imported dependencies
	TestImports  []string          // imports from TestGoFiles
	XTestImports []string          // imports from XTestGoFiles

	// Error information
	Incomplete bool              // this package or a dependency has an error
	Error      *GoPackageError   // error loading package
	DepsErrors []*GoPackageError // errors loading dependencies
}

type GoPackageError struct {
	ImportStack []string // shortest path from package named on command line to this one
	Pos         string   // position of error (if present, file:line:col)
	Err         string   // the error itself
}

type Matcher[T any] interface {
	Matches(T) (bool, error)
	MatchesWithContext(context.Context, T) (bool, error)
}

type Module struct {
	Path    string
	Version string
}

type NegateMatcher[T any] struct {
	Matcher[T]
}

type NoopMatcher[T any] bool

type OrMatcher[T any] []Matcher[T]

type Replace struct {
	Old Module
	New Module
}

type Require struct {
	Path     string
	Version  string
	Indirect bool
}

type Retract struct {
	Low       string
	High      string
	Rationale string
}

type RunE func(cmd *cobra.Command, args []string) error

type ShCmdOption struct {
	Cmds    []string
	Dir     string
	Env     []string
	ShowCmd bool
	Stdin   io.Reader
	Stdout  io.Writer
	Stderr  io.Writer
}

type ShCmdOptions func(opt *ShCmdOption)

type StringMatcher interface {
	ChainableMatcher[string]
}

type TemplateOption struct {
	FS         embed.FS
	TmplName   string      // template name
	Output     string      // output path
	OutputPerm os.FileMode // output file permission when create
	Overwrite  bool        // should overwrite if output file already exists
	Model      interface{}
	Customizer func(*template.Template)
	CommonTmpl string
}