feat(HasSudoPassword): Add withoutSudoPassword method to clear sudo password

guanguans · guanguans · commit 2fd77fa05cdf · 2025-12-03T18:10:47.000+08:00
- Add withoutSudoPassword() to clear the sudo password by delegating to withSudoPassword(null)
- Update tests to ensure withoutSudoPassword() yields a null sudo password before setting a new one
- Preserve fluent interface by returning self from the new method
- Provide clearer, explicit API for removing the sudo password when needed

Signed-off-by: guanguans &lt;ityaozm@gmail.com&gt;
diff --git a/baselines/loader.neon b/baselines/loader.neon
@@ -1,4 +1,4 @@
-# total 7 errors
+# total 8 errors
 
 includes:
     - assign.propertyType.neon
diff --git a/baselines/typePerfect.narrowPublicClassMethodParamType.neon b/baselines/typePerfect.narrowPublicClassMethodParamType.neon
@@ -1,8 +1,13 @@
-# total 1 error
+# total 2 errors
 
 parameters:
     ignoreErrors:
         -
             message: '#^Parameters should have "array" types as the only types passed to this method$#'
             count: 1
             path: ../src/Soar.php
+
+        -
+            message: '#^Parameters should have "null" types as the only types passed to this method$#'
+            count: 1
+            path: ../src/Soar.php
diff --git a/src/Concerns/HasSudoPassword.php b/src/Concerns/HasSudoPassword.php
@@ -27,6 +27,11 @@ public function getSudoPassword(): ?string
         return $this->sudoPassword;
     }
 
+    public function withoutSudoPassword(): self
+    {
+        return $this->withSudoPassword(null);
+    }
+
     public function withSudoPassword(
         #[\SensitiveParameter]
         ?string $sudoPassword
diff --git a/tests/Concerns/HasSudoPasswordTest.php b/tests/Concerns/HasSudoPasswordTest.php
@@ -23,6 +23,8 @@
 
 it('can set sudo password', function (): void {
     expect(Soar::make())
+        ->withoutSudoPassword()
+        ->getSudoPassword()->toBeNull()
         ->withSudoPassword($sudoPassword = 'foo')
         ->getSudoPassword()->toBe($sudoPassword);
 })->group(__DIR__, __FILE__);

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# total 7 errors`
	`1`	`+# total 8 errors`
`2`	`2`
`3`	`3`	`includes:`
`4`	`4`	`- assign.propertyType.neon`