Control.Concurrent.CHP.Traces.Structural

Description

This module contains support for structural traces. Structural traces reflect the parallel composition of your program. Effectively, each process records its own local trace. Parallel traces are then merged as parallel compositions, and you end up with a big tree of sequentially and parallel-composed traces. Note that in this tracing style, unlike CSP and VCR, events are recorded by every process involved in them, not just once per occurrence.

Synopsis

newtype StructuralTrace = StructuralTrace (ChannelLabels, Maybe (EventHierarchy RecordedIndivEvent))

data EventHierarchy a

= SingleEvent a

| StructuralSequence Int [EventHierarchy a]

| StructuralParallel [EventHierarchy a]

runCHP_StructuralTrace :: CHP a -> IO (Maybe a, StructuralTrace)

runCHP_StructuralTraceAndPrint :: CHP a -> IO ()

getAllEventsInHierarchy :: EventHierarchy a -> [a]

Documentation

newtype StructuralTrace

Source

A nested (or hierarchical) trace. The trace is an event hierarchy, wrapped in a Maybe type to allow for representation of the empty trace (Nothing).

Constructors

StructuralTrace (ChannelLabels, Maybe (EventHierarchy RecordedIndivEvent))

Instances

Show StructuralTrace

Trace StructuralTrace

data EventHierarchy a

Source

A data type representing a hierarchy of events. The count on the StructuralSequence count is a replicator count for that list of sequential items.

Constructors

SingleEvent a
StructuralSequence Int [EventHierarchy a]
StructuralParallel [EventHierarchy a]

Instances

Functor EventHierarchy

runCHP_StructuralTrace :: CHP a -> IO (Maybe a, StructuralTrace)

Source

runCHP_StructuralTraceAndPrint :: CHP a -> IO ()

Source

getAllEventsInHierarchy :: EventHierarchy a -> [a]

Source

Flattens the events into a list. The resulting list may contain duplicates, and it should not be assumed that the order relates in any way to the original hierarchy.

Produced by Haddock version 2.4.2