use Ct alias for CancellationToken

Author: adamralph

Directory.Build.props

@@ -21,4 +21,8 @@
     <ContinuousIntegrationBuild>true</ContinuousIntegrationBuild>
   </PropertyGroup>
 
+  <ItemGroup>
+    <Compile Include="$(MSBuildThisFileDirectory)/Global.cs" Link="Global.cs" />
+  </ItemGroup>
+
 </Project>

Global.cs

@@ -0,0 +1,3 @@
+#pragma warning disable IDE0005 // Remove unnecessary using directives
+global using Ct = System.Threading.CancellationToken;
+#pragma warning restore IDE0005

SimpleExec/Command.cs

@@ -35,7 +35,7 @@ public static class Command
     /// If set to <c>true</c>, when the command is cancelled, any child processes created by the command
     /// are left running after the command is cancelled.
     /// </param>
-    /// <param name="cancellationToken">A <see cref="CancellationToken"/> to observe while waiting for the command to exit.</param>
+    /// <param name="cancellationToken">A <see cref="Ct"/> to observe while waiting for the command to exit.</param>
     /// <exception cref="ExitCodeException">The command exited with non-zero exit code.</exception>
     /// <remarks>
     /// By default, the resulting command line and the working directory (if specified) are echoed to standard output (stdout).
