Add env testtools subcommand to show the environment

(This is only temporarily in `gix-testtools` and shall either be
moved to `internal-tools` or removed altogether.)

It is useful to be able to observe environment variables that are
set when running code with tools such as `cargo` or `cross`. This
is therefore not intended for general-purpose use. A system command
like `printenv` or `env` or a shell facility should be preferred
where applicable, since it is considered a feature rather than a
bug that commands like `cargo run -p gix-testtools env` include
changes to the environment from `cargo` itself.

Since one use for checking environment variables is to investigate
the effects of environments that contain variable names or values
that are not valid Unicode, this avoids requiring that environment
variables all be Unicode. Any name or value that is not Unicode is
shown in its Rust debug representation. This is always quoted, and
to decrease ambiguity any name or (more likely) value that contains
literal double quotes is likewise shown in its debug representation
so that it is always clear if a quotation mark is just for display.
Each name and value is otherwise shown literally. In either case
the name or its representation is separated by a `=` from the value
or its representation.

Author: EliahKagan

tests/tools/src/main.rs

@@ -9,6 +9,19 @@ fn bash_program() -> io::Result<()> {
     Ok(())
 }
 
+fn env() -> io::Result<()> {
+    fn repr(text: &std::ffi::OsStr) -> String {
+        text.to_str()
+            .filter(|s| !s.contains('"'))
+            .map(ToOwned::to_owned)
+            .unwrap_or_else(|| format!("{text:?}"))
+    }
+    for (name, value) in std::env::vars_os() {
+        println!("{}={}", repr(&name), repr(&value));
+    }
+    Ok(())
+}
+
 fn mess_in_the_middle(path: PathBuf) -> io::Result<()> {
     let mut file = fs::OpenOptions::new().read(false).write(true).open(path)?;
     file.seek(io::SeekFrom::Start(file.metadata()?.len() / 2))?;
@@ -27,6 +40,7 @@ fn main() -> Result<(), Box<dyn std::error::Error>> {
     let scmd = args.next().expect("sub command");
     match &*scmd {
         "bash-program" | "bp" => bash_program()?,
+        "env" => env()?,
         "mess-in-the-middle" => mess_in_the_middle(PathBuf::from(args.next().expect("path to file to mess with")))?,
         #[cfg(unix)]
         "umask" => umask()?,