Provide a cargo-generate template

[skade]

cargo-generate is great, we should ship a template for an async-std app with:

• a small example in src/main.rs
• an example for a test

[ansrivas]

Hi @skade I recently started using async-std and stumbled upon this issue.
Quickly brought this together, do you think this will be sufficient for this issue?
In case its fine, should I transfer it to async-rs org ?

https://github.com/ansrivas/async-std-starter

@ansrivas This looks good!

I think my further suggestions would be:

• Put everything inside main.rs rather than main.rs and hello_world.rs
• Simplify the main function so that it only has a big block_on() and then does something inside, perhaps calls say_hi().await or something like that.

@skade opinions?

[skade]

Hi @ansrivas,

sorry for missing that.

I agree with what @stjepang said and would love to move it into the async-rs org after those fixes have been made. We can still further iterate :).

[ansrivas]

Hi @stjepang, @skade thank you for the suggestions.

I incorporated them here:
https://github.com/ansrivas/async-std-starter/blob/0d62dde33acab9ef563104bf9668315c96fa0237/src/main.rs#L8

[kpp]

@ansrivas cargo new --bin creates a project with

fn main() {
    println!("Hello, world!");
}

So I "believe" what they mean is not only to return "hello world" via async fn but to print it using async_std::io::stdout. So the main should look like:

fn main() -> std::io::Result<()> {
    async_std::task::block_on(async {
        let mut stdout = async_std::io::stdout();
        stdout.write_all(b"Hello, world!").await?;

        Ok(())
    })
}

You can master it with async fn get_phrase() -> String { ... } and with tests.

Correct me if I am wrong.