From 399d5e3d101df95bf35d71e2ab9542bff004fe3f Mon Sep 17 00:00:00 2001
From: Umberto Pepato <umbo.pepato@gmail.com>
Date: Fri, 22 May 2020 17:08:50 +0200
Subject: [PATCH] feat(export): add script exporting functionality

---
 .github/workflows/test.yml  |   6 +-
 README.md                   | 148 ++++++++++++++++++++++++++++--------
 assets/logo.svg             |   1 +
 deps.ts                     |  23 +++---
 src/build_command_string.ts | 114 +++++++++++++++++++++++++++
 src/check_config_data.ts    |  17 +++++
 src/check_script.ts         |  20 +++++
 src/cli/commands/export.ts  |  26 +++++++
 src/cli/commands/vr.ts      |   8 +-
 src/command.ts              |   4 +-
 src/did_you_mean.ts         |  10 +--
 src/export_scripts.ts       | 105 +++++++++++++++++++++++++
 src/load_config.ts          |  14 ++--
 src/logger.ts               |   3 +-
 src/run_commands.ts         | 130 +++----------------------------
 src/run_script.ts           |  29 ++-----
 src/scripts_config.ts       |  14 +---
 src/util.ts                 |  13 ++++
 18 files changed, 467 insertions(+), 218 deletions(-)
 create mode 100644 assets/logo.svg
 create mode 100644 src/build_command_string.ts
 create mode 100644 src/check_config_data.ts
 create mode 100644 src/check_script.ts
 create mode 100644 src/cli/commands/export.ts
 create mode 100644 src/export_scripts.ts

diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
index 1281f9e..a2d19d8 100644
--- a/.github/workflows/test.yml
+++ b/.github/workflows/test.yml
@@ -11,12 +11,12 @@ jobs:
   test:
     strategy:
       matrix:
-        deno: ['v1.0.0']
+        deno: ['v1.0.1']
         os: [ubuntu-latest, macOS-latest, windows-latest]
     runs-on: ${{ matrix.os }}
-    
+
     steps:
-    
+
       - uses: actions/checkout@v2
 
       - name: Setup Deno
diff --git a/README.md b/README.md
index 66774a8..427d5eb 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,41 @@
-# Velociraptor
+<p align="center">
+  <img src="assets/logo.svg" width="350">
+</p>
 
