diff options
author | Jaap Aarts <JAicewizard@users.noreply.github.com> | 2020-06-12 16:59:51 +0200 |
---|---|---|
committer | GitHub <noreply@github.com> | 2020-06-12 10:59:51 -0400 |
commit | 3eee9614732ed8636bb8ebbd6f6a13d44531df6c (patch) | |
tree | de6543a88ec637aec373d0d425bdf958077d89df | |
parent | 93573afe8262efa21cf68269618b4416001ea609 (diff) |
document "deno run -" (#6256)
-rw-r--r-- | cli/flags.rs | 9 | ||||
-rw-r--r-- | 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 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 |