More examples about rust-c-ares HOT 3 CLOSED

I had a go at coming up with the simplest possible example. I wanted to write something like this:

fn main() {
    // Perform a query, getting the result as a future.
    let mut resolver = SomeResolverObject::new(); // Probably passing in some c_ares::Options
    let future_results = resolver.a_query_as_future("apple.com");

    // Do some other stuff here while we wait
    // ...

    // Now we need the resolved adress, so block on it.
    print_a_results(future_results.into_inner());
}

Then I realised Futures aren't possible in the current Rust, so had the query_as_future return a function instead, which blocks for the result.

Anyway, long story short, I don't think the current API makes this very easy - I think you still need to faff around with file process_fd, ares_timeout etc. to get any callbacks from c-ares. I've not got that far yet, but do you agree that it's desirable to have the API abstract away more of the c-ares grunge, or does this go contrary to your intentions?

WIP example at CJTozer/rust-c-ares@8dc4474 in case you're interested...

from rust-c-ares.

I wouldn't want to remove the current API, but I'd be very happy to have a way of using the library without doing so much work.

Suggest: work on something in examples for now - as you are doing - and if and when you get something that looks nice we'll work out whether we just leave it there, or incorporate something into the API on this crate, or release the nice wrapper as its own crate, or what.

Possibly useful things to look at:

• mioco is built on mio and "allows handling asynchronous and scalable IO inside coroutines, simplifying the handling logic". I've only looked at this briefly and so far completely failed to understand, but the description sounds like something useful.
• eventual comes from the same guy as mio; looks like it provides futures if that's what you want

from rust-c-ares.

Closing.

I might yet write more examples at some point, and I'd surely accept pull requests containing nice examples. But I've nothing currently planned, and the existing examples give pretty good coverage of how I imagine the API being used.

from rust-c-ares.