loader

Documentation

Index

• type Errors
  • func (e Errors) Error() string
• type ImportCycleError
  • func (e *ImportCycleError) Error() string
• type Package
  • func (p *Package) Check() error
  • func (p *Package) Import(to string) (*types.Package, error)
  • func (p *Package) Parse(includeTests bool) error
• type Program
  • func (p *Program) Import(path, srcDir string) (*Package, error)
  • func (p *Program) ImportFile(path string) (*Package, error)
  • func (p *Program) LoadSSA() *ssa.Program
  • func (p *Program) Parse(compileTestBinary bool) error
  • func (p *Program) Sorted() []*Package
  • func (p *Program) SwapTestMain() error

Types

type Errors

type Errors struct {
	Pkg  *Package
	Errs []error
}

Errors contains a list of parser errors or a list of typechecker errors for the given package.

func (Errors) Error

func (e Errors) Error() string

type ImportCycleError

type ImportCycleError struct {
	Packages        []string
	ImportPositions []token.Position
}

ImportCycleErrors is returned when encountering an import cycle. The list of packages is a list from the root package to the leaf package that imports one of the packages in the list.

func (*ImportCycleError) Error

func (e *ImportCycleError) Error() string

type Package

type Package struct {
	*Program
	*build.Package
	Imports   map[string]*Package
	Importing bool
	Files     []*ast.File
	Pkg       *types.Package
	types.Info
}

Package holds a loaded package, its imports, and its parsed files.

func (*Package) Check

func (p *Package) Check() error

Check runs the package through the typechecker. The package must already be loaded and all dependencies must have been checked already.

Idempotent.

func (*Package) Import

func (p *Package) Import(to string) (*types.Package, error)

Import implements types.Importer. It loads and parses packages it encounters along the way, if needed.

func (*Package) Parse

func (p *Package) Parse(includeTests bool) error

Parse parses and typechecks this package.

Idempotent.

type Program

type Program struct {
	Build        *build.Context
	OverlayBuild *build.Context
	OverlayPath  func(path string) string
	Packages     map[string]*Package

	TypeChecker  types.Config
	Dir          string // current working directory (for error reporting)
	TINYGOROOT   string // root of the TinyGo installation or root of the source code
	CFlags       []string
	ClangHeaders string
	// contains filtered or unexported fields
}

Program holds all packages and some metadata about the program as a whole.

func (*Program) Import

func (p *Program) Import(path, srcDir string) (*Package, error)

Import loads the given package relative to srcDir (for the vendor directory). It only loads the current package without recursion.

func (*Program) ImportFile

func (p *Program) ImportFile(path string) (*Package, error)

ImportFile loads and parses the import statements in the given path and creates a pseudo-package out of it.

func (*Program) LoadSSA

func (p *Program) LoadSSA() *ssa.Program

LoadSSA constructs the SSA form of the loaded packages.

The program must already be parsed and type-checked with the .Parse() method.

func (*Program) Parse

func (p *Program) Parse(compileTestBinary bool) error

Parse recursively imports all packages, parses them, and typechecks them.

The returned error may be an Errors error, which contains a list of errors.

Idempotent.

func (*Program) Sorted

func (p *Program) Sorted() []*Package

Sorted returns a list of all packages, sorted in a way that no packages come before the packages they depend upon.

func (*Program) SwapTestMain

func (p *Program) SwapTestMain() error