feat!: Add support for returning result (#9)

* feat!: Add support for returning result

Added support for returning results from remote methods.
In doing so, a need for embracing the async nature of the problem
was exposed, so now the protocol interfaces have to be declared with
methods returning either Task or Task<T>.

* Update src/apps/H.Ipc.Apps.Wpf/H.Ipc.Apps.Wpf.csproj

* fix: Cleanup according to review

- Avoid adding 'using' statements in generated code
- Revert some package version updates
- Remove temporary (debug/learning) code
- Add doc comments

* Update src/libs/H.Ipc.Generator/HIpcGenerator.cs

---------

Co-authored-by: Konstantin S <[email protected]>

src/apps/H.Ipc.Apps.Wpf/ClientWindow.xaml.cs

@@ -1,4 +1,5 @@
-using System.Windows;
+using System.Diagnostics.CodeAnalysis;
+using System.Windows;
 using H.Pipes;
 
 namespace H.Ipc.Apps.Wpf;
@@ -73,11 +74,11 @@ private async void Window_Unloaded(object _, RoutedEventArgs e)
  }
  }
 
- private void RaiseEvent1Button_Click(object sender, RoutedEventArgs e)
+ private async void RaiseEvent1Button_Click(object sender, RoutedEventArgs e)
  {
  try
  {
- ActionServiceClient.ShowTrayIcon();
+ await ActionServiceClient.ShowTrayIcon();
  //if (Instance == null)
  //{
  // return;
@@ -92,11 +93,11 @@ private void RaiseEvent1Button_Click(object sender, RoutedEventArgs e)
  }
  }
 
- private void RaiseEvent3Button_Click(object sender, RoutedEventArgs e)
+ private async void RaiseEvent3Button_Click(object sender, RoutedEventArgs e)
  {
  try
  {
- ActionServiceClient.HideTrayIcon();
+ await ActionServiceClient.HideTrayIcon();
  //if (Instance == null)
  //{
  // return;
@@ -129,11 +130,11 @@ private void Method1Button_Click(object sender, RoutedEventArgs e)
  }
  }
 
- private void Method2Button_Click(object sender, RoutedEventArgs e)
+ private async void Method2Button_Click(object sender, RoutedEventArgs e)
  {
  try
  {
- ActionServiceClient.SendText(Method2ArgumentTextBox.Text);
+ await ActionServiceClient.SendText(Method2ArgumentTextBox.Text);
  }
  catch (Exception exception)
  {

src/apps/H.Ipc.Apps.Wpf/IActionService.cs

@@ -2,13 +2,19 @@
 
 namespace H.Ipc.Apps.Wpf;
 
+public class Person
+{
+ public string? Name { get; set; }
+}
+
 public interface IActionService
 {
- void SendText(string text);
- void ShowTrayIcon();
- void HideTrayIcon();
+ Task SendText(string text);
+ Task ShowTrayIcon();
+ Task HideTrayIcon();
 
- //event EventHandler<string> TextReceived;
+ Task<int> CalculateResult();
+ Task<Person> GetPerson();
 }
 
 [H.IpcGenerators.IpcClient]
@@ -19,18 +25,31 @@ public partial class ActionServiceClient : IActionService
 [H.IpcGenerators.IpcServer]
 public partial class ActionService : IActionService
 {
- public void ShowTrayIcon()
+ public Task ShowTrayIcon()
  {
  MessageBox.Show(nameof(ShowTrayIcon));
+ return Task.CompletedTask;
  }
 
- public void HideTrayIcon()
+ public Task HideTrayIcon()
  {
  MessageBox.Show(nameof(HideTrayIcon));
+ return Task.CompletedTask;
+ }
+
+ public Task<Person> GetPerson()
+ {
+ return Task.FromResult(new Person());
+ }
+
+ public Task<int> CalculateResult()
+ {
+ return Task.FromResult(10);
  }
 
- public void SendText(string text)
+ public Task SendText(string text)
  {
  MessageBox.Show(text);
+ return Task.CompletedTask;
  }
 }

src/libs/H.Ipc.Generator/H.Ipc.Generator.csproj

@@ -4,6 +4,7 @@
  <TargetFramework>netstandard2.0</TargetFramework>
  <IsPackable>false</IsPackable>
  <GenerateDocumentationFile>false</GenerateDocumentationFile>
+ <EnforceExtendedAnalyzerRules>true</EnforceExtendedAnalyzerRules>
  <NoWarn>$(NoWarn);CA1014;CA1031</NoWarn>
  </PropertyGroup>
 

src/libs/H.Ipc.Generator/HIpcGenerator.cs

@@ -1,4 +1,5 @@
-using Microsoft.CodeAnalysis;
+using H.Generators.Extensions;
+using Microsoft.CodeAnalysis;
 using Microsoft.CodeAnalysis.CSharp.Syntax;
 
 namespace H.Generators;
@@ -65,14 +66,14 @@ public void Initialize(IncrementalGeneratorInitializationContext context)
  InterfaceName: interfaceName,
  Methods: methods);
  }
- 
+
  private static FileWithName GetClientSourceCode(ClassData @class)
  {
  return new FileWithName(
  Name: $"{@class.Name}.IpcClient.generated.cs",
  Text: SourceGenerationHelper.GenerateClientImplementation(@class));
  }
- 
+
  private static FileWithName GetServerSourceCode(ClassData @class)
  {
  return new FileWithName(