show-env: Add --csh

Author: taiki-e

.github/.cspell/project-dictionary.txt

@@ -22,6 +22,7 @@ profraw
 rmeta
 rustfilt
 rustix
+tcsh
 TESTNAME
 winapi
 xargo

.github/workflows/ci.yml

@@ -272,16 +272,26 @@ jobs:
         if: startsWith(matrix.os, 'windows')
       - name: Install other shells (Ubuntu)
         run: |
-          sudo apt-get -o Acquire::Retries=10 -qq update
-          sudo apt-get -o Acquire::Retries=10 -o Dpkg::Use-Pty=0 install -y --no-install-recommends fish zsh
+          retry() {
+            for i in {1..10}; do
+              if "$@"; then
+                return 0
+              else
+                sleep "${i}"
+              fi
+            done
+            "$@"
+          }
+          retry sudo apt-get -o Acquire::Retries=10 -qq update
+          retry sudo apt-get -o Acquire::Retries=10 -o Dpkg::Use-Pty=0 install -y --no-install-recommends csh fish tcsh zsh
         if: startsWith(matrix.os, 'ubuntu') || matrix.os == ''
       - name: Install other shells (macOS)
         run: |
-          brew install fish
+          brew install fish tcsh
         if: startsWith(matrix.os, 'macos')
       - name: Install other shells (Windows)
         run: |
-          C:/msys64/usr/bin/pacman -S --noconfirm fish zsh
+          C:/msys64/usr/bin/pacman -S --noconfirm fish tcsh zsh
           printf '%s\n' 'C:\msys64\usr\bin' >>"${GITHUB_PATH}"
         # TODO: C:/msys64/usr/bin/pacman: No such file or directory
         if: startsWith(matrix.os, 'windows') && matrix.os != 'windows-11-arm'
@@ -301,6 +311,37 @@ jobs:
         shell: zsh {0}
         working-directory: tests/fixtures/crates/bin_crate
         if: matrix.os != 'windows-11-arm'
+      - name: Test show-env --csh on csh
+        run: |
+          cargo llvm-cov show-env --csh > env.csh
+          source ./env.csh
+          cargo llvm-cov clean --workspace
+          cargo build
+          cargo run -- 1
+          cargo llvm-cov report --fail-under-lines 50
+          cargo llvm-cov clean --workspace
+          cargo build
+          cargo run -- 2
+          cargo llvm-cov report --fail-under-lines 50
+        shell: bsd-csh {0}
+        working-directory: tests/fixtures/crates/bin_crate
+        if: startsWith(matrix.os, 'ubuntu') || matrix.os == ''
+      - name: Test show-env --csh on tcsh
+        run: |
+          tcsh --version
+          cargo llvm-cov show-env --csh > env.csh
+          source ./env.csh
+          cargo llvm-cov clean --workspace
+          cargo build
+          cargo run -- 1
+          cargo llvm-cov report --fail-under-lines 50
+          cargo llvm-cov clean --workspace
+          cargo build
+          cargo run -- 2
+          cargo llvm-cov report --fail-under-lines 50
+        shell: tcsh {0}
+        working-directory: tests/fixtures/crates/bin_crate
+        if: matrix.os != 'windows-11-arm'
       - name: Test show-env --fish
         run: |
           cargo llvm-cov show-env --sh > env.fish

CHANGELOG.md

@@ -12,6 +12,8 @@ Note: In this file, do not use the hard wrap in the middle of a sentence for com
 
 ## [Unreleased]
 
+- Add `--csh` to `cargo llvm-cov show-env` for csh and tcsh.
+
 - Diagnostics improvements.
 
 ## [0.8.2] - 2026-01-27

README.md

