Crates.io | syncify |
lib.rs | syncify |
version | 0.1.0 |
source | src |
created_at | 2024-07-30 12:53:24.268301 |
updated_at | 2024-07-30 12:53:24.268301 |
description | A simple macro for writing async functions once and getting both the async version and a sync version that strips all async function modifiers and all .await suffixes. |
homepage | |
repository | https://github.com/worm-blossom/syncify |
max_upload_size | |
id | 1319771 |
size | 17,459 |
Two functions for the price of one: a simplistic rust macro for writing async functions once and getting both the async version and a sync version that strips all async
function modifiers and all .await
suffixes.
Status: it works, but this is not intended to be a high-quality, general-purpose crate. The macro error messages are bad, the features are barebones. But it does what we need it to do, and that suffices.
Place the #[syncify(name_of_sync_mod_variant)]
on a mod
item. Annotate all use
items inside that mod
that should be different in the sync version with #[syncify_replace(<alternate-use-item>)]
.
Example:
use syncify::syncify;
use syncify::syncify_replace;
#[syncify(greet_sync)]
mod greet {
#[syncify_replace(use crate::speaking_sync::speak;)] // A sync function for speaking.
use crate::speaking::speak; // An async function for speaking.
pub async fn do_greet(name: &str) -> usize {
speak(name).await;
return name.len();
}
}
Expands to:
use syncify::syncify;
use syncify::syncify_replace;
mod greet {
use crate::speaking::speak; // An async function for speaking.
pub async fn do_greet(name: &str) -> usize {
speak(name).await;
return name.len();
}
}
mod greet_sync {
use crate::speaking_sync::speak; // A sync function for speaking.
pub fn do_greet(name: &str) -> usize {
speak(name);
return name.len();
}
}