554: do not attempt to use sudo on Windows

Author: asgrim

src/File/Sudo.php

@@ -4,6 +4,7 @@
 
 namespace Php\Pie\File;
 
+use Composer\Util\Platform as ComposerPlatform;
 use Php\Pie\Platform;
 use Php\Pie\Platform\TargetPlatform;
 use Symfony\Component\Process\ExecutableFinder;
@@ -23,6 +24,10 @@ final class Sudo
      */
     public static function find(): string
     {
+        if (ComposerPlatform::isWindows()) {
+            throw SudoNotFoundOnSystem::new();
+        }
+
         if (! is_string(self::$memoizedSudo)) {
             $sudo = (new ExecutableFinder())->find('sudo');
 

test/unit/File/SudoTest.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Php\PieUnitTest\File;
+
+use Composer\Util\Platform as ComposerPlatform;
+use Php\Pie\File\Sudo;
+use Php\Pie\File\SudoNotFoundOnSystem;
+use PHPUnit\Framework\Attributes\CoversClass;
+use PHPUnit\Framework\TestCase;
+
+#[CoversClass(Sudo::class)]
+final class SudoTest extends TestCase
+{
+    public function testSudoIsNeverDetectedOnWindows(): void
+    {
+        if (! ComposerPlatform::isWindows()) {
+            self::markTestSkipped('This test only applies to Windows, where a native `sudo.exe` may exist but is not usable by PIE');
+        }
+
+        self::assertFalse(Sudo::exists());
+
+        $this->expectException(SudoNotFoundOnSystem::class);
+        Sudo::find();
+    }
+}