amalgomated

type AliasStatus struct {
	// true if this alias is the only alias used for a package or is the most common alias used for a package.
	OK bool
	// recommendation for how to fix the issue if OK is false.
	Recommendation string
}

type ImportAlias struct {
	ImportPath string
	Alias      string
	Pos        token.Position
}

type ImportAliasInfo struct {
	ImportPath string
	Alias      string
	// file -> line information for import in the file
	Occurrences map[string]token.Position
}

type ProjectImportInfo interface {
	// AddImportAliasesFromFile adds all of the import alias information from the given file.
	AddImportAliasesFromFile(filename string) error

	// ImportsWithMultipleAliases returns a map from an imported package path to all of the aliases to import the package.
	// The aliases are sorted by the number of uses of that alias.
	ImportsToAliases() map[string][]ImportAliasInfo

	// FilesToImportAliases returns a map from each file in the project to all of the alias imports in the file.
	FilesToImportAliases() map[string][]ImportAlias

	// GetAliasStatus returns the AliasStatus for the given alias used to import the package with the provided path.
	GetAliasStatus(alias, importPath string) AliasStatus
}