# Examples

This directory contains example code that makes use of `async-std`, each of which can be run from the command line.

##### [Hello World][hello-world]

Spawns a task that says hello.

```
cargo run --example hello-world
```

##### [Line Count][line-count]

Counts the number of lines in a file given as an argument.

```shell
cargo run --example line-count -- ./Cargo.toml
```

##### [List Dir][list-dir]

Lists files in a directory given as an argument.

```shell
cargo run --example list-dir -- .
```

##### [Logging][logging]

Prints the runtime's execution log on the standard output.

```shell
cargo run --example logging
```

##### [Print File][print-file]

Prints a file given as an argument to stdout.

```shell
cargo run --example print-file ./Cargo.toml
```

##### [Socket Timeouts][socket-timeouts]

Prints response of GET request made to TCP server with 5 second socket timeout

```shell
cargo run --example socket-timeouts
```

##### [Stdin Echo][stdin-echo]

Echoes lines read on stdin to stdout.

```shell
cargo run --example stdin-echo
```

##### [Stdin Timeout][stdin-timeout]

Reads a line from stdin, or exits with an error if nothing is read in 5 seconds.

```shell
cargo run --example stdin-timeout
```

##### [Surf Web][surf-web]

Sends an HTTP request to the Rust website.

```shell
cargo run --example surf-web
```

##### [Task Local][task-local]

Creates a task-local value.

```shell
cargo run --example task-local
```

##### [Task Name][task-name]

Spawns a named task that prints its name.

```shell
cargo run --example task-name
```

##### [TCP Client][tcp-client]

Connects to Localhost over TCP.

First, start the echo server:

```shell
cargo run --example tcp-echo
```

Then run the client:

```shell
cargo run --example tcp-client
```

##### [TCP Echo][tcp-echo]

TCP echo server.

Start the echo server:

```shell
cargo run --example tcp-echo
```

Make requests by running the client example:

```shell
cargo run --example tcp-client
```

##### [UDP Client][udp-client]

Connects to Localhost over UDP.

First, start the echo server:

```shell
cargo run --example udp-echo
```

Then run the client:

```shell
cargo run --example udp-client
```

##### [UDP Echo][udp-echo]

UDP echo server.

Start the echo server:

```shell
cargo run --example udp-echo
```

Make requests by running the client example:

```shell
cargo run --example udp-client
```

[hello-world]: https://github.com/async-rs/async-std/blob/HEAD/examples/hello-world.rs
[line-count]: https://github.com/async-rs/async-std/blob/HEAD/examples/line-count.rs
[list-dir]: https://github.com/async-rs/async-std/blob/HEAD/examples/list-dir.rs
[logging]: https://github.com/async-rs/async-std/blob/HEAD/examples/logging.rs
[print-file]: https://github.com/async-rs/async-std/blob/HEAD/examples/print-file.rs
[socket-timeouts]: https://github.com/async-rs/async-std/blob/HEAD/examples/socket-timeouts.rs
[stdin-echo]: https://github.com/async-rs/async-std/blob/HEAD/examples/stdin-echo.rs
[stdin-timeout]: https://github.com/async-rs/async-std/blob/HEAD/examples/stdin-timeout.rs
[surf-web]: https://github.com/async-rs/async-std/blob/HEAD/examples/surf-web.rs
[task-local]: https://github.com/async-rs/async-std/blob/HEAD/examples/task-local.rs
[task-name]: https://github.com/async-rs/async-std/blob/HEAD/examples/task-name.rs
[tcp-client]: https://github.com/async-rs/async-std/blob/HEAD/examples/tcp-client.rs
[tcp-echo]: https://github.com/async-rs/async-std/blob/HEAD/examples/tcp-echo.rs
[udp-client]: https://github.com/async-rs/async-std/blob/HEAD/examples/udp-client.rs
[udp-echo]: https://github.com/async-rs/async-std/blob/HEAD/examples/udp-echo.rs