https://github.com/sheyll/unliftio-messagebox
Fast and reliable message queues
https://github.com/sheyll/unliftio-messagebox
concurrent-processes
Last synced: 19 days ago
JSON representation
Fast and reliable message queues
- Host: GitHub
- URL: https://github.com/sheyll/unliftio-messagebox
- Owner: sheyll
- License: bsd-2-clause
- Created: 2020-12-07T05:33:38.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2021-06-22T21:55:12.000Z (over 4 years ago)
- Last Synced: 2025-10-21T13:58:56.406Z (5 months ago)
- Topics: concurrent-processes
- Language: HTML
- Homepage:
- Size: 16 MB
- Stars: 4
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/sheyll/unliftio-messagebox/actions)
[](https://github.com/sheyll/unliftio-messagebox/actions)
# Fast and Robust Message Queues for Concurrent Processes
**NOTE:** To be able to fully view this README, use the [GitHub Pages Version](https://sheyll.github.io/unliftio-messagebox/).
* [API docs](./generated-reports/haddock-report/unliftio-messagebox)
* [API docs on Hackage](http://hackage.haskell.org/package/unliftio-messagebox)
A thin wrapper around a subset of `unagi-chan` based on `unliftio`.
The unit tests and benchmarks in this project excercise a subset
of `unagi-chan`, so hopefully the user of this library doesn't
have to worry about this.
This project also aims to implicitly verify parts of `unagi-chan`.
The overall goal is to reduce the risk of live and dead locks and
thread starvation, as well as acceptable performance
even in massively concurrent programs.
## Module Structure
The library is contained in modules with names starting with
**UnliftIO.MessageBox**.
Also the module
`UnliftIO.MessageBox` [(API docs)](./generated-reports/haddock-report/unliftio-messagebox/UnliftIO-MessageBox.html)
[(Hackage)](http://hackage.haskell.org/package/unliftio-messagebox/docs/UnliftIO-MessageBox.html)
exposes the API, and can be used to import everything.
The full documentation is either [on this page](./generated-reports/haddock-report/unliftio-messagebox/index.html)[(build log)](./generated-reports/haddock-report/build.log)
or on [Hackage](http://hackage.haskell.org/package/unliftio-messagebox).
## Benchmarks
* [Single Core Results](./generated-reports/benchmark-report/benchmark-1-CORES.html)
* [Multi Core Results](./generated-reports/benchmark-report/benchmark-ALL-CORES.html)
## Unit Tests
* [Test Results](./generated-reports/test-profiling-report/test-result.html)
* [Test Coverage](./generated-reports/test-coverage-report/hpc_index.html)
### Heap Profiling
### Time Profiling
[Test Profiling Report](./generated-reports/test-profiling-report/unliftio-messagebox-test.prof)
## Memory Leak Tests
This is a small application with a 1002 processes, each performing a fix amount of
work.
When the work is done, all processes synchronise before starting a new iteration.
After each iteration, the memory usage is queried from the GHC runtime
statistics.
There are 10 iterations like that.
After that all processes are shutdown, and the process
starts all over again, 5 times.
In total 50 iterations.
If memory is leaked it should become visible.
The test program is executed with the `+RTS -Mxxxm` option that instructs
the runtime to limit the available heap to `xxx` MB, so if there is a memory
leak, the program would at some point crash with a heap exhaustion error.
The output is printed into [this log file](./generated-reports/messagebox-memleak-test-report/test.log).