Ability to log a summary message

Author: NikolayPianikov

CSharpInteractive.HostApi/IHost.cs

@@ -88,6 +88,17 @@ public interface IHost
     /// <param name="warning">Warning message.</param>
     void Warning(string? warning);
 
+    /// <summary>
+    /// Writes a summary message to stdOut.
+    /// <example>
+    /// <code>
+    /// Info("Some info");
+    /// </code>
+    /// </example>
+    /// </summary>
+    /// <param name="summary">Summary message.</param>
+    void Summary(string? summary);
+
     /// <summary>
     /// Writes an information message to stdOut.
     /// <example>

CSharpInteractive.Tests/ProcessResultHandlerTests.cs

@@ -29,7 +29,7 @@ internal void ShouldLogInfoWhenFinishedAndHasHandler(ProcessState state)
     }
 
     [Fact]
-    public void ShouldLogInfoWhenFinishedAndHasNoHandler()
+    public void ShouldLogSummaryWhenFinishedAndHasNoHandler()
     {
         // Given
         var handler = CreateInstance();
@@ -38,7 +38,7 @@ public void ShouldLogInfoWhenFinishedAndHasNoHandler()
         handler.Handle(new ProcessResult(_processInfo, ProcessState.Finished, 12, _description), default(Action<object>));
 
         // Then
-        _log.Verify(i => i.Info(_description));
+        _log.Verify(i => i.Summary(_description));
     }
 
     [Fact]

CSharpInteractive.Tests/UsageScenarios/BaseScenario.cs

@@ -73,6 +73,8 @@ public bool HasSdk(string sdkVersion)
 
     public void Warning(string? warning) => Composition.Shared.Root.Host.Warning(warning);
 
+    public void Summary(string? summary) => Composition.Shared.Root.Host.Summary(summary);
+
     public void Info(string? text) => Composition.Shared.Root.Host.Info(text);
 
     public void Trace(string? trace, string? origin = null) => Composition.Shared.Root.Host.Trace(trace, origin);

CSharpInteractive.Tests/UsageScenarios/LogSummaryScenario.cs

@@ -0,0 +1,23 @@
+// ReSharper disable StringLiteralTypo
+// ReSharper disable SuggestVarOrType_BuiltInTypes
+
+namespace CSharpInteractive.Tests.UsageScenarios;
+
+using System;
+
+public class LogSummaryScenario(ITestOutputHelper output) : BaseScenario(output)
+{
+    [SkippableFact]
+    public void Run()
+    {
+        Skip.IfNot(string.IsNullOrWhiteSpace(Environment.GetEnvironmentVariable("TEAMCITY_VERSION")));
+
+        // $visible=true
+        // $tag=01 Output, logging and tracing
+        // $priority=04
+        // $description=Registering a summary in the build log
+        // {
+        Summary("Summary message");
+        // }
+    }
+}

CSharpInteractive/Core/HostService.cs

@@ -45,6 +45,14 @@ public void Warning(string? warning)
         }
     }
 
+    public void Summary(string? summary)
+    {
+        if (summary != null)
+        {
+            log.Summary(summary);
+        }
+    }
+
     public void Info(string? text)
     {
         if (text != null)

CSharpInteractive/Core/ILog.cs

@@ -8,6 +8,8 @@ internal interface ILog<T>
 
     void Warning(params Text[] warning);
 
+    void Summary(params Text[] summary);
+
     void Info(params Text[] message);
 
     void Trace(Func<Text[]> traceMessagesFactory, string origin = "");

CSharpInteractive/Core/IStatistics.cs

@@ -8,6 +8,8 @@ internal interface IStatistics
 
     IReadOnlyCollection<Text[]> Warnings { get; }
 
+    IReadOnlyCollection<Text[]> Summary { get; }
+
     TimeSpan TimeElapsed { get; }
 
     IReadOnlyCollection<CommandLineInfo> CommandLines { get; }

CSharpInteractive/Core/IStatisticsRegistry.cs

@@ -7,4 +7,6 @@ internal interface IStatisticsRegistry
     void RegisterError(Text[] error);
 
     void RegisterWarning(Text[] warning);
+
+    void RegisterSummary(Text[] summary);
 }

CSharpInteractive/Core/Log.cs

@@ -34,6 +34,17 @@ public void Warning(params Text[] warning)
         stdOut.WriteLine(warning);
     }
 
+    public void Summary(params Text[] summary)
+    {
+        if (summary.Length == 0)
+        {
+            return;
+        }
+
+        statisticsRegistry.RegisterSummary(summary);
+        stdOut.WriteLine(GetMessage(summary, Color.Highlighted));
+    }
+
     public void Info(params Text[] message)
     {
         if (settings.VerbosityLevel >= VerbosityLevel.Normal)

CSharpInteractive/Core/LogExtensions.cs

@@ -31,4 +31,10 @@ public static ILog<T> Warning<T>(this ILog<T> log, params string[] warning)
         log.Warning(warning.Select(i => new Text(i, Color.Warning)).ToArray());
         return log;
     }
