Cleanup examples

Author: Stjepan Glavina

examples/list-dir.rs

@@ -4,7 +4,10 @@
 
 use std::env::args;
 
-use async_std::{fs, io, prelude::*, task};
+use async_std::fs;
+use async_std::io;
+use async_std::prelude::*;
+use async_std::task;
 
 fn main() -> io::Result<()> {
     let path = args().nth(1).expect("missing path argument");

examples/print-file.rs

@@ -4,7 +4,10 @@
 
 use std::env::args;
 
-use async_std::{fs::File, io, prelude::*, task};
+use async_std::fs::File;
+use async_std::io;
+use async_std::prelude::*;
+use async_std::task;
 
 const LEN: usize = 4 * 1024 * 1024; // 4 Mb
 

examples/stdin-echo.rs

@@ -2,7 +2,9 @@
 
 #![feature(async_await)]
 
-use async_std::{io, prelude::*, task};
+use async_std::io;
+use async_std::prelude::*;
+use async_std::task;
 
 fn main() -> io::Result<()> {
     task::block_on(async {

examples/stdin-timeout.rs

@@ -4,7 +4,9 @@
 
 use std::time::Duration;
 
-use async_std::{io, prelude::*, task};
+use async_std::io;
+use async_std::prelude::*;
+use async_std::task;
 
 fn main() -> io::Result<()> {
     task::block_on(async {

examples/task-local.rs

@@ -4,7 +4,8 @@
 
 use std::cell::Cell;
 
-use async_std::{task, task_local};
+use async_std::prelude::*;
+use async_std::task;
 
 task_local! {
     static VAR: Cell<i32> = Cell::new(1);

examples/tcp-client.rs

@@ -14,7 +14,10 @@
 
 #![feature(async_await)]
 
-use async_std::{io, net::TcpStream, prelude::*, task};
+use async_Std::prelude::*;
+use async_std::io;
+use async_std::net::TcpStream;
+use async_std::task;
 
 fn main() -> io::Result<()> {
     task::block_on(async {

examples/tcp-echo.rs

@@ -8,8 +8,10 @@
 
 #![feature(async_await)]
 
+use async_stD::task;
+use async_std::io;
 use async_std::net::{TcpListener, TcpStream};
-use async_std::{io, prelude::*, task};
+use async_std::prelude::*;
 
 async fn process(stream: TcpStream) -> io::Result<()> {
     println!("Accepted from: {}", stream.peer_addr()?);

examples/udp-client.rs

@@ -14,7 +14,9 @@
 
 #![feature(async_await)]
 
-use async_std::{io, net::UdpSocket, task};
+use async_std::io;
+use async_std::net::UdpSocket;
+use async_std::task;
 
 fn main() -> io::Result<()> {
     task::block_on(async {

examples/udp-echo.rs

@@ -8,7 +8,9 @@
 
 #![feature(async_await)]
 
-use async_std::{io, net::UdpSocket, task};
+use async_std::io;
+use async_std::net::UdpSocket;
+use async_std::task;
 
 fn main() -> io::Result<()> {
     task::block_on(async {

src/fs/dir_entry.rs

@@ -77,7 +77,8 @@ impl DirEntry {
     /// # #![feature(async_await)]
     /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
     /// #
-    /// use async_std::{fs, prelude::*};
+    /// use async_std::fs;
+    /// use async_std::prelude::*;
     ///
     /// let mut dir = fs::read_dir(".").await?;
     ///
@@ -102,7 +103,8 @@ impl DirEntry {
     /// # #![feature(async_await)]
     /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
     /// #
-    /// use async_std::{fs, prelude::*};
+    /// use async_std::fs;
+    /// use async_std::prelude::*;
     ///
     /// let mut dir = fs::read_dir(".").await?;
     ///
@@ -155,7 +157,8 @@ impl DirEntry {
     /// # #![feature(async_await)]
     /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
     /// #
-    /// use async_std::{fs, prelude::*};
+    /// use async_std::fs;
+    /// use async_Std::prelude::*;
     ///
     /// let mut dir = fs::read_dir(".").await?;
     ///
@@ -206,7 +209,8 @@ impl DirEntry {
     /// # #![feature(async_await)]
     /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
     /// #
-    /// use async_std::{fs, prelude::*};
+    /// use async_std::fs;
+    /// use async_std::prelude::*;
     ///
     /// let mut dir = fs::read_dir(".").await?;
     ///

src/fs/read_dir.rs

@@ -1,5 +1,4 @@
 use std::fs;
-
 use std::path::Path;
 use std::pin::Pin;
 use std::sync::Mutex;
@@ -34,7 +33,8 @@ use crate::task::{blocking, Context, Poll};
 /// # #![feature(async_await)]
 /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
 /// #
-/// use async_std::{fs, prelude::*};
+/// use async_std::fs;
+/// use async_std::prelude::*;
 ///
 /// let mut dir = fs::read_dir(".").await?;
 ///

src/fs/read_to_string.rs

@@ -21,12 +21,13 @@ use crate::task::blocking;
 ///
 /// ```no_run
 /// # #![feature(async_await)]
-/// use async_std::fs::read_to_string;
+/// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
+/// #
+/// use async_std::fs;
 ///
-/// # futures::executor::block_on(async {
-/// let contents = read_to_string("a.txt").await?;
-/// # std::io::Result::Ok(())
-/// # }).unwrap();
+/// let contents = fs::read_to_string("a.txt").await?;
+/// #
+/// # Ok(()) }) }
 /// ```
 pub async fn read_to_string<P: AsRef<Path>>(path: P) -> io::Result<String> {
     let path = path.as_ref().to_owned();

src/fs/set_permissions.rs

@@ -27,7 +27,6 @@ use crate::task::blocking;
 ///
 /// let mut perm = fs::metadata("a.txt").await?.permissions();
 /// perm.set_readonly(true);
-///
 /// fs::set_permissions("a.txt", perm).await?;
 /// #
 /// # Ok(()) }) }

src/future/pending.rs

@@ -5,9 +5,10 @@
 /// # #![feature(async_await)]
 /// # fn main() { async_std::task::block_on(async {
 /// #
+/// use std::time::Duration;
+///
 /// use async_std::future::pending;
 /// use async_std::prelude::*;
-/// use std::time::Duration;
 ///
 /// let dur = Duration::from_secs(1);
 /// assert!(pending::<()>().timeout(dur).await.is_err());

src/io/buf_read.rs

@@ -49,7 +49,9 @@ pub trait BufRead {
     /// # #![feature(async_await)]
     /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
     /// #
-    /// use async_std::{fs::File, io::BufReader, prelude::*};
+    /// use async_std::fs::File;
+    /// use async_std::io::BufReader;
+    /// use async_std::prelude::*;
     ///
     /// let mut f = BufReader::new(File::open("a.txt").await?);
     ///
@@ -98,7 +100,9 @@ pub trait BufRead {
     /// # #![feature(async_await)]
     /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
     /// #
-    /// use async_std::{fs::File, io::BufReader, prelude::*};
+    /// use async_std::fs::File;
+    /// use async_std::io::BufReader;
+    /// use async_std::prelude::*;
     ///
     /// let mut f = BufReader::new(File::open("a.txt").await?);
     ///
@@ -137,7 +141,9 @@ pub trait BufRead {
     /// # #![feature(async_await)]
     /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
     /// #
-    /// use async_std::{fs::File, io::BufReader, prelude::*};
+    /// use async_std::fs::File;
+    /// use async_std::io::BufReader;
+    /// use async_std::prelude::*;
     ///
     /// let mut f = BufReader::new(File::open("a.txt").await?);
     ///

src/io/copy.rs

@@ -31,7 +31,8 @@ use crate::io;
 /// # #![feature(async_await)]
 /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
 /// #
-/// use async_std::{io, task};
+/// use async_std::io;
+/// use async_std::task;
 ///
 /// let mut reader: &[u8] = b"hello";
 /// let mut writer = io::stdout();

src/io/read.rs

@@ -55,7 +55,8 @@ pub trait Read {
     /// # #![feature(async_await)]
     /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
     /// #
-    /// use async_std::{fs::File, prelude::*};
+    /// use async_std::fs::File;
+    /// use async_std::prelude::*;
     ///
     /// let mut f = File::open("a.txt").await?;
     ///
@@ -104,7 +105,8 @@ pub trait Read {
     /// # #![feature(async_await)]
     /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
     /// #
-    /// use async_std::{fs::File, prelude::*};
+    /// use async_std::fs::File;
+    /// use async_std::prelude::*;
     ///
     /// let mut f = File::open("a.txt").await?;
     ///
@@ -141,7 +143,8 @@ pub trait Read {
     /// # #![feature(async_await)]
     /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
     /// #
-    /// use async_std::{fs::File, prelude::*};
+    /// use async_std::fs::File;
+    /// use async_std::prelude::*;
     ///
     /// let mut f = File::open("a.txt").await?;
     ///
@@ -193,7 +196,8 @@ pub trait Read {
     /// # #![feature(async_await)]
     /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
     /// #
-    /// use async_std::{fs::File, prelude::*};
+    /// use async_std::fs::File;
+    /// use async_std::prelude::*;
     ///
     /// let mut f = File::open("a.txt").await?;
     ///

src/io/seek.rs

@@ -47,7 +47,9 @@ pub trait Seek {
     /// # #![feature(async_await)]
     /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
     /// #
-    /// use async_std::{fs::File, io::SeekFrom, prelude::*};
+    /// use async_std::fs::File;
+    /// use async_std::io::SeekFrom;
+    /// use async_std::prelude::*;
     ///
     /// let mut f = File::open("a.txt").await?;
     ///

src/io/stderr.rs

@@ -19,7 +19,8 @@ use crate::task::{blocking, Context, Poll};
 /// # #![feature(async_await)]
 /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
 /// #
-/// use async_std::{io, prelude::*};
+/// use async_std::io;
+/// use async_std::prelude::*;
 ///
 /// let mut stderr = io::stderr();
 /// stderr.write_all(b"Hello, world!").await?;

src/io/stdin.rs

@@ -93,14 +93,15 @@ impl Stdin {
     ///
     /// ```no_run
     /// # #![feature(async_await)]
-    /// use async_std::io::stdin;
+    /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
+    /// #
+    /// use async_std::io;
     ///
-    /// # futures::executor::block_on(async {
-    /// let stdin = stdin();
+    /// let stdin = io::stdin();
     /// let mut line = String::new();
     /// stdin.read_line(&mut line).await?;
-    /// # std::io::Result::Ok(())
-    /// # }).unwrap();
+    /// #
+    /// # Ok(()) }) }
     /// ```
     pub async fn read_line(&self, buf: &mut String) -> io::Result<usize> {
         future::poll_fn(|cx| {

src/io/stdout.rs

@@ -19,7 +19,8 @@ use crate::task::{blocking, Context, Poll};
 /// # #![feature(async_await)]
 /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
 /// #
-/// use async_std::{io, prelude::*};
+/// use async_std::io;
+/// use async_std::prelude::*;
 ///
 /// let mut stdout = io::stdout();
 /// stdout.write_all(b"Hello, world!").await?;

src/io/write.rs

@@ -50,7 +50,8 @@ pub trait Write {
     /// # #![feature(async_await)]
     /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
     /// #
-    /// use async_std::{fs::File, prelude::*};
+    /// use async_std::fs::File;
+    /// use async_std::prelude::*;
     ///
     /// let mut f = File::create("a.txt").await?;
     ///
@@ -70,7 +71,8 @@ pub trait Write {
     /// # #![feature(async_await)]
     /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
     /// #
-    /// use async_std::{fs::File, prelude::*};
+    /// use async_std::fs::File;
+    /// use async_std::prelude::*;
     ///
     /// let mut f = File::create("a.txt").await?;
     ///
@@ -115,7 +117,8 @@ pub trait Write {
     /// # #![feature(async_await)]
     /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
     /// #
-    /// use async_std::{fs::File, prelude::*};
+    /// use async_std::fs::File;
+    /// use async_std::prelude::*;
     ///
     /// let mut f = File::create("a.txt").await?;
     ///

src/net/tcp/listener.rs

@@ -33,7 +33,9 @@ use crate::task::{Context, Poll};
 /// # #![feature(async_await)]
 /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
 /// #
-/// use async_std::{io, net::TcpListener, prelude::*};
+/// use async_std::io;
+/// use async_std::net::TcpListener;
+/// use async_std::prelude::*;
 ///
 /// let listener = TcpListener::bind("127.0.0.1:8080").await?;
 /// let mut incoming = listener.incoming();
@@ -173,7 +175,8 @@ impl TcpListener {
     /// # #![feature(async_await)]
     /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
     /// #
-    /// use async_std::{net::TcpListener, prelude::*};
+    /// use async_std::net::TcpListener;
+    /// use async_std::prelude::*;
     ///
     /// let listener = TcpListener::bind("127.0.0.1:0").await?;
     /// let mut incoming = listener.incoming();