#sync #automatic #async #macro #run-time #tokio #function

also_sync

Macros to automatically wrap async functions as sync

1 unstable release

0.1.0 Feb 20, 2024

#2595 in Rust patterns

MIT license

14KB

Also Sync

This library provides a macro to automatically derive a *_sync version from your async functions. It does so by having a global tokio runtime with all features on all cores.

This allows a async-first library development while supporting sync.

How does it work?

Take a look at the following piece of code:

use also_sync::also_sync;

struct Struct;

impl Struct {
    #[also_sync]
    pub async fn foo(&self, a: i32) -> i32 {
        42 * a
    }
}

This is literally just converted to

struct Struct;

impl Struct {
    pub async fn foo(&self, a: i32) -> i32 {
        42
    }
    pub fn foo_sync(&self: a: i32) -> i32 {
        let handle = also_sync::TOKIO_RUNTIME.handle();
        handle.block_on(async move { self.foo(a).await })
    }
}

Of course if works for simple functions as well.

Dependencies

~2.6–8.5MB
~74K SLoC