feat: add way to block on async to from sync code

Wraps function for futures crate to block on an async task

Author: c-git

Cargo.toml

@@ -14,6 +14,7 @@ description = "Wrapper around reqwest for use in both native and wasm"
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
 
 [dependencies]
+futures = "0.3.28"
 reqwest = { version = "0.12.3", default-features = false }
 
 # For native compilation
@@ -27,7 +28,6 @@ js-sys = { version = "0.3.69", optional = true }
 web-sys = { version = "0.3.69", optional = true }
 
 [dev-dependencies]
-futures = "0.3.28"
 reqwest = { version = "0.12.3" }
 wasm-bindgen-test = "0.3.34"
 

src/lib.rs

@@ -75,4 +75,6 @@ pub use wrappers::fetch;
 #[cfg(feature = "yield_now")]
 pub use yield_::yield_now;
 
+pub use wrappers::block_on;
+
 pub use reqwest::Client; // Exported to make it easier to use without a second import and maintain semver

src/wrappers.rs

@@ -43,4 +43,14 @@ where
     crate::wasm::fetch(request, on_done);
 }
 
+/// Provides a cross platform compatible way to run an async function in a blocking fashion.
+/// Intended for use in callbacks as this will block but call backs are not async so we need sync code
+pub fn block_on<F>(future: F) -> F::Output
+where
+    F: std::future::Future + Send + 'static,
+    F::Output: Send + 'static,
+{
+    futures::executor::block_on(future)
+}
+
 // TODO 3: Test link in documentation after pushing to main