Test.Sandbox.Internals

Documentation

newtype Sandbox a

Constructors

Sandbox

Fields

runSandbox :: ErrorT String (StateT SandboxState IO) a

Instances

Monad Sandbox

Functor Sandbox

Applicative Sandbox

MonadIO Sandbox

MonadBase IO Sandbox

MonadBaseControl IO Sandbox

MonadError String Sandbox

MonadState SandboxState Sandbox

data SandboxState

Constructors

SandboxState

Fields

ssName :: String

ssDataDir :: FilePath

ssProcesses :: Map String SandboxedProcess

ssProcessOrder :: [String]

ssAllocatedPorts :: Map String PortNumber

ssAvailablePorts :: [PortNumber]

ssFiles :: Map String FilePath

ssVariables :: Map String ByteString

Instances

MonadState SandboxState Sandbox

data SandboxedProcess

Constructors

SandboxedProcess

Fields

spName :: String

spBinary :: FilePath

spArgs :: [String]

spWait :: Maybe Int

spCapture :: Maybe Capture

spInstance :: Maybe SandboxedProcessInstance

data Capture

Constructors

CaptureStdout

CaptureStderr

CaptureBoth

data SandboxedProcessInstance

Constructors

RunningInstance ProcessHandle Handle (Maybe Handle)

StoppedInstance ExitCode (Maybe String)

pretty :: SandboxState -> String

header :: SandboxState -> String

footer :: String

newSandboxState :: String -> FilePath -> IO SandboxState

registerProcess :: String -> FilePath -> [String] -> Maybe Int -> Maybe Capture -> Sandbox SandboxedProcess

getProcess :: String -> Sandbox SandboxedProcess

updateProcess :: SandboxedProcess -> Sandbox SandboxedProcess

secondInµs :: Int

setFile' :: String -> String -> SandboxState -> IO (FilePath, SandboxState)

bufferSize :: Int

hReadWithTimeout :: Handle -> Int -> Sandbox ByteString

sendToPort :: String -> String -> Int -> Sandbox String

getNewPort :: String -> Sandbox PortNumber

isBindable :: PortNumber -> IO Bool

startProcess :: SandboxedProcess -> Sandbox SandboxedProcess

formatCommandLine :: String -> [String] -> String

stopProcess :: SandboxedProcess -> Sandbox SandboxedProcess

hSignalProcess :: Signal -> ProcessHandle -> IO ()

killProcess :: ProcessHandle -> IO ()

hGetProcessID :: ProcessHandle -> IO ProcessID

interactWithProcess :: SandboxedProcess -> String -> Int -> Sandbox String

getProcessInputHandle :: SandboxedProcess -> Sandbox Handle

getProcessCapturedOutputHandle :: SandboxedProcess -> Sandbox Handle

getProcessBinary :: SandboxedProcess -> Sandbox FilePath

findExecutables :: [FilePath] -> IO [FilePath]

tryBinary :: FilePath -> IO (Maybe FilePath)

getProcessCandidateBinaries :: SandboxedProcess -> [FilePath]

expand :: String -> IO String

whenM :: Monad m => m Bool -> m () -> m ()

setVariable

Arguments

:: Serialize a

=> String

Variable key for future reference

-> a

Variable value

-> Sandbox a

Sets a custom variable in the sandbox monad.

checkVariable

Arguments

:: String

Variable key

-> Sandbox Bool

Checks that a custom sandbox variable is set.

getVariable

Arguments

:: Serialize a

=> String

Variable key

-> a

Default value if not found

-> Sandbox a

Returns the value of a previously set sandbox variable (or a provided default value if unset)

unsetVariable

Arguments

:: String

Variable key

-> Sandbox ()

Unsets a custom variable.

isVerbose :: Sandbox Bool

verbosityKey :: String

displayBanner :: Sandbox ()

data SandboxSeed

Constructors

SandboxFixedSeed Int

SandboxRandomSeed

Instances

Generic SandboxSeed

Serialize SandboxSeed

data SandboxTestOptions

Constructors

SandboxTestOptions

Fields

stoSeed :: Maybe SandboxSeed

stoMaximumGeneratedTests :: Maybe Int

stoMaximumUnsuitableGeneratedTests :: Maybe Int

stoMaximumTestSize :: Maybe Int

Instances

Generic SandboxTestOptions

Serialize SandboxTestOptions

putOptions :: SandboxTestOptions -> Sandbox ()

getOptions :: Sandbox (Maybe SandboxTestOptions)

optionsVariable :: String