git.iko.soy/distributed-process
on a5191ce help sign in
7 files changed+106−280
since splitsnapshots
unifiedsplit
distributed-process-tests/distributed-process-tests.cabal+1−1 distributed-process-tests/src/Control/Distributed/Process/Tests/CH.hs+25−104 distributed-process-tests/src/Control/Distributed/Process/Tests/Internal/Utils.hs+1−3 distributed-process-tests/src/Control/Distributed/Process/Tests/Mx.hs+75−130 distributed-process.cabal+1−1 src/Control/Distributed/Process/Internal/Primitives.hs+1−7 src/Control/Distributed/Process/Management.hs+2−34
distributed-process-tests/distributed-process-tests.cabal+1−1
@@ -6,7 +6,7 @@ description: Tests and test suite for Cloud Haskell libraries.
66license: BSD3
77license-file: LICENSE
88Author: Duncan Coutts, Nicolas Wu, Edsko de Vries
9−Maintainer: Tim Watson <watson.timothy@gmail.com>
9+Maintainer: Facundo Domínguez <facundo.dominguez@tweag.io>
1010copyright: Well-Typed LLP
1111category: Control, Cloud Haskell
1212build-type: Simple
distributed-process-tests/src/Control/Distributed/Process/Tests/CH.hs+25−104
@@ -46,11 +46,11 @@ import Control.Distributed.Process.Debug
4646import Control.Distributed.Process.Management.Internal.Types
4747import Control.Distributed.Process.Tests.Internal.Utils (shouldBe, pause)
4848import Control.Distributed.Process.Serializable (Serializable)
49−import Data.Maybe (isNothing, isJust)
49+
5050import Test.HUnit (Assertion, assertBool, assertFailure)
5151import Test.Framework (Test, testGroup)
5252import Test.Framework.Providers.HUnit (testCase)
53−import Control.Rematch hiding (match, isNothing, isJust)
53+import Control.Rematch hiding (match)
5454import Control.Rematch.Run (Match(..))
5555
5656newtype Ping = Ping ProcessId
@@ -735,6 +735,7 @@ testRemoteRegistry :: TestTransport -> Assertion
735735testRemoteRegistry TestTransport{..} = do
736736 node1 <- newLocalNode testTransport initRemoteTable
737737 node2 <- newLocalNode testTransport initRemoteTable
738+ done <- newEmptyMVar
738739
739740 pingServer <- forkProcess node1 ping
740741 deadProcess <- forkProcess node1 (return ())
@@ -749,7 +750,6 @@ testRemoteRegistry TestTransport{..} = do
749750
750751 pid <- verifyWhereIsRemote nid1 "ping"
751752 liftIO $ assertBool "Expected pindServer to match pid" $ pingServer == pid
752−
753753 us <- getSelfPid
754754 nsendRemote nid1 "ping" (Pong us)
755755 receiveWait [
@@ -759,22 +759,22 @@ testRemoteRegistry TestTransport{..} = do
759759 -- test that if process was not registered Nothing is returned
760760 -- in owner field.
761761 registerRemoteAsync nid1 "dead" deadProcess
762− receiveWait [ matchIf (\(RegisterReply label' f mPid) -> "dead" == label')
763− (\(RegisterReply _ f mPid) -> return (not f && isNothing mPid))
764− ] >>= liftIO . assertBool "Expected False Nothing in RegisterReply"
765−
762+ receiveWait [
763+ matchIf (\(RegisterReply label' False Nothing) -> "dead" == label')
764+ (\(RegisterReply _ _ _) -> return ()) ]
766765 registerRemoteAsync nid1 "ping" deadProcess
767766 receiveWait [
768− matchIf (\(RegisterReply label' False mPid) ->
769− "ping" == label' && isJust mPid)
770− (\(RegisterReply _ f (Just pid'')) -> return (not f && pid'' == pingServer))
771− ] >>= liftIO . assertBool "Expected False and (Just alreadyRegisteredPid) in RegisterReply"
772−
767+ matchIf (\(RegisterReply label' False (Just pid'')) ->
768+ "ping" == label' && pid'' == pingServer)
769+ (\(RegisterReply _ _ _) -> return ()) ]
773770 unregisterRemoteAsync nid1 "dead"
774771 receiveWait [
775− matchIf (\(RegisterReply label' _ _) -> "dead" == label')
776− (\(RegisterReply _ f mPid) -> return (not f && isNothing mPid))
777− ] >>= liftIO . assertBool "Expected False and Nothing in RegisterReply"
772+ matchIf (\(RegisterReply label' False Nothing) ->
773+ "dead" == label' && pid == pingServer)
774+ (\(RegisterReply _ _ _) -> return ()) ]
775+ liftIO $ putMVar done ()
776+
777+ takeMVar done
778778
779779testRemoteRegistryRemoteProcess :: TestTransport -> Assertion
780780testRemoteRegistryRemoteProcess TestTransport{..} = do
@@ -1272,76 +1272,6 @@ testReceiveChanFeatures TestTransport{..} = do
12721272
12731273 takeMVar done
12741274
1275−testChanLifecycle :: TestTransport -> Assertion
1276−testChanLifecycle TestTransport{..} = let delay = 3000000 in do
1277− result <- newEmptyMVar
1278− tchMV <- newEmptyMVar
1279− localNode <- newLocalNode testTransport initRemoteTable
1280− runProcess localNode $ do
1281−
1282− pid <- spawnLocal $ do tCh <- newChan :: Process (SendPort (), ReceivePort ())
1283− liftIO $ putMVar tchMV tCh
1284− expect :: Process ()
1285− let (sp, _) = tCh
1286− sendChan sp ()
1287− expect :: Process ()
1288−
1289− mRefPid <- monitor pid
1290−
1291− cPid <- spawnLocal $ do
1292− (sp', rp) <- liftIO $ takeMVar tchMV
1293− -- say "picked up our test channel"
1294− send pid ()
1295− -- say "told pid to continue"
1296− res <- receiveChanTimeout delay rp
1297− case res of
1298− Nothing -> say "initial chan () missing!" >> (liftIO $ putMVar result False)
1299− Just () -> do mr <- monitor pid
1300− pause 10000
1301− -- say "sending pid a second () will cause it to exit"
1302− send pid ()
1303−
1304− -- say "make sure we see a DOWN notification for pid having stopped"
1305− receiveWait [ match (\(_ :: ProcessMonitorNotification) -> return ()) ]
1306−
1307− -- now that pid has died, the send port should be useless...
1308− liftIO $ putMVar tchMV (sp', rp)
1309−
1310− -- let's verify that we do not see the message from our
1311− -- parent process on the channel, once pid has died...
1312− recv <- receiveChanTimeout delay rp
1313− -- say $ "finished waiting for second (), writing result" ++ (show recv)
1314− liftIO $ putMVar result $ isNothing recv
1315−
1316− mRefCPid <- monitor cPid
1317−
1318− receiveWait
1319− [ matchIf (\(ProcessMonitorNotification r _ _) -> r == mRefPid)
1320− (\_ -> return ())
1321− ]
1322−
1323− -- say "seen first pid die..."
1324−
1325− (sendPort, _) <- liftIO $ takeMVar tchMV
1326− sendChan sendPort ()
1327− -- say "sent () after owning pid died"
1328−
1329− -- let cPid know we've written to the channel...
1330− send cPid ()
1331−
1332− receiveWait
1333− [ matchIf (\(ProcessMonitorNotification r _ _) -> r == mRefCPid)
1334− (\_ -> return ())
1335− ]
1336−
1337− -- say "seen both pids die now..."
1338−
1339− -- and wait on the result back in IO land...
1340− testRes <- takeMVar result
1341− -- runProcess localNode $ say "got result..."
1342− assertBool "Expected sending on the channel to fail, but received data!" testRes
1343−
1344−
13451275testKillLocal :: TestTransport -> Assertion
13461276testKillLocal TestTransport{..} = do
13471277 localNode <- newLocalNode testTransport initRemoteTable
@@ -1556,24 +1486,20 @@ testRegistryMonitoring :: TestTransport -> Assertion
15561486testRegistryMonitoring TestTransport{..} = do
15571487 node1 <- newLocalNode testTransport initRemoteTable
15581488 node2 <- newLocalNode testTransport initRemoteTable
1489+ waitH <- newEmptyMVar
15591490
15601491 let nid = localNodeId node2
15611492 pid <- forkProcess node1 $ do
1562− self <- getSelfPid
1563− runUntilRegistered nid self
1564− say $ (show self) ++ " registered as " ++ regName
1565− expect :: Process ()
1566− say $ (show self) ++ " exiting normally"
1493+ getSelfPid >>= runUntilRegistered nid
1494+ liftIO $ takeMVar waitH
15671495
15681496 runProcess node2 $ do
15691497 register regName pid
1570− say $ regName ++ " registered to " ++ show pid
15711498 res <- whereis regName
1572− send pid ()
1573− say $ " sent finish signal to " ++ show pid
15741499 us <- getSelfPid
1575− liftIO $ assertBool "expected (Just pid)" $ res == (Just pid)
1576−
1500+ liftIO $ do
1501+ putMVar waitH ()
1502+ assertBool "expected (Just pid)" $ res == (Just pid)
15771503
15781504 -- This delay isn't essential!
15791505 -- The test case passes perfectly fine without it (feel free to comment out
@@ -1598,9 +1524,7 @@ testRegistryMonitoring TestTransport{..} = do
15981524 regHere <- newEmptyMVar
15991525 runProcess node2 $ whereis regName >>= liftIO . putMVar regHere
16001526 res <- takeMVar regHere
1601− case res of
1602− Nothing -> return ()
1603− Just pid -> assertBool ("expected Nothing, but got " ++ show pid) False
1527+ assertBool "expected Nothing, but process still registered" (res == Nothing)
16041528
16051529 where
16061530 runUntilRegistered nid us = do
@@ -1612,13 +1536,11 @@ testRegistryMonitoring TestTransport{..} = do
16121536
16131537 delayUntilMaybeUnregistered nid p = do
16141538 whereisRemoteAsync nid regName
1615− res <- receiveTimeout 20000000 {- 20 sec delay -} [
1616− matchIf (\(WhereIsReply n p) -> n == regName && isNothing p)
1539+ receiveTimeout 20000000 {- 20 sec delay -} [
1540+ matchIf (\(WhereIsReply n p) -> n == regName && p == Nothing)
16171541 (const $ return ())
16181542 ]
1619− case res of
1620− Just () -> return ()
1621− Nothing -> delayUntilMaybeUnregistered nid p
1543+ return ()
16221544
16231545 regName = "testRegisterRemote"
16241546
@@ -1814,7 +1736,6 @@ tests testtrans = return [
18141736 , testCase "MatchMessageUnwrap" (testMatchMessageWithUnwrap testtrans)
18151737 , testCase "ReceiveChanTimeout" (testReceiveChanTimeout testtrans)
18161738 , testCase "ReceiveChanFeatures" (testReceiveChanFeatures testtrans)
1817− , testCase "ChanLifecycle" (testChanLifecycle testtrans)
18181739 , testCase "KillLocal" (testKillLocal testtrans)
18191740 , testCase "KillRemote" (testKillRemote testtrans)
18201741 , testCase "Die" (testDie testtrans)
distributed-process-tests/src/Control/Distributed/Process/Tests/Internal/Utils.hs+1−3
@@ -91,7 +91,6 @@ import Test.HUnit (Assertion, assertFailure)
9191import Test.HUnit.Base (assertBool)
9292
9393import GHC.Generics
94−import System.Timeout (timeout)
9594
9695-- | A mutable cell containing a test result.
9796type TestResult a = MVar a
@@ -234,8 +233,7 @@ testProcessReport pid = do
234233tryRunProcess :: LocalNode -> Process () -> IO ()
235234tryRunProcess node p = do
236235 tid <- liftIO myThreadId
237− void $ timeout (1000000 * 60 * 5 :: Int) $
238− runProcess node $ catch p (\e -> liftIO $ throwTo tid (e::SomeException))
236+ runProcess node $ catch p (\e -> liftIO $ throwTo tid (e::SomeException))
239237
240238tryForkProcess :: LocalNode -> Process () -> IO ProcessId
241239tryForkProcess node p = do
distributed-process-tests/src/Control/Distributed/Process/Tests/Mx.hs+75−130
@@ -5,6 +5,7 @@ module Control.Distributed.Process.Tests.Mx (tests) where
55
66import Control.Distributed.Process.Tests.Internal.Utils
77import Network.Transport.Test (TestTransport(..))
8+import Control.Exception (SomeException)
89import Control.Distributed.Process hiding (bracket, finally, try)
910import Control.Distributed.Process.Internal.Types
1011 ( ProcessExitException(..)
@@ -16,7 +17,6 @@ import qualified Control.Distributed.Process.UnsafePrimitives as Unsafe
1617 , nsend
1718 , nsendRemote
1819 , usend
19− , sendChan
2020 )
2121import Control.Distributed.Process.Management
2222 ( MxEvent(..)
@@ -38,7 +38,7 @@ import Control.Monad.Catch(finally, bracket, try)
3838import Control.Rematch (equalTo)
3939import Data.Binary
4040import Data.List (find, sort, intercalate)
41−import Data.Maybe (isJust, fromJust, isNothing, fromMaybe, catMaybes)
41+import Data.Maybe (isJust, fromJust, isNothing)
4242import Data.Typeable
4343import GHC.Generics hiding (from)
4444#if ! MIN_VERSION_base(4,6,0)
@@ -66,7 +66,7 @@ awaitExit pid =
6666 where
6767 withMonitorRef p = bracket (monitor p) unmonitor
6868
69−testAgentBroadcast :: TestResult (Maybe ()) -> Process ()
69+testAgentBroadcast :: TestResult () -> Process ()
7070testAgentBroadcast result = do
7171 (resultSP, resultRP) <- newChan :: Process (SendPort (), ReceivePort ())
7272
@@ -81,10 +81,10 @@ testAgentBroadcast result = do
8181 mxNotify ()
8282 -- Once the publisher has seen our message, it will broadcast the Publish
8383 -- and the consumer will see that and send the result to our typed channel.
84− stash result =<< receiveChanTimeout 10000000 resultRP
84+ stash result =<< receiveChan resultRP
8585
86− kill publisher "finished"
87− kill consumer "finished"
86+ kill publisher "finished" >> awaitExit publisher
87+ kill consumer "finished" >> awaitExit consumer
8888
8989testAgentDualInput :: TestResult (Maybe Int) -> Process ()
9090testAgentDualInput result = do
@@ -99,8 +99,6 @@ testAgentDualInput result = do
9999 else mxReady)
100100 ]
101101
102− mRef <- monitor s
103−
104102 mxNotify (1 :: Int)
105103 nsend "sum-agent" (3 :: Int)
106104 mxNotify (2 :: Int)
@@ -108,10 +106,7 @@ testAgentDualInput result = do
108106 mxNotify (5 :: Int)
109107
110108 stash result =<< receiveChanTimeout 10000000 rp
111− died <- receiveTimeout 10000000 [
112− matchIf (\(ProcessMonitorNotification r _ _) -> r == mRef) (const $ return True)
113− ]
114− died `shouldBe` equalTo (Just True)
109+ awaitExit s
115110
116111testAgentPrioritisation :: TestResult [String] -> Process ()
117112testAgentPrioritisation result = do
@@ -125,10 +120,10 @@ testAgentPrioritisation result = do
125120 (sp, rp) <- newChan
126121 s <- mxAgent (MxAgentId name) ["first"] [
127122 mxSink (\(s :: String) -> do
128− mxUpdateLocal (s:)
123+ mxUpdateLocal ((s:))
129124 st <- mxGetLocal
130125 case length st of
131− n | n == 5 -> do liftMX $ sendChan sp (sort st)
126+ n | n == 5 -> do liftMX $ sendChan sp st
132127 mxDeactivate "finished"
133128 _ -> mxReceive -- go to the mailbox
134129 )
@@ -139,7 +134,7 @@ testAgentPrioritisation result = do
139134 mxNotify "fourth"
140135 nsend name "fifth"
141136
142− stash result . fromMaybe [] =<< receiveChanTimeout 10000000 rp
137+ stash result . sort =<< receiveChan rp
143138 awaitExit s
144139
145140testAgentMailboxHandling :: TestResult (Maybe ()) -> Process ()
@@ -152,19 +147,12 @@ testAgentMailboxHandling result = do
152147 nsend "mailbox-agent" ()
153148
154149 stash result =<< receiveChanTimeout 1000000 rp
155− kill agent "finished"
150+ kill agent "finished" >> awaitExit agent
156151
157152testAgentEventHandling :: TestResult Bool -> Process ()
158153testAgentEventHandling result = do
159− us <- getSelfPid
160− -- because this test is a bit racy, let's ensure it can't run indefinitely
161− timer <- spawnLocal $ do
162− pause (1000000 * 60 * 5)
163− -- okay we've waited 5 mins, let's kill the test off if it's stuck...
164− stash result False
165− kill us "Test Timed Out"
166−
167154 let initState = [] :: [MxEvent]
155+
168156 (rc, rs) <- newChan
169157 agentPid <- mxAgent (MxAgentId "lifecycle-listener-agent") initState [
170158 (mxSink $ \ev -> do
@@ -197,7 +185,8 @@ testAgentEventHandling result = do
197185 -- TODO: yes, this is racy, but we're at the mercy of the scheduler here...
198186 faff 2000000 rs
199187
200− (sp, rp) <- newChan :: Process (SendPort (), ReceivePort ())
188+ _ <- monitor agentPid
189+ (sp, rp) <- newChan
201190
202191 pid <- spawnLocal $ expect >>= sendChan sp
203192
@@ -206,11 +195,9 @@ testAgentEventHandling result = do
206195 monitor pid
207196
208197 send pid ()
209− rct <- receiveChanTimeout 10000000 rp
210− unless (isJust rct) $ die "No response on channel"
198+ () <- receiveChan rp
211199
212− pmn <- receiveTimeout 2000000 [ match (\ProcessMonitorNotification{} -> return ()) ]
213− unless (isJust pmn) $ die "No monitor notification arrived"
200+ receiveWait [ match (\(ProcessMonitorNotification _ _ _) -> return ()) ]
214201
215202 -- TODO: yes, this is racy, but we're at the mercy of the scheduler here...
216203 faff 2000000 rs
@@ -219,16 +206,17 @@ testAgentEventHandling result = do
219206 mxNotify (MxSpawned pid, replyTo)
220207 mxNotify (MxProcessDied pid DiedNormal, replyTo)
221208
222− seenAlive <- receiveChanTimeout 10000000 reply
223− seenDead <- receiveChanTimeout 10000000 reply
209+ seenAlive <- receiveChan reply
210+ seenDead <- receiveChan reply
224211
225− stash result $ foldr (&&) True $ catMaybes [seenAlive, seenDead]
226− kill timer "test-complete"
227− kill agentPid "test-complete"
212+ stash result $ seenAlive && seenDead
213+ kill agentPid "test-complete" >> awaitExit agentPid
228214 where
229215 faff delay port = do
230216 res <- receiveChanTimeout delay port
231− unless (isNothing res) $ pause delay
217+ unless (isNothing res) $ do
218+ pause delay
219+ faff delay port
232220
233221testMxRegEvents :: TestResult () -> Process ()
234222testMxRegEvents result = do
@@ -275,6 +263,7 @@ testMxRegEvents result = do
275263 reg3 `shouldBe` equalTo (Just (label, p1))
276264
277265 mapM_ (flip kill $ "test-complete") [agent, p1, p2]
266+ awaitExit agent
278267
279268testMxRegMon :: LocalNode -> TestResult () -> Process ()
280269testMxRegMon remoteNode result = do
@@ -332,99 +321,67 @@ testMxRegMon remoteNode result = do
332321 evts `shouldContain` (Just (label1, p1))
333322 evts `shouldContain` (Just (label2, p1))
334323
335− kill agent "test-complete"
324+ kill agent "test-complete" >> awaitExit agent
336325
337326ensure :: Process () -> Process () -> Process ()
338327ensure = flip finally
339328
340329testNSend :: (String -> () -> Process ())
341330 -> Maybe LocalNode
331+ -> TestResult Bool
342332 -> Process ()
343−testNSend op n = do
344− us <- getSelfPid
333+testNSend op n r = testMxSend n r $ \p1 sink -> do
345334 let delay = 5000000
346− let label = "testMxSend" ++ (show us)
335+ let label = "testMxSend"
347336 let isValid = isValidLabel n label
348337
349− testMxSend n label $ \p1 sink -> do
350− register label p1
351− reg1 <- receiveChanTimeout delay sink
352− case reg1 of
353− Just (MxRegistered pd lb)
354− | pd == p1 && isValid lb -> return ()
355− _ -> die $ "Reg-Failed: " ++ show reg1
338+ register label p1
339+ reg1 <- receiveChanTimeout delay sink
340+ case reg1 of
341+ Just (MxRegistered pd lb)
342+ | pd == p1 && isValid lb -> return ()
343+ _ -> die $ "Reg-Failed: " ++ show reg1
356344
357− op label ()
345+ op label ()
358346
359− sent <- receiveChanTimeout delay sink
360− case sent of
361− Just (MxSentToName lb by _)
362− | by == us && isValid lb -> return True
363− _ -> die $ "Send-Failed: " ++ show sent
347+ us <- getSelfPid
348+ sent <- receiveChanTimeout delay sink
349+ case sent of
350+ Just (MxSentToName lb by _)
351+ | by == us && isValid lb -> return True
352+ _ -> die $ "Send-Failed: " ++ show sent
364353
365354 where
366− isValidLabel nd l1 l2
355+ isValidLabel n l1 l2
367356 | l2 == l2 = True
368− | isJust nd = l2 == l1 ++ "@" ++ show (localNodeId $ fromJust nd)
357+ | isJust n = l2 == l1 ++ "@" ++ show (localNodeId $ fromJust n)
369358 | otherwise = False
370359
371360testSend :: (ProcessId -> () -> Process ())
372361 -> Maybe LocalNode
362+ -> TestResult Bool
373363 -> Process ()
374−testSend op n = do
375− us <- getSelfPid
376− let label = "testMxSend" ++ (show us)
377− testMxSend n label $ \p1 sink -> do
378− -- initiate a send
379− op p1 ()
380−
381− -- verify the management event
382− sent <- receiveChanTimeout 5000000 sink
383− case sent of
384− Just (MxSent pidTo pidFrom _)
385− | pidTo == p1 && pidFrom == us -> return True
386− _ -> return False
387−
388−testChan :: (SendPort () -> () -> Process ())
389− -> Maybe LocalNode
390− -> Process ()
391−testChan op n = testMxSend n "" $ \p1 sink -> do
392−
393− us <- getSelfPid
394− send p1 us
395−
396− cleared <- receiveChanTimeout 2000000 sink
397− case cleared of
398− Just (MxSent pidTo pidFrom _)
399− | pidTo == p1 && pidFrom == us -> return ()
400− _ -> die "Received uncleared Mx Event"
401−
402− chan <- receiveTimeout 5000000 [ match return ]
403− let ch' = fromMaybe (error "No reply chan received") chan
404−
364+testSend op n r = testMxSend n r $ \p1 sink -> do
405365 -- initiate a send
406− op ch' ()
366+ op p1 ()
407367
408368 -- verify the management event
369+ us <- getSelfPid
409370 sent <- receiveChanTimeout 5000000 sink
410371 case sent of
411− Just (MxSentToPort sId spId _)
412− | sId == us && spId == sendPortId ch' -> return True
413− _ -> return False
372+ Just (MxSent pidTo pidFrom _)
373+ | pidTo == p1 && pidFrom == us -> return True
374+ _ -> return False
414375
415376type SendTest = ProcessId -> ReceivePort MxEvent -> Process Bool
416377
417−testMxSend :: Maybe LocalNode -> String -> SendTest -> Process ()
418−testMxSend mNode label test = do
378+testMxSend :: Maybe LocalNode -> TestResult Bool -> SendTest -> Process ()
379+testMxSend mNode result test = do
419380 us <- getSelfPid
420− (sp, rp) <- newChan
421381 (chan, sink) <- newChan
422382 agent <- mxAgent (MxAgentId $ agentLabel us) () [
423383 mxSink $ \ev -> do
424384 case ev of
425− m@(MxSentToPort _ cid _)
426− | cid /= sendPortId chan
427− && cid /= sendPortId sp -> liftMX $ sendChan chan m
428385 m@(MxSent _ fromPid _)
429386 | fromPid == us -> liftMX $ sendChan chan m
430387 m@(MxSentToName _ fromPid _)
@@ -435,34 +392,23 @@ testMxSend mNode label test = do
435392 mxReady
436393 ]
437394
395+ (sp, rp) <- newChan
438396 case mNode of
439397 Nothing -> void $ spawnLocal (proc sp)
440398 Just remoteNode -> void $ liftIO $ forkProcess remoteNode $ proc sp
441399
442− p1 <- receiveChanTimeout 2000000 rp
443− unless (isJust p1) $ die "Timed out waiting for ProcessId"
444− res <- try $ test (fromJust p1) sink
445−
446− kill agent "bye"
447− kill (fromJust p1) "bye"
448−
400+ p1 <- receiveChan rp
401+ res <- try (test p1 sink)
449402 case res of
450− Left (ProcessExitException _ m) -> (liftIO $ putStrLn $ "SomeException-" ++ show m) >> die m
451− Right tr -> tr `shouldBe` equalTo True
452−
403+ Left (ProcessExitException _ m) -> (liftIO $ putStrLn $ "SomeException-" ++ show m) >> stash result False
404+ Right tr -> stash result tr
405+ kill agent "bye"
406+ kill p1 "bye"
453407
454408 where
409+ label = "testMxSend"
455410 agentLabel s = "mx-unsafe-check-agent-" ++ show s
456− proc sp' = getSelfPid >>= sendChan sp' >> go Nothing
457−
458− go :: Maybe (ReceivePort ()) -> Process ()
459− go Nothing = receiveTimeout 5000000 [ match replyChannel ] >>= go
460− go c@(Just c') = receiveWait [ matchChan c' return ] >> go c
461−
462− replyChannel p' = do
463− (s, r) <- newChan
464− send p' s
465− return r
411+ proc sp' = getSelfPid >>= sendChan sp' >> expect :: Process ()
466412
467413tests :: TestTransport -> IO [Test]
468414tests TestTransport{..} = do
@@ -477,7 +423,7 @@ tests TestTransport{..} = do
477423 , testCase "InterAgentBroadcast"
478424 (delayedAssertion
479425 "expected (), but no broadcast was received"
480− node1 (Just ()) testAgentBroadcast)
426+ node1 () testAgentBroadcast)
481427 , testCase "AgentMailboxHandling"
482428 (delayedAssertion
483429 "expected (Just ()), but no regular (mailbox) input was handled"
@@ -506,20 +452,19 @@ tests TestTransport{..} = do
506452 ]
507453 ]
508454 where
509− buildTestCases n1 n2 = let nid = localNodeId n2 in build n1 n2 [
455+ buildTestCases n1 n2 =
456+ let nid = localNodeId n2 in build n2 [
510457 ("NSend", [
511− ("nsend", testNSend nsend)
512− , ("Unsafe.nsend", testNSend Unsafe.nsend)
513− , ("nsendRemote", testNSend (nsendRemote nid))
458+ ("Unsafe.nsend", testNSend Unsafe.nsend)
514459 , ("Unsafe.nsendRemote", testNSend (Unsafe.nsendRemote nid))
460+ , ("nsend", testNSend nsend)
461+ , ("nsendRemote", testNSend (nsendRemote nid))
515462 ])
516463 , ("Send", [
517− ("send", testSend send)
518− , ("Unsafe.send", testSend Unsafe.send)
519− , ("usend", testSend usend)
520− , ("Unsafe.usend", testSend Unsafe.usend)
521− , ("sendChan", testChan sendChan)
522− , ("Unsafe.sendChan", testChan Unsafe.sendChan)
464+ ("Unsafe.send", testSend Unsafe.send)
465+ , ("Unsafe.usend", testSend Unsafe.usend)
466+ , ("send", testSend send)
467+ , ("usend", testSend usend)
523468 ])
524469 , ("Forward", [
525470 ("forward", testSend (\p m -> forward (unsafeCreateUnencodedMessage m) p))
@@ -528,13 +473,13 @@ tests TestTransport{..} = do
528473 ]
529474
530475 build :: LocalNode
531− -> LocalNode
532− -> [(String, [(String, (Maybe LocalNode -> Process ()))])]
476+ -> [(String, [(String, (Maybe LocalNode -> TestResult Bool -> Process ()))])]
533477 -> [Test]
534− build n ln specs =
478+ build ln specs =
535479 [ testGroup (intercalate "-" [groupName, caseSuffix]) [
536480 testCase (intercalate "-" [caseName, caseSuffix])
537− (runProcess n (caseImpl caseNode))
481+ (delayedAssertion "expected mx events failed"
482+ ln True (caseImpl caseNode))
538483 | (caseName, caseImpl) <- groupCases
539484 ]
540485 | (groupName, groupCases) <- specs
distributed-process.cabal+1−1
@@ -6,7 +6,7 @@ License: BSD3
66License-File: LICENSE
77Copyright: Well-Typed LLP, Tweag I/O Limited
88Author: Duncan Coutts, Nicolas Wu, Edsko de Vries
9−Maintainer: Tim Watson <watson.timothy@gmail.com>
9+Maintainer: Facundo Domínguez <facundo.dominguez@tweag.io>
1010Stability: experimental
1111Homepage: http://haskell-distributed.github.com/
1212Bug-Reports: https://github.com/haskell-distributed/distributed-process/issues
src/Control/Distributed/Process/Internal/Primitives.hs+1−7
@@ -307,13 +307,7 @@ expect = receiveWait [match return]
307307-- Channels --
308308--------------------------------------------------------------------------------
309309
310−-- | Create a new typed channel, bound to the calling Process
311−--
312−-- Note that the channel is bound to the lifecycle of the process that evaluates
313−-- this function, such that when it dies/exits, the channel will no longer
314−-- function, but will remain accessible. Thus reading from the ReceivePort will
315−-- fail silently thereafter, blocking indefinitely (unless a timeout is used).
316−--
310+-- | Create a new typed channel
317311newChan :: Serializable a => Process (SendPort a, ReceivePort a)
318312newChan = do
319313 proc <- ask
src/Control/Distributed/Process/Management.hs+2−34
@@ -76,40 +76,6 @@
7676--
7777-- * Whether messages will be taken from the mailbox first, or the event bus.
7878--
79−-- Since the event bus uses STM broadcast channels to communicate with agents,
80−-- no message written to the bus successfully can be lost.
81−--
82−-- Agents can also receive messages via their mailboxes - these are subject to
83−-- the same guarantees as all inter-process message sending.
84−--
85−-- Messages dispatched on an STM broadcast channel (i.e., management event bus)
86−-- are guaranteed to be delivered with the same FIFO ordering guarantees that
87−-- exist between two communicating processes, such that communication from the
88−-- node controller's threads (i.e., MxEvent's) will never be re-ordered, but
89−-- messages dispatched to the event bus by other processes (including, but not
90−-- limited to agents) are only guaranteed to be ordered between one sender and
91−-- one receiver.
92−--
93−-- No guarantee exists for the ordering in which messages sent to an agent's
94−-- mailbox will be delivered, vs messages dispatched via the event bus.
95−--
96−-- Because of the above, there are no ordering guarantees for messages sent
97−-- between agents, or for processes to agents, except for those that apply to
98−-- messages sent between regular processes, since agents are
99−-- implemented as such.
100−--
101−-- The event bus is serial and single threaded. Anything that is published by
102−-- the node controller will be seen in FIFO order. There are no ordering
103−-- guarantees pertaining to entries published to the event bus by other
104−-- processes or agents.
105−--
106−-- It should not be possible to see, for example, an @MxReceived@ before the
107−-- corresponding @MxSent@ event, since the places where we issue the @MxSent@
108−-- write directly to the event bus (using STM) in the calling (green) thread,
109−-- before dispatching instructions to the node controller to perform the
110−-- necessary routing to deliver the message to a process (or registered name,
111−-- or typed channel) locally or remotely.
112−--
11379-- [Management Data API]
11480--
11581-- Both management agents and clients of the API have access to a variety of
@@ -178,6 +144,8 @@
178144-- > monitorNames = getSelfPid >>= nsend "name-monitor"
179145-- > monitorNames2 = getSelfPid >>= mxNotify
180146--
147+-- For some real-world examples, see the distributed-process-platform package.
148+--
181149-- [Performance, Stablity and Scalability]
182150--
183151-- /Management Agents/ offer numerous advantages over regular processes: