Crate r3bl_rs_utils

This crate provides utility functions to do the following:

1. Non binary tree data structure that is safe to use across threads and supports parallel tree walking & processing (inspired by memory arena.
2. Kotlin inspired scope functions that make it easy to work w/ wrapped values (wrapped in std::sync::Arc<std::sync::RwLock>, or Option, etc).
3. Print colored text to the terminal. And create TUI (text user interface) applications, similar to what you can do w/ Ink, React, and TypeScript on Node.js.

Modules

async_safe_share_mutate

color_text

ANSI colorized text https://github.com/ogham/rust-ansi-term helper methods.

decl_macros

redux

tree_memory_arena

This module contains Arena a non-binary tree implementation that is thread safe, and MTArena a variant of the tree that supports parallel tree walking.

tui

This is an experimental module that isn’t ready yet. It is the first step towards creating a TUI library that can be used to create sophisticated TUI applications. This is similar to Ink library for Node.js & TypeScript (that uses React and Yoga)

utils

This module contains a lot of utility functions that are meant to:

Macros

debug

fire_and_forget

Declarative macro to surround the given block with a call to tokio::spawn. This is useful for spawning a task that will run in the background from a function that is NOT async.

make_api_call_for

Declarative macro to generate the API call functions. This adds the following:

make_safe_async_fn_wrapper

make_shareable_fn_wrapper

make_struct_safe_to_share_and_mutate

unwrap

Macros to unwrap various locks.

Traits

SafeToMutate

This trait marks a type as being safe to mutate (interior mutability) across threads (parallel safe) and tasks (async safe). These are just convenience static methods. You can simply use the read() and write() methods directly on the Arc reference.

SafeToShare

This trait marks a type as being safe to share across threads (parallel safe) and tasks (async safe).

Functions

eprint_header

print_header

Equivalent for template string literal. One way to do this using format!

style_dimmed

style_error

style_primary

style_prompt

Derive Macros

Builder