T.Pipes 5.0.0

There is a newer version of this package available.
See the version list below for details.
dotnet add package T.Pipes --version 5.0.0
                    
NuGet\Install-Package T.Pipes -Version 5.0.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="T.Pipes" Version="5.0.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="T.Pipes" Version="5.0.0" />
                    
Directory.Packages.props
<PackageReference Include="T.Pipes" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add T.Pipes --version 5.0.0
                    
#r "nuget: T.Pipes, 5.0.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#addin nuget:?package=T.Pipes&version=5.0.0
                    
Install as a Cake Addin
#tool nuget:?package=T.Pipes&version=5.0.0
                    
Install as a Cake Tool

T.Pipes

A wrapper for H.Pipes For Surrogate implementation and other things too.

Features

  • Incremental Code Generator for interface to command and command to interface boilerplate using Attributes (Generated Functions can be only overriden staticly, but be warned to apply that correcly as there is one Collection per Unique generic type)
  • A semi prepared Newtonsoft.Json serialzer for remoting (using deprecated binary serializer when needed)
  • A simple SurrogateProcessWrapper to start/stop a surrogate safely (it only kills it after timeout, if possible use disconnect or other packet as a termination signal, the natural exit will be awaited for the timeout duration)
  • Pipe ConnectionBase/Client/Server/CallbackBase as wrappers for H.Pipes
  • Delegating Pipe Client/Server/Callback implementation for Interface delegation
  • Spawning Pipe Client/Server/Callback implementation to Produce Delegating Pipes on demand
  • Pipe/Callback objects derive from BaseClass which allow to also dispose on LifetimeCancellation token and listen to cancellation events (usefull in no IoC scenarios to handle cascading disposing)
  • Generic Classes for the most part allowing to create targeted non-generic sealed classes for optimal performace
  • Simple example application in T.Pipes.Test.Client/Server
  • A bunch of unit tests T.Pipes.Test to assert some of the issues which might arise are handled

More indepth info can be gathered by strolling trough the Code or by reading the XML docs.

Code generator

If you add the Code generator to project, the PipeUse and PipeServe attributes will be generating boilerplate for your Delegating Pipe Callback implementations.

The interface to generate code for must be specified using typeof operator in the attribute parameter. Multiple instances of this attribute are allowed. All Generic types must be Closed.

  • PipeUse Will Use the actual Target implmentation and make the callback act like an adapter for properties/methods/events
  • PipeServer Will explicityly implement the interface on the callback to avoid collisions and make the callback act like an adapter for properties/methods/events

From the Pipe perspective all calls go trough collected static Functions property to lookup correct action. Aliased implementations are visible from the Callback itself.

There is an edge case for any method of Disposing - ideally you just want to dispose the entire Callback/Server/Client/Callback/Target stack nad not just the Target object itself. The dispose can be delegated to the target only, but then it is up to the user to handle reuse of pipes and etc., it should be possible thanks to protected Setter on Target.

Usage example can be found in T.Pipes.Test.Client/Server.

Delegating Pipe Server/Client/Callback

Abstract classes to build the Interface Delegation upon. Should be ideally implemented by user using a sealed class. All actual logic lands in Callback, the Server/Client are just managing the pipe.

Spawning Pipe Server/Client/Callback

Abstract classes to create more Delegating Pipes. Should be ideally implemented by user using a sealed class. All actual logic lands in Callback, the Server/Client are just managing the pipe.

Surrogate Process Wrapper

Is a simple class with start and stop methods.

  • Starting first ensures the previous instance of the process is Stopped then calls Start on the Process.
  • Stopping the process tries to send the CloseMainWindow, and then awaits graceful close, if the timeout will expire Kill is called on the process.
Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 is compatible.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
5.3.5 174 2/21/2024
5.3.4 160 2/21/2024
5.3.3 161 2/19/2024
5.3.2 137 2/14/2024
5.3.1 151 2/14/2024
5.3.0 151 2/14/2024
5.2.7 129 2/13/2024
5.2.6 131 2/13/2024
5.2.5 133 2/13/2024
5.2.4 138 2/13/2024
5.2.3 135 2/13/2024
5.2.2 144 2/13/2024
5.2.1 164 2/12/2024
5.2.0 137 2/12/2024
5.1.6 134 2/2/2024
5.1.5 125 2/2/2024
5.1.4 128 2/2/2024
5.1.3 142 2/2/2024
5.1.2 131 2/2/2024
5.1.1 139 2/1/2024
5.1.0 143 2/1/2024
5.0.3 145 1/29/2024
5.0.2 134 1/29/2024
5.0.1 137 1/29/2024
5.0.0 150 1/18/2024
4.0.6 128 1/17/2024
4.0.5 157 1/12/2024
4.0.4 150 1/12/2024
4.0.3 165 12/22/2023
4.0.2 166 12/19/2023
4.0.1 164 12/19/2023
4.0.0 141 12/18/2023
3.4.2 161 12/15/2023
3.4.1 146 12/14/2023
3.4.0 157 12/13/2023
3.3.7 176 12/11/2023
3.3.6 136 12/11/2023
3.3.4 146 12/6/2023
3.3.3 161 12/6/2023
3.2.3 173 12/6/2023
3.2.2 136 12/6/2023
3.2.1 162 12/6/2023
3.1.0 146 12/5/2023
3.0.1 148 12/4/2023
3.0.0 150 12/1/2023
2.4.0 140 11/29/2023
2.3.2 137 11/29/2023
2.3.1 147 11/28/2023
2.3.0 146 11/28/2023
2.2.3 164 11/27/2023
2.2.2 124 11/27/2023
2.1.2 153 11/27/2023
2.1.1 145 11/27/2023
2.1.0 153 11/27/2023
2.0.1 146 11/27/2023
2.0.0 150 11/27/2023
1.2.0 157 11/27/2023
1.1.2 143 11/27/2023
1.1.1 159 11/24/2023
1.0.0 156 11/23/2023