ghc-7.10.2: The GHC API

Safe HaskellNone
LanguageHaskell2010

Finder

Synopsis

Documentation

data FindResult Source

The result of searching for an imported module.

Constructors

Found ModLocation Module

The module was found

NoPackage PackageKey

The requested package was not found

FoundMultiple [(Module, ModuleOrigin)]

_Error_: both in multiple packages

NotFound

Not found

findImportedModule :: HscEnv -> ModuleName -> Maybe FastString -> IO FindResult Source

Locate a module that was imported by the user. We have the module's name, and possibly a package name. Without a package name, this function will use the search path and the known exposed packages to find the module, if a package is specified then only that package is searched for the module.

findExactModule :: HscEnv -> Module -> IO FindResult Source

Locate a specific Module. The purpose of this function is to create a ModLocation for a given Module, that is to find out where the files associated with this module live. It is used when reading the interface for a module mentioned by another interface, for example (a "system import").

findHomeModule :: HscEnv -> ModuleName -> IO FindResult Source

Implements the search for a module name in the home package only. Calling this function directly is usually *not* what you want; currently, it's used as a building block for the following operations:

  1. When you do a normal package lookup, we first check if the module is available in the home module, before looking it up in the package database.
  2. When you have a package qualified import with package name "this", we shortcut to the home module.
  3. When we look up an exact Module, if the package key associated with the module is the current home module do a look up in the home module.
  4. Some special-case code in GHCi (ToDo: Figure out why that needs to call this.)