@@ -52,7 +52,7 @@ public static void Run(
         bool createNoWindow = false,
         Func<int, bool>? handleExitCode = null,
         bool cancellationIgnoresProcessTree = false,
-        CancellationToken cancellationToken = default) =>
+        Ct cancellationToken = default) =>
         ProcessStartInfo
             .Create(
                 Resolve(Validate(name)),
@@ -89,7 +89,7 @@ public static void Run(
     /// If set to <c>true</c>, when the command is cancelled, any child processes created by the command
     /// are left running after the command is cancelled.
     /// </param>
-    /// <param name="cancellationToken">A <see cref="CancellationToken"/> to observe while waiting for the command to exit.</param>
+    /// <param name="cancellationToken">A <see cref="Ct"/> to observe while waiting for the command to exit.</param>
     /// <exception cref="ExitCodeException">The command exited with non-zero exit code.</exception>
     public static void Run(
         string name,
@@ -102,7 +102,7 @@ public static void Run(
         bool createNoWindow = false,
         Func<int, bool>? handleExitCode = null,
         bool cancellationIgnoresProcessTree = false,
-        CancellationToken cancellationToken = default) =>
+        Ct cancellationToken = default) =>
         ProcessStartInfo
             .Create(
                 Resolve(Validate(name)),
@@ -121,7 +121,7 @@ private static void Run(
         string echoPrefix,
         Func<int, bool>? handleExitCode,
         bool cancellationIgnoresProcessTree,
-        CancellationToken cancellationToken)
+        Ct cancellationToken)
     {
         using var process = new Process();
         process.StartInfo = startInfo;
@@ -156,7 +156,7 @@ private static void Run(
     /// If set to <c>true</c>, when the command is cancelled, any child processes created by the command
     /// are left running after the command is cancelled.
     /// </param>
-    /// <param name="cancellationToken">A <see cref="CancellationToken"/> to observe while waiting for the command to exit.</param>
+    /// <param name="cancellationToken">A <see cref="Ct"/> to observe while waiting for the command to exit.</param>
     /// <returns>A <see cref="Task"/> that represents the asynchronous running of the command.</returns>
     /// <exception cref="ExitCodeReadException">The command exited with non-zero exit code.</exception>
     /// <remarks>
@@ -174,7 +174,7 @@ public static Task RunAsync(
         bool createNoWindow = false,
         Func<int, bool>? handleExitCode = null,
         bool cancellationIgnoresProcessTree = false,
-        CancellationToken cancellationToken = default) =>
+        Ct cancellationToken = default) =>
         ProcessStartInfo
             .Create(
                 Resolve(Validate(name)),
@@ -211,7 +211,7 @@ public static Task RunAsync(
     /// If set to <c>true</c>, when the command is cancelled, any child processes created by the command
     /// are left running after the command is cancelled.
     /// </param>
-    /// <param name="cancellationToken">A <see cref="CancellationToken"/> to observe while waiting for the command to exit.</param>
+    /// <param name="cancellationToken">A <see cref="Ct"/> to observe while waiting for the command to exit.</param>
     /// <returns>A <see cref="Task"/> that represents the asynchronous running of the command.</returns>
     /// <exception cref="ExitCodeReadException">The command exited with non-zero exit code.</exception>
     public static Task RunAsync(
@@ -225,7 +225,7 @@ public static Task RunAsync(
         bool createNoWindow = false,
         Func<int, bool>? handleExitCode = null,
         bool cancellationIgnoresProcessTree = false,
-        CancellationToken cancellationToken = default) =>
+        Ct cancellationToken = default) =>
         ProcessStartInfo
             .Create(
                 Resolve(Validate(name)),
@@ -244,7 +244,7 @@ private static async Task RunAsync(
         string echoPrefix,
         Func<int, bool>? handleExitCode,
         bool cancellationIgnoresProcessTree,
-        CancellationToken cancellationToken)
+        Ct cancellationToken)
     {
         using var process = new Process();
         process.StartInfo = startInfo;
@@ -276,7 +276,7 @@ private static async Task RunAsync(
     /// If set to <c>true</c>, when the command is cancelled, any child processes created by the command
     /// are left running after the command is cancelled.
     /// </param>
-    /// <param name="cancellationToken">A <see cref="CancellationToken"/> to observe while waiting for the command to exit.</param>
+    /// <param name="cancellationToken">A <see cref="Ct"/> to observe while waiting for the command to exit.</param>
     /// <returns>
     /// A <see cref="Task{TResult}"/> representing the asynchronous running of the command and reading of standard output (stdout) and standard error (stderr).
     /// The task result is a <see cref="ValueTuple{T1, T2}"/> representing the contents of standard output (stdout) and standard error (stderr).
@@ -293,7 +293,7 @@ private static async Task RunAsync(
         Func<int, bool>? handleExitCode = null,
         string? standardInput = null,
         bool cancellationIgnoresProcessTree = false,
-        CancellationToken cancellationToken = default) =>
+        Ct cancellationToken = default) =>
         ProcessStartInfo
             .Create(
                 Resolve(Validate(name)),
@@ -332,7 +332,7 @@ private static async Task RunAsync(
     /// If set to <c>true</c>, when the command is cancelled, any child processes created by the command
     /// are left running after the command is cancelled.
     /// </param>
-    /// <param name="cancellationToken">A <see cref="CancellationToken"/> to observe while waiting for the command to exit.</param>
+    /// <param name="cancellationToken">A <see cref="Ct"/> to observe while waiting for the command to exit.</param>
     /// <returns>
     /// A <see cref="Task{TResult}"/> representing the asynchronous running of the command and reading of standard output (stdout) and standard error (stderr).
     /// The task result is a <see cref="ValueTuple{T1, T2}"/> representing the contents of standard output (stdout) and standard error (stderr).
@@ -349,7 +349,7 @@ private static async Task RunAsync(
         Func<int, bool>? handleExitCode = null,
         string? standardInput = null,
         bool cancellationIgnoresProcessTree = false,
-        CancellationToken cancellationToken = default) =>
+        Ct cancellationToken = default) =>
         ProcessStartInfo
             .Create(
                 Resolve(Validate(name)),
@@ -371,7 +371,7 @@ private static async Task RunAsync(
         Func<int, bool>? handleExitCode,
         string? standardInput,
         bool cancellationIgnoresProcessTree,
-        CancellationToken cancellationToken)
+        Ct cancellationToken)
     {
         using var process = new Process();
         process.StartInfo = startInfo;

SimpleExec/ProcessExtensions.cs

@@ -7,7 +7,7 @@ namespace SimpleExec;
 
 internal static class ProcessExtensions
 {
-    public static void Run(this Process process, IEnumerable<string> secrets, bool noEcho, string echoPrefix, bool cancellationIgnoresProcessTree, CancellationToken cancellationToken)
+    public static void Run(this Process process, IEnumerable<string> secrets, bool noEcho, string echoPrefix, bool cancellationIgnoresProcessTree, Ct cancellationToken)
     {
         var cancelled = new StrongBox<long>(0);
 
@@ -36,7 +36,7 @@ public static void Run(this Process process, IEnumerable<string> secrets, bool n
         }
     }
 
-    public static async Task RunAsync(this Process process, IEnumerable<string> secrets, bool noEcho, string echoPrefix, bool cancellationIgnoresProcessTree, CancellationToken cancellationToken)
+    public static async Task RunAsync(this Process process, IEnumerable<string> secrets, bool noEcho, string echoPrefix, bool cancellationIgnoresProcessTree, Ct cancellationToken)
     {
         using var sync = new SemaphoreSlim(1, 1);
         var tcs = new TaskCompletionSource(TaskCreationOptions.RunContinuationsAsynchronously);

SimpleExecTests/EchoingCommands.cs

@@ -10,7 +10,7 @@ public static class EchoingCommands
     private const string SecretLower = "secret";
     private const string SecretUpper = "SECRET";
 
-    private static CancellationToken Ct => TestContext.Current.CancellationToken;
+    private static Ct Ct => TestContext.Current.CancellationToken;
 
     [Fact]
     public static void EchoingACommand()

SimpleExecTests/ExitCodes.cs

@@ -6,7 +6,7 @@ namespace SimpleExecTests;
 
 public static class ExitCodes
 {
-    private static CancellationToken Ct => TestContext.Current.CancellationToken;
+    private static Ct Ct => TestContext.Current.CancellationToken;
 
     [Theory]
     [InlineData(0, false)]

SimpleExecTests/ReadingCommands.cs

@@ -8,7 +8,7 @@ namespace SimpleExecTests;
 
 public static class ReadingCommands
 {
-    private static CancellationToken Ct => TestContext.Current.CancellationToken;
+    private static Ct Ct => TestContext.Current.CancellationToken;
 
     [Theory]
     [InlineData(false)]

SimpleExecTests/RunningCommands.cs

@@ -10,7 +10,7 @@ namespace SimpleExecTests;
 public static class RunningCommands
 {
     private static readonly string Command = RuntimeInformation.IsOSPlatform(OSPlatform.Windows) ? "hello-world.cmd" : "ls";
-    private static CancellationToken Ct => TestContext.Current.CancellationToken;
+    private static Ct Ct => TestContext.Current.CancellationToken;
 
     public static bool OsPlatformIsWindows => RuntimeInformation.IsOSPlatform(OSPlatform.Windows);