move examples/ to demo/

Cargo.toml

@@ -11,7 +11,6 @@ documentation = "https://docs.rs/smol"
 keywords = ["async", "await", "future", "io", "networking"]
 categories = ["asynchronous", "concurrency", "network-programming"]
 readme = "README.md"
-autoexamples = false
 
 [features]
 # Optional feature for seamless integration with crates depending on tokio.
@@ -53,5 +52,6 @@ tempfile = "3.1.0"
 [workspace]
 members = [
   ".",
-  "examples",
+  "demos",
 ]
+default-members = [ "demos" ]

README.md

@@ -20,11 +20,11 @@ and is only 1500 lines of code long.
 
 [std]: https://docs.rs/std
 
-Reading the [docs] or looking at the [examples] is a great way to start learning
+Reading the [docs] or looking at the [demos] is a great way to start learning
 async Rust.
 
 [docs]: https://docs.rs/smol
-[examples]: ./examples
+[demos]: ./demos
 
 Async I/O is implemented using [epoll] on Linux/Android, [kqueue] on
 macOS/iOS/BSD, and [wepoll] on Windows.
@@ -42,14 +42,14 @@ macOS/iOS/BSD, and [wepoll] on Windows.
 * Tasks that support cancelation.
 * Userspace timers.
 
-## Examples
+## Demos
 
-You need to be in the [examples] directory to run them:
+There is a number of demos in the Git repo,
+and you can run them with the `--bin` option,
+example...
 
 ```terminal
-$ cd examples
-$ ls
-$ cargo run --example ctrl-c
+$ cargo run --bin ctrl-c
 ```
 
 ## Compatibility

examples/Cargo.toml → demos/Cargo.toml

@@ -1,5 +1,5 @@
 [package]
-name = "smol-examples"
+name = "smol-demos"
 version = "0.0.0"
 authors = ["Stjepan Glavina <[email protected]>"]
 edition = "2018"
@@ -8,116 +8,116 @@ publish = false
 [target.'cfg(windows)'.dev-dependencies]
 uds_windows = "0.1.4"
 
-[target.'cfg(target_os = "linux")'.dev-dependencies]
-inotify = { version = "0.8.2", default-features = false }
-nix = "0.17.0"
+[target.'cfg(target_os = "linux")'.dependencies]
+inotify = { version = "0.8", default-features = false }
+nix = "0.17"
 timerfd = "1.1.1"
 
-[dev-dependencies]
-anyhow = "1.0.28"
-async-h1 = "1.1.2"
-async-native-tls = "0.3.3"
-async-std = "1.5.0"
-async-tungstenite = { version = "0.4.2", features = ["async-native-tls"] }
-base64 = "0.12.0"
-ctrlc = "3.1.4"
-futures = "0.3.4"
-http = "0.2.1"
-http-types = "1.2.0"
-hyper = { version = "0.13.5", default-features = false, features = ["stream"] }
-native-tls = "0.2.4"
-num_cpus = "1.13.0"
-piper = "0.1.1"
-reqwest = "0.10.4"
-scraper = "0.11.0"
-signal-hook = "0.1.13"
+[dependencies]
+anyhow = "1"
+async-h1 = "1"
+async-native-tls = "0.3"
+async-std = "1"
+async-tungstenite = { version = "0.4", features = ["async-native-tls"] }
+base64 = "0.12"
+ctrlc = "3"
+futures = "0.3"
+http = "0.2"
+http-types = "1"
+hyper = { version = "0.13", default-features = false, features = ["stream"] }
+native-tls = "0.2"
+num_cpus = "1"
+piper = "0.1"
+reqwest = "0.10"
+scraper = "0.11"
+signal-hook = "0.1"
 smol = { path = "../", features = ["tokio02"] }
