Stack.Types.Config

Documentation

data Config

The top-level Stackage configuration.

Constructors

Config

Fields

• configWorkDir :: !(Path Rel Dir)

  this allows to override .stack-work directory

• configUserConfigPath :: !(Path Abs File)

  Path to user configuration file (usually ~.stackconfig.yaml)

• configBuild :: !BuildOpts

  Build configuration

• configDocker :: !DockerOpts

  Docker configuration

• configNix :: !NixOpts

  Execution environment (e.g nix-shell) configuration

• configProcessContextSettings :: !(EnvSettings -> IO ProcessContext)

  Environment variables to be passed to external tools

• configLocalProgramsBase :: !(Path Abs Dir)

  Non-platform-specific path containing local installations

• configLocalPrograms :: !(Path Abs Dir)

  Path containing local installations (mainly GHC)

• configHideTHLoading :: !Bool

  Hide the Template Haskell "Loading package ..." messages from the console

• configPrefixTimestamps :: !Bool

  Prefix build output with timestamps for each line.

• configPlatform :: !Platform

  The platform we're building for, used in many directory names

• configPlatformVariant :: !PlatformVariant

  Variant of the platform, also used in directory names

• configGHCVariant :: !(Maybe GHCVariant)

  The variant of GHC requested by the user.

• configGHCBuild :: !(Maybe CompilerBuild)

  Override build of the compiler distribution (e.g. standard, gmp4, tinfo6)

• configLatestSnapshot :: !Text

  URL of a JSON file providing the latest LTS and Nightly snapshots.

• configSystemGHC :: !Bool

  Should we use the system-installed GHC (on the PATH) if available? Can be overridden by command line options.

• configInstallGHC :: !Bool

  Should we automatically install GHC if missing or the wrong version is available? Can be overridden by command line options.

• configSkipGHCCheck :: !Bool

  Don't bother checking the GHC version or architecture.

• configSkipMsys :: !Bool

  On Windows: don't use a sandboxed MSYS

• configCompilerCheck :: !VersionCheck

  Specifies which versions of the compiler are acceptable.

• configCompilerRepository :: !CompilerRepository

  Specifies the repository containing the compiler sources

• configLocalBin :: !(Path Abs Dir)

  Directory we should install executables into

• configRequireStackVersion :: !VersionRange

  Require a version of Stack within this range.

• configJobs :: !Int

  How many concurrent jobs to run, defaults to number of capabilities

• configOverrideGccPath :: !(Maybe (Path Abs File))

  Optional gcc override path

• configExtraIncludeDirs :: ![FilePath]
  • -extra-include-dirs arguments
• configExtraLibDirs :: ![FilePath]
  • -extra-lib-dirs arguments
• configCustomPreprocessorExts :: ![Text]

  List of custom preprocessors to complete the hard coded ones

• configConcurrentTests :: !Bool

  Run test suites concurrently

• configTemplateParams :: !(Map Text Text)

  Parameters for templates.

• configScmInit :: !(Maybe SCM)

  Initialize SCM (e.g. git) when creating new projects.

• configGhcOptionsByName :: !(Map PackageName [Text])

  Additional GHC options to apply to specific packages.

• configGhcOptionsByCat :: !(Map ApplyGhcOptions [Text])

  Additional GHC options to apply to categories of packages

• configCabalConfigOpts :: !(Map CabalConfigKey [Text])

  Additional options to be passed to ./Setup.hs configure

• configSetupInfoLocations :: ![String]

  URLs or paths to stack-setup.yaml files, for finding tools. If none present, the default setup-info is used.

• configSetupInfoInline :: !SetupInfo

  Additional SetupInfo to use to find tools.

• configPvpBounds :: !PvpBounds

  How PVP upper bounds should be added to packages

• configModifyCodePage :: !Bool

  Force the code page to UTF-8 on Windows

• configRebuildGhcOptions :: !Bool

  Rebuild on GHC options changes

• configApplyGhcOptions :: !ApplyGhcOptions

  Which packages do --ghc-options on the command line apply to?

• configApplyProgOptions :: !ApplyProgOptions

  Which packages do all and any --PROG-option options on the command line apply to?

• configAllowNewer :: !Bool

  Ignore version ranges in .cabal files. Funny naming chosen to match cabal.

• configAllowNewerDeps :: !(Maybe [PackageName])

  Ignore dependency upper and lower bounds only for specified packages. No effect unless allow-newer is enabled.

• configDefaultTemplate :: !(Maybe TemplateName)

  The default template to use when none is specified. (If Nothing, the 'default' default template is used.)