@@ -506,7 +506,7 @@ cargo llvm-cov report --lcov # Generate report without tests.
 > ```
 >
 > See "Test show-env ... on ..." in [our CI config](https://github.com/taiki-e/cargo-llvm-cov/blob/HEAD/.github/workflows/ci.yml)
-> for usage with other shells.
+> for usage with other shells (cmd.exe, csh, tcsh, fish).
 
 ### Get coverage of AFL fuzzers
 

docs/cargo-llvm-cov-show-env.txt

@@ -14,6 +14,9 @@ OPTIONS:
         --cmd
             Make output suitable to be called by cmd.exe
 
+        --csh
+            Make output suitable to be sourced by csh and tcsh
+
         --fish
             Make output suitable to be sourced by fish
 

src/cli.rs

@@ -576,20 +576,25 @@ pub(crate) enum ShowEnvFormat {
     Pwsh,
     /// Each key-value: `set {key}={value}`, where `{value}` is escaped using [`shell_escape::windows::escape`].
     Cmd,
+    /// Each key-value: `setenv {key} '{value}'`, where `{value}` is escaped using [`shell_escape::unix::escape`].
+    Csh,
     /// Each key-value: `set -gx {key}={value}`, where `{value}` is escaped using [`shell_escape::unix::escape`].
     Fish,
 }
 
 impl ShowEnvFormat {
     #[allow(clippy::fn_params_excessive_bools)]
-    pub(crate) fn new(sh: bool, pwsh: bool, cmd: bool, fish: bool) -> Result<Self> {
+    pub(crate) fn new(sh: bool, pwsh: bool, cmd: bool, csh: bool, fish: bool) -> Result<Self> {
         Ok(if sh {
             if pwsh {
                 conflicts("--sh", "--pwsh")?;
             }
             if cmd {
                 conflicts("--sh", "--cmd")?;
             }
+            if csh {
+                conflicts("--sh", "--csh")?;
+            }
             if fish {
                 conflicts("--sh", "--fish")?;
             }
@@ -598,15 +603,26 @@ impl ShowEnvFormat {
             if cmd {
                 conflicts("--pwsh", "--cmd")?;
             }
+            if csh {
+                conflicts("--pwsh", "--csh")?;
+            }
             if fish {
                 conflicts("--pwsh", "--fish")?;
             }
             ShowEnvFormat::Pwsh
         } else if cmd {
+            if csh {
+                conflicts("--cmd", "--csh")?;
+            }
             if fish {
                 conflicts("--cmd", "--fish")?;
             }
             ShowEnvFormat::Cmd
+        } else if csh {
+            if fish {
+                conflicts("--csh", "--fish")?;
+            }
+            ShowEnvFormat::Csh
         } else if fish {
             ShowEnvFormat::Fish
         } else {
@@ -634,6 +650,15 @@ impl ShowEnvFormat {
             ShowEnvFormat::Cmd => {
                 writeln!(writer, "set {key}={}", escape::cmd(value.into()))
             }
+            ShowEnvFormat::Csh => {
+                // TODO: https://en.wikipedia.org/wiki/C_shell#Quoting_and_escaping
+                let value = escape::sh(value.into());
+                if value.starts_with('"') || value.starts_with('\'') {
+                    writeln!(writer, "setenv {key} {value}")
+                } else {
+                    writeln!(writer, "setenv {key} '{value}'")
+                }
+            }
             ShowEnvFormat::Fish => {
                 // TODO: https://fishshell.com/docs/current/language.html#quotes
                 writeln!(writer, "set -gx {key}={}", escape::sh(value.into()))
@@ -781,6 +806,7 @@ impl Args {
         let mut sh = false;
         let mut pwsh = false;
         let mut cmd = false;
+        let mut csh = false;
         let mut fish = false;
 
         // options ambiguous between nextest-related and others
@@ -994,6 +1020,7 @@ impl Args {
                     parse_flag!(pwsh);
                 }
                 Long("cmd") => parse_flag!(cmd),
+                Long("csh") => parse_flag!(csh),
                 Long("fish") => parse_flag!(fish),
 
                 // ambiguous between nextest-related and others will be handled later
@@ -1099,11 +1126,15 @@ impl Args {
         // Handle options specific to certain subcommands.
         // show-env specific
         let show_env_format = match subcommand {
-            Subcommand::ShowEnv => ShowEnvFormat::new(sh, pwsh, cmd, fish)?,
+            Subcommand::ShowEnv => ShowEnvFormat::new(sh, pwsh, cmd, csh, fish)?,
             _ => {
-                for (passed, flag) in
-                    [(sh, "--sh"), (pwsh, "--pwsh"), (cmd, "--cmd"), (fish, "--fish")]
-                {
+                for (passed, flag) in [
+                    (sh, "--sh"),
+                    (pwsh, "--pwsh"),
+                    (cmd, "--cmd"),
+                    (csh, "--csh"),
+                    (fish, "--fish"),
+                ] {
                     if passed {
                         specific_flag(flag, subcommand, &["show-env"])?;
                     }

tests/test.rs

@@ -416,7 +416,7 @@ fn invalid_arg() {
         ["", "test", "run", "report", "clean", "show-env", "nextest", "nextest-archive"]
     {
         if subcommand != "show-env" {
-            for flag in ["--sh", "--pwsh", "--cmd", "--fish"] {
+            for flag in ["--sh", "--pwsh", "--cmd", "--csh", "--fish"] {
                 cargo_llvm_cov(subcommand)
                     .arg(flag)
                     .assert_failure()