huge WIP commit

- new `__do` and `__try`, instead of `eval_capture`
    - better coverage and tests, see `dorothy-internals`
    - more powerful API
- new `is-fs` helpers
- new `echo-wait` (maybe should rename to `echo-write`)
    - no longer needs sponge
    - more powerful API
    - moreutils as such is no longer a dorothy recommended dep
- auto-sudo escalation on nearly everything
    - new sudo/elevate/elevated args
- use FDs instead of device files where sensible to avoid linux divergence from macos
- ... todo

Author: balupton

Diff for: TODOS.md

@@ -0,0 +1,24 @@
+# TODOS
+
+ssh-helper
+until-success
+eval-helper
+eval-helper --terminal-device-file=/dev/stderr
+
+is-\* --reason support
+
+support --no-status and --status=no/null to discard status so failure returns 0
+
+ensure-trailing-newline
+ensure-trailing-slash
+echo-file
+echo-wait
+config-helper
+
+get-devices
+get-terminal-quiet-support could remove need for \__is_non_affirmative as it has eval_
+
+debug-terminal-tty
+fs-dequarantine should use is-fs
+commands.test/bash.bash
+echo-style --tty

Diff for: commands.beta/convert-helper

@@ -42,7 +42,7 @@ function convert_helper() (
 	# Arguments
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			Covert a format into other formats.
 

Diff for: commands.beta/echo-affirmative

@@ -10,7 +10,7 @@ function echo_affirmative() (
 	# Arguments
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			For each <input>, output 'yes' if affirmative, 'no' if non-affirmative, otherwise note the invalidity to stderr.
 
@@ -56,13 +56,14 @@ function echo_affirmative() (
 	local had_invalid_input=no
 	function on_input {
 		local status
-		eval_capture --statusvar=status -- is-affirmative -- "$1"
+		# @todo source is-affirmative and call __is_affirmative instead
+		__do --redirect-status={status} -- is-affirmative -- "$1"
 		if [[ $status -eq 0 ]]; then
 			__print_lines 'yes'
 		elif [[ $status -eq 1 ]]; then
 			__print_lines 'no'
 		else
-			echo-style --error="[$1] is neither affirmative or non-affirmative" >/dev/stderr
+			echo-style --stderr --error="[$1] is neither affirmative or non-affirmative"
 			had_invalid_input=yes
 		fi
 	}

Diff for: commands.beta/echo-escape-special

@@ -4,7 +4,7 @@ function echo_escape_special() (
 	source "$DOROTHY/sources/stdinargs.bash"
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			For each input, output its escaped form.
 

Diff for: commands.beta/echo-eval

@@ -11,7 +11,7 @@ function echo_eval() (
 	# Arguments
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			Execute the <command> on each stdin input.
 

Diff for: commands.beta/echo-exit-affirmative

@@ -9,7 +9,7 @@ function echo_exit_affirmative() (
 	# Arguments
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			Output the result of a command's exit status.
 
@@ -63,7 +63,7 @@ function echo_exit_affirmative() (
 	# Action
 
 	local cmd_status
-	eval_capture --statusvar=cmd_status -- "${option_cmd[@]}"
+	__try {cmd_status} -- "${option_cmd[@]}"
 	if [[ $cmd_status -eq 0 ]]; then
 		__print_lines 'yes'
 	elif [[ $cmd_status -eq 1 ]]; then

Diff for: commands.beta/echo-exit-status

@@ -9,7 +9,7 @@ function echo_exit_status() (
 	# Arguments
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			Given a command as arguments, execute it, output the exit status.
 
@@ -49,7 +49,7 @@ function echo_exit_status() (
 	# Action
 
 	local cmd_status
-	eval_capture --statusvar=cmd_status -- "${cmd[@]}"
+	__try {cmd_status} -- "${cmd[@]}"
 	__print_lines "$cmd_status"
 )
 

Diff for: commands.beta/echo-if-directory

@@ -56,7 +56,7 @@ function echo_if_directory() (
 	source "$DOROTHY/sources/stdinargs.bash"
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			Output <input>s that are a directory, or an unbroken symlink to a directory.
 			Companion to [is-directory].

Diff for: commands.beta/echo-if-executable

@@ -59,7 +59,7 @@ function echo_if_executable() (
 	source "$DOROTHY/sources/stdinargs.bash"
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			Output <input>s that are paths that are executable (including that of symlinks, broken or otherwise).
 			Companion to [is-executable].

Diff for: commands.beta/echo-mkdir

@@ -7,7 +7,7 @@ function echo_mkdir() (
 	# Arguments
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			Make a directory at each input path, if it was not already one, and output its absolute path.
 
@@ -64,7 +64,7 @@ function echo_mkdir() (
 	# construct command
 	if [[ $option_sudo == 'yes' ]]; then
 		function __mkdir {
-			sudo-helper --reason='Your sudo/root/login password is required to ensure the directory exists:' -- mkdir -p -- "$@"
+			sudo-helper --reason='Your password is required to momentarily grant privileges to ensure the directory exists:' -- mkdir -p -- "$@"
 		}
 	else
 		function __mkdir {

Diff for: commands.beta/echo-non-affirmative

@@ -10,7 +10,7 @@ function echo_non_affirmative() (
 	# Arguments
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			For each input, output 'yes' if non-affirmative, 'no' if affirmative, otherwise note the invalidity to stderr.
 			Using [is-non-affirmative] for the validation.
@@ -57,13 +57,13 @@ function echo_non_affirmative() (
 	local had_invalid_input=no
 	function on_line {
 		local non_affirmative_status
-		eval_capture --statusvar=non_affirmative_status -- is-non-affirmative -- "$1"
+		__try {non_affirmative_status} -- is-non-affirmative -- "$1"
 		if [[ $non_affirmative_status -eq 0 ]]; then
 			__print_lines 'yes'
 		elif [[ $non_affirmative_status -eq 1 ]]; then
 			__print_lines 'no'
 		else
-			echo-style --error="[$1] is neither affirmative or non-affirmative" >/dev/stderr
+			echo-style --stderr --error="[$1] is neither affirmative or non-affirmative"
 			had_invalid_input=yes
 		fi
 	}

Diff for: commands.beta/echo-nonflags

@@ -4,7 +4,7 @@ function echo_nonflags() (
 	source "$DOROTHY/sources/stdinargs.bash"
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			Output all arguments that aren't flags.
 

Diff for: commands.beta/echo-nothing-or-fail

@@ -7,7 +7,7 @@ function echo_nothing_or_fail() (
 	# Arguments
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			If input is provided, fail.
 			If no input was provided, success.

Diff for: commands.beta/echo-numeric

@@ -5,7 +5,7 @@ function echo_numeric() (
 	source "$DOROTHY/sources/stdinargs.bash"
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			Outputs inputs that are numbers, otherwise note their invalidity to stderr.
 			Using [is-number] for the validation.
@@ -32,7 +32,7 @@ function echo_numeric() (
 			    [] is not a number
 			    # exit status: 1
 
-			echo-numeric -- 1 a '' 2> /dev/stderr || :
+			echo-numeric -- 1 a '' 2>>/dev/stderr || :
 
 			    1
 			    # exit status: 0, it was ignored due to || :
@@ -49,7 +49,7 @@ function echo_numeric() (
 		if is-number -- "$1"; then
 			__print_lines "$1"
 		else
-			echo-style --error="[$1] is not a number" >/dev/stderr
+			echo-style --stderr --error="[$1] is not a number"
 			had_an_invalid_input=yes
 		fi
 	}

Diff for: commands.beta/echo-revolving-screen

@@ -7,7 +7,7 @@ function echo_revolving_screen() (
 	# Arguments
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			Continuously clear the output of a command, showing only the latest output, then clearing it upon completion.
 
@@ -59,14 +59,10 @@ function echo_revolving_screen() (
 	if [[ -z $option_lines || -z $option_columns || $option_lines -le 0 || $option_columns -le 0 ]]; then
 		cat
 	else
-		local terminal_device_file clear_screen
-		terminal_device_file="$(get-terminal-device-file)"
-		clear_screen=$'\e[H\e[J'
-
-		local input total_lines=0 status wrapped lines=0
+		local clear_screen=$'\e[H\e[J' input total_lines=0 status wrapped lines=0
 		while IFS= read -r input || [[ -n $input ]]; do
-			eval_capture --statusvar=status --outputvar=wrapped \
-				-- gfold --width="$option_columns" <<<"$input"
+			__do --redirect-status={status} --redirect-output={wrapped} -- \
+				gfold --width="$option_columns" <<<"$input"
 			#-- echo-wrap --width="$option_columns" -- "$input"
 			if [[ $status -ne 0 ]]; then
 				echo-error "$wrapped"
@@ -82,16 +78,16 @@ function echo_revolving_screen() (
 					__print_lines "${clear_screen}${wrapped}" | head -n "$option_lines"
 				else
 					# clear the screen
-					__print_lines "${clear_screen}${wrapped}" >"$terminal_device_file"
+					__do --redirect-stdout=tty -- __print_lines "${clear_screen}${wrapped}"
 				fi
 				total_lines="$lines"
 			else
 				# print the wrapped output
-				__print_lines "$wrapped" >"$terminal_device_file"
+				__do --redirect-stdout=tty -- __print_lines "$wrapped"
 			fi
 		done
 		# we are now done, so clear wrapped
-		__print_string "${clear_screen}" >"$terminal_device_file"
+		__do --redirect-stdout=tty -- __print_string "${clear_screen}"
 	fi
 )
 

Diff for: commands.beta/echo-sort

@@ -4,7 +4,7 @@ function echo_sort() (
 	source "$DOROTHY/sources/stdinargs.bash"
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			Sort the inputs using [sort]
 

Diff for: commands.beta/echo-truncate-lines

@@ -39,7 +39,7 @@ function echo_truncate_lines() (
 	# Arguments
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			Truncate the <input> if it reaches more than <limit>.
 

Diff for: commands.beta/echo-with-empty-fallback

@@ -4,7 +4,7 @@ function echo_with_empty_fallback() (
 	source "$DOROTHY/sources/stdinargs.bash"
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			Output <fallback> if all <input> is zero-length.
 			Similar to [echo-with-whitespace-fallback], [eval-on-empty-stdin], [eval-on-not-empty-stdin].

Diff for: commands.beta/echo-with-whitespace-fallback

@@ -4,7 +4,7 @@ function echo_with_whitespace_fallback() (
 	source "$DOROTHY/sources/stdinargs.bash"
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			Output <fallback> if all <input> is only whitespace.
 			Similar to [echo-with-empty-fallback].

Diff for: commands.beta/edit-dns

@@ -8,7 +8,7 @@ function edit_dns() (
 	# Arguments
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			If possible, edit the DNS configuration of the DNS service.
 			You probably want [setup-dns] instead.

Diff for: commands.beta/edit-hosts

@@ -7,7 +7,7 @@ function edit_hosts() (
 	# Arguments
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			Edit the system's HOSTS file.
 

Diff for: commands.beta/eject-all

@@ -7,7 +7,7 @@ function eject_all() (
 	# Arguments
 
 	function help {
-		cat <<-EOF >/dev/stderr
+		cat <<-EOF >&2
 			ABOUT:
 			Eject all the ejectable drives attached to the system.