Moduleprocess-extras-0.7.4Haskell2010

System.Process.Common

4 classes
6 values

Packageprocess-extras-0.7.4
Exports10
LanguageHaskell2010
LicenceMIT
SourceCommon.hs

classclass ProcessMaker a where

Methods

process :: a -> IO (Handle, Handle, Handle, ProcessHandle)
showProcessMakerForUser :: a -> String

Instances2ProcessMaker

ProcessMaker CreateProcessDefined in process-extras-0.7.4 · System.Process.Common
This is the usual maker argument to readCreateProcessLazy.
ProcessMaker (CreateProcess, BufferMode, BufferMode)Defined in process-extras-0.7.4 · System.Process.Common
Passing this to readCreateProcessLazy as the maker argument allows you to set the buffer mode of the process stdout and stderr handles just after the handles are created. These are set to BlockBuffering by default, but for running console commands LineBuffering is probably what you want.

classclass ListLikeIO text char => ListLikeProcessIO text char where

Process IO is based on the ListLikeIO class from the ListLike package

Methods

forceOutput :: text -> IO text
readChunks :: Handle -> IO [text]
Read from a handle, returning a lazy list of the monoid a.

Instances7ListLikeProcessIO, …

ListLikeProcessIO Chars CharDefined in process-extras-0.7.4 · System.Process.Chars · orphan
Like readProcessWithExitCode, but specialized for Text
ListLikeProcessIO ByteString Word8Defined in process-extras-0.7.4 · System.Process.ByteString · orphan
Like readProcessWithExitCode, but using ByteString
ListLikeProcessIO ByteString Word8Defined in process-extras-0.7.4 · System.Process.ByteString.Lazy · orphan
Like readProcessWithExitCode, but using ByteString
ListLikeProcessIO String CharDefined in process-extras-0.7.4 · System.Process.ListLike · orphan
Like readProcessWithExitCode that takes a CreateProcess.
ListLikeProcessIO Text CharDefined in process-extras-0.7.4 · System.Process.Text · orphan
Like readProcessWithExitCode, but using Text
ListLikeProcessIO Builder CharDefined in process-extras-0.7.4 · System.Process.Text.Builder · orphan
Like readProcessWithExitCode, but using Text
ListLikeProcessIO Text CharDefined in process-extras-0.7.4 · System.Process.Text.Lazy · orphan
Like readProcessWithExitCode, but using Text

classclass (IsString text, Monoid text, ListLike text char) => ProcessText text char

Instances5ProcessText

ProcessText ByteString Word8Defined in process-extras-0.7.4 · System.Process.ByteString · orphan
ProcessText ByteString Word8Defined in process-extras-0.7.4 · System.Process.ByteString.Lazy · orphan
ProcessText String CharDefined in process-extras-0.7.4 · System.Process.ListLike · orphan
ProcessText Text CharDefined in process-extras-0.7.4 · System.Process.Text · orphan
ProcessText Text CharDefined in process-extras-0.7.4 · System.Process.Text.Lazy · orphan

classclass Monoid result => ProcessResult text result | result -> text where

Methods

pidf :: ProcessHandle -> result
outf :: text -> result
errf :: text -> result
intf :: SomeException -> result
codef :: ExitCode -> result

Instances3ProcessResult

ListLikeProcessIO a c => ProcessResult a [Chunk a]Defined in process-extras-0.7.4 · System.Process.ListLike
ListLikeProcessIO a c => ProcessResult a (ExitCode, [Chunk a])Defined in process-extras-0.7.4 · System.Process.ListLike
ListLikeProcessIO text char => ProcessResult text (ExitCode, text, text)Defined in process-extras-0.7.4 · System.Process.Common

valuereadProcessWithExitCode

:: ListLikeProcessIO text char
=> FilePath
command to run
-> [String]
any arguments
-> text
standard input
-> IO (ExitCode, text, text)
exitcode, stdout, stderr

Like readProcessWithExitCode, but with generalized input and output type. Aside from the usual text-like types, the output can be a list of Chunk a. This lets you process the chunks received from stdout and stderr lazil, in the order they are received, as well as the exit code. Utilities to handle Chunks are provided in System.Process.ListLike.

valuereadCreateProcessWithExitCode

:: (ProcessMaker maker, ListLikeProcessIO text char)
=> maker
command and arguments to run
-> text
standard input
-> IO (ExitCode, text, text)
exitcode, stdout, stderr

valuereadCreateProcessStrict

:: (ProcessMaker maker, ProcessResult text result, ListLikeProcessIO text char)
=> maker
-> text
-> IO result

valuereadCreateProcessLazy

:: (ProcessMaker maker, ProcessResult a b, ListLikeProcessIO a c)
=> maker
-> a
-> IO b

Like readCreateProcessStrict, but the output is read lazily.

valueshowCmdSpecForUser :: CmdSpec -> String

valueshowCreateProcessForUser :: CreateProcess -> String

System.Process utility functions.

Orphan instances

2 instances

Semigroup ExitCode
Monoid ExitCode
A process usually has one ExitCode at the end of its output, this Monoid instance lets us build the type returned by readProcessWithExitCode.