#immediate-mode #lazy-evaluation #tokio #egui #future #primitive #data

lazy_async_promise

Primitives for lazily getting data from futures with tokio for immediate mode guis

8 releases (4 breaking)

0.5.0 May 29, 2023
0.4.0 Mar 22, 2023
0.4.0-RC1 Jan 12, 2023
0.3.1 Nov 10, 2022
0.1.2 Oct 8, 2022

#863 in Algorithms

Download history 76/week @ 2024-04-22 148/week @ 2024-04-29 100/week @ 2024-05-06 226/week @ 2024-05-13 198/week @ 2024-05-20 256/week @ 2024-05-27 529/week @ 2024-06-03 182/week @ 2024-06-10 183/week @ 2024-06-17 321/week @ 2024-06-24 145/week @ 2024-07-01 74/week @ 2024-07-08 77/week @ 2024-07-15 128/week @ 2024-07-22 132/week @ 2024-07-29 403/week @ 2024-08-05

740 downloads per month

MIT license

50KB
858 lines

lazy_async_promise: Simple primitives to manage tokio and egui

Documentation CI Coverage Status License

This crate currently only features simple primitives for getting computation time off the main thread using tokio:

  • LazyVecPromise for a vector-backed storage which can be displayed while the task in progress.
  • LazyValuePromise for a single value future that can be updated during task-progress. My usage was for iterative algorithms where the intermediate results were interesting for display.

As the name suggests the two of them are lazily evaluated and nothing happens until they are polled for the first time.

For single values which are either available or not there's ImmediateValuePromise which triggers computation immediately. There's not in-calculation value read out, so either it's finished or not. After heavy usage, I currently tend to use ImmediateValuePromise wrapped in Option for most lazy values, too. Especially when no intermediate values are needed, it's technically sufficient and simpler. Also, since 0.4.0 it's very convenient to use now, see the docs for examples.

Another example usage of this crate with a small egui/eframe blog-reader can be found here

Changelog:

0.5.0

  • Fixed visibility issues with BoxSendError (thanks @aspcartman)
  • Added progress tracked wrapper for immediate value promise (made lazyvaluepromise obsolete at least for me)
  • Updated documentation

0.4.0:

  • Added more flexible API to lazy and immediate structures, allowing to take the values
  • Added DirectCacheAccess trait to make option-based usage of the immediate value promise more convenient
  • Updated documentation

0.3.1:

  • Add better api macros for lazy structures

0.3.0:

  • Removed into_boxed trait in favor of supporting the regular From trait which allows direct usage of the ?-Operator in ImmediateValuePromise
  • Added a progress indicator for the LazyVecPromise and LazyValuePromise
  • Indication is done by Progress strong type which ensures values between 0.0 and 1.0
  • Added CI for mac, windows and linux - had to give test-timings more leeway for mac os than on linux.

Dependencies

~2–3MB
~47K SLoC