-surf = { version = "2.0.0-alpha.1", default-features = false, features = ["h1-client"] }
-tempfile = "3.1.0"
-tokio = { version = "0.2.18", default-features = false }
-tungstenite = "0.10.1"
-url = "2.1.1"
+surf = { version = "2.0.0-alpha", default-features = false, features = ["h1-client"] }
+tempfile = "3"
+tokio = { version = "0.2", default-features = false }
+tungstenite = "0.10"
+url = "2"
 
-[[example]]
+[[bin]]
 name = "async-h1-client"
 path = "async-h1-client.rs"
 
-[[example]]
+[[bin]]
 name = "async-h1-server"
 path = "async-h1-server.rs"
 
-[[example]]
+[[bin]]
 name = "chat-client"
 path = "chat-client.rs"
 
-[[example]]
+[[bin]]
 name = "chat-server"
 path = "chat-server.rs"
 
-[[example]]
+[[bin]]
 name = "ctrl-c"
 path = "ctrl-c.rs"
 
-[[example]]
+[[bin]]
 name = "hyper-client"
 path = "hyper-client.rs"
 
-[[example]]
+[[bin]]
 name = "hyper-server"
 path = "hyper-server.rs"
 
-[[example]]
+[[bin]]
 name = "linux-inotify"
 path = "linux-inotify.rs"
 
-[[example]]
+[[bin]]
 name = "linux-timerfd"
 path = "linux-timerfd.rs"
 
-[[example]]
+[[bin]]
 name = "other-runtimes"
 path = "other-runtimes.rs"
 
-[[example]]
+[[bin]]
 name = "simple-client"
 path = "simple-client.rs"
 
-[[example]]
+[[bin]]
 name = "simple-server"
 path = "simple-server.rs"
 
-[[example]]
+[[bin]]
 name = "tcp-client"
 path = "tcp-client.rs"
 
-[[example]]
+[[bin]]
 name = "tcp-server"
 path = "tcp-server.rs"
 
-[[example]]
+[[bin]]
 name = "tls-client"
 path = "tls-client.rs"
 
-[[example]]
+[[bin]]
 name = "tls-server"
 path = "tls-server.rs"
 
-[[example]]
+[[bin]]
 name = "unix-signal"
 path = "unix-signal.rs"
 
-[[example]]
+[[bin]]
 name = "web-crawler"
 path = "web-crawler.rs"
 
-[[example]]
+[[bin]]
 name = "websocket-client"
 path = "websocket-client.rs"
 
-[[example]]
+[[bin]]
 name = "websocket-server"
 path = "websocket-server.rs"
 
-[[example]]
+[[bin]]
 name = "windows-uds"
 path = "windows-uds.rs"

demos/README.md

@@ -0,0 +1,10 @@
+## smol demos
+
+An example of running any of the demos:
+
+```
+$ cargo run --bin ctrl-c
+```
+
+If you've got a demo you'd like to see here,
+please feel free to open an issue or submit a PR!

examples/async-h1-client.rs → demos/async-h1-client.rs

@@ -1,10 +1,8 @@
 //! An HTTP+TLS client based on `async-h1` and `async-native-tls`.
-//!
 //! Run with:
 //!
 //! ```
-//! cd examples  # make sure to be in this directory
-//! cargo run --example async-h1-client
+//! cargo run --bin async-h1-client
 //! ```
 
 use std::net::TcpStream;

examples/async-h1-server.rs → demos/async-h1-server.rs

@@ -3,8 +3,7 @@
 //! Run with:
 //!
 //! ```
-//! cd examples  # make sure to be in this directory
-//! cargo run --example async-h1-server
+//! cargo run --bin async-h1-server
 //! ```
 //!
 //! Open in the browser any of these addresses:

examples/chat-client.rs → demos/chat-client.rs

@@ -3,15 +3,13 @@
 //! First start a server:
 //!
 //! ```
-//! cd examples  # make sure to be in this directory
-//! cargo run --example chat-server
+//! cargo run --bin chat-server
 //! ```
 //!
 //! Then start clients:
 //!
 //! ```
