------------------------------------------------------------------------- --- The options of the contract verification tool together with some --- related operations. --- --- @author Michael Hanus --- @version October 2021 ------------------------------------------------------------------------- module ToolOptions ( Options(..), defaultOptions, processOptions , printWhenStatus, printWhenIntermediate, printWhenAll ) where import Control.Monad ( when, unless ) import Data.Char ( toUpper ) import System.Console.GetOpt import Numeric ( readNat ) import System.Process ( exitWith ) import System.CurryPath ( stripCurrySuffix ) data Options = Options { optVerb :: Int -- verbosity (0: quiet, 1: status, 2: interm, 3: all) , optHelp :: Bool -- if help info should be printed , optName :: String -- show only the name of a nonfail condition , optVerify :: Bool -- verify contracts (or just add them)? , optFCY :: Bool -- replace FlatCurry program? , optTAFCY :: Bool -- replace type-annotated FlatCurry program? , optStrict :: Bool -- verify precondition w.r.t. strict evaluation? -- in this case, we assume that all operations are -- strictly evaluated which might give better results -- but not not be correct if some argument is not -- demanded (TODO: add demand analysis to make it -- safe and powerful) , optNoProof :: Bool -- do not write scripts of successful proofs , optTimeout :: Int -- timeout (in seconds) for SMT prover } defaultOptions :: Options defaultOptions = Options 1 False "" True True False False False 4 --- Process the actual command line argument and return the options --- and the name of the main program. processOptions :: String -> [String] -> IO (Options,[String]) processOptions banner argv = do let (funopts, args, opterrors) = getOpt Permute options argv opts = foldl (flip id) defaultOptions funopts unless (null opterrors) (putStr (unlines opterrors) >> printUsage >> exitWith 1) when (optHelp opts) (printUsage >> exitWith 0) return (opts, map stripCurrySuffix args) where printUsage = putStrLn (banner ++ "\n" ++ usageText) -- Help text usageText :: String usageText = usageInfo ("Usage: curry-contracts [options] \n") options -- Definition of actual command line options. options :: [OptDescr (Options -> Options)] options = [ Option "h?" ["help"] (NoArg (\opts -> opts { optHelp = True })) "print help and exit" , Option "q" ["quiet"] (NoArg (\opts -> opts { optVerb = 0 })) "run quietly (no output, only exit code)" , Option "v" ["verbosity"] (OptArg (maybe (checkVerb 2) (safeReadNat checkVerb)) "") "verbosity level:\n0: quiet (same as `-q')\n1: show status messages (default)\n2: show intermediate results (same as `-v')\n3: show all intermediate results and more details" , Option "a" ["add"] (NoArg (\opts -> opts { optVerify = False })) "do not verify contracts, just add contract checks" , Option "s" ["strict"] (NoArg (\opts -> opts { optStrict = True })) "check contracts w.r.t. strict evaluation strategy" , Option "t" ["target"] (ReqArg checkTarget "") ("target of the transformed program:\n" ++ "NONE : do not store transformed FlatCurry program\n" ++ "FCY : write FlatCurry program (default)\n" ++ "TAFCY: write type-annotated FlatCurry program") , Option "" ["timeout"] (ReqArg (safeReadNat (\n opts -> opts { optTimeout = n })) "") ("timeout for SMT prover (default: " ++ show (optTimeout defaultOptions) ++ "s)") , Option "" ["noproof"] (NoArg (\opts -> opts { optNoProof = True })) "do not write scripts of successful proofs" , Option "" ["name"] (ReqArg (\s opts -> opts { optName = s }) "") "only show the names of pre- and postconditions\nfor function " ] where safeReadNat opttrans s opts = case readNat s of [(n,"")] -> opttrans n opts _ -> error "Illegal number argument (try `-h' for help)" checkVerb n opts = if n>=0 && n<4 then opts { optVerb = n } else error "Illegal verbosity level (try `-h' for help)" checkTarget t opts = case map toUpper t of "NONE" -> opts { optFCY = False, optTAFCY = False } "FCY" -> opts { optFCY = True, optTAFCY = False } "TAFCY" -> opts { optFCY = False, optTAFCY = True } _ -> error $ "Illegal target `" ++ t ++ "' (try `-h' for help)" ------------------------------------------------------------------------- printWhenStatus :: Options -> String -> IO () printWhenStatus opts s = when (optVerb opts > 0) (printCP s) printWhenIntermediate :: Options -> String -> IO () printWhenIntermediate opts s = when (optVerb opts > 1) (printCP s) printWhenAll :: Options -> String -> IO () printWhenAll opts s = when (optVerb opts > 2) (printCP s) printCP :: String -> IO () printCP s = putStrLn $ "INFO: " ++ s ---------------------------------------------------------------------------