Macro conquer_future

conquer_future!() { /* proc-macro */ }

Macro function to use for resolving the futures concurrently, for fields of struct and returning the struct itself.

Example

Following is a usecase where we are trying to get the some details from some async functions, but don’t wish to write all the boilerplate code for it. conquer_future internally uses tokio::join to achieve concurrent execution.

#[derive(PartialEq, Debug)]
struct Contact {
    name: String,
    phone_no: String,
    address: String,

}

#[tokio::main]
async fn main() {
    let contact = conquer_struct::conquer_future!(Contact {
        name: "John Doe".to_string(),
        phone_no: async { get_contact_no().await },
        address: async { get_address().await }
    }).await;

    assert_eq!(contact, Contact { name: "John Doe".to_string(), phone_no:
    "1234567890".to_string(), address: "221B Baker Street".to_string() })
}
async fn get_contact_no() -> String { "1234567890".to_string() }
async fn get_address() -> String { "221B Baker Street".to_string() }

---

In case you haven’t provided any async field to the struct within the macro, the macro will throw a compile time error, not to use the macro. As the macro internally creates a new async { } block to store the code that is generated, in case of no async execution this creates a redundant future.

#[derive(PartialEq, Debug)]
struct Contact {
    name: String,
    phone_no: String,
    address: String,

}

#[tokio::main]
async fn main() {
    let contact = conquer_struct::conquer_future!(Contact {
        name: "John Doe".to_string(),
        phone_no: "1234567890".to_string(),
        address: "221B Baker Street".to_string(),
    }).await;
}