Copyright	See LICENSE file
License	BSD
Maintainer	Ganesh Sittampalam <ganesh@earth.li>
Stability	experimental
Portability	non-portable (not tested)
Safe Haskell	Safe
Language	Haskell98

Network.Stream

Description

An library for creating abstract streams. Originally part of Gray's\/Bringert's HTTP module.

Changes by Robin Bate Boerop robin@bateboerop.name:
Removed unnecessary import statements.
Moved Debug code to StreamDebugger.hs
Moved Socket-related code to StreamSocket.hs.
Changes by Simon Foster:
Split Network.HTTPmodule up into to separate Network.[Stream,TCP,HTTP] modules

Synopsis

Documentation

class Stream x where Source #

Streams should make layering of TLS protocol easier in future, they allow reading/writing to files etc for debugging, they allow use of protocols other than TCP/IP and they allow customisation.

Instances of this class should not trim the input in any way, e.g. leave LF on line endings etc. Unless that is exactly the behaviour you want from your twisted instances ;)

Minimal complete definition

readLine, readBlock, writeBlock, close, closeOnEnd

Methods

readLine :: x -> IO (Result String) Source #

readBlock :: x -> Int -> IO (Result String) Source #

writeBlock :: x -> String -> IO (Result ()) Source #

close :: x -> IO () Source #

closeOnEnd Source #

Arguments

:: x
-> Bool
-> IO ()	True => shutdown the connection when response has been read / end-of-stream has been reached.

Instances

Stream Connection Source #
Methods readLine :: Connection -> IO (Result String) Source # readBlock :: Connection -> Int -> IO (Result String) Source # writeBlock :: Connection -> String -> IO (Result ()) Source # close :: Connection -> IO () Source # closeOnEnd :: Connection -> Bool -> IO () Source #
Stream x => Stream (StreamDebugger x) Source #
Methods readLine :: StreamDebugger x -> IO (Result String) Source # readBlock :: StreamDebugger x -> Int -> IO (Result String) Source # writeBlock :: StreamDebugger x -> String -> IO (Result ()) Source # close :: StreamDebugger x -> IO () Source # closeOnEnd :: StreamDebugger x -> Bool -> IO () Source #

data ConnError Source #

Constructors

ErrorReset
ErrorClosed
ErrorParse String
ErrorMisc String

Instances

Eq ConnError Source #
Methods (==) :: ConnError -> ConnError -> Bool # (/=) :: ConnError -> ConnError -> Bool #
Show ConnError Source #
Methods showsPrec :: Int -> ConnError -> ShowS # show :: ConnError -> String # showList :: [ConnError] -> ShowS #
Error ConnError Source #
Methods noMsg :: ConnError # strMsg :: String -> ConnError #

type Result a = Either ConnError a Source #

This is the type returned by many exported network functions.

bindE :: Result a -> (a -> Result b) -> Result b Source #

fmapE :: (a -> Result b) -> IO (Result a) -> IO (Result b) Source #

failParse :: String -> Result a Source #

failWith :: ConnError -> Result a Source #

failMisc :: String -> Result a Source #