The 'libunifex' project is a prototype implementation of the C++ sender/receiver async programming model that is currently being considered for standardisation.
This project contains implementations of the following: * Schedulers * Timers * Asynchronous I/O (Linux w/ io_uring) * Algorithms that encapsulate certain concurrency patterns * Async streams * Cancellation * Coroutine integration
This project is still evolving and should be considered experimental in nature. No guarantee is made for API or ABI stability.
A recent compiler that supports C++17 or later. Libunifex is known to work with the following compilers:
This library also supports C++20 coroutines. You will need to compile with coroutine support enabled if you want to use the coroutine integrations. This generally means adding
-fcoroutines-tson Clang (see "Configuring" below).
Note that MSVC 2019.6 support for C++20 coroutines has known issues and is not currently supported.
The io_uring support on Linux requires a recent kernel version (5.6 or later).
The io_uring support depends on liburing: https://github.com/axboe/liburing/
windows_thread_poolexecutor requires Windows Vista or later.
This project can be built using CMake.
The examples below assume using the Ninja build system. You can use other build systems supported by CMake.
First generate the build files under the
From the libunifex project root:
cmake -G Ninja -H. -Bbuild \ -DCMAKE_CXX_COMPILER:PATH=/path/to/compiler
By default, this builds libunifex in C++17 without coroutines. If you want to turn on coroutines with clang, add:
To use libc++ with clang, which has coroutine support, you should also add:
-DCMAKE_CXX_FLAGS:STRING=-stdlib=libc++ \ -DCMAKE_EXE_LINKER_FLAGS:STRING="-L/path/to/libc++/lib"
If you want to build libunifex as C++20, add:
To build the library and tests.
Once the tests have been built you can run them.
sh ninja test
This project is made available under the Apache License, version 2.0.
See LICENSE.txt for details.
C++ standardisation papers: * P0443R13 "A Unified Executors Proposal for C++" * ...