# tasty-process
`tasty-process` is a library for running integration tests with the [Tasty](https://github.com/UnkindPartition/tasty) testing framework.
Features:
- Run an external process as a test case
- Supply input to `stdin`
- Test the process' `exitcode`, `stdout` and `stderr`
- Set timeout for the running process using Tasty's `Timeout` option
- Automatic clean up the process after the test
## Example
Here is an example Echo program that reads from `stdin` and echos back to `stdout`.
```hs
module Main (main) where
main :: IO ()
main = getLine >>= putStr
```
And here is a test case for the Echo program using `tasty-process`.
```hs
import System.Exit (ExitCode (..))
import Test.Tasty (TestTree)
import Test.Tasty.Process
echoTest :: TestTree
echoTest =
setTimeout (1000000) $ -- set timeout to 1 second
processTest
"Echo test" -- test name
TestProcess
{ process =
(proc "echo-test" []) -- process to launch with a list of arguments
, input = "Echo!" -- input to stdin
, exitCodeCheck = equals ExitSuccess -- check exit code
, stdoutCheck = equals "Echo!" -- check stdout
, stderrCheck = equals "" -- check stderr
}
```
## Documentation
See the [Hackage page](https://hackage.haskell.org/package/tasty-process) for detailed API documentation.
## GHC Compatibility
`tasty-process` is tested with GHC version >= 8.6