diff options
Diffstat (limited to 'cli')
| -rw-r--r-- | cli/flags.rs | 99 |
1 files changed, 52 insertions, 47 deletions
diff --git a/cli/flags.rs b/cli/flags.rs index 14ec7cd51..2761294fd 100644 --- a/cli/flags.rs +++ b/cli/flags.rs @@ -41,11 +41,27 @@ pub fn create_cli_app<'a, 'b>() -> App<'a, 'b> { .global_settings(&[AppSettings::ColorNever]) .settings(&[AppSettings::DisableVersion]) .after_help(ENV_VARIABLES_HELP) - .long_about(" - Run deno REPL + .long_about("A secure runtime for JavaScript and TypeScript built with V8, Rust, and Tokio. - This command has implicit access to all permissions (equivalent to deno run --allow-all) - ") +Docs: https://deno.land/manual.html +Modules: https://github.com/denoland/deno_std +Bugs: https://github.com/denoland/deno/issues + +To run the REPL: + + deno + +To execute a sandboxed script: + + deno run https://deno.land/welcome.ts + +To evaluate code from the command line: + + deno eval \"console.log(30933 + 404)\" + +To get help on the another subcommands (run in this case): + + deno help run") .arg( Arg::with_name("log-debug") .short("D") @@ -83,21 +99,17 @@ pub fn create_cli_app<'a, 'b>() -> App<'a, 'b> { SubCommand::with_name("version") .setting(AppSettings::DisableVersion) .about("Print the version") - .long_about( - " -Print current version of Deno. + .long_about("Print current version of Deno. Includes versions of Deno, V8 JavaScript Engine, and the TypeScript -compiler. -", +compiler.", ), ).subcommand( SubCommand::with_name("fetch") .setting(AppSettings::DisableVersion) .about("Fetch the dependencies") .long_about( - " -Fetch and compile remote dependencies recursively. + "Fetch and compile remote dependencies recursively. Downloads all statically imported scripts and save them in local cache, without running the code. No future import network requests @@ -105,66 +117,57 @@ would be made unless --reload is specified. # Downloads all dependencies deno fetch https://deno.land/std/http/file_server.ts + # Once cached, static imports no longer send network requests - deno run -A https://deno.land/std/http/file_server.ts -", + deno run -A https://deno.land/std/http/file_server.ts", ).arg(Arg::with_name("file").takes_value(true).required(true)), ).subcommand( SubCommand::with_name("types") .setting(AppSettings::DisableVersion) .about("Print runtime TypeScript declarations") - .long_about( - " -Print runtime TypeScript declarations. - -The declaration file could be saved and used for typing information. + .long_about("Print runtime TypeScript declarations. deno types > lib.deno_runtime.d.ts -", + +The declaration file could be saved and used for typing information.", ), ).subcommand( SubCommand::with_name("info") .setting(AppSettings::DisableVersion) .about("Show source file related info") - .long_about( - " -Show source file related info. + .long_about("Show source file related info. -The following information is shown: + deno info https://deno.land/std@v0.6/http/file_server.ts -local: local path of the file. -type: type of script (e.g. JavaScript/TypeScript/JSON) -compiled: (TypeScript only) shown local path of compiled source code. -map: (TypeScript only) shown local path of source map. -deps: dependency tree of the source file. +The following information is shown: - deno info myfile.ts -", + local: Local path of the file. + type: JavaScript, TypeScript, or JSON. + compiled: TypeScript only. shown local path of compiled source code. + map: TypeScript only. shown local path of source map. + deps: Dependency tree of the source file.", ).arg(Arg::with_name("file").takes_value(true).required(true)), ).subcommand( SubCommand::with_name("eval") .setting(AppSettings::DisableVersion) .about("Eval script") .long_about( - " -Evaluate provided script. + "Evaluate provided script. This command has implicit access to all permissions (equivalent to deno run --allow-all) - deno eval 'console.log(\"hello world\")' -", + deno eval \"console.log('hello world')\"", ).arg(Arg::with_name("code").takes_value(true).required(true)), ).subcommand( SubCommand::with_name("fmt") .setting(AppSettings::DisableVersion) .about("Format files") .long_about( - " -Format given list of files using Prettier. Automatically downloads -Prettier dependencies on first run. +"Auto-format JavaScript/TypeScript source code using Prettier + +Automatically downloads Prettier dependencies on first run. - deno fmt myfile1.ts myfile2.ts -", + deno fmt --write myfile1.ts myfile2.ts", ).arg( Arg::with_name("files") .takes_value(true) @@ -180,8 +183,7 @@ Prettier dependencies on first run. AppSettings::SubcommandRequired, ]).about("Run a program given a filename or url to the source code") .long_about( - " -Run a program given a filename or url to the source code. + "Run a program given a filename or url to the source code. By default all programs are run in sandbox without access to disk, network or ability to spawn subprocesses. @@ -195,8 +197,7 @@ ability to spawn subprocesses. deno run --allow-net --allow-read=$(pwd) https://deno.land/std/http/file_server.ts # run program with all permissions - deno run -A https://deno.land/std/http/file_server.ts -", + deno run -A https://deno.land/std/http/file_server.ts", ).arg( Arg::with_name("allow-read") .long("allow-read") @@ -253,8 +254,7 @@ ability to spawn subprocesses. .setting(AppSettings::DisableVersion) .about("Eval a script on text segments from stdin") .long_about( - " -Eval a script on lines (or chunks split under delimiter) from stdin. + "Eval a script on lines from stdin Read from standard input and eval code on each whitespace-delimited string chunks. @@ -264,12 +264,17 @@ Otherwise '$' will be used as default variable name. This command has implicit access to all permissions (equivalent to deno run --allow-all) +Print all the usernames in /etc/passwd: + cat /etc/passwd | deno xeval \"a = $.split(':'); if (a) console.log(a[0])\" +A complicated way to print the current git branch: + git branch | deno xeval -I 'line' \"if (line.startsWith('*')) console.log(line.slice(2))\" - cat LICENSE | deno xeval -d ' ' \"if ($ === 'MIT') console.log('MIT licensed')\" -", +Demonstrates breaking the input up by space delimiter instead of by lines: + + cat LICENSE | deno xeval -d \" \" \"if ($ === 'MIT') console.log('MIT licensed')\"", ).arg( Arg::with_name("replvar") .long("replvar") |