-Velociraptor is a script runner for Deno, inspired by npm's package.json scripts. It offers a similar experience but with out-of-the-box support for declarative deno cli options, environment variables, concurrency and (soon) git hooks.
+<p align="center">
+  Velociraptor is a script runner for Deno, inspired by npm's package.json scripts. It offers a similar experience but with out-of-the-box support for declarative deno cli options, environment variables, concurrency and (soon) git hooks.
+</p>
+
+<p align="center">
+
+ <img src="https://github.com/umbopepato/velociraptor/workflows/Deno%20CI/badge.svg"/>
+ <a href="https://doc.deno.land/https/deno.land/x/velociraptor@v1.0.0-beta.5/src/scripts_config.ts#ScriptsConfiguration"><img src="https://doc.deno.land/badge.svg"></a>
+ <img src="https://img.shields.io/badge/deno-%5E1.0.0-blue"/>
+ <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-brightgreen"/></a>
+
+</p>
+
+<!-- START doctoc generated TOC please keep comment here to allow auto update -->
+<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->
+
+
+- [Motivation](#motivation)
+- [Install](#install)
+- [Project status](#project-status)
+- [Script files](#script-files)
+- [Listing scripts](#listing-scripts)
+- [Running scripts](#running-scripts)
+- [Exporting scripts](#exporting-scripts)
+- [Shell scripting](#shell-scripting)
+- [Current working directory](#current-working-directory)
+- [Shell completions](#shell-completions)
+- [Known limitations](#known-limitations)
+- [Upcoming features](#upcoming-features)
+- [Contributing](#contributing)
+- [License](#license)
+
+<!-- END doctoc generated TOC please keep comment here to allow auto update -->
 
-![Deno CI](https://github.com/umbopepato/velociraptor/workflows/Deno%20CI/badge.svg)
-[![deno doc](https://doc.deno.land/badge.svg)](https://doc.deno.land/https/deno.land/x/velociraptor@v1.0.0-beta.5/src/scripts_config.ts#ScriptsConfiguration)
 
 ## Motivation
 
@@ -12,7 +44,7 @@ Mainly because Deno cli commands can easily become very long and difficult to re
 ## Install
 
 ```sh
-$ deno install --allow-read --allow-env --allow-run -n vr https://deno.land/x/velociraptor/cli.ts
+$ deno install --allow-read --allow-write --allow-env --allow-run -n vr https://deno.land/x/velociraptor/cli.ts
 ```
 
 <details>
@@ -35,36 +67,20 @@ $ deno install ... https://deno.land/x/velociraptor@<version>/cli.ts
 For example
 
 ```sh
-$ deno install --allow-read --allow-env --allow-run -n vr https://deno.land/x/velociraptor@v1.0.0-beta.5/cli.ts
+$ deno install --allow-read --allow-write --allow-env --allow-run -n vr https://deno.land/x/velociraptor@v1.0.0-beta.5/cli.ts
 ```
 
 </details>
 
-## Usage
-
-```sh
-$ vr [SCRIPT] [ADDITIONAL ARGS]...
-# or
-$ vr run <SCRIPT> [ADDITIONAL ARGS]...
-```
-
-**`SCRIPT`**  
-The identifier of the script to run.
-
-**`ADDITIONAL ARGS`**  
-Any other argument, passed to the script. Unlike `npm run`, the `--` separator is not needed.
-
-Run `vr` without arguments to see a list of available scripts.
-
-Run `vr --help` for more guidance.
+To get help with the CLI run `vr help`, or `vr help <SUBCOMMAND>` for specific commands.
 
 ## Project status
 
-👨‍💻 WIP: until the Deno std library is stable there may be breaking changes here, use carefully and feel free to open an issue if you found a bug.
+👨‍💻 WIP: until the Deno std library is stable there may be breaking changes here, use carefully and feel free to open an issue if you find a bug.
 
 ## Script files
 
-To define scripts, create a file called `scripts.yaml` or `velociraptor.yaml` in your project folder.
+To get started, create a file called `scripts.yaml` or `velociraptor.yaml` in your project folder:
 
 ```yaml
 # scripts.yaml
@@ -237,7 +253,7 @@ scripts:
       logfile: v8.log
 ```
 
-### Multiple commands
+### Compound commands and concurrency
 
 If the script value is an array of commands, the commands are executed serially.
 
@@ -252,7 +268,7 @@ scripts:
       tsconfig: tsconfig.json
 ```
 
-To execute commands in parallel, list them in the `pll` property of an object.
+To declare concurrent commands, list them in the `pll` property of an object.
 
 ```yaml
 scripts:
@@ -284,9 +300,78 @@ scripts:
 
 See [ScriptConfiguration](https://doc.deno.land/https/deno.land/x/velociraptor@v1.0.0-beta.5/src/scripts_config.ts#ScriptsConfiguration) for a detailed description of the structure of script files.
 
+## Listing scripts
+
+Run
+
+```sh
+$ vr
+```
+
+to see a list of available scripts.
+
+## Running scripts
+
+To run a script, use the `run` subcommand
+
+```sh
+$ vr run <SCRIPT> [ADDITIONAL ARGS]...
+```
+
+or, more concisely
+
+```sh
+$ vr [SCRIPT] [ADDITIONAL ARGS]...
+```
+
+|Arg or option|Description|
+|:---|:---|
+|`SCRIPT`|The identifier of the script to run.|
+|`ADDITIONAL ARGS`|Any other argument, passed to the script. Unlike `npm run`, the `--` separator is not needed.|
+
+For example, run
+
+```sh
+$ vr start
+# or
+$ vr run start
+```
+
+to execute the `start` script.
+
+> If you enabled [shell completions](#shell-completions), trigger the autocomplete on one of this commands to get the available scripts as suggestions.
+
+## Exporting scripts
+
+You may find yourself in a situation where you want to use velociraptor to manage your scripts during development, but you're not comfortable installing it (or just can't install it) in your production environment.
+In this case the `export` subcommand may be of help: it allows you to export one or more scripts as standalone executable shell files:
+
+```sh
+$ vr export [SCRIPTS]...
+```
+
+|Arg or option|Description|
+|:---|:---|
+|`SCRIPTS`|A space-separated list of scripts to export. If omitted, all the declared scripts are exported.|
+|`-o, --out-dir`|The directory where the scripts will be exported (default: `bin`).|
+
+For example, run
+
+```sh
+$ vr export start
+```
+
+to export the `start` script, together with its env variables, deno cli options etc. Now you can execute it by running
+
+```sh
+$ ./bin/start [ARGS]...
+```
+
+> Scripts exporting currently only supports `sh`.
+
 ## Shell scripting
 
-Like in `npm` scripts, vr commands are executed inside a shell. The shell is determined by the `SHELL` env variable on Unix-like systems and by `ComSpec` on Windows, with respectively `sh` and `cmd.exe` as fallback values. To customize the shell without changing you default shell env variables you can use the `VR_SHELL` variable (a full path is requried).
+Like in `npm` scripts, vr commands are executed inside a shell. The shell is determined by the `SHELL` env variable on Unix-like systems and by `ComSpec` on Windows, with respectively `sh` and `cmd.exe` as fallback values. To customize the shell without changing your default shell env variables you can use the `VR_SHELL` variable (a full path is requried).
 
 The shell requirements are pretty much the same as [node's](https://nodejs.org/api/child_process.html#child_process_shell_requirements).
 
@@ -296,15 +381,13 @@ Velociraptor searches for script files up the folder tree starting from the dire
 
 ## Shell completions
 
-To enable shell tab-completion for Velociraptor commands, add the following line to your `~/.zshrc`
+To enable zsh tab-completion for velociraptor commands, add the following line to your `~/.zshrc`
 
 ```sh
 source <(vr completions zsh)
 ```
 
-Trigger the autocomplete on `vr`/`vr run` to get the available scripts as suggestions.
-
-> Bash completions are not supported yet, but will be added.
+> Bash is not supported yet, but will be added.
 
 ## Known limitations
 
@@ -314,7 +397,6 @@ As a workaround you can tell Velociraptor to use `PowerShell` instead of `cmd` (
 ## Upcoming features
 
 - [ ] Self-update: run `vr upgrade` to install the latest version.
-- [ ] Scripts exporting: run `vr export` to save your scripts as shell scripts to avoid having to install `vr` in your production environment.
 - [ ] Husky style git hooks: use the `hook` property to link a script to a git hook.
 
 ## Contributing
diff --git a/assets/logo.svg b/assets/logo.svg
new file mode 100644
index 0000000..b15f9dd
--- /dev/null
+++ b/assets/logo.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="839.54" height="173.78" viewBox="0 0 839.54 173.78"><defs><style>.cls-1{fill:none;}.cls-2{fill:gray;}.cls-3{clip-path:url(#clip-path);}.cls-4{fill:url(#Sfumatura_senza_nome_39);}.cls-5{fill:#fff;}.cls-6{fill:#deeef9;}</style><clipPath id="clip-path" transform="translate(0 -0.46)"><path class="cls-1" d="M2.45,136.92V19.19A19.19,19.19,0,0,1,21.64,0H166.7a19.19,19.19,0,0,1,17.81,12.05l23.58,58.87a19.23,19.23,0,0,1,0,14.27l-23.58,58.87a19.19,19.19,0,0,1-17.81,12.05H21.64A19.19,19.19,0,0,1,2.45,136.92Z"/></clipPath><linearGradient id="Sfumatura_senza_nome_39" x1="3.06" y1="78.05" x2="208.86" y2="78.05" gradientUnits="userSpaceOnUse"><stop offset="0" stop-color="#2eafff"/><stop offset="1" stop-color="#505dde"/></linearGradient></defs><title>logo_3</title><g id="Livello_2" data-name="Livello 2"><g id="Livello_2-2" data-name="Livello 2"><path class="cls-2" d="M357.24,43.45l-26,60H317.53l-25.9-60h15L324.9,86.33l18.53-42.88Z" transform="translate(0 -0.46)"/><path class="cls-2" d="M402.77,84.19h-34.9A10.84,10.84,0,0,0,372.33,91a14.75,14.75,0,0,0,8.75,2.49,17.74,17.74,0,0,0,6.38-1.07A15.6,15.6,0,0,0,392.65,89l7.12,7.72q-6.51,7.46-19,7.46a30.08,30.08,0,0,1-13.8-3,22.27,22.27,0,0,1-9.27-8.44,23.3,23.3,0,0,1-3.26-12.27,23.63,23.63,0,0,1,3.22-12.22,22.53,22.53,0,0,1,8.83-8.49,27.4,27.4,0,0,1,24.83-.13,21.36,21.36,0,0,1,8.62,8.37A24.87,24.87,0,0,1,403,80.58C403,80.76,402.94,82,402.77,84.19Zm-31.3-14.84a10.92,10.92,0,0,0-3.77,7h22.72a11,11,0,0,0-3.77-7,11.29,11.29,0,0,0-7.55-2.61A11.54,11.54,0,0,0,371.47,69.35Z" transform="translate(0 -0.46)"/><path class="cls-2" d="M412,39.85h13.38v63.63H412Z" transform="translate(0 -0.46)"/><path class="cls-2" d="M446.64,101.12a22.55,22.55,0,0,1-9.05-8.44,24.7,24.7,0,0,1,0-24.53,22.64,22.64,0,0,1,9.05-8.45,27.67,27.67,0,0,1,13.08-3,27.38,27.38,0,0,1,13,3,22.79,22.79,0,0,1,9,8.45,24.7,24.7,0,0,1,0,24.53,22.7,22.7,0,0,1-9,8.44,27.39,27.39,0,0,1-13,3A27.67,27.67,0,0,1,446.64,101.12Zm21.52-11.4q3.31-3.48,3.31-9.31c0-3.88-1.1-7-3.31-9.3a11.11,11.11,0,0,0-8.44-3.47,11.26,11.26,0,0,0-8.49,3.47,12.84,12.84,0,0,0-3.35,9.3,12.87,12.87,0,0,0,3.35,9.31,11.3,11.3,0,0,0,8.49,3.47A11.14,11.14,0,0,0,468.16,89.72Z" transform="translate(0 -0.46)"/><path class="cls-2" d="M503,101.12a22.74,22.74,0,0,1-9.17-8.44,23.27,23.27,0,0,1,9.17-33,28.39,28.39,0,0,1,13.25-3,25.68,25.68,0,0,1,12.74,3,18,18,0,0,1,7.93,8.71L526.52,74q-3.6-6.35-10.37-6.34a11.71,11.71,0,0,0-8.66,3.43q-3.44,3.42-3.44,9.34t3.44,9.35a11.71,11.71,0,0,0,8.66,3.43q6.86,0,10.37-6.35L536.9,92.5a18.44,18.44,0,0,1-7.93,8.58,25.38,25.38,0,0,1-12.74,3.09A28.4,28.4,0,0,1,503,101.12Z" transform="translate(0 -0.46)"/><path class="cls-2" d="M545.3,48.77a7.28,7.28,0,0,1,0-10.64,8.55,8.55,0,0,1,6-2.14,8.71,8.71,0,0,1,6,2.06,6.61,6.61,0,0,1,2.32,5.14,7.28,7.28,0,0,1-2.32,5.53,8.38,8.38,0,0,1-6,2.19A8.51,8.51,0,0,1,545.3,48.77Zm-.68,8.57H558v46.14H544.62Z" transform="translate(0 -0.46)"/><path class="cls-2" d="M589.68,58.37a24.14,24.14,0,0,1,9.4-1.71V69c-1.49-.12-2.49-.17-3-.17q-5.75,0-9,3.21t-3.26,9.65v21.78H570.43V57.34h12.78v6.09A14.94,14.94,0,0,1,589.68,58.37Z" transform="translate(0 -0.46)"/><path class="cls-2" d="M641.87,61.76q5.75,5.1,5.75,15.39v26.33H635.1V97.74q-3.78,6.42-14.07,6.43a21.85,21.85,0,0,1-9.22-1.8,13.72,13.72,0,0,1-6-5,12.93,12.93,0,0,1-2.06-7.2,12,12,0,0,1,4.85-10.12q4.85-3.69,15-3.69h10.64a8.54,8.54,0,0,0-2.66-6.73q-2.66-2.36-8-2.36a23.28,23.28,0,0,0-7.24,1.16,19.2,19.2,0,0,0-6.05,3.13l-4.8-9.35a28.89,28.89,0,0,1,9-4.11,40.15,40.15,0,0,1,10.84-1.46Q636.13,56.66,641.87,61.76ZM630.46,93.58a8.7,8.7,0,0,0,3.78-4.68V84.19h-9.18q-8.23,0-8.23,5.4a4.82,4.82,0,0,0,2,4.07,9.11,9.11,0,0,0,5.54,1.5A11.61,11.61,0,0,0,630.46,93.58Z" transform="translate(0 -0.46)"/><path class="cls-2" d="M698.69,59.62A21.21,21.21,0,0,1,707,67.94a25.1,25.1,0,0,1,3,12.47,25.11,25.11,0,0,1-3,12.48,21.27,21.27,0,0,1-8.27,8.32,23.56,23.56,0,0,1-11.71,3q-8.84,0-13.89-5.58v21.53H659.71V57.34h12.78v5.32q5-6,14.49-6A23.45,23.45,0,0,1,698.69,59.62Zm-5.58,30.1q3.3-3.48,3.3-9.31c0-3.88-1.1-7-3.3-9.3a12,12,0,0,0-16.89,0c-2.21,2.31-3.3,5.42-3.3,9.3s1.09,7,3.3,9.31a12,12,0,0,0,16.89,0Z" transform="translate(0 -0.46)"/><path class="cls-2" d="M748.64,101.25a13.71,13.71,0,0,1-4.85,2.19,24.74,24.74,0,0,1-6,.73q-8.24,0-12.74-4.2t-4.5-12.35v-19h-7.12V58.37h7.12V47.14h13.38V58.37h11.49V68.66H733.89V87.45a6.3,6.3,0,0,0,1.5,4.5,5.54,5.54,0,0,0,4.24,1.58A8.63,8.63,0,0,0,745,91.82Z" transform="translate(0 -0.46)"/><path class="cls-2" d="M763.6,101.12a22.58,22.58,0,0,1-9-8.44,24.7,24.7,0,0,1,0-24.53,22.68,22.68,0,0,1,9-8.45,29.57,29.57,0,0,1,26.12,0,22.7,22.7,0,0,1,9,8.45,24.7,24.7,0,0,1,0,24.53,22.61,22.61,0,0,1-9,8.44,29.49,29.49,0,0,1-26.12,0Zm21.53-11.4q3.3-3.48,3.3-9.31c0-3.88-1.1-7-3.3-9.3a11.13,11.13,0,0,0-8.45-3.47,11.26,11.26,0,0,0-8.49,3.47c-2.23,2.31-3.34,5.42-3.34,9.3s1.11,7,3.34,9.31a11.3,11.3,0,0,0,8.49,3.47A11.16,11.16,0,0,0,785.13,89.72Z" transform="translate(0 -0.46)"/><path class="cls-2" d="M830.15,58.37a24.12,24.12,0,0,1,9.39-1.71V69c-1.48-.12-2.48-.17-3-.17q-5.74,0-9,3.21t-3.26,9.65v21.78H810.9V57.34h12.78v6.09A14.94,14.94,0,0,1,830.15,58.37Z" transform="translate(0 -0.46)"/><g class="cls-3"><path class="cls-4" d="M3.06,136.58v-117A19.07,19.07,0,0,1,22.13.46H166.34a19.07,19.07,0,0,1,17.71,12L207.49,71a19.12,19.12,0,0,1,0,14.19l-23.44,58.52a19.07,19.07,0,0,1-17.71,12H22.13A19.07,19.07,0,0,1,3.06,136.58Z" transform="translate(0 -0.46)"/><path class="cls-5" d="M43.33,167.05,0,166.72s2-33.78,2.1-40.9c.25-30.13,16.32-41.27,20.19-47.14,9-13.61,11.6-20.76,18.88-26.5,9.5-7.5,20-6.25,29.16-9.13,4.12-1.29,8.53-7,19.09-6.25s19.25,10,29.91,13.92c7.28,2.67,40.77,16,43.79,20.55C166.9,77,166,90.14,163,93.72c-9.21,11.08-80.83,1.46-94,4-27.21,5.25-46.08,54.46-9.08,57.93ZM85.12,48.56A13.59,13.59,0,0,0,85,50.49a13.05,13.05,0,0,0,24.44,6.37C102.73,50.3,94.46,48,85.12,48.56Z" transform="translate(0 -0.46)"/><path class="cls-6" d="M32.27,158.55c-16.5-50.16,17.83-52.83,20.62-79.5C51.14,99.43,69,97.72,69,97.72c-27.21,5.25-46.08,54.46-9.08,57.93C59.92,155.65,44.41,195.47,32.27,158.55Z" transform="translate(0 -0.46)"/></g></g></g></svg>
\ No newline at end of file
diff --git a/deps.ts b/deps.ts
index 7cfb6a6..378dff6 100644
--- a/deps.ts
+++ b/deps.ts
@@ -1,19 +1,22 @@
-export { stringSimilarity } from "https://unpkg.com/string-similarity-js@2.1.2/src/string-similarity.ts";
-export { parse as parseYaml } from "https://deno.land/std@v0.42.0/encoding/yaml.ts";
-export { readJsonSync } from "https://deno.land/std@v0.42.0/fs/read_json.ts";
-export { readFileStrSync } from "https://deno.land/std@v0.42.0/fs/read_file_str.ts";
-export { existsSync } from "https://deno.land/std@v0.42.0/fs/exists.ts";
-export * as path from "https://deno.land/std@v0.42.0/path/mod.ts";
-export * as logger from "https://deno.land/std@v0.42.0/log/mod.ts";
+export { default as levenshtein } from "https://deno.land/x/levenshtein@v1.0.0/mod.ts";
+export { parse as parseYaml } from "https://deno.land/std@v0.52.0/encoding/yaml.ts";
+export { readFileStrSync } from "https://deno.land/std@v0.52.0/fs/read_file_str.ts";
+export { writeFileStr } from "https://deno.land/std@v0.52.0/fs/write_file_str.ts";
+export { moveSync } from "https://deno.land/std@v0.52.0/fs/move.ts";
+export { existsSync } from "https://deno.land/std@v0.52.0/fs/exists.ts";
+export { ensureDirSync } from "https://deno.land/std@v0.52.0/fs/ensure_dir.ts";
+export * as path from "https://deno.land/std@v0.52.0/path/mod.ts";
+export * as logger from "https://deno.land/std@v0.52.0/log/mod.ts";
 export {
   blue,
   yellow,
   red,
   bold,
   gray,
-} from "https://deno.land/std@v0.42.0/fmt/colors.ts";
-export { ConsoleHandler } from "https://deno.land/std@v0.42.0/log/handlers.ts";
-export { LogRecord } from "https://deno.land/std@v0.42.0/log/logger.ts";
+} from "https://deno.land/std@v0.52.0/fmt/colors.ts";
+export { ConsoleHandler } from "https://deno.land/std@v0.52.0/log/handlers.ts";
+export { LogRecord } from "https://deno.land/std@v0.52.0/log/logger.ts";
+export { LevelName } from "https://deno.land/std@v0.52.0/log/levels.ts";
 export {
   Command,
   BaseCommand,
diff --git a/src/build_command_string.ts b/src/build_command_string.ts
new file mode 100644
index 0000000..49b5a88
--- /dev/null
+++ b/src/build_command_string.ts
@@ -0,0 +1,114 @@
+import { Command } from "./command.ts";
+import { FlagsObject, ScriptOptions } from "./scripts_config.ts";
+
+const denoCmdOptions: { [key: string]: string[] } = {
+  bundle: ["cert", "imap", "log"],
+  cache: ["cert", "tsconfig", "imap", "lock", "log"],
+  install: ["allow", "log"],
+  run: [
+    "allow",
+    "cert",
+    "tsconfig",
+    "imap",
+    "inspect",
+    "inspectBrk",
+    "lock",
+    "log",
+    "v8Flags",
+  ],
+  test: [
+    "allow",
+    "cert",
+    "tsconfig",
+    "imap",
+    "inspect",
+    "inspectBrk",
+    "lock",
+    "log",
+    "v8Flags",
+  ],
+};
+
+const denoOption: { [key: string]: string } = {
+  allow: "allow-",
+  cert: "cert",
+  imap: "importmap",
+  inspect: "inspect",
+  inspectBrk: "inspect-brk",
+  lock: "lock",
+  log: "log-level",
+  tsconfig: "config",
+  v8Flags: "v8-flags",
+};
+
+export function buildCommandString(command: Command): string {
+  let cmd = command.cmd.concat(), match;
+  if (match = matchCompactRun(cmd)) {
+    cmd = "deno run " + cmd;
+  }
+  if (match = matchDenoCommand(cmd)) {
+    const subCommand = match[1];
+    if (subCommand && subCommand in denoCmdOptions) {
+      const insertAt = match[0].length;
+      const options = denoCmdOptions[subCommand];
+      for (let optionName of options) {
+        const option = command[optionName as keyof ScriptOptions];
+        if (option) {
+          if (optionName === "allow") {
+            const flags = generateFlagOptions(
+              option as FlagsObject,
+              denoOption[optionName],
+            );
+            if (flags && flags.length > 0) {
+              cmd = insertOptions(cmd, insertAt, ...flags);
+            }
+          } else if (optionName === "v8Flags") {
+            const flags = generateFlagOptions(option as FlagsObject);
+            if (flags && flags.length > 0) {
+              cmd = insertOptions(
+                cmd,
+                insertAt,
+                `--${denoOption[optionName]}=${flags.join(",")}`,
+              );
+            }
+          } else {
+            cmd = insertOptions(
+              cmd,
+              insertAt,
+              `--${denoOption[optionName]}=${option}`,
+            );
+          }
+        }
+      }
+    }
+  }
+  return cmd;
+}
+
+function insertOptions(
+  command: string,
+  atPosition: number,
+  ...options: string[]
+) {
+  return command.slice(0, atPosition) + " " + options.join(" ") +
+    command.slice(atPosition);
+}
+
+function generateFlagOptions(
+  flags: FlagsObject,
+  prefix: string = "",
+): string[] {
+  return Object.entries(flags).map(([k, v]) =>
+    `--${prefix}${k}${v !== true ? `="${v}"` : ""}`
+  );
+}
+
+function matchDenoCommand(command: string) {
+  return command.match(/^deno +(\w+)/);
+}
+
+function matchCompactRun(command: string) {
+  return command.match(
+    /^'(?:\\'|.)*?\.ts'|^"(?:\\"|.)*?\.ts"|^(?:\\\ |\S)+\.ts/,
+  );
+}
diff --git a/src/check_config_data.ts b/src/check_config_data.ts
new file mode 100644
index 0000000..8e3caa6
--- /dev/null
+++ b/src/check_config_data.ts
@@ -0,0 +1,17 @@
+import { ConfigData } from "./load_config.ts";
+import { log } from "./logger.ts";
+
+export function checkConfigData(configData: ConfigData | null) {
+  if (!configData) {
+    throw new Error("No scripts file found.");
+  }
+  if (
+    !configData.config.scripts ||
+    Object.entries(configData.config.scripts).length < 1
+  ) {
+    log.warning(
+      "No scripts available.\nSee https://github.com/umbopepato/velociraptor for guidance on how to create scripts.",
+    );
+    Deno.exit();
+  }
+}
diff --git a/src/check_script.ts b/src/check_script.ts
new file mode 100644
index 0000000..50b0254
--- /dev/null
+++ b/src/check_script.ts
@@ -0,0 +1,20 @@
+import { log } from "./logger.ts";
+import { bold } from "../deps.ts";
+import { didYouMean } from "./did_you_mean.ts";
+import { ScriptsConfiguration } from "./scripts_config.ts";
+
+export function checkScript(script: string, config: ScriptsConfiguration) {
+  if (!(script in config.scripts)) {
+    log.error(`Script ${bold(script)} not found`);
+    const suggestion = didYouMean(script, config.scripts);
+    if (suggestion) console.log(`Did you mean ${bold(suggestion)}?`);
+    else {
+      console.log(
+        `Run ${
+          bold("vr")
+        } without arguments to see a list of available scripts.`,
+      );
+    }
+    Deno.exit();
+  }
+}
diff --git a/src/cli/commands/export.ts b/src/cli/commands/export.ts
new file mode 100644
index 0000000..876001f
--- /dev/null
+++ b/src/cli/commands/export.ts
@@ -0,0 +1,26 @@
+import { BaseCommand, HelpCommand } from "../../../deps.ts";
+import { ScriptIdType } from "../script_id_type.ts";
+import { ConfigData } from "../../load_config.ts";
+import { exportScripts } from "../../export_scripts.ts";
+
+export class ExportCommand extends BaseCommand {
+  private helpCommand = new HelpCommand(this);
+
+  constructor(private configData: ConfigData | null) {
+    super();
+    this.description("Export one or more scripts as executable files")
+      .type("scriptid", new ScriptIdType(this.configData))
+      .arguments("[scripts...:string:scriptid]")
+      .option(
+        "-o, --out-dir [dir:string]",
+        "The folder where the scripts will be exported",
+      )
+      .action(async (options, scripts: string[]) => {
+        await exportScripts(this.configData, scripts, options.outDir);
+      });
+  }
+
+  getHelpCommand(): HelpCommand {
+    return this.helpCommand;
+  }
+}
diff --git a/src/cli/commands/vr.ts b/src/cli/commands/vr.ts
index 773a4f1..4a07743 100644
--- a/src/cli/commands/vr.ts
+++ b/src/cli/commands/vr.ts
@@ -3,6 +3,7 @@ import { version } from "../../version.ts";
 import { ScriptIdType } from "../script_id_type.ts";
 import { ConfigData } from "../../load_config.ts";
 import { RunCommand } from "./run.ts";
+import { ExportCommand } from "./export.ts";
 import { runScript } from "../../run_script.ts";
 
 export class VrCommand extends Command {
@@ -13,18 +14,23 @@ export class VrCommand extends Command {
     super();
     this.version(version)
       .description(
-        "🦖 Velociraptor\nAn npm-style script runner for Deno\n\nDocs: https://deno.land/x/velociraptor",
+        "🦖 Velociraptor\nAn npm-style script runner for Deno\n\nDocs: https://github.com/umbopepato/velociraptor",
       )
       .env(
         "VR_SHELL=<value:string>",
         "The path to a shell executable to be used for executing scripts",
       )
+      .env(
+        "VR_LOG=<value:string>",
+        "Log verbosity. One of: DEBUG, INFO, WARNING, ERROR, CRITICAL",
+      )
       .type("scriptid", new ScriptIdType(this.configData))
       .arguments("[script:string:scriptid] [additionalArgs...]")
       .action(async (options, script: string, additionalArgs: string[]) => {
         await runScript(this.configData, script, additionalArgs);
       })
       .command("run", new RunCommand(this.configData))
+      .command("export", new ExportCommand(this.configData))
       .reset();
   }
 }
diff --git a/src/command.ts b/src/command.ts
index abc7b6f..3629933 100644
--- a/src/command.ts
+++ b/src/command.ts
@@ -1,6 +1,6 @@
 import { ScriptObject } from "./scripts_config.ts";
 
-export interface Command extends Omit<ScriptObject, "cmd"> {
+export interface Command extends ScriptObject {
   cmd: string;
 }
 
@@ -8,5 +8,7 @@ export interface ParallelCommands {
   pll: Array<Command | ParallelCommands>;
 }
 
+export type CompoundCommandItem = Command | ParallelCommands | null;
+
 export const isParallel = (command: object): command is ParallelCommands =>
   "pll" in command;
diff --git a/src/did_you_mean.ts b/src/did_you_mean.ts
index 64bbacc..a57cfff 100644
--- a/src/did_you_mean.ts
+++ b/src/did_you_mean.ts
@@ -1,15 +1,15 @@
-import { stringSimilarity } from "../deps.ts";
+import { levenshtein } from "../deps.ts";
 import { Scripts } from "./scripts_config.ts";
 
 export function didYouMean(wrongName: string, scripts: Scripts): string | null {
   const names = Object.keys(scripts);
   const suggestion = names.reduce((closest: any, name, index) => {
-    const similarity = stringSimilarity(wrongName, name);
+    const distance = levenshtein(wrongName, name);
     if (
-      similarity > 0 &&
-      (closest == null || similarity > (<any> closest).similarity)
+      distance < wrongName.length &&
+      (closest == null || distance < (<any> closest).distance)
     ) {
-      return { index, similarity };
+      return { index, distance };
     }
     return closest;
   }, null);
diff --git a/src/export_scripts.ts b/src/export_scripts.ts
new file mode 100644
index 0000000..1a575dc
--- /dev/null
+++ b/src/export_scripts.ts
@@ -0,0 +1,105 @@
+import { ConfigData } from "./load_config.ts";
+import { checkConfigData } from "./check_config_data.ts";
+import { checkScript } from "./check_script.ts";
+import { isWindows, OneOrMore, makeFileExecutable } from "./util.ts";
+import { normalizeScript } from "./normalize_script.ts";
+import { CompoundCommandItem } from "./command.ts";
+import { log } from "./logger.ts";
+import { isParallel } from "./command.ts";
+import { buildCommandString } from "./build_command_string.ts";
+import { escape } from "./util.ts";
+import {
+  path,
+  existsSync,
+  readFileStrSync,
+  writeFileStr,
+  moveSync,
+  ensureDirSync,
+} from "../deps.ts";
+
+const VR_MARK = "Generated by velociraptor";
+
+export async function exportScripts(
+  configData: ConfigData | null,
+  scripts: string[],
+  outDir: string = "bin",
+) {
+  checkConfigData(configData);
+  const { cwd, config } = configData as ConfigData;
+  const outDirPath = path.join(cwd, outDir);
+  ensureDirSync(outDirPath);
+  if (!scripts || scripts.length < 1) {
+    scripts = Object.keys(config.scripts);
+  }
+  await Promise.all(
+    scripts.map(async (script) => {
+      checkScript(script, config);
+      const scriptDef = config.scripts[script];
+      const { scripts, ...rootConfig } = config;
+      const commands = normalizeScript(scriptDef, rootConfig);
+      const content = generateExecutableFile(commands);
+      if (content) {
+        const filePath = path.join(outDirPath, script);
+        if (
+          existsSync(filePath) &&
+          !readFileStrSync(filePath).includes(VR_MARK)
+        ) {
+          moveSync(filePath, `${filePath}.bkp`);
+        }
+        await writeFileStr(filePath, content);
+        makeFileExecutable(filePath);
+      }
+    }),
+  );
+}
+
+function generateExecutableFile(
+  commands: CompoundCommandItem[],
+) {
+  if (isWindows) {
+    log.warning("Scripts exporting only supports sh.");
+  }
+  return `#!/bin/sh
+# ${VR_MARK}
+
+${exportCommands(commands)}
+`;
+}
+
+function exportCommands(
+  commands: CompoundCommandItem[],
+): string {
+  const _exportCommands = (
+    commands: OneOrMore<CompoundCommandItem>,
+    doGroup: boolean = false,
+  ): string => {
+    if (!commands) return "";
+    if (Array.isArray(commands)) {
+      let res = commands.map((c) =>
+        _exportCommands(c, commands.length > 1 ? true : false)
+      ).join(" && ");
+      if (doGroup) res = `(${res})`;
+      return res;
+    } else {
+      if (isParallel(commands)) {
+        return `(${
+          commands.pll.map((c) => _exportCommands(c, true)).join(" & ")
+        }; wait)`;
+      }
+      const cmd = commands;
+      let res = "";
+      if (cmd.env) {
+        const envVars = Object.entries(cmd.env);
+        if (envVars.length > 0) {
+          res += envVars
+            .map(([key, val]) => `${key}="${escape(val, '"')}"`)
+            .join(" ") + " ";
+        }
+      }
+      res += buildCommandString(cmd) + ' "$@"';
+      if (doGroup) res = `(${res})`;
+      return res;
+    }
+  };
+  return _exportCommands(commands);
+}
diff --git a/src/load_config.ts b/src/load_config.ts
index b8148e3..b2b7c9e 100644
--- a/src/load_config.ts
+++ b/src/load_config.ts
@@ -1,9 +1,8 @@
 import {
   parseYaml,
-  readJsonSync,
-  readFileStrSync,
-  existsSync,
   path,
+  existsSync,
+  readFileStrSync,
 } from "../deps.ts";
 import { ScriptsConfiguration } from "./scripts_config.ts";
 
@@ -39,10 +38,7 @@ function parent(dir: string) {
 }
 
 function parseConfig(configPath: string): ScriptsConfiguration {
-  if (/ya?ml$/.test(configPath)) {
-    return parseYaml(
-      readFileStrSync(configPath, { encoding: "utf8" }),
-    ) as ScriptsConfiguration;
-  }
-  return readJsonSync(configPath) as ScriptsConfiguration;
+  return parseYaml(
+    readFileStrSync(configPath, { encoding: "utf8" }),
+  ) as ScriptsConfiguration;
 }
diff --git a/src/logger.ts b/src/logger.ts
index af19564..f5adada 100644
--- a/src/logger.ts
+++ b/src/logger.ts
@@ -6,6 +6,7 @@ import {
   logger,
   ConsoleHandler,
   LogRecord,
+  LevelName,
 } from "../deps.ts";
 
 const LEVEL_PREFIX: { [key: number]: string } = {
@@ -26,7 +27,7 @@ await logger.setup({
   },
   loggers: {
     default: {
-      level: "INFO",
+      level: Deno.env.get("VR_LOG") as LevelName || "WARNING",
       handlers: ["console"],
     },
   },
diff --git a/src/run_commands.ts b/src/run_commands.ts
index 7547b49..42ad882 100644
--- a/src/run_commands.ts
+++ b/src/run_commands.ts
@@ -1,73 +1,28 @@
-import { isWindows } from "./util.ts";
+import { isWindows, OneOrMore } from "./util.ts";
 import { log } from "./logger.ts";
 import {
-  FlagsObject,
   EnvironmentVariables,
-  ScriptOptions,
 } from "./scripts_config.ts";
 import {
   ParallelCommands,
   Command,
   isParallel,
+  CompoundCommandItem,
 } from "./command.ts";
-
-const denoCmdOptions: { [key: string]: string[] } = {
-  bundle: ["cert", "imap", "log"],
-  cache: ["cert", "tsconfig", "imap", "lock", "log"],
-  install: ["allow", "log"],
-  run: [
-    "allow",
-    "cert",
-    "tsconfig",
-    "imap",
-    "inspect",
-    "inspectBrk",
-    "lock",
-    "log",
-    "v8Flags",
-  ],
-  test: [
-    "allow",
-    "cert",
-    "tsconfig",
-    "imap",
-    "inspect",
-    "inspectBrk",
-    "lock",
-    "log",
-    "v8Flags",
-  ],
-};
-
-const denoOption: { [key: string]: string } = {
-  allow: "allow-",
-  cert: "cert",
-  imap: "importmap",
-  inspect: "inspect",
-  inspectBrk: "inspect-brk",
-  lock: "lock",
-  log: "log-level",
-  tsconfig: "config",
-  v8Flags: "v8-flags",
-};
+import { buildCommandString } from "./build_command_string.ts";
 
 const runningProcesses: Set<Deno.Process> = new Set();
 
 export async function runCommands(
-  commands: Array<Command | ParallelCommands | null>,
+  commands: CompoundCommandItem[],
   shell: string,
   additionalArgs: string[],
   cwd: string,
 ): Promise<void> {
-  if (!commands) return;
   const _runCommands = async (
-    commands:
-      | Command
-      | ParallelCommands
-      | Array<
-        Command | ParallelCommands
-      >,
+    commands: OneOrMore<CompoundCommandItem>,
   ): Promise<unknown> => {
+    if (!commands) return;
     if (Array.isArray(commands)) {
       for (let command of commands) {
         await _runCommands(command);
@@ -87,70 +42,13 @@ export async function runCommands(
   }
 }
 
-function insertOptions(
-  command: string,
-  atPosition: number,
-  ...options: string[]
-) {
-  return command.slice(0, atPosition) + " " + options.join(" ") +
-    command.slice(atPosition);
-}
-
-function generateFlagOptions(
-  flags: FlagsObject,
-  prefix: string = "",
-): string[] {
-  return Object.entries(flags).map(([k, v]) =>
-    `--${prefix}${k}${v !== true ? `="${v}"` : ""}`
-  );
-}
-
 async function runCommand(
   command: Command,
   shell: string,
   additionalArgs: string[],
   cwd: string,
 ): Promise<void> {
-  let cmd = command.cmd, match;
-  if (match = matchCompactRun(cmd)) {
-    cmd = "deno run " + cmd;
-  }
-  if (match = matchDenoCommand(cmd)) {
-    const subCommand = match[1];
-    if (subCommand && subCommand in denoCmdOptions) {
-      const insertAt = match[0].length;
-      const options = denoCmdOptions[subCommand];
-      for (let optionName of options) {
-        const option = command[optionName as keyof ScriptOptions];
-        if (option) {
-          if (optionName === "allow") {
-            const flags = generateFlagOptions(
-              option as FlagsObject,
-              denoOption[optionName],
-            );
-            if (flags && flags.length > 0) {
-              cmd = insertOptions(cmd, insertAt, ...flags);
-            }
-          } else if (optionName === "v8Flags") {
-            const flags = generateFlagOptions(option as FlagsObject);
-            if (flags && flags.length > 0) {
-              cmd = insertOptions(
-                cmd,
-                insertAt,
-                `--${denoOption[optionName]}=${flags.join(",")}`,
-              );
-            }
-          } else {
-            cmd = insertOptions(
-              cmd,
-              insertAt,
-              `--${denoOption[optionName]}=${option}`,
-            );
-          }
-        }
-      }
-    }
-  }
+  const cmd = buildCommandString(command);
   let runOptions: Deno.RunOptions = {
     cmd: [shell, ...buildShellArgs(shell, cmd, additionalArgs)],
     cwd,
@@ -158,8 +56,8 @@ async function runCommand(
   if (command.env && Object.entries(command.env).length > 0) {
     runOptions.env = stringifyEnv(command.env);
   }
-  log.debug(
-    `> ${cmd}${
+  log.info(
+    `Running > ${cmd}${
       additionalArgs && additionalArgs.length > 0
         ? ` -- ${additionalArgs.join(" ")}`
         : ""
@@ -175,16 +73,6 @@ async function runCommand(
   }
 }
 
-function matchDenoCommand(command: string) {
-  return command.match(/^deno +(\w+)/);
-}
-
-function matchCompactRun(command: string) {
-  return command.match(
-    /^'(?:\\'|.)*?\.ts'|^"(?:\\"|.)*?\.ts"|^(?:\\\ |\S)+\.ts/,
-  );
-}
-
 function stringifyEnv(env: EnvironmentVariables): EnvironmentVariables {
   for (let key in env) {
     if (key in env) {
diff --git a/src/run_script.ts b/src/run_script.ts
index 64ee95e..61dc9be 100644
--- a/src/run_script.ts
+++ b/src/run_script.ts
@@ -2,43 +2,24 @@ import { ConfigData } from "./load_config.ts";
 import { log } from "./logger.ts";
 import { printScriptsInfo } from "./scripts_info.ts";
 import { bold } from "../deps.ts";
-import { didYouMean } from "./did_you_mean.ts";
 import { normalizeScript } from "./normalize_script.ts";
 import { resolveShell } from "./resolve_shell.ts";
 import { runCommands } from "./run_commands.ts";
+import { checkConfigData } from "./check_config_data.ts";
+import { checkScript } from "./check_script.ts";
 
 export async function runScript(
   configData: ConfigData | null,
   script: string,
   additionalArgs: string[] = [],
 ) {
-  if (!configData) {
-    throw new Error("No scripts file found.");
-  }
-  const { cwd, config } = configData;
-  if (!config.scripts || Object.entries(config.scripts).length < 1) {
-    log.warning(
-      "No scripts available.\nSee https://deno.land/x/velociraptor for guidance on how to create scripts.",
-    );
-    Deno.exit();
-  }
+  checkConfigData(configData);
+  const { cwd, config } = configData as ConfigData;
   if (script == null || script.length < 1) {
     printScriptsInfo(config);
     Deno.exit();
   }
-  if (!(script in config.scripts)) {
-    log.error(`Script ${bold(script)} not found`);
-    const suggestion = didYouMean(script, config.scripts);
-    if (suggestion) console.log(`Did you mean ${bold(suggestion)}?`);
-    else {
-      console.log(
-        `Run ${
-          bold("vr")
-        } without arguments to see a list of available scripts.`,
-      );
-    }
-    Deno.exit();
-  }
+  checkScript(script, config);
   const scriptDef = config.scripts[script];
   const { scripts, ...rootConfig } = config;
   const commands = normalizeScript(scriptDef, rootConfig);
diff --git a/src/scripts_config.ts b/src/scripts_config.ts
index 4a95eb9..007e258 100644
--- a/src/scripts_config.ts
+++ b/src/scripts_config.ts
@@ -16,9 +16,7 @@ export interface ScriptsConfiguration extends ScriptOptions {
  *  test: deno test
  * ```
  */
-export interface Scripts {
-  [key: string]: ScriptDefinition;
-}
+export type Scripts = Record<string, ScriptDefinition>;
 
 /**
  * Either a script or a list of scripts
@@ -55,7 +53,7 @@ export interface ScriptObject extends ScriptOptions {
 export type CompositeScript = Array<Script | ParallelScripts>;
 
 /**
- * An object representing script
+ * An object representing scripts
  * to be executed in parallel
  */
 export interface ParallelScripts {
@@ -144,13 +142,9 @@ export interface ScriptOptions {
   inspectBrk?: string;
 }
 
-export interface FlagsObject {
-  [key: string]: unknown;
-}
+export type FlagsObject = Record<string, unknown>;
 
-export interface EnvironmentVariables {
-  [key: string]: string;
-}
+export type EnvironmentVariables = Record<string, string>;
 
 export const isScriptObject = (script: object): script is ScriptObject =>
   "cmd" in script;
diff --git a/src/util.ts b/src/util.ts
index fdd3568..a5370da 100644
--- a/src/util.ts
+++ b/src/util.ts
@@ -1 +1,14 @@
+export type OneOrMore<T> = T | T[];
+
 export const isWindows = Deno.build.os == "windows";
+
+export function escape(str: string, ...chars: string[]): string {
+  return chars.reduce(
+    (str, char) => str.replace(RegExp(char, "g"), `\\${char}`),
+    str,
+  );
+}
+
+export function makeFileExecutable(filePath: string) {
+  Deno.chmodSync(filePath, 0o0755);
+}