Variable scriptlikeDryRun

If true, then run, tryRun, file write, file append, and all the echoable commands that modify the filesystem will be echoed to stdout (regardless of scriptlikeEcho) and NOT actually executed.

Warning! This is NOT a "set it and forget it" switch. You must still take care to write your script in a way that's dryrun-safe. Two things to remember:

1. ONLY Scriptlike's functions will obey this setting. Calling Phobos functions directly will BYPASS this setting.

2. If part of your script relies on a command having ACTUALLY been run, then that command will fail. You must avoid that situation or work around it. For example:

run(`date > tempfile`);

// The following will FAIL or behave INCORRECTLY in dryrun mode:
auto data = cast(string)read("tempfile");
run("echo "~data);

That may be an unrealistic example, but it demonstrates the problem: Normally, the code above should run fine (at least on posix). But in dryrun mode, "date" will not actually be run. Therefore, tempfile will neither be created nor overwritten. Result: Either an exception reading a non-existent file, or outdated information will be displayed.

Scriptlike cannot anticipate or handle such situations. So it's up to you to make sure your script is dryrun-safe.

Declaration

bool scriptlikeDryRun = false;

Authors

Nick Sabalausky

Copyright

Copyright (C) 2014-2016 Nick Sabalausky

License

zlib/libpng