`cabal run +RTS ...` is confusing

[noughtmare]

I've seen multiple reports of issues that were caused by people writing cabal run +RTS ... with the intention of passing those RTS options to the program that they run. Instead cabal itself consumes those RTS options.

Recently, this came up again on reddit.

The obvious solution is that users can just run cabal run -- +RTS .... However, I think this is such a common mistake that it might warrant a custom warning. Would it be possible to show something like the following warning?

$ cabal run +RTS -N
Warning: Your RTS options are applied to cabal itself, not the executable.
         Use 'cabal run -- +RTS -N' to pass the RTS options to your executable.

There are also stackoverflow questions caused by this confusion:

• https://stackoverflow.com/q/22942194
• https://stackoverflow.com/q/51352517

[BasLaa]

Is this something I could work on? I looked through the codebase, but am having trouble finding the right starting point for this.

[noughtmare]

It is a bit tricky because it seems like the +RTS flags are parsed before any Haskell program has started. Or at least the standard System.Environment.getArgs doesn't list the +RTS argument.

So, the first step is to try to write a Haskell program that can tell if it has been given any +RTS ... arguments.

Then the next step would be to integrate that mechanism into cabal.

Edit: I guess getRTSFlags might be useful.

[BasLaa]

Right I see the issue, The +RTS flag is already 'gone' before the Haskell program begins.
Let me try to look into getRTSFlags and see if I can write a sample program which can detect it.

[BasLaa]

From searching around bit it seems pretty doable.
Instead of System.Environment.getArgs, GHC.environment.getFullArgs could be used, which also lists +RTS.

import GHC.Environment (getFullArgs)

main :: IO ()
main = do
    putStrLn "Searching all args..."
    args <- getFullArgs 
    print $ elem "+RTS" args
    return ()

now if I run ./main +RTS, it detects that the flag was passed.

Would this help?

Using getRTSFlags gives the RTS flags (obviously) but doesn't indicate whether +RTS was used to set flags or a different method, like -rtsopts.

[noughtmare]

Yeah, that looks much better than getRTSFlags. Now you still do need to check that the +RTS is not on the right of a -- argument, because then we don't want to show the warning.

As for the actual place where this should go, it should probably only warn if you are using the run command. So, perhaps somewhere near the beginning of Distribution.Client.CmdRun.runAction? Although, I'm not really familiar with the cabal-install codebase either.

[BasLaa]

If I have a detection program in a cabal project, and I run cabal run detect-exe -- +RTS it detects the flag +RTS because the +RTS flag is passed to the program detect-exe. However, if I run cabal run +RTS, it does not detect the flag because the flag is passed to cabal.

For this reason I would think that if I run cabal run +RTS I can detect the flag from within cabal, whereas with cabal run detect-exe -- +RTS I cannot detect it (because it's not passed to cabal). This should be exactly what we want.

Perhaps someone else could give input on where it would be suitable to implement this?

[noughtmare]

You can try it and see what happens:

-- T3.hs
import GHC.Environment (getFullArgs)

main :: IO ()
main = do
    putStrLn "Searching all args..."
    args <- getFullArgs 
    print args

$ ./T3 -- +RTS -T
Searching all args...
["./T3","--","+RTS","-T"]
$ ./T3 +RTS -T   
Searching all args...
["./T3","+RTS","-T"]

[BasLaa]

I was talking about the case where you use cabal run. You can try it out: if you run cabal run detect-exe -- +RTS it will be there, if you run cabal run +RTS it won't be there.

The point I was making is that then (likely) within cabal exactly the inverse will be true: if you run cabal run +RTS, then within cabal you can detect the +RTS flag, and If you run cabal run detect-exe -- +RTS it won't be there. This means that we would not need to take care of the case where +RTS is on the right of a --, as then cabal won't detect it.

[noughtmare]

But if the cabal program itself runs getFullArgs is then it will surely too get ["cabal","run","detect-exe","--","+RTS"], no?

[BasLaa]

My bad, of course that's correct, I wasn't thinking about it right. That additional check should be doable to implement as well.