Merge pull request #222 from ccmywish/skip-tests

Add `-T` flag and `RSTAR_NO_TEST` env var to skip module tests

Author: AntonOks

README.md

@@ -20,7 +20,7 @@ A *user-friendly* distribution of the [Raku programming language](https://raku.o
 ## Docker Image
 
 * Please refer to [Rakudo-Star on Docker Hub](https://hub.docker.com/_/rakudo-star) for an image.
-* Find the related Docker files on the ["Raku Docker" GitHub repository](https://github.com/Raku/docker) 
+* Find the related Docker files on the ["Raku Docker" GitHub repository](https://github.com/Raku/docker)
 
 ## What's in this GIT repo
 
@@ -32,6 +32,41 @@ Both tools compile Rakudo and then add some selected modules!
 
 ### 1. _RSTAR_ tool
 
+#### Usage
+
+```
+rstar install [options] [core] [modules]
+```
+
+**Options:**
+
+| Option | Description |
+|--------|-------------|
+| `-b <backend>` | Set the compiler backend (default: `moar`) |
+| `-p <prefix>` | Set the installation prefix |
+| `-T` | Skip module tests (`--/test`) during installation |
+
+**Skipping module tests:**
+
+By default, `zef` runs all tests when installing bundled modules. Pass `-T` to
+disable this, which can significantly speed up installation:
+
+```sh
+rstar install -T modules
+```
+
+You can also set the environment variable `RSTAR_NO_TEST` to any non-empty
+value to achieve the same effect without modifying the command:
+
+```sh
+RSTAR_NO_TEST=1 rstar install modules
+```
+
+> Note: When a module fails and is retried with `--force-test`, tests are
+> always run regardless of this option.
+
+---
+
 * `bash` based tool, should work on any **Linux OS** (_should also build Rakudo-Star on macOS_!?).
   - The `rstar` (bash) tool downloads all requirements, like MoarVM, NQP, Rakudo and some Rakudo modules.
   - It then compiles everything into a local Rakudo installation and add's the modules via `zef`.
@@ -47,7 +82,7 @@ Furthermore, all code should be linted against [`shellcheck`](https://www.shellc
 
 * A [Powershell script](https://github.com/rakudo/star/blob/master/tools/build/binary-release/Windows/build-with-choco.ps1), which internally uses `chocolatey` to create a **Windows MSI** package.
     - The created MSI package can be used to install Rakudo-Star (Rakudo with some additional modules) on any Windows device.
-* *More information to be added* in the [wiki](https://github.com/rakudo/star/wiki) 
+* *More information to be added* in the [wiki](https://github.com/rakudo/star/wiki)
 
 ### 3. Community Modules
 
@@ -65,7 +100,7 @@ the module, the second the protocol to use, with the third column being the
 URL to fetch it from. Columns following the third have different meaning
 depending on the protocol.
 
-*Currently all modules are expected to be available via `git` (GitHub) and having `git tags`, similar to the `version` given in the modules `META6.json`* 
+*Currently all modules are expected to be available via `git` (GitHub) and having `git tags`, similar to the `version` given in the modules `META6.json`*
 
 ## Bugs, Feedback and Patches
 

lib/actions/install.bash

@@ -19,11 +19,12 @@ action() {
 	local init
 	local prefix_absolute
 
-	while getopts ":b:p:" opt
+	while getopts ":b:p:T" opt
 	do
 		case "$opt" in
 			b) RSTAR_BACKEND=$OPTARG ;;
 			p) RSTAR_PREFIX=$OPTARG ;;
+			T) RSTAR_NO_TEST=1 ;;
 			*) emerg "Invalid option specified: $opt" ;;
 		esac
 	done
@@ -246,17 +247,17 @@ build_prepare() {
 install_raku_module() {
 	if [[ -f "$1/Build.pm6" ]]
 	then
-		"$RSTAR_PREFIX/bin/raku" "$RSTAR_PREFIX/share/perl6/site/bin/zef.raku" build --debug "$1"
+		"$RSTAR_PREFIX/bin/raku" "$RSTAR_PREFIX/share/perl6/site/bin/zef.raku" build --debug ${RSTAR_NO_TEST:+--/test} "$1"
 	fi
 
 	if [[ "$1" =~ /zef ]]
 	then
 	  pushd "$1" > /dev/null
 	  PATH="$RSTAR_PREFIX/bin/:$PATH"
-	  "$RSTAR_PREFIX/bin/raku" -I. bin/zef --debug install .
+	  "$RSTAR_PREFIX/bin/raku" -I. bin/zef --debug install . ${RSTAR_NO_TEST:+--/test}
 	  popd > /dev/null
 	else
-	  "$RSTAR_PREFIX/bin/raku" "$RSTAR_PREFIX/share/perl6/site/bin/zef.raku" install --debug "$1"
+	  "$RSTAR_PREFIX/bin/raku" "$RSTAR_PREFIX/share/perl6/site/bin/zef.raku" install --debug ${RSTAR_NO_TEST:+--/test} "$1"
 	  if [[ $? == 130 ]]
 	  then
 	    notice "zef: re-installing module \"$1\" with \"--force-test\" option"