From 3eee9614732ed8636bb8ebbd6f6a13d44531df6c Mon Sep 17 00:00:00 2001 From: Jaap Aarts Date: Fri, 12 Jun 2020 16:59:51 +0200 Subject: [PATCH] document "deno run -" (#6256) --- cli/flags.rs | 9 ++++++--- docs/getting_started/command_line_interface.md | 12 ++++++++++++ 2 files changed, 18 insertions(+), 3 deletions(-) diff --git a/cli/flags.rs b/cli/flags.rs index 61ce401a48..95be8b585c 100644 --- a/cli/flags.rs +++ b/cli/flags.rs @@ -1037,9 +1037,9 @@ fn run_subcommand<'a, 'b>() -> App<'a, 'b> { run_test_args(SubCommand::with_name("run")) .setting(AppSettings::TrailingVarArg) .arg(script_arg()) - .about("Run a program given a filename or url to the module") + .about("Run a program given a filename or url to the module. Use '-' as a filename to read from stdin.") .long_about( - "Run a program given a filename or url to the module. + "Run a program given a filename or url to the module. By default all programs are run in sandbox without access to disk, network or ability to spawn subprocesses. @@ -1052,7 +1052,10 @@ Grant permission to read from disk and listen to network: deno run --allow-read --allow-net https://deno.land/std/http/file_server.ts Grant permission to read whitelisted files from disk: - deno run --allow-read=/etc https://deno.land/std/http/file_server.ts", + deno run --allow-read=/etc https://deno.land/std/http/file_server.ts + +Deno allows specifying the filename '-' to read the file from stdin. + curl https://deno.land/std/examples/welcome.ts | target/debug/deno run -", ) } diff --git a/docs/getting_started/command_line_interface.md b/docs/getting_started/command_line_interface.md index e8538cd3f8..dfbd551a96 100644 --- a/docs/getting_started/command_line_interface.md +++ b/docs/getting_started/command_line_interface.md @@ -29,6 +29,18 @@ deno bundle --help Detailed guides to each subcommand can be found [here](../tools.md). +### Script source + +Deno can grab the scripts from multiple sources, a filename, a url, and '-' to +read the file from stdin. The later is useful for integration with other +applications. + +```shell +deno run main.ts +deno run https://mydomain.com/main.ts +cat main.ts | deno run - +``` + ### Script arguments Separately from the Deno runtime flags, you can pass user-space arguments to the