feat(pty): add Windows ConPTY provider

.github/workflows/test.yml

@@ -28,10 +28,14 @@ jobs:
 
     name: "Test on ${{ matrix.platform }} with Rust ${{ matrix.toolchain }} (feat: ${{ matrix.features }})"
     runs-on: "${{ matrix.platform }}-latest"
+    timeout-minutes: 30
+    env:
+      PROCESS_WRAP_EXPECT_CONPTY: "${{ matrix.platform == 'windows' && '1' || '0' }}"
 
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
           persist-credentials: false
 
       - name: Configure Rust
@@ -41,6 +45,11 @@ jobs:
           rustup default ${{ matrix.toolchain }}
           rustup component add clippy
 
+      - name: Report expected ConPTY mode
+        if: matrix.platform == 'windows'
+        shell: pwsh
+        run: Write-Host "PROCESS_WRAP_EXPECT_CONPTY=$env:PROCESS_WRAP_EXPECT_CONPTY"
+
       - run: tests/multiproc_helper.rs 1 1
 
       - name: Test defaults plus frontend
@@ -50,6 +59,14 @@ jobs:
         if: matrix.toolchain == 'stable'
         run: cargo test --locked --no-default-features --features ${{ matrix.features }} --all-targets
 
+      - name: Compile PTY README example as a downstream crate
+        if: matrix.features == 'pty'
+        run: cargo check --locked --manifest-path tests/readme/pty/Cargo.toml
+
+      - name: Compile Windows README example as a downstream crate
+        if: matrix.platform == 'windows' && matrix.features == 'pty'
+        run: cargo check --locked --manifest-path tests/readme/windows/Cargo.toml
+
       - run: cargo clippy --locked --features ${{ matrix.features }} --all-targets
 
   no-default-features:
@@ -59,6 +76,7 @@ jobs:
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
           persist-credentials: false
 
       - name: Configure Rust
@@ -68,6 +86,25 @@ jobs:
 
       - run: cargo check --locked --no-default-features --lib
 
+  windows-production-features:
+    name: Check Windows production feature closure
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
+          persist-credentials: false
+
+      - name: Configure Rust
+        run: |
+          rustup toolchain install --profile minimal --no-self-update stable
+          rustup default stable
+          rustup target add x86_64-pc-windows-gnu
+
+      - name: Check Tokio JobObject production library
+        run: cargo check --locked --target x86_64-pc-windows-gnu --no-default-features --features tokio1,job-object --lib
+
   # Miri deliberately excludes native process creation and FFI.
   miri-process-free:
     name: Miri (process-free state and ownership)
@@ -76,6 +113,7 @@ jobs:
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
           persist-credentials: false
 
       - name: Configure Rust
@@ -101,10 +139,14 @@ jobs:
 
     name: "Test all features on ${{ matrix.platform }}"
     runs-on: "${{ matrix.platform }}-latest"
+    timeout-minutes: 30
+    env:
+      PROCESS_WRAP_EXPECT_CONPTY: "${{ matrix.platform == 'windows' && '1' || '0' }}"
 
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
           persist-credentials: false
 
       - name: Configure Rust
@@ -114,6 +156,11 @@ jobs:
           rustup default stable
           rustup component add clippy
 
+      - name: Report expected ConPTY mode
+        if: matrix.platform == 'windows'
+        shell: pwsh
+        run: Write-Host "PROCESS_WRAP_EXPECT_CONPTY=$env:PROCESS_WRAP_EXPECT_CONPTY"
+
       - run: tests/multiproc_helper.rs 1 1
       - run: cargo test --locked --all-features --all-targets
       - run: cargo clippy --locked --all-features --all-targets
@@ -125,6 +172,7 @@ jobs:
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
           persist-credentials: false
 
       - name: Configure Rust
@@ -163,6 +211,7 @@ jobs:
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
           persist-credentials: false
 
       - name: Configure Rust
@@ -184,13 +233,18 @@ jobs:
             cargo clippy --locked --target "${{ matrix.target }}" --no-default-features --features pty --lib
           fi
 
+      - name: Compile unsupported PTY integration test
+        if: matrix.target == 'aarch64-apple-ios'
+        run: cargo check --locked --target aarch64-apple-ios --all-features --test tokio_pty_unsupported
+
   rustdoc:
     name: Rustdoc
     runs-on: ubuntu-latest
 
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
           persist-credentials: false
 
       - name: Configure Rust
@@ -206,13 +260,17 @@ jobs:
       - name: Test documentation examples
         run: cargo test --locked --all-features --doc
 
+      - name: Compile PTY README example as a downstream crate
+        run: cargo check --locked --manifest-path tests/readme/pty/Cargo.toml
+
   package:
     name: Package contents
     runs-on: ubuntu-latest
 
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
           persist-credentials: false
 
       - name: Configure Rust
@@ -233,6 +291,7 @@ jobs:
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
           fetch-depth: 0
           persist-credentials: false
 
@@ -260,6 +319,7 @@ jobs:
     steps:
       - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
         with:
+          ref: ${{ github.event_name == 'pull_request' && github.event.pull_request.head.sha || github.sha }}
           persist-credentials: false
 
       - name: Configure Rust

Cargo.toml

@@ -44,10 +44,12 @@ windows = { version = "0.62.2", optional = true }
 # as process-wrap is carefully designed to never expose windows's types
 
 [dev-dependencies]
-remoteprocess = "0.5.0"
 tempfile = { version = "3.20.0", default-features = false }
 tokio = { version = "1.38.2", features = ["io-util", "macros", "process", "rt", "rt-multi-thread", "time"] }
 
+[target.'cfg(any(target_os = "freebsd", target_os = "linux", target_os = "macos"))'.dev-dependencies]
+remoteprocess = "0.5.0"
+
 [features]
 default = ["creation-flags", "job-object", "kill-on-drop", "process-group", "process-session", "tracing"]
 
@@ -67,7 +69,13 @@ pty = [
     "tokio/net",
     "dep:windows",
     "windows/Win32_Globalization",
+    "windows/Win32_Security",
+    "windows/Win32_Storage_FileSystem",
+    "windows/Win32_System_Console",
     "windows/Win32_System_Environment",
+    "windows/Win32_System_LibraryLoader",
+    "windows/Win32_System_Pipes",
+    "windows/Win32_System_SystemInformation",
     "windows/Win32_System_Threading",
 ]