-//! cd examples  # make sure to be in this directory
-//! cargo run --example chat-client
+//! cargo run --bin chat-client
 //! ```
 
 use std::net::TcpStream;

examples/chat-server.rs → demos/chat-server.rs

@@ -3,15 +3,13 @@
 //! First start a server:
 //!
 //! ```
-//! cd examples  # make sure to be in this directory
-//! cargo run --example chat-server
+//! cargo run --bin chat-server
 //! ```
 //!
 //! Then start clients:
 //!
 //! ```
-//! cd examples  # make sure to be in this directory
-//! cargo run --example chat-client
+//! cargo run --bin chat-client
 //! ```
 
 use std::collections::HashMap;

examples/ctrl-c.rs → demos/ctrl-c.rs

@@ -3,8 +3,7 @@
 //! Run with:
 //!
 //! ```
-//! cd examples  # make sure to be in this directory
-//! cargo run --example ctrl-c
+//! cargo run --bin ctrl-c
 //! ```
 
 use futures::prelude::*;

examples/hyper-client.rs → demos/hyper-client.rs

@@ -3,8 +3,7 @@
 //! Run with:
 //!
 //! ```
-//! cd examples  # make sure to be in this directory
-//! cargo run --example hyper-client
+//! cargo run --bin hyper-client
 //! ```
 
 use std::io;

examples/hyper-server.rs → demos/hyper-server.rs

@@ -3,8 +3,7 @@
 //! Run with:
 //!
 //! ```
-//! cd examples  # make sure to be in this directory
-//! cargo run --example hyper-server
+//! cargo run --bin hyper-server
 //! ```
 //!
 //! Open in the browser any of these addresses:

examples/linux-inotify.rs → demos/linux-inotify.rs

@@ -3,8 +3,7 @@
 //! Run with:
 //!
 //! ```
-//! cd examples  # make sure to be in this directory
-//! cargo run --example linux-inotify
+//! cargo run --bin linux-inotify
 //! ```
 
 #[cfg(target_os = "linux")]

examples/linux-timerfd.rs → demos/linux-timerfd.rs

@@ -3,8 +3,7 @@
 //! Run with:
 //!
 //! ```
-//! cd examples  # make sure to be in this directory
-//! cargo run --example linux-timerfd
+//! cargo run --bin linux-timerfd
 //! ```
 
 #[cfg(target_os = "linux")]

examples/other-runtimes.rs → demos/other-runtimes.rs

@@ -13,8 +13,7 @@
 //! Run with:
 //!
 //! ```
-//! cd examples  # make sure to be in this directory
-//! cargo run --example other-runtimes
+//! cargo run --bin other-runtimes
 //! ```
 
 use std::time::{Duration, Instant};

examples/simple-client.rs → demos/simple-client.rs

@@ -3,7 +3,7 @@
 //! Run with:
 //!
 //! ```
-//! cargo run --example simple-client
+//! cargo run --bin simple-client
 //! ```
 
 use std::net::TcpStream;

examples/simple-server.rs → demos/simple-server.rs

@@ -3,8 +3,7 @@
 //! Run with:
 //!
 //! ```
-//! cd examples  # make sure to be in this directory
-//! cargo run --example simple-server
+//! cargo run --bin simple-server
 //! ```
 //!
 //! Open in the browser any of these addresses:

examples/tcp-client.rs → demos/tcp-client.rs

@@ -3,15 +3,13 @@
 //! First start a server:
 //!
 //! ```
-//! cd examples  # make sure to be in this directory
-//! cargo run --example tcp-server
+//! cargo run --bin tcp-server
 //! ```
 //!
 //! Then start a client:
 //!
 //! ```
-//! cd examples  # make sure to be in this directory
-//! cargo run --example tcp-client
+//! cargo run --bin tcp-client
 //! ```
 
 use std::net::TcpStream;