package source

Import Path
	gotest.tools/v3/internal/source (on go.dev)

Dependency Relation
	imports 13 packages, and imported by 2 packages

Involved Source Files

	    bazel.go
	    defers.go
	  d source.go
		Package source provides utilities for handling source-code.

	    update.go
	    version.go
Package-Level Type Names (total 2, neither is exported)

	/* sort exporteds by: alphabet | popularity */
	/* 2 unexporteds ... *//* 2 unexporteds: */
	 type callExprVisitor (struct)

		Fields (only one, which is unexported)
			/* one unexported ... *//* one unexported: */
			expr *ast.CallExpr
		Methods (only one, which is exported)
			(*callExprVisitor) Visit(node ast.Node) ast.Visitor
		Implements (at least one exported)
			*callExprVisitor : go/ast.Visitor

	 type debugFormatNode (struct)

		Fields (only one, which is exported)
			Node ast.Node
		Methods (total 3, all are exported)
			( debugFormatNode) End() token.Pos
				// position of first character immediately after the node

			( debugFormatNode) Pos() token.Pos
				// position of first character belonging to the node

			( debugFormatNode) String() string
		Implements (at least 6, in which 3 are exported)
			 debugFormatNode : expvar.Var
			 debugFormatNode : fmt.Stringer
			 debugFormatNode : go/ast.Node
			/* 3+ unexporteds ... *//* 3+ unexporteds: */
			 debugFormatNode : context.stringer
			 debugFormatNode : go/types.positioner
			 debugFormatNode : runtime.stringer


Package-Level Functions (total 17, in which 7 are exported)

	 func CallExprArgs(stackIndex int) ([]ast.Expr, error)
		CallExprArgs returns the ast.Expr slice for the args of an ast.CallExpr at
		the index in the call stack.

	 func FormatNode(node ast.Node) (string, error)
		FormatNode using go/format.Node and return the result as a string

	 func FormattedCallExprArg(stackIndex int, argPos int) (string, error)
		FormattedCallExprArg returns the argument from an ast.CallExpr at the
		index in the call stack. The argument is formatted using FormatNode.

	 func GoVersionLessThan(major, minor int64) bool
		GoVersionLessThan returns true if runtime.Version() is semantically less than
		version major.minor. Returns false if a release version can not be parsed from
		runtime.Version().

	 func IsUpdate() bool
		IsUpdate is returns true if the -update flag is set. It indicates the user
		running the tests would like to update any golden values.

	 func UpdateExpectedValue(stackIndex int, x, y interface{}) error
		UpdateExpectedValue looks for a package-level variable with a name that
		starts with expected in the arguments to the caller. If the variable is
		found, the value of the variable will be updated to value of the other
		argument to the caller.

	 func UpdateVariable(filename string, fileset *token.FileSet, astFile *ast.File, ident *ast.Ident, value string) error
		UpdateVariable writes to filename the contents of astFile with the value of
		the variable updated to value.

	/* 10 unexporteds ... *//* 10 unexporteds: */
	 func bazelSourcePath(filename string) (string, error)
	 func collectDefers(node ast.Node) []*ast.DeferStmt
	 func debug(format string, args ...interface{})
	 func getCallExprArgs(fileset *token.FileSet, astFile ast.Node, line int) ([]ast.Expr, error)
	 func getIdentForExpectedValueArg(expr []ast.Expr) (int, *ast.Ident)
	 func getNodeAtLine(fileset *token.FileSet, astFile ast.Node, lineNum int) (ast.Node, error)
	 func guessDefer(node ast.Node) (ast.Node, error)
	 func init()
	 func scanToDeferLine(fileset *token.FileSet, node ast.Node, lineNum int) ast.Node
	 func scanToLine(fileset *token.FileSet, node ast.Node, lineNum int) ast.Node
Package-Level Variables (total 8, in which 2 are exported)

	  var ErrNotFound error
		ErrNotFound indicates that UpdateExpectedValue failed to find the
		variable to update, likely because it is not a package level variable.

	  var Update bool
		Update is a shim for testing, and for compatibility with the old -update-golden
		flag.

	/* 6 unexporteds ... *//* 6 unexporteds: */
	  var bazelMissingSourceMsg string
	  var bazelTestSrcdir string
		Absolute path to the base of the runfiles tree

	  var bazelTestTarget string
		The name of the target being tested (ex: //some_package:some_package_test)

	  var bazelTestWorkspace string
		The local repository's workspace name (ex: __main__)

	  var debugEnabled bool
	  var inBazelTest bool
		Signifies test executable is being driven by `bazel test`.
		
		Due to Bazel's compilation and sandboxing strategy,
		some care is required to handle resolving the original *.go source file.

The pages are generated with Golds v0.7.6. (GOOS=linux GOARCH=amd64)