migrate: std::net::ToSocketAddrs -> async_std::net::ToSocketAddrs

Author: DCjanus

docs/src/tutorial/accept_loop.md

@@ -6,23 +6,20 @@ First of all, let's add required import boilerplate:
 
 ```rust,edition2018
 # extern crate async_std;
-use std::net::ToSocketAddrs; // 1
 use async_std::{
-    prelude::*, // 2
-    task, // 3
-    net::TcpListener, // 4
+    prelude::*, // 1
+    task, // 2
+    net::{TcpListener, ToSocketAddrs}, // 3
 };
 
-type Result<T> = std::result::Result<T, Box<dyn std::error::Error + Send + Sync>>; // 5
+type Result<T> = std::result::Result<T, Box<dyn std::error::Error + Send + Sync>>; // 4
 ```
 
-1. `async_std` uses `std` types where appropriate.
-   We'll need `ToSocketAddrs` to specify address to listen on.
-2. `prelude` re-exports some traits required to work with futures and streams.
-3. The `task` module roughly corresponds to the `std::thread` module, but tasks are much lighter weight.
+1. `prelude` re-exports some traits required to work with futures and streams.
+2. The `task` module roughly corresponds to the `std::thread` module, but tasks are much lighter weight.
    A single thread can run many tasks.
-4. For the socket type, we use `TcpListener` from `async_std`, which is just like `std::net::TcpListener`, but is non-blocking and uses `async` API.
-5. We will skip implementing comprehensive error handling in this example.
+3. For the socket type, we use `TcpListener` from `async_std`, which is just like `std::net::TcpListener`, but is non-blocking and uses `async` API.
+4. We will skip implementing comprehensive error handling in this example.
    To propagate the errors, we will use a boxed error trait object.
    Do you know that there's `From<&'_ str> for Box<dyn Error>` implementation in stdlib, which allows you to use strings with `?` operator?
 
@@ -31,10 +28,9 @@ Now we can write the server's accept loop:
 ```rust,edition2018
 # extern crate async_std;
 # use async_std::{
-#     net::TcpListener,
+#     net::{TcpListener, ToSocketAddrs},
 #     prelude::Stream,
 # };
-# use std::net::ToSocketAddrs;
 #
 # type Result<T> = std::result::Result<T, Box<dyn std::error::Error + Send + Sync>>;
 #
@@ -69,11 +65,10 @@ Finally, let's add main:
 ```rust,edition2018
 # extern crate async_std;
 # use async_std::{
-#     net::TcpListener,
+#     net::{TcpListener, ToSocketAddrs},
 #     prelude::Stream,
 #     task,
 # };
-# use std::net::ToSocketAddrs;
 #
 # type Result<T> = std::result::Result<T, Box<dyn std::error::Error + Send + Sync>>;
 #

docs/src/tutorial/all_together.md

@@ -7,7 +7,7 @@ At this point, we only need to start the broker to get a fully-functioning (in t
 # extern crate futures;
 use async_std::{
     io::{self, BufReader},
-    net::{TcpListener, TcpStream},
+    net::{TcpListener, TcpStream, ToSocketAddrs},
     prelude::*,
     task,
 };
@@ -17,7 +17,6 @@ use futures::{
 };
 use std::{
     collections::hash_map::{HashMap, Entry},
-    net::ToSocketAddrs,
     sync::Arc,
 };
 

docs/src/tutorial/clean_shutdown.md

@@ -25,7 +25,7 @@ Let's add waiting to the server:
 # extern crate futures;
 # use async_std::{
 #     io::{self, BufReader},
-#     net::{TcpListener, TcpStream},
+#     net::{TcpListener, TcpStream, ToSocketAddrs},
 #     prelude::*,
 #     task,
 # };
@@ -35,7 +35,6 @@ Let's add waiting to the server:
 # };
 # use std::{
 #     collections::hash_map::{HashMap, Entry},
-#     net::ToSocketAddrs,
 #     sync::Arc,
 # };
 #
@@ -160,7 +159,7 @@ And to the broker:
 # extern crate futures;
 # use async_std::{
 #     io::{self, BufReader},
-#     net::{TcpListener, TcpStream},
+#     net::{TcpListener, TcpStream, ToSocketAddrs},
 #     prelude::*,
 #     task,
 # };
@@ -170,7 +169,6 @@ And to the broker:
 # };
 # use std::{
 #     collections::hash_map::{HashMap, Entry},
-#     net::ToSocketAddrs,
 #     sync::Arc,
 # };
 #

docs/src/tutorial/handling_disconnection.md

@@ -121,13 +121,12 @@ The final code looks like this:
 # extern crate futures;
 use async_std::{
     io::{BufReader, BufRead, Write},
-    net::{TcpListener, TcpStream},
+    net::{TcpListener, TcpStream, ToSocketAddrs},
     task,
 };
 use futures::{channel::mpsc, future::Future, select, FutureExt, SinkExt, StreamExt};
 use std::{
     collections::hash_map::{Entry, HashMap},
-    net::ToSocketAddrs,
     sync::Arc,
 };
 

docs/src/tutorial/implementing_a_client.md

@@ -19,11 +19,10 @@ With async, we can just use the `select!` macro.
 # extern crate futures;
 use async_std::{
     io::{stdin, BufRead, BufReader, Write},
-    net::TcpStream,
+    net::{TcpStream, ToSocketAddrs},
     task,
 };
 use futures::{select, FutureExt, StreamExt};
-use std::net::ToSocketAddrs;
 
 type Result<T> = std::result::Result<T, Box<dyn std::error::Error + Send + Sync>>;
 

docs/src/tutorial/receiving_messages.md

@@ -11,11 +11,10 @@ We need to:
 # extern crate async_std;
 # use async_std::{
 #     io::{BufRead, BufReader},
-#     net::{TcpListener, TcpStream},
+#     net::{TcpListener, TcpStream. ToSocketAddrs},
 #     prelude::Stream,
 #     task,
 # };
-# use std::net::ToSocketAddrs;
 #
 # type Result<T> = std::result::Result<T, Box<dyn std::error::Error + Send + Sync>>;
 #
@@ -77,11 +76,10 @@ We can "fix" it by waiting for the task to be joined, like this:
 # extern crate async_std;
 # use async_std::{
 #     io::{BufRead, BufReader},
-#     net::{TcpListener, TcpStream},
+#     net::{TcpListener, TcpStream, ToSocketAddrs},
 #     prelude::Stream,
 #     task,
 # };
-# use std::net::ToSocketAddrs;
 #
 # type Result<T> = std::result::Result<T, Box<dyn std::error::Error + Send + Sync>>;
 #