Feature/terminal simulation for windows

.github/workflows/CICD.yml

@@ -3,7 +3,7 @@ name: CICD
 # spell-checker:ignore (abbrev/names) CICD CodeCOV MacOS MinGW MSVC musl taiki
 # spell-checker:ignore (env/flags) Awarnings Ccodegen Coverflow Cpanic Dwarnings RUSTDOCFLAGS RUSTFLAGS Zpanic CARGOFLAGS
 # spell-checker:ignore (jargon) SHAs deps dequote softprops subshell toolchain fuzzers
-# spell-checker:ignore (people) Peltoche rivy dtolnay
+# spell-checker:ignore (people) Peltoche rivy dtolnay mxschmitt
 # spell-checker:ignore (shell/tools) choco clippy dmake dpkg esac fakeroot fdesc fdescfs gmake grcov halium lcov libssl mkdir popd printf pushd rsync rustc rustfmt rustup shopt utmpdump xargs
 # spell-checker:ignore (misc) aarch alnum armhf bindir busytest coreutils defconfig DESTDIR gecos gnueabihf issuecomment maint multisize nullglob onexitbegin onexitend pell runtest Swatinem tempfile testsuite toybox uutils
 
@@ -54,8 +54,8 @@ jobs:
     steps:
     - uses: actions/checkout@v4
     - uses: dtolnay/rust-toolchain@nightly
-    ## note: requires 'nightly' toolchain b/c `cargo-udeps` uses the `rustc` '-Z save-analysis' option
-    ## * ... ref: <https://github.com/est31/cargo-udeps/issues/73>
+      ## note: requires 'nightly' toolchain b/c `cargo-udeps` uses the `rustc` '-Z save-analysis' option
+      ## * ... ref: <https://github.com/est31/cargo-udeps/issues/73>
     - uses: taiki-e/install-action@cargo-udeps
     - uses: Swatinem/rust-cache@v2
     - name: Initialize workflow variables
@@ -98,11 +98,11 @@ jobs:
       matrix:
         job:
           - { os: ubuntu-latest  , features: feat_os_unix }
-# for now, don't build it on mac & windows because the doc is only published from linux
-# + it needs a bunch of duplication for build
-# and I don't want to add a doc step in the regular build to avoid long builds
-#          - { os: macos-latest   , features: feat_os_macos }
-#          - { os: windows-latest , features: feat_os_windows }
+          # for now, don't build it on mac & windows because the doc is only published from linux
+          # + it needs a bunch of duplication for build
+          # and I don't want to add a doc step in the regular build to avoid long builds
+          #          - { os: macos-latest   , features: feat_os_macos }
+          #          - { os: windows-latest , features: feat_os_windows }
     steps:
     - uses: actions/checkout@v4
     - uses: dtolnay/rust-toolchain@master
@@ -215,6 +215,12 @@ jobs:
       env:
         RUSTFLAGS: "-Awarnings"
         RUST_BACKTRACE: "1"
+    - name: Setup tmate session
+      if: false
+      uses: mxschmitt/action-tmate@v3
+      env:
+        RUSTFLAGS: "-Awarnings"
+        RUST_BACKTRACE: "1"
 
   deps:
     name: Dependencies
@@ -308,8 +314,10 @@ jobs:
     - uses: Swatinem/rust-cache@v2
     - name: Run sccache-cache
       uses: mozilla-actions/sccache-action@v0.0.4
+      #    - name: Setup tmate session
+      #      uses: mxschmitt/action-tmate@v3
     - name: Test
-      run: cargo nextest run --hide-progress-bar --profile ci ${{ steps.vars.outputs.CARGO_FEATURES_OPTION }}
+      run: cargo nextest run --hide-progress-bar --profile ci --features ${{ matrix.job.features }}
       env:
         RUST_BACKTRACE: "1"
 
@@ -336,7 +344,7 @@ jobs:
     - name: Run sccache-cache
       uses: mozilla-actions/sccache-action@v0.0.4
     - name: Test
-      run: cargo nextest run --hide-progress-bar --profile ci ${{ steps.vars.outputs.CARGO_FEATURES_OPTION }}
+      run: cargo nextest run --hide-progress-bar --profile ci --features ${{ matrix.job.features }}
       env:
         RUST_BACKTRACE: "1"
 
