HORIZON HASKELLDocslts/ghc-9.14.x3e2d5682026-10-11Search names, modules, packages, or :: a typeCtrl K

GHC 9.14.1 · lts/ghc-9.14.x · 3e2d568 · 2026-10-11

Modulecabal-install-3.16.0.0Haskell2010

Distribution.Client.ProjectBuilding.UnpackedPackage

This module exposes functions to build and register unpacked packages.

Mainly, unpacked packages are either: * Built and registered in-place * Built and installed

The two cases differ significantly for there to be a distinction. For instance, we only care about file monitoring and re-building when dealing with "inplace" registered packages, whereas for installed packages we don't.

  • 1 type
  • 5 values

Auxiliary definitions

2 declarations
valuebuildAndRegisterUnpackedPackage
  1. :: Verbosity
  2. -> DistDirLayout
  3. -> Maybe SemaphoreName

    Whether to pass a semaphore to build process this is different to BuildTimeSettings because the name of the semaphore is created freshly each time.

  4. -> BuildTimeSettings
  5. -> Lock
  6. -> Lock
  7. -> ElaboratedSharedConfig
  8. -> ElaboratedInstallPlan
  9. -> ElaboratedReadyPackage
  10. -> SymbolicPath CWD ('Dir Pkg)
  11. -> SymbolicPath Pkg ('Dir Dist)
  12. -> Maybe FilePath

    The path to an initialized log file

  13. -> (PackageBuildingPhase -> IO ())
  14. -> IO ()
#

Structures the phases of building and registering a package amongst others (see PackageBuildingPhase). Delegates logic specific to a certain building style (notably, inplace vs install) to the delegate function that receives as an argument PackageBuildingPhase)

datadata PackageBuildingPhase
#

Each unpacked package is processed in the following phases:

  • Configure phase

  • Build phase

  • Haddock phase

  • Install phase (copy + register)

  • Register phase

  • Test phase

  • Bench phase

  • Repl phase

Depending on whether we are installing the package or building it inplace, the phases will be carried out differently. For example, when installing, the test, benchmark, and repl phase are ignored.

Utilities

2 declarations