async/await errors should not discuss "yield statements"

[sophiajt]

Awesome to see async/await starting to light up. I poked around and hit a snag putting together a naive little example. Clearly, this example is probably missing a bit more to get it running, but I just wanted to point the error here doesn't quite help:

#![feature(arbitrary_self_types, async_await, await_macro, futures_api, pin)]

async fn inc(limit: i64) -> i64 {
    limit + 1
}

fn main() {
    let result = inc(10000);
    let finished = await!(result);
}

For the above, you get:

error[E0627]: yield statement outside of generator literal
  --> src/main.rs:22:20
   |
22 |     let finished = await!(result);
   |                    ^^^^^^^^^^^^^^
   |
   = note: this error originates in a macro outside of the current crate (in Nightly builds, run with -Z external-macro-backtrace for more info)

Which immediately makes you wonder "what yield statement?" I suspect one of the first things people will want to try is awaiting an async function, so we might want to gently point them in the right direction.

cc @estebank @cramertj

[cramertj]

@jonathandturner Ugh-- thanks for pointing this out! This is an annoying result of the fact that await is currently implemented as a plain-old macro rather than something that hooks into the compiler. Error messages should be much better when await is built-in.

cc @eddyb

[eddyb]

Closely related to #51719.

[brandonros]

@jonathandturner What ended up being the working code?

[eddyb]

@brandonros You need to keep await! only in async fns. To actually execute async fns you want the futures crate (possibly futures-preview, not sure), or, more likely, tokio's event loop.
cc @alexcrichton

[brandonros]

@eddyb I apologize for the extreme lack of knowledge on the topic as I am still a beginner, but I am curious and excited to give Rust a shot once I understand how to use async/await. I am struggling to find any kind of clear example on the Internet (probably because all of this is still so fresh)

Are you saying it is not possible to call await! in main? Is it possible to make main async?

Regarding the futures create, I was under the impression all of the necessary moving pieces for futures/async/await were being brought in to the Rust compiler + standard library so that no external crates would be required.

Can somebody post a full example of what a simple "Hello world" level async/await/futures function would look like (including its invocation from main?)

This is the closest I can come up with what seems it might be in the right direction is

#![feature(async_await, await_macro, futures_api)]

use std::task::Executor;

async fn inc(limit: i64) -> i64 {
    limit + 1
}

async fn run() {
  let result = await!(inc(10000));

  println!("{}", result);
}

fn main() {
  Executor::spawn_obj(&self, run);
}

but this does not compile for many obvious reasons. I feel there isn't any documentation out there that shows how to piece together the new async/await language features with the new std::future library. I think a working example of the pasted above code would be pretty big for the "beginner" community trying to get on board with Rust and not be fragmented between the many different ways to do async code that currently exist (and are most likely outdated/going to get phased out it sounds like with these new RFCs)

[eddyb]

@brandonros I expect any practical usecase would still involve a tokio dependency (which would implement the executor & waker, for integrating async I/O and other async functionality).
This is a bit offtopic though, I'm guessing you also asked on reddit? That's a better discussion place.

[gilescope]

Would some wording like this work:
"yield statement outside of generator literal (Maybe async called from a non-async context?)"