summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJaap Aarts <JAicewizard@users.noreply.github.com>2020-06-12 16:59:51 +0200
committerGitHub <noreply@github.com>2020-06-12 10:59:51 -0400
commit3eee9614732ed8636bb8ebbd6f6a13d44531df6c (patch)
treede6543a88ec637aec373d0d425bdf958077d89df
parent93573afe8262efa21cf68269618b4416001ea609 (diff)
document "deno run -" (#6256)
-rw-r--r--cli/flags.rs9
-rw-r--r--docs/getting_started/command_line_interface.md12
2 files changed, 18 insertions, 3 deletions
diff --git a/cli/flags.rs b/cli/flags.rs
index 61ce401a4..95be8b585 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 e8538cd3f..dfbd551a9 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