• configAllowDifferentUser :: !Bool

  Allow users other than the Stack root owner to use the Stack installation.

• configDumpLogs :: !DumpLogs

  Dump logs of local non-dependencies when doing a build.

• configProject :: !(ProjectConfig (Project, Path Abs File))

  Project information and stack.yaml file location

• configAllowLocals :: !Bool

  Are we allowed to build local packages? The script command disallows this.

• configSaveHackageCreds :: !Bool

  Should we save Hackage credentials to a file?

• configHackageBaseUrl :: !Text

  Hackage base URL used when uploading packages

• configRunner :: !Runner
• configPantryConfig :: !PantryConfig
• configStackRoot :: !(Path Abs Dir)
• configResolver :: !(Maybe AbstractResolver)

  Any resolver override from the command line

• configUserStorage :: !UserStorage

  Database connection pool for user Stack database

• configHideSourcePaths :: !Bool

  Enable GHC hiding source paths?

• configRecommendUpgrade :: !Bool

  Recommend a Stack upgrade?

• configNotifyIfNixOnPath :: !Bool

  Notify if the Nix package manager (nix) is on the PATH, but Stack's Nix integration is not enabled?

• configNoRunCompile :: !Bool

  Use --no-run and --compile options when using `stack script`

• configStackDeveloperMode :: !Bool

  Turn on Stack developer mode for additional messages?

• configCasa :: !(Maybe (CasaRepoPrefix, Int))

  Optional Casa configuration

Instances

HasPantryConfig Config

Defined in Stack.Types.Config

Methods

pantryConfigL :: Lens' Config PantryConfig

HasLogFunc Config

Defined in Stack.Types.Config

Methods

logFuncL :: Lens' Config LogFunc

HasProcessContext Config

Defined in Stack.Types.Config

Methods

processContextL :: Lens' Config ProcessContext

HasTerm Config

Defined in Stack.Types.Config

Methods

useColorL :: Lens' Config Bool

termWidthL :: Lens' Config Int

HasStylesUpdate Config

Defined in Stack.Types.Config

Methods

stylesUpdateL :: Lens' Config StylesUpdate

HasConfig Config

Defined in Stack.Types.Config

Methods

configL :: Lens' Config Config

HasGHCVariant Config

Defined in Stack.Types.Config

Methods

ghcVariantL :: SimpleGetter Config GHCVariant

HasPlatform Config

Defined in Stack.Types.Config

Methods

platformL :: Lens' Config Platform

platformVariantL :: Lens' Config PlatformVariant

HasRunner Config

Defined in Stack.Types.Config

Methods

runnerL :: Lens' Config Runner

class (HasPlatform env, HasGHCVariant env, HasProcessContext env, HasPantryConfig env, HasTerm env, HasRunner env) => HasConfig env where

Class for environment values that can provide a Config.

Methods

configL :: Lens' env Config

Instances

HasConfig PathInfo

Defined in Stack.Path

Methods

configL :: Lens' PathInfo Config

HasConfig BuildConfig

Defined in Stack.Types.BuildConfig

Methods

configL :: Lens' BuildConfig Config

HasConfig Config

Defined in Stack.Types.Config

Methods

configL :: Lens' Config Config

HasConfig EnvConfig

Defined in Stack.Types.EnvConfig

Methods

configL :: Lens' EnvConfig Config

HasConfig GetPackageFileContext

Defined in Stack.Types.PackageFile

Methods

configL :: Lens' GetPackageFileContext Config

askLatestSnapshotUrl :: (MonadReader env m, HasConfig env) => m Text

Get the URL to request the information on the latest snapshots

configProjectRoot :: Config -> Maybe (Path Abs Dir)

The project root directory, if in a project.

ghcInstallHook :: HasConfig env => RIO env (Path Abs File)

STACK_ROOT/hooks/ghc-install.sh

Lens helpers

buildOptsL :: HasConfig s => Lens' s BuildOpts

envOverrideSettingsL :: HasConfig env => Lens' env (EnvSettings -> IO ProcessContext)

globalOptsL :: HasRunner env => Lens' env GlobalOpts

stackGlobalConfigL :: HasConfig s => Lens' s (Path Abs File)

stackRootL :: HasConfig s => Lens' s (Path Abs Dir)

workDirL :: HasConfig env => Lens' env (Path Rel Dir)

".stack-work"

Helper logging functions

prettyStackDevL :: HasConfig env => [StyleDoc] -> RIO env ()

In dev mode, print as a warning, otherwise as debug