network-fancy-0.1.1: Networking support with a cleaner API Source code Contents Index

Network.Fancy

Contents Address Stream clients Datagram clients Servers Other

Synopsis

type HostName = String data Address = IP HostName Int | IPv4 HostName Int | IPv6 HostName Int | Unix FilePath withStream :: Address -> (Handle -> IO a) -> IO a connectStream :: Address -> IO Handle connectDgram :: Address -> IO Socket withDgram :: Address -> (Socket -> IO a) -> IO a class StringLike string recv :: StringLike string => Socket -> Int -> IO string send :: StringLike string => Socket -> string -> IO () closeSocket :: Socket -> IO () data ServerSpec = ServerSpec { address :: Address reverseAddress :: Reverse threading :: Threading closeConnection :: Bool recvSize :: Int } serverSpec :: ServerSpec data Threading = Threaded | Inline data Reverse = ReverseNumeric | ReverseName streamServer :: ServerSpec -> (Handle -> Address -> IO ()) -> IO [ThreadId] dgramServer :: StringLike packet => ServerSpec -> (packet -> Address -> IO [packet]) -> IO [ThreadId] sleepForever :: IO () getCurrentHost :: IO HostName data Socket

Address

type HostName = String Source

data Address Source

Constructors IP HostName Int Host name and port, either IPv4 or IPv6. IPv4 HostName Int Host name and port, only IPv4. IPv6 HostName Int Host name and port, only IPv6 Unix FilePath Local unix socket, not supported on Windows. Instances Eq Address Ord Address Show Address Typeable Address

Stream clients

withStream :: Address -> (Handle -> IO a) -> IO a Source

Open a stream (tcp) socket for the given block and close it afterwards.

connectStream :: Address -> IO Handle Source

Open a stream (tcp) socket.

Datagram clients

connectDgram :: Address -> IO Socket Source

Open a datagram (udp) socket.

withDgram :: Address -> (Socket -> IO a) -> IO a Source

Open a datagram (udp) socket for the given block and close it afterwards.

class StringLike string Source

Instances StringLike String StringLike ByteString StringLike ByteString

recv :: StringLike string => Socket -> Int -> IO string Source

Receive one chunk with given maximum size

send :: StringLike string => Socket -> string -> IO () Source

Send the string as one chunk

closeSocket :: Socket -> IO () Source

Close the socket specified.

Servers

data ServerSpec Source

Constructors ServerSpec address :: Address Address for the server. Use hostname "" to bind to all interfaces. reverseAddress :: Reverse Should the address of connecting clients be suplied numerically or as a name to server function. threading :: Threading Handle requests Inline or Threaded. closeConnection :: Bool Close the client connection automatically after the ServerFun finishes. recvSize :: Int Buffer size for receiving datagrams.

serverSpec :: ServerSpec Source

Default server specification

data Threading Source

Constructors Threaded Run each request in a separate thread without blocking the server loop. Inline Run each request inline inside the request loop.

data Reverse Source

Constructors ReverseNumeric Use numeric addresses for peers. ReverseName Resolve reverse names if possible for peers.

streamServer :: ServerSpec -> (Handle -> Address -> IO ()) -> IO [ThreadId] Source

Run a stream (tcp) server. The function does not block, use sleepForever if that is desired.

dgramServer Source

:: StringLike packet => ServerSpec Server specification -> packet -> Address -> IO [packet] The server function is given a received packet and the Address of the peer. It returns a list of reply packets to send to that peer. Note that the list elements are invidual packets, not concatenated together. -> IO [ThreadId] ThreadIds of the server listener processes. Run a datagram (udp) server. The function does not block, use sleepForever if that is desired.

sleepForever :: IO () Source

Sleep forever. Useful after a server.

Other

getCurrentHost :: IO HostName Source

Get the current hostname.

data Socket Source

Produced by Haddock version 2.4.2