@@ -466,21 +474,21 @@ jobs:
       fail-fast: false
       matrix:
         job:
-          # - { os , target , cargo-options , features , use-cross , toolchain, skip-tests }
-          - { os: ubuntu-latest  , target: arm-unknown-linux-gnueabihf, features: feat_os_unix_gnueabihf, use-cross: use-cross, skip-tests: true }
-          - { os: ubuntu-latest  , target: aarch64-unknown-linux-gnu   , features: feat_os_unix_gnueabihf , use-cross: use-cross , skip-tests: true }
-          - { os: ubuntu-latest  , target: aarch64-unknown-linux-musl  , features: feat_os_unix_musl      , use-cross: use-cross , skip-tests: true }
-          # - { os: ubuntu-latest  , target: x86_64-unknown-linux-gnu    , features: feat_selinux           , use-cross: use-cross }
-          - { os: ubuntu-latest  , target: i686-unknown-linux-gnu      , features: feat_os_unix           , use-cross: use-cross }
-          - { os: ubuntu-latest  , target: i686-unknown-linux-musl     , features: feat_os_unix_musl      , use-cross: use-cross }
-          - { os: ubuntu-latest  , target: x86_64-unknown-linux-gnu    , features: feat_os_unix           , use-cross: use-cross }
-          - { os: ubuntu-latest  , target: x86_64-unknown-linux-musl   , features: feat_os_unix_musl      , use-cross: use-cross }
-          - { os: ubuntu-latest  , target: x86_64-unknown-redox        , features: feat_os_unix_redox     , use-cross: redoxer , skip-tests: true }
-          - { os: macos-14       , target: aarch64-apple-darwin        , features: feat_os_macos } # M1 CPU
-          - { os: macos-latest   , target: x86_64-apple-darwin         , features: feat_os_macos }
-          - { os: windows-latest , target: i686-pc-windows-msvc        , features: feat_os_windows }
-          - { os: windows-latest , target: x86_64-pc-windows-gnu       , features: feat_os_windows }
-          - { os: windows-latest , target: x86_64-pc-windows-msvc      , features: feat_os_windows }
+          # - { target , os , cargo-options , features , use-cross , toolchain, skip-tests }
+          - {target: arm-unknown-linux-gnueabihf , os: ubuntu-latest  , features: feat_os_unix_gnueabihf, use-cross: use-cross, skip-tests: true }
+          - {target: aarch64-unknown-linux-gnu   , os: ubuntu-latest  , features: feat_os_unix_gnueabihf , use-cross: use-cross , skip-tests: true }
+          - {target: aarch64-unknown-linux-musl  , os: ubuntu-latest  , features: feat_os_unix_musl      , use-cross: use-cross , skip-tests: true }
+          # - {target: x86_64-unknown-linux-gnu    , os: ubuntu-latest  , features: feat_selinux           , use-cross: use-cross }
+          - {target: i686-unknown-linux-gnu      , os: ubuntu-latest  , features: feat_os_unix           , use-cross: use-cross }
+          - {target: i686-unknown-linux-musl     , os: ubuntu-latest  , features: feat_os_unix_musl      , use-cross: use-cross }
+          - {target: x86_64-unknown-linux-gnu    , os: ubuntu-latest  , features: feat_os_unix           , use-cross: use-cross }
+          - {target: x86_64-unknown-linux-musl   , os: ubuntu-latest  , features: feat_os_unix_musl      , use-cross: use-cross }
+          - {target: x86_64-unknown-redox        , os: ubuntu-latest  , features: feat_os_unix_redox     , use-cross: redoxer , skip-tests: true }
+          - {target: aarch64-apple-darwin        , os: macos-14       , features: feat_os_macos } # M1 CPU
+          - {target: x86_64-apple-darwin         , os: macos-latest   , features: feat_os_macos }
+          - {target: i686-pc-windows-msvc        , os: windows-latest , features: feat_os_windows }
+          - {target: x86_64-pc-windows-gnu       , os: windows-latest , features: feat_os_windows }
+          - {target: x86_64-pc-windows-msvc      , os: windows-latest , features: feat_os_windows }
     steps:
     - uses: actions/checkout@v4
     - uses: dtolnay/rust-toolchain@master
