Special return code when update-eng made no change.

Author: gfraiteur

src/PostSharp.Engineering.BuildTools/BaseCommand.cs

@@ -156,21 +156,21 @@ public sealed override int Execute( CommandContext context, T settings )
 
                 if ( buildContext.CancellationToken.IsCancellationRequested )
                 {
-                    return (int) ExitCodes.Cancelled;
+                    return (int) ExitCode.Cancelled;
                 }
 
                 if ( !settings.NoLogo )
                 {
                     buildContext.Console.WriteMessage( $"Finished at {DateTime.Now} after {stopwatch.Elapsed}." );
                 }
 
-                return (int) (success ? ExitCodes.Success : ExitCodes.Error);
+                return (int) (success ? buildContext.ExitCode : ExitCode.Error);
             }
             catch ( Exception ex )
             {
                 AnsiConsole.WriteException( ex );
 
-                return (int) ExitCodes.Exception;
+                return (int) ExitCode.Exception;
             }
             finally
             {

src/PostSharp.Engineering.BuildTools/Build/BuildContext.cs

@@ -200,7 +200,9 @@ internal TimeSpan BuildTimeout
             }
         }
 
-        // Adds a margin to dump the hanging processes.
-        internal TimeSpan BuildTimeoutWithMargin => this.BuildTimeout.Add( TimeSpan.FromMinutes( 5 ) );
+        /// <summary>
+        /// Gets or sets the exit code in case the <see cref="BaseCommand{T}.ExecuteCore"/> method returns <c>true</c>.
+        /// </summary>
+        public ExitCode ExitCode { get; set; } = ExitCode.Success;
     }
 }

src/PostSharp.Engineering.BuildTools/Dependencies/UpdateEngineeringCommand.cs

@@ -136,6 +136,7 @@ protected override bool ExecuteCore( BuildContext context, CommonCommandSettings
         else
         {
             console.WriteWarning( $"PostSharp.Engineering was already of the latest version ({lastVersion})." );
+            context.ExitCode = ExitCode.NoChangeMade;
         }
 
         return true;

src/PostSharp.Engineering.BuildTools/ExitCode.cs

@@ -0,0 +1,31 @@
+// Copyright (c) SharpCrafters s.r.o. See the LICENSE.md file in the root directory of this repository root for details.
+
+namespace PostSharp.Engineering.BuildTools;
+
+public enum ExitCode
+{
+    /// <summary>
+    /// Success.
+    /// </summary>
+    Success,
+
+    /// <summary>
+    /// Handled error.
+    /// </summary>
+    Error,
+
+    /// <summary>
+    /// No change was made.
+    /// </summary>
+    NoChangeMade,
+
+    /// <summary>
+    /// Unhandled exception.
+    /// </summary>
+    Exception = 100,
+
+    /// <summary>
+    /// Cancelled through Ctrl+C.
+    /// </summary>
+    Cancelled = 200
+}