{-# LANGUAGE PatternSynonyms #-}
{-# LANGUAGE RecordWildCards #-}

-- | cabal-install CLI command: test
module Distribution.Client.CmdTest
  ( -- * The @test@ CLI and action
    testCommand
  , testAction

    -- * Internals exposed for testing
  , isSubComponentProblem
  , notTestProblem
  , noTestsProblem
  , selectPackageTargets
  , selectComponentTarget
  ) where

import Distribution.Client.Compat.Prelude
import Prelude ()

import Distribution.Client.CmdErrorMessages
  ( plural
  , renderTargetProblem
  , renderTargetProblemNoTargets
  , renderTargetSelector
  , showTargetSelector
  , targetSelectorFilter
  , targetSelectorPluralPkgs
  )
import Distribution.Client.NixStyleOptions
  ( NixStyleFlags (..)
  , cfgVerbosity
  , defaultNixStyleFlags
  , nixStyleOptions
  )
import Distribution.Client.ProjectOrchestration
import Distribution.Client.Setup
  ( GlobalFlags (..)
  )
import Distribution.Client.TargetProblem
  ( TargetProblem (..)
  )
import Distribution.Client.Utils
  ( giveRTSWarning
  )
import Distribution.Simple.Command
  ( CommandUI (..)
  , usageAlternatives
  )
import Distribution.Simple.Flag
  ( Flag
  , pattern Flag
  )
import Distribution.Simple.Setup
  ( TestFlags (..)
  )
import Distribution.Simple.Utils
  ( dieWithException
  , notice
  , warn
  , wrapText
  )
import Distribution.Verbosity
  ( normal
  )

import qualified System.Exit (exitSuccess)

import Distribution.Client.Errors
import GHC.Environment
  ( getFullArgs
  )

testCommand :: CommandUI (NixStyleFlags ())
testCommand :: CommandUI (NixStyleFlags ())
testCommand =
  CommandUI
    { commandName :: [Char]
commandName = [Char]
"v2-test"
    , commandSynopsis :: [Char]
commandSynopsis = [Char]
"Run test-suites."
    , commandUsage :: [Char] -> [Char]
commandUsage = [Char] -> [[Char]] -> [Char] -> [Char]
usageAlternatives [Char]
"v2-test" [[Char]
"[TARGETS] [FLAGS]"]
    , commandDescription :: Maybe ([Char] -> [Char])
commandDescription = ([Char] -> [Char]) -> Maybe ([Char] -> [Char])
forall a. a -> Maybe a
Just (([Char] -> [Char]) -> Maybe ([Char] -> [Char]))
-> ([Char] -> [Char]) -> Maybe ([Char] -> [Char])
forall a b. (a -> b) -> a -> b
$ \[Char]
_ ->
        [Char] -> [Char]
wrapText ([Char] -> [Char]) -> [Char] -> [Char]
forall a b. (a -> b) -> a -> b
$
          [Char]
"Runs the specified test-suites, first ensuring they are up to "
            [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"date.\n\n"
            [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"Any test-suite in any package in the project can be specified. "
            [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"A package can be specified in which case all the test-suites in the "
            [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"package are run. The default is to run all the test-suites in the "
            [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"package in the current directory.\n\n"
            [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"Dependencies are built or rebuilt as necessary. Additional "
            [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"configuration flags can be specified on the command line and these "
            [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"extend the project configuration from the 'cabal.project', "
            [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"'cabal.project.local' and other files.\n\n"
            [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"To pass command-line arguments to a test suite, see the "
            [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"v2-run command."
    , commandNotes :: Maybe ([Char] -> [Char])
commandNotes = ([Char] -> [Char]) -> Maybe ([Char] -> [Char])
forall a. a -> Maybe a
Just (([Char] -> [Char]) -> Maybe ([Char] -> [Char]))
-> ([Char] -> [Char]) -> Maybe ([Char] -> [Char])
forall a b. (a -> b) -> a -> b
$ \[Char]
pname ->
        [Char]
"Examples:\n"
          [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"  "
          [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
pname
          [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
" v2-test\n"
          [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"    Run all the test-suites in the package in the current directory\n"
          [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"  "
          [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
pname
          [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
" v2-test pkgname\n"
          [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"    Run all the test-suites in the package named pkgname\n"
          [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"  "
          [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
pname
          [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
" v2-test cname\n"
          [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"    Run the test-suite named cname\n"
          [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"  "
          [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
pname
          [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
" v2-test cname --enable-coverage\n"
          [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"    Run the test-suite built with code coverage (including local libs used)\n"
    , commandDefaultFlags :: NixStyleFlags ()
commandDefaultFlags = () -> NixStyleFlags ()
forall a. a -> NixStyleFlags a
defaultNixStyleFlags ()
    , commandOptions :: ShowOrParseArgs -> [OptionField (NixStyleFlags ())]
commandOptions = (ShowOrParseArgs -> [OptionField ()])
-> ShowOrParseArgs -> [OptionField (NixStyleFlags ())]
forall a.
(ShowOrParseArgs -> [OptionField a])
-> ShowOrParseArgs -> [OptionField (NixStyleFlags a)]
nixStyleOptions ([OptionField ()] -> ShowOrParseArgs -> [OptionField ()]
forall a b. a -> b -> a
const [])
    }

-- | The @test@ command is very much like @build@. It brings the install plan
-- up to date, selects that part of the plan needed by the given or implicit
-- test target(s) and then executes the plan.
--
-- Compared to @build@ the difference is that there's also test targets
-- which are ephemeral.
--
-- For more details on how this works, see the module
-- "Distribution.Client.ProjectOrchestration"
testAction :: NixStyleFlags () -> [String] -> GlobalFlags -> IO ()
testAction :: NixStyleFlags () -> [[Char]] -> GlobalFlags -> IO ()
testAction flags :: NixStyleFlags ()
flags@NixStyleFlags{()
HaddockFlags
BenchmarkFlags
ConfigFlags
TestFlags
ProjectFlags
ConfigExFlags
InstallFlags
configFlags :: ConfigFlags
configExFlags :: ConfigExFlags
installFlags :: InstallFlags
haddockFlags :: HaddockFlags
testFlags :: TestFlags
benchmarkFlags :: BenchmarkFlags
projectFlags :: ProjectFlags
extraFlags :: ()
benchmarkFlags :: forall a. NixStyleFlags a -> BenchmarkFlags
configExFlags :: forall a. NixStyleFlags a -> ConfigExFlags
configFlags :: forall a. NixStyleFlags a -> ConfigFlags
extraFlags :: forall a. NixStyleFlags a -> a
haddockFlags :: forall a. NixStyleFlags a -> HaddockFlags
installFlags :: forall a. NixStyleFlags a -> InstallFlags
projectFlags :: forall a. NixStyleFlags a -> ProjectFlags
testFlags :: forall a. NixStyleFlags a -> TestFlags
..} [[Char]]
targetStrings GlobalFlags
globalFlags = do
  baseCtx <- Verbosity
-> ProjectConfig -> CurrentCommand -> IO ProjectBaseContext
establishProjectBaseContext Verbosity
verbosity ProjectConfig
cliConfig CurrentCommand
OtherCommand

  targetSelectors <-
    either (reportTargetSelectorProblems verbosity) return
      =<< readTargetSelectors (localPackages baseCtx) (Just TestKind) targetStrings

  buildCtx <-
    runProjectPreBuildPhase verbosity baseCtx $ \ElaboratedInstallPlan
elaboratedPlan -> do
      Bool -> IO () -> IO ()
forall (f :: * -> *). Applicative f => Bool -> f () -> f ()
when (BuildTimeSettings -> Bool
buildSettingOnlyDeps (ProjectBaseContext -> BuildTimeSettings
buildSettings ProjectBaseContext
baseCtx)) (IO () -> IO ()) -> IO () -> IO ()
forall a b. (a -> b) -> a -> b
$
        Verbosity -> CabalInstallException -> IO ()
forall a1 a.
(HasCallStack, Show a1, Typeable a1,
 Exception (VerboseException a1)) =>
Verbosity -> a1 -> IO a
dieWithException Verbosity
verbosity CabalInstallException
TestCommandDoesn'tSupport

      fullArgs <- IO [[Char]]
getFullArgs
      when ("+RTS" `elem` fullArgs) $
        warn verbosity $
          giveRTSWarning "test"

      -- Interpret the targets on the command line as test targets
      -- (as opposed to say build or haddock targets).
      targets <-
        either (reportTargetProblems verbosity failWhenNoTestSuites) return $
          resolveTargetsFromSolver
            selectPackageTargets
            selectComponentTarget
            elaboratedPlan
            Nothing
            targetSelectors

      let elaboratedPlan' =
            TargetAction
-> TargetsMap -> ElaboratedInstallPlan -> ElaboratedInstallPlan
pruneInstallPlanToTargets
              TargetAction
TargetActionTest
              TargetsMap
targets
              ElaboratedInstallPlan
elaboratedPlan
      return (elaboratedPlan', targets)

  printPlan verbosity baseCtx buildCtx

  buildOutcomes <- runProjectBuildPhase verbosity baseCtx buildCtx
  runProjectPostBuildPhase verbosity baseCtx buildCtx buildOutcomes
  where
    failWhenNoTestSuites :: Flag Bool
failWhenNoTestSuites = TestFlags -> Flag Bool
testFailWhenNoTestSuites TestFlags
testFlags
    verbosity :: Verbosity
verbosity = Verbosity -> NixStyleFlags () -> Verbosity
forall a. Verbosity -> NixStyleFlags a -> Verbosity
cfgVerbosity Verbosity
normal NixStyleFlags ()
flags
    cliConfig :: ProjectConfig
cliConfig = GlobalFlags
-> NixStyleFlags () -> ClientInstallFlags -> ProjectConfig
forall a.
GlobalFlags
-> NixStyleFlags a -> ClientInstallFlags -> ProjectConfig
commandLineFlagsToProjectConfig GlobalFlags
globalFlags NixStyleFlags ()
flags ClientInstallFlags
forall a. Monoid a => a
mempty -- ClientInstallFlags

-- | This defines what a 'TargetSelector' means for the @test@ command.
-- It selects the 'AvailableTarget's that the 'TargetSelector' refers to,
-- or otherwise classifies the problem.
--
-- For the @test@ command we select all buildable test-suites,
-- or fail if there are no test-suites or no buildable test-suites.
selectPackageTargets
  :: TargetSelector
  -> [AvailableTarget k]
  -> Either TestTargetProblem [k]
selectPackageTargets :: forall k.
TargetSelector
-> [AvailableTarget k] -> Either TestTargetProblem [k]
selectPackageTargets TargetSelector
targetSelector [AvailableTarget k]
targets
  -- If there are any buildable test-suite targets then we select those
  | Bool -> Bool
not ([k] -> Bool
forall a. [a] -> Bool
forall (t :: * -> *) a. Foldable t => t a -> Bool
null [k]
targetsTestsBuildable) =
      [k] -> Either TestTargetProblem [k]
forall a b. b -> Either a b
Right [k]
targetsTestsBuildable
  -- If there are test-suites but none are buildable then we report those
  | Bool -> Bool
not ([AvailableTarget ()] -> Bool
forall a. [a] -> Bool
forall (t :: * -> *) a. Foldable t => t a -> Bool
null [AvailableTarget ()]
targetsTests) =
      TestTargetProblem -> Either TestTargetProblem [k]
forall a b. a -> Either a b
Left (TargetSelector -> [AvailableTarget ()] -> TestTargetProblem
forall a. TargetSelector -> [AvailableTarget ()] -> TargetProblem a
TargetProblemNoneEnabled TargetSelector
targetSelector [AvailableTarget ()]
targetsTests)
  -- If there are no test-suite but some other targets then we report that
  | Bool -> Bool
not ([AvailableTarget k] -> Bool
forall a. [a] -> Bool
forall (t :: * -> *) a. Foldable t => t a -> Bool
null [AvailableTarget k]
targets) =
      TestTargetProblem -> Either TestTargetProblem [k]
forall a b. a -> Either a b
Left (TargetSelector -> TestTargetProblem
noTestsProblem TargetSelector
targetSelector)
  -- If there are no targets at all then we report that
  | Bool
otherwise =
      TestTargetProblem -> Either TestTargetProblem [k]
forall a b. a -> Either a b
Left (TargetSelector -> TestTargetProblem
forall a. TargetSelector -> TargetProblem a
TargetProblemNoTargets TargetSelector
targetSelector)
  where
    targetsTestsBuildable :: [k]
targetsTestsBuildable =
      [AvailableTarget k] -> [k]
forall k. [AvailableTarget k] -> [k]
selectBuildableTargets
        ([AvailableTarget k] -> [k])
-> ([AvailableTarget k] -> [AvailableTarget k])
-> [AvailableTarget k]
-> [k]
forall b c a. (b -> c) -> (a -> b) -> a -> c
. ComponentKind -> [AvailableTarget k] -> [AvailableTarget k]
forall k.
ComponentKind -> [AvailableTarget k] -> [AvailableTarget k]
filterTargetsKind ComponentKind
TestKind
        ([AvailableTarget k] -> [k]) -> [AvailableTarget k] -> [k]
forall a b. (a -> b) -> a -> b
$ [AvailableTarget k]
targets

    targetsTests :: [AvailableTarget ()]
targetsTests =
      [AvailableTarget k] -> [AvailableTarget ()]
forall k. [AvailableTarget k] -> [AvailableTarget ()]
forgetTargetsDetail
        ([AvailableTarget k] -> [AvailableTarget ()])
-> ([AvailableTarget k] -> [AvailableTarget k])
-> [AvailableTarget k]
-> [AvailableTarget ()]
forall b c a. (b -> c) -> (a -> b) -> a -> c
. ComponentKind -> [AvailableTarget k] -> [AvailableTarget k]
forall k.
ComponentKind -> [AvailableTarget k] -> [AvailableTarget k]
filterTargetsKind ComponentKind
TestKind
        ([AvailableTarget k] -> [AvailableTarget ()])
-> [AvailableTarget k] -> [AvailableTarget ()]
forall a b. (a -> b) -> a -> b
$ [AvailableTarget k]
targets

-- | For a 'TargetComponent' 'TargetSelector', check if the component can be
-- selected.
--
-- For the @test@ command we just need to check it is a test-suite, in addition
-- to the basic checks on being buildable etc.
selectComponentTarget
  :: SubComponentTarget
  -> AvailableTarget k
  -> Either TestTargetProblem k
selectComponentTarget :: forall k.
SubComponentTarget
-> AvailableTarget k -> Either TestTargetProblem k
selectComponentTarget subtarget :: SubComponentTarget
subtarget@SubComponentTarget
WholeComponent AvailableTarget k
t
  | CTestName UnqualComponentName
_ <- AvailableTarget k -> ComponentName
forall k. AvailableTarget k -> ComponentName
availableTargetComponentName AvailableTarget k
t =
      (TestTargetProblem -> Either TestTargetProblem k)
-> (k -> Either TestTargetProblem k)
-> Either TestTargetProblem k
-> Either TestTargetProblem k
forall a c b. (a -> c) -> (b -> c) -> Either a b -> c
either TestTargetProblem -> Either TestTargetProblem k
forall a b. a -> Either a b
Left k -> Either TestTargetProblem k
forall a. a -> Either TestTargetProblem a
forall (m :: * -> *) a. Monad m => a -> m a
return (Either TestTargetProblem k -> Either TestTargetProblem k)
-> Either TestTargetProblem k -> Either TestTargetProblem k
forall a b. (a -> b) -> a -> b
$
        SubComponentTarget
-> AvailableTarget k -> Either TestTargetProblem k
forall k a.
SubComponentTarget
-> AvailableTarget k -> Either (TargetProblem a) k
selectComponentTargetBasic SubComponentTarget
subtarget AvailableTarget k
t
  | Bool
otherwise =
      TestTargetProblem -> Either TestTargetProblem k
forall a b. a -> Either a b
Left
        ( PackageIdentifier -> ComponentName -> TestTargetProblem
notTestProblem
            (AvailableTarget k -> PackageIdentifier
forall k. AvailableTarget k -> PackageIdentifier
availableTargetPackageId AvailableTarget k
t)
            (AvailableTarget k -> ComponentName
forall k. AvailableTarget k -> ComponentName
availableTargetComponentName AvailableTarget k
t)
        )
selectComponentTarget SubComponentTarget
subtarget AvailableTarget k
t =
  TestTargetProblem -> Either TestTargetProblem k
forall a b. a -> Either a b
Left
    ( PackageIdentifier
-> ComponentName -> SubComponentTarget -> TestTargetProblem
isSubComponentProblem
        (AvailableTarget k -> PackageIdentifier
forall k. AvailableTarget k -> PackageIdentifier
availableTargetPackageId AvailableTarget k
t)
        (AvailableTarget k -> ComponentName
forall k. AvailableTarget k -> ComponentName
availableTargetComponentName AvailableTarget k
t)
        SubComponentTarget
subtarget
    )

-- | The various error conditions that can occur when matching a
-- 'TargetSelector' against 'AvailableTarget's for the @test@ command.
data TestProblem
  = -- | The 'TargetSelector' matches targets but no test-suites
    TargetProblemNoTests TargetSelector
  | -- | The 'TargetSelector' refers to a component that is not a test-suite
    TargetProblemComponentNotTest PackageId ComponentName
  | -- | Asking to test an individual file or module is not supported
    TargetProblemIsSubComponent PackageId ComponentName SubComponentTarget
  deriving (TestProblem -> TestProblem -> Bool
(TestProblem -> TestProblem -> Bool)
-> (TestProblem -> TestProblem -> Bool) -> Eq TestProblem
forall a. (a -> a -> Bool) -> (a -> a -> Bool) -> Eq a
$c== :: TestProblem -> TestProblem -> Bool
== :: TestProblem -> TestProblem -> Bool
$c/= :: TestProblem -> TestProblem -> Bool
/= :: TestProblem -> TestProblem -> Bool
Eq, Int -> TestProblem -> [Char] -> [Char]
[TestProblem] -> [Char] -> [Char]
TestProblem -> [Char]
(Int -> TestProblem -> [Char] -> [Char])
-> (TestProblem -> [Char])
-> ([TestProblem] -> [Char] -> [Char])
-> Show TestProblem
forall a.
(Int -> a -> [Char] -> [Char])
-> (a -> [Char]) -> ([a] -> [Char] -> [Char]) -> Show a
$cshowsPrec :: Int -> TestProblem -> [Char] -> [Char]
showsPrec :: Int -> TestProblem -> [Char] -> [Char]
$cshow :: TestProblem -> [Char]
show :: TestProblem -> [Char]
$cshowList :: [TestProblem] -> [Char] -> [Char]
showList :: [TestProblem] -> [Char] -> [Char]
Show)

type TestTargetProblem = TargetProblem TestProblem

noTestsProblem :: TargetSelector -> TargetProblem TestProblem
noTestsProblem :: TargetSelector -> TestTargetProblem
noTestsProblem = TestProblem -> TestTargetProblem
forall a. a -> TargetProblem a
CustomTargetProblem (TestProblem -> TestTargetProblem)
-> (TargetSelector -> TestProblem)
-> TargetSelector
-> TestTargetProblem
forall b c a. (b -> c) -> (a -> b) -> a -> c
. TargetSelector -> TestProblem
TargetProblemNoTests

notTestProblem :: PackageId -> ComponentName -> TargetProblem TestProblem
notTestProblem :: PackageIdentifier -> ComponentName -> TestTargetProblem
notTestProblem PackageIdentifier
pkgid ComponentName
name = TestProblem -> TestTargetProblem
forall a. a -> TargetProblem a
CustomTargetProblem (TestProblem -> TestTargetProblem)
-> TestProblem -> TestTargetProblem
forall a b. (a -> b) -> a -> b
$ PackageIdentifier -> ComponentName -> TestProblem
TargetProblemComponentNotTest PackageIdentifier
pkgid ComponentName
name

isSubComponentProblem
  :: PackageId
  -> ComponentName
  -> SubComponentTarget
  -> TargetProblem TestProblem
isSubComponentProblem :: PackageIdentifier
-> ComponentName -> SubComponentTarget -> TestTargetProblem
isSubComponentProblem PackageIdentifier
pkgid ComponentName
name SubComponentTarget
subcomponent =
  TestProblem -> TestTargetProblem
forall a. a -> TargetProblem a
CustomTargetProblem (TestProblem -> TestTargetProblem)
-> TestProblem -> TestTargetProblem
forall a b. (a -> b) -> a -> b
$
    PackageIdentifier
-> ComponentName -> SubComponentTarget -> TestProblem
TargetProblemIsSubComponent PackageIdentifier
pkgid ComponentName
name SubComponentTarget
subcomponent

reportTargetProblems :: Verbosity -> Flag Bool -> [TestTargetProblem] -> IO a
reportTargetProblems :: forall a. Verbosity -> Flag Bool -> [TestTargetProblem] -> IO a
reportTargetProblems Verbosity
verbosity Flag Bool
failWhenNoTestSuites [TestTargetProblem]
problems =
  case (Flag Bool
failWhenNoTestSuites, [TestTargetProblem]
problems) of
    (Flag Bool
True, [CustomTargetProblem (TargetProblemNoTests TargetSelector
_)]) ->
      Verbosity -> CabalInstallException -> IO a
forall a1 a.
(HasCallStack, Show a1, Typeable a1,
 Exception (VerboseException a1)) =>
Verbosity -> a1 -> IO a
dieWithException Verbosity
verbosity (CabalInstallException -> IO a) -> CabalInstallException -> IO a
forall a b. (a -> b) -> a -> b
$ [Char] -> CabalInstallException
ReportTargetProblems [Char]
problemsMessage
    (Flag Bool
_, [CustomTargetProblem (TargetProblemNoTests TargetSelector
selector)]) -> do
      Verbosity -> [Char] -> IO ()
notice Verbosity
verbosity (TargetSelector -> [Char]
renderAllowedNoTestsProblem TargetSelector
selector)
      IO a
forall a. IO a
System.Exit.exitSuccess
    (Flag Bool
_, [TestTargetProblem]
_) -> Verbosity -> CabalInstallException -> IO a
forall a1 a.
(HasCallStack, Show a1, Typeable a1,
 Exception (VerboseException a1)) =>
Verbosity -> a1 -> IO a
dieWithException Verbosity
verbosity (CabalInstallException -> IO a) -> CabalInstallException -> IO a
forall a b. (a -> b) -> a -> b
$ [Char] -> CabalInstallException
ReportTargetProblems [Char]
problemsMessage
  where
    problemsMessage :: [Char]
problemsMessage = [[Char]] -> [Char]
unlines ([[Char]] -> [Char])
-> ([TestTargetProblem] -> [[Char]])
-> [TestTargetProblem]
-> [Char]
forall b c a. (b -> c) -> (a -> b) -> a -> c
. (TestTargetProblem -> [Char]) -> [TestTargetProblem] -> [[Char]]
forall a b. (a -> b) -> [a] -> [b]
map TestTargetProblem -> [Char]
renderTestTargetProblem ([TestTargetProblem] -> [Char]) -> [TestTargetProblem] -> [Char]
forall a b. (a -> b) -> a -> b
$ [TestTargetProblem]
problems

-- | Unless @--test-fail-when-no-test-suites@ flag is passed, we don't
--   @die@ when the target problem is 'TargetProblemNoTests'.
--   Instead, we display a notice saying that no tests have run and
--   indicate how this behaviour was enabled.
renderAllowedNoTestsProblem :: TargetSelector -> String
renderAllowedNoTestsProblem :: TargetSelector -> [Char]
renderAllowedNoTestsProblem TargetSelector
selector =
  [Char]
"No tests to run for " [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ TargetSelector -> [Char]
renderTargetSelector TargetSelector
selector

renderTestTargetProblem :: TestTargetProblem -> String
renderTestTargetProblem :: TestTargetProblem -> [Char]
renderTestTargetProblem (TargetProblemNoTargets TargetSelector
targetSelector) =
  case TargetSelector -> Maybe ComponentKind
targetSelectorFilter TargetSelector
targetSelector of
    Just ComponentKind
kind
      | ComponentKind
kind ComponentKind -> ComponentKind -> Bool
forall a. Eq a => a -> a -> Bool
/= ComponentKind
TestKind ->
          [Char]
"The test command is for running test suites, but the target '"
            [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ TargetSelector -> [Char]
showTargetSelector TargetSelector
targetSelector
            [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"' refers to "
            [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ TargetSelector -> [Char]
renderTargetSelector TargetSelector
targetSelector
            [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"."
            [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"\n"
            [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ TargetSelector -> [Char]
forall a. Show a => a -> [Char]
show TargetSelector
targetSelector
    Maybe ComponentKind
_ -> [Char] -> TargetSelector -> [Char]
renderTargetProblemNoTargets [Char]
"test" TargetSelector
targetSelector
renderTestTargetProblem TestTargetProblem
problem =
  [Char] -> (TestProblem -> [Char]) -> TestTargetProblem -> [Char]
forall a. [Char] -> (a -> [Char]) -> TargetProblem a -> [Char]
renderTargetProblem [Char]
"test" TestProblem -> [Char]
renderTestProblem TestTargetProblem
problem

renderTestProblem :: TestProblem -> String
renderTestProblem :: TestProblem -> [Char]
renderTestProblem (TargetProblemNoTests TargetSelector
targetSelector) =
  [Char]
"Cannot run tests for the target '"
    [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ TargetSelector -> [Char]
showTargetSelector TargetSelector
targetSelector
    [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"' which refers to "
    [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ TargetSelector -> [Char]
renderTargetSelector TargetSelector
targetSelector
    [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
" because "
    [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ Plural -> [Char] -> [Char] -> [Char]
forall a. Plural -> a -> a -> a
plural (TargetSelector -> Plural
targetSelectorPluralPkgs TargetSelector
targetSelector) [Char]
"it does" [Char]
"they do"
    [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
" not contain any test suites."
renderTestProblem (TargetProblemComponentNotTest PackageIdentifier
pkgid ComponentName
cname) =
  [Char]
"The test command is for running test suites, but the target '"
    [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ TargetSelector -> [Char]
showTargetSelector TargetSelector
targetSelector
    [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"' refers to "
    [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ TargetSelector -> [Char]
renderTargetSelector TargetSelector
targetSelector
    [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
" from the package "
    [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ PackageIdentifier -> [Char]
forall a. Pretty a => a -> [Char]
prettyShow PackageIdentifier
pkgid
    [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"."
  where
    targetSelector :: TargetSelector
targetSelector = PackageIdentifier
-> ComponentName -> SubComponentTarget -> TargetSelector
TargetComponent PackageIdentifier
pkgid ComponentName
cname SubComponentTarget
WholeComponent
renderTestProblem (TargetProblemIsSubComponent PackageIdentifier
pkgid ComponentName
cname SubComponentTarget
subtarget) =
  [Char]
"The test command can only run test suites as a whole, "
    [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"not files or modules within them, but the target '"
    [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ TargetSelector -> [Char]
showTargetSelector TargetSelector
targetSelector
    [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"' refers to "
    [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ TargetSelector -> [Char]
renderTargetSelector TargetSelector
targetSelector
    [Char] -> [Char] -> [Char]
forall a. [a] -> [a] -> [a]
++ [Char]
"."
  where
    targetSelector :: TargetSelector
targetSelector = PackageIdentifier
-> ComponentName -> SubComponentTarget -> TargetSelector
TargetComponent PackageIdentifier
pkgid ComponentName
cname SubComponentTarget
subtarget