@@ -705,6 +713,9 @@ jobs:
         ${{ matrix.job.cargo-options }} ${{ steps.dep_vars.outputs.CARGO_UTILITY_LIST_OPTIONS }}
       env:
         RUST_BACKTRACE: "1"
+    - name: Setup tmate session
+      if: failure()
+      uses: mxschmitt/action-tmate@v3
     - name: Archive executable artifacts
       uses: actions/upload-artifact@v4
       with:
@@ -945,8 +956,8 @@ jobs:
     - uses: Swatinem/rust-cache@v2
     - name: Run sccache-cache
       uses: mozilla-actions/sccache-action@v0.0.4
-    # - name: Reattach HEAD ## may be needed for accurate code coverage info
-    #   run: git checkout ${{ github.head_ref }}
+      # - name: Reattach HEAD ## may be needed for accurate code coverage info
+      #   run: git checkout ${{ github.head_ref }}
     - name: Initialize workflow variables
       id: vars
       shell: bash
@@ -1007,6 +1018,8 @@ jobs:
         UTILITY_LIST="$(./util/show-utils.sh ${{ steps.vars.outputs.CARGO_FEATURES_OPTION }})"
         CARGO_UTILITY_LIST_OPTIONS="$(for u in ${UTILITY_LIST}; do echo -n "-puu_${u} "; done;)"
         outputs CARGO_UTILITY_LIST_OPTIONS
+        # - name: Setup tmate session
+        #  uses: mxschmitt/action-tmate@v3
     - name: Test
       run: cargo nextest run --profile ci --hide-progress-bar ${{ steps.vars.outputs.CARGO_FEATURES_OPTION }} -p uucore -p coreutils
       env:

Cargo.toml

@@ -109,6 +109,7 @@ feat_common_core = [
   "sort",
   "split",
   "sum",
+  "stty",
   "tac",
   "tail",
   "tee",
@@ -118,6 +119,7 @@ feat_common_core = [
   "truncate",
   "tsort",
   "touch",
+  "tty",
   "unexpand",
   "uniq",
   "unlink",
@@ -156,6 +158,8 @@ feat_os_unix = [
 # "feat_os_windows" == set of utilities which can be built/run on modern/usual windows platforms
 feat_os_windows = [
   "feat_Tier1", ## == "feat_os_windows_legacy" + "hostname"
+  "stty",
+  "tty",
 ]
 ## (secondary platforms) feature sets
 # "feat_os_unix_gnueabihf" == set of utilities which can be built/run on the "arm-unknown-linux-gnueabihf" target (ARMv6 Linux [hardfloat])
@@ -330,7 +334,7 @@ unicode-width = "0.1.11"
 utf-8 = "0.7.6"
 walkdir = "2.5"
 winapi-util = "0.1.6"
-windows-sys = { version = "0.48.0", default-features = false }
+windows-sys = { version = "0.48.0", default-features = false, features = ["Win32_Foundation", "Win32_Security", "Win32_System_Pipes"]}
 xattr = "1.3.1"
 zip = { version = "0.6.6", default-features = false, features = ["deflate"] }
 
@@ -501,6 +505,8 @@ rlimit = "0.10.1"
 rand_pcg = "0.3"
 xattr = { workspace = true }
 
+[target.'cfg(windows)'.dev-dependencies]
+
 [build-dependencies]
 phf_codegen = { workspace = true }
 

GNUmakefile

@@ -110,6 +110,7 @@ PROGS       := \
 	sleep \
 	sort \
 	split \
+	stty \
 	sum \
 	sync \
 	tac \
@@ -150,6 +151,7 @@ UNIX_PROGS := \
 	sleep \
 	stat \
 	stdbuf \
+	stty \
 	timeout \
 	touch \
 	tty \
@@ -227,6 +229,7 @@ TEST_PROGS  := \
 	split \
 	stat \
 	stdbuf \
+	stty \
 	sum \
 	tac \
 	tail \
@@ -236,6 +239,7 @@ TEST_PROGS  := \
 	true \
 	truncate \
 	tsort \
+	tty \
 	uname \
 	unexpand \
 	uniq \