The daemons package

[Tags:gpl, library, program, test]

Control.Pipe.C3 provides simple RPC-like wrappers for pipes.

Control.Pipe.Serialize provides serialization and incremental deserialization pipes.

Control.Pipe.Socket provides functions to setup pipes around sockets.

System.Daemon provides a high-level interface to starting daemonized programs that are controlled through sockets.

System.Posix.Daemon provides a low-level interface to starting, and controlling detached jobs.

See the README.md file and the homepage for details.


[Skip to Readme]

Properties

Versions 0.1.0, 0.1.1, 0.1.2, 0.2.0, 0.2.1
Change log NEWS.md
Dependencies base (==4.*), bytestring, cereal, containers, daemons, data-default, directory, filepath, ghc-prim, network, pipes (>=3.1), transformers, unix [details]
License GPL-3
Author Alexandru Scvortov <scvalex@gmail.com>
Maintainer scvalex@gmail.com
Stability experimental
Category System, Control, Network
Home page https://github.com/scvalex/daemons
Source repository head: git clone git://github.com/scvalex/daemons.git
Uploaded Fri Apr 5 21:42:05 UTC 2013 by AlexandruScvortov
Distributions NixOS:0.2.1
Downloads 1773 total (7 in the last 30 days)
Votes
0 []
Status Docs uploaded by user
Build status unknown [no reports yet]

Modules

[Index]

Downloads

Maintainer's Corner

For package maintainers and hackage trustees

Readme for daemons

Readme for daemons-0.1.2

daemons

Daemons in Haskell made fun and easy

Example

Here's AddOne, a simple daemon that waits for a number and responds with the incremented number.

import Data.Default ( def )
import System.Environment ( getArgs )
import System.Daemon

addOne :: Int -> IO Int
addOne n = return (n + 1)

main :: IO ()
main = do
    ensureDaemonRunning "addOne" def addOne
    [n] <- getArgs
    res <- runClient "localhost" 5000 ((read n) :: Int)
    print (res :: Maybe Int)

Running it, we see:

% addone 22
Daemon started on port 5000
Just 23
% addone 41
Just 42

The two important functions above are ensureDaemonRunning, which checks if a daemon named addOne is already running, and starts it if not, and runClient which connects to the daemon running on localhost:5000, passes it a number, and waits for the response.

What would I use this for?

  • You can use the runDetached from System.Posix.Daemon to turn your program into a daemon for Unix-like systems. You'd want to do this for practically every program that's meant to run as a server.

  • You can use the functions from Control.Pipe.C3, Socket, and Serialize to communicate with running Haskell program. At the simplest, you could query the program for its status, or instruct it to shutdown cleanly. A more complex use would be adding a full REPL into a running Haskell process (think erl -remsh).

  • You can use the helpers from System.Daemon to trivially do the above. Check out the following tutorials and examples for details.

Tutorials and examples

  • Memo - in which we write an in-memory key-value store,

  • Queue

    • a task queue using the streaming interface of daemons.

Installation

This package is on Hackage. To install it, run:

cabal update
cabal install daemons

Modules

  • Control.Pipe.C3 provides simple RPC-like wrappers for pipes.

  • Control.Pipe.Serialize provides pipes to serialize and deserialize streams of strict ByteStrings using cereal.

  • Control.Pipe.Socket provides functions to setup strict ByteString pipes around sockets.

  • System.Daemon provides a high-level interface to starting daemonized programs that are controlled through sockets.

  • System.Posix.Daemon provides a low-level interface to starting, and controlling detached jobs.

See also