curl.ts example with reference in manual (#3161)

2 files changed, 14 insertions, 0 deletions

diff --git a/std/examples/README.md b/std/examples/README.md
index e6102a843..14f101244 100644
--- a/std/examples/README.md
+++ b/std/examples/README.md
@@ -37,6 +37,12 @@ catj file1.json file2.json
 echo example.json | catj -
 ```
 
+### curl - print the contents of a url to standard output
+
+```shell
+deno --allow-net=deno.land https://deno.land/std/examples/curl.ts https://deno.land/
+```
+
 ### gist - easily create and upload Gists
 
 ```
diff --git a/std/examples/curl.ts b/std/examples/curl.ts
new file mode 100644
index 000000000..04dd9d601
--- /dev/null
+++ b/std/examples/curl.ts
@@ -0,0 +1,8 @@
+// Copyright 2018-2019 the Deno authors. All rights reserved. MIT license.
+async function curl(url: string): Promise<void> {
+  const res = await fetch(url);
+  await Deno.copy(Deno.stdout, res.body);
+}
+
+await curl(Deno.args[1]);
+Deno.exit(0);