tree: 7a9793f466aafc995f9b632905a7dbd7bfd283ab [path history] [tgz]
  1. include/
  2. tests/
  3. barrier.cc
  4. BUILD.gn
  5. fit-promise.api
  6. promise.cc
  7. README.md
  8. scheduler.cc
  9. scope.cc
  10. sequencer.cc
  11. single_threaded_executor.cc
sdk/lib/fit-promise/README.md

fit-promise library

This was formerly part of the lib/fit library. Further migrations and renamings are expected.

fit::promise, fit::future, fit::executor, etc.

  • When writing asynchronous event-driven programs, it's convenient to be able to stage a sequence of asynchronous tasks. This tends to be challenging to implement in a callback-driven manner due to object lifetime issues, so we would like an alternative pattern that is easier to apply correctly, such as by expressing asynchronous logic as a compositions of futures.
  • The C++ 14 standard library offers std::future but it is tied to a thread-based execution model. Awaiting a future requires blocking, which is bad for event loops.
  • So libfit offers a family of APIs that work better with event loops.