+
+    public static ILog<T> Summary<T>(this ILog<T> log, params string[] summary)
+    {
+        log.Summary(summary.Select(i => new Text(i, Color.Highlighted)).ToArray());
+        return log;
+    }
 }

CSharpInteractive/Core/ProcessResultHandler.cs

@@ -35,7 +35,7 @@ public void Handle<T>(ProcessResult result, Action<T>? handler)
 
                 case ProcessState.Finished:
                 default:
-                    log.Info(description);
+                    log.Summary(description);
                     break;
             }
         }

CSharpInteractive/Core/Statistics.cs

@@ -12,6 +12,7 @@ internal class Statistics : IStatisticsRegistry, IStatistics, ICommandLineStatis
     private readonly Stopwatch _stopwatch = new();
     private readonly List<Text[]> _errors = [];
     private readonly List<Text[]> _warnings = [];
+    private readonly List<Text[]> _summary = [];
     private readonly List<CommandLineInfo> _info = [];
 
     public bool IsEmpty => Errors.Count == 0 && Warnings.Count == 0 && CommandLines.Count == 0;
@@ -22,7 +23,7 @@ public IReadOnlyCollection<Text[]> Errors
         {
             lock (_lockObject)
             {
-                return new ReadOnlyCollection<Text[]>(_errors);
+                return _errors.AsReadOnly();
             }
         }
     }
@@ -33,7 +34,18 @@ public IReadOnlyCollection<Text[]> Warnings
         {
             lock (_lockObject)
             {
-                return new ReadOnlyCollection<Text[]>(_warnings);
+                return _warnings.AsReadOnly();
+            }
+        }
+    }
+
+    public IReadOnlyCollection<Text[]> Summary
+    {
+        get
+        {
+            lock (_lockObject)
+            {
+                return _summary.AsReadOnly();
             }
         }
     }
@@ -70,6 +82,18 @@ public void RegisterWarning(Text[] warning)
         }
     }
 
+    public void RegisterSummary(Text[] summary)
+    {
+        summary = summary.Trim();
+        if (!summary.IsEmptyOrWhiteSpace())
+        {
+            lock (_lockObject)
+            {
+                _summary.Add(summary);
+            }
+        }
+    }
+
     public IReadOnlyCollection<CommandLineInfo> CommandLines
     {
         get

CSharpInteractive/Core/StatisticsPresenter.cs

@@ -18,6 +18,11 @@ public void Show(IStatistics statistics)
 
         Show(tests);
 
+        foreach (var summary in statistics.Summary)
+        {
+            log.Info(summary.AddPrefix(_ => Tab));
+        }
+
         foreach (var warning in statistics.Warnings)
         {
             log.Info(warning.AddPrefix(_ => Tab));

CSharpInteractive/Core/SummaryPresenter.cs

@@ -23,11 +23,6 @@ public void Show(Summary summary)
         if (!statistics.IsEmpty)
         {
             log.Info(new Text("Summary:", Color.Header));
-            foreach (var commandLineInfo in statistics.CommandLines)
-            {
-                log.Info(commandLineInfo.ProcessResult.Description.AddPrefix(_ => Tab));
-            }
-
             statisticsPresenter.Show(statistics);
         }
 

CSharpInteractive/Core/TeamCityLog.cs

@@ -26,6 +26,12 @@ public void Warning(params Text[] warning)
         teamCityWriter.WriteWarning(message);
     }
 
+    public void Summary(params Text[] summary)
+    {
+        statisticsRegistry.RegisterSummary(summary);
+        teamCityWriter.WriteMessage(lineFormatter.Format(summary));
+    }
+
     public void Info(params Text[] message)
     {
         if (settings.VerbosityLevel >= VerbosityLevel.Normal)

CSharpInteractive/Host.cs

@@ -162,6 +162,17 @@ private static void CurrentDomainOnUnhandledException(object sender, UnhandledEx
     /// <param name="warning">Warning message.</param>
     public static void Warning(string? warning) => CurHost.Warning(warning);
 
+    /// <summary>
+    /// Writes a summary message to stdOut.
+    /// <example>
+    /// <code>
+    /// Info("Some info");
+    /// </code>
+    /// </example>
+    /// </summary>
+    /// <param name="summary">Summary message.</param>
+    public static void Summary(string? summary) => CurHost.Summary(summary);
+
     /// <summary>
     /// Writes an information message to stdOut.
     /// <example>

Samples/MySampleLib/Build/Program.cs

@@ -8,6 +8,7 @@
 // Output, logging and tracing API
 WriteLine("Hello");
 WriteLine("Hello !!!", Color.Highlighted);
+Summary("Summary message");
 Error("Error details", "ErrorId");
 Warning("Warning");
 Info("Some info");