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;
+    }
 }