Distribution.Client.Setup

Available Hackage servers.

Ignore security expiry dates

Integrate with Nix

Extra program path used for packagedb lookups in a global context (i.e. for http transports)

All user-specified repositories

Get the HTTP transport

The transport will be initialized on the first call to this function.

NOTE: It is important that we don't eagerly initialize the transport. Initializing the transport is not free, and especially in contexts where we don't know a priori whether or not we need the transport (for instance when using cabal in "nix mode") incurring the overhead of transport initialization on _every_ invocation (eg cabal build) is undesirable.

Get the (initialized) secure repo

(the Repo type itself is stateless and must remain so, because it must be serializable)

Should we ignore expiry times (when checking security)?

All programs that cabal may run

user specified programs paths

user specified programs args

Extend the $PATH

The "flavor" of the compiler, e.g. GHC.

given compiler location

given hc-pkg location

Enable vanilla library

Enable profiling in the library

Build shared library

Build static library

Enable dynamic linking of the executables.

Enable fully static linking of the executables.

Enable profiling in the executables.

Enable profiling in the library and executables.

Profiling detail level in the library and executables.

Profiling detail level in the library

Extra arguments to configure

Enable optimization.

Installed executable prefix.

Installed executable suffix.

Installation paths

path to search for extra libraries

path to search for extra libraries when linking fully static executables

path to search for extra frameworks (OS X only)

path to search for header files

explicit IPID to be used

explicit CID to be used

be as deterministic as possible (e.g., invariant over GHC, database, etc). Used by the test suite

"dist" prefix

Cabal file to use

verbosity level

The --user/--global flag

Which package DBs to use

Enable compiling library for GHCi

Enable -split-sections with GHC

Enable -split-objs with GHC

Enable executable stripping

Enable library stripping

Additional constraints for dependencies.

The packages depended on which already exist

The packages depended on which doesn't yet exist (i.e. promised). Promising dependencies enables us to configure components in parallel, and avoids expensive builds if they are not necessary. For example, in multi-repl mode, we don't want to build dependencies that are loaded into the interactive session, since we have to build them again.

The requested Backpack instantiation. If empty, either this package does not use Backpack, or we just want to typecheck the indefinite package.

Enable test suite compilation

Enable benchmark compilation

Enable program coverage

Enable program coverage (deprecated)

All direct dependencies and flags are provided on the command line by the user via the '--dependency' and '--flags' options.

Halt and show an error message indicating an error in flag assignment

Enable relocatable package built

Emit debug info.

Should we dump available build information on build? Dump build information to disk before attempting to build, tooling can parse these files and use them to compile the source files themselves.

Whether to use response files at all. They're used for such tools as haddock, or ld.

Allow depending on private sublibraries. This is used by external tools (like cabal-install) so they can add multiple-public-libraries compatibility to older ghcs by checking visibility externally.

The list of libraries to be included in the hpc coverage report for testsuites run with --enable-coverage. Notably, this list must exclude indefinite libraries and instantiations because HPC does not support backpack (Nov. 2023).