importer

Documentation

Overview

Package importer provides access to export data importers.

Index

• func Default() types.Importer
• func For(compiler string, lookup Lookup) types.Importer
• func ForCompiler(fset *token.FileSet, compiler string, lookup Lookup) types.Importer
• type Lookup

Functions

func Default

func Default() types.Importer

Default returns an Importer for the compiler that built the running binary. If available, the result implements types.ImporterFrom.

func For

func For(compiler string, lookup Lookup) types.Importer

For calls ForCompiler with a new FileSet.

Deprecated: use ForCompiler, which populates a FileSet with the positions of objects created by the importer.

func ForCompiler

func ForCompiler(fset *token.FileSet, compiler string, lookup Lookup) types.Importer

ForCompiler returns an Importer for importing from installed packages for the compilers "gc" and "gccgo", or for importing directly from the source if the compiler argument is "source". In this latter case, importing may fail under circumstances where the exported API is not entirely defined in pure Go source code (if the package API depends on cgo-defined entities, the type checker won't have access to those).

If lookup is nil, the default package lookup mechanism for the given compiler is used, and the resulting importer attempts to resolve relative and absolute import paths to canonical import path IDs before finding the imported file.

If lookup is non-nil, then the returned importer calls lookup each time it needs to resolve an import path. In this mode the importer can only be invoked with canonical import paths (not relative or absolute ones); it is assumed that the translation to canonical import paths is being done by the client of the importer.

Types

type Lookup

type Lookup func(path string) (io.ReadCloser, error)

A Lookup function returns a reader to access package data for a given import path, or an error if no matching package is found.