ManagedCode.Communication.Orleans 9.0.0

Prefix Reserved
dotnet add package ManagedCode.Communication.Orleans --version 9.0.0                
NuGet\Install-Package ManagedCode.Communication.Orleans -Version 9.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="ManagedCode.Communication.Orleans" Version="9.0.0" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add ManagedCode.Communication.Orleans --version 9.0.0                
#r "nuget: ManagedCode.Communication.Orleans, 9.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.
// Install ManagedCode.Communication.Orleans as a Cake Addin
#addin nuget:?package=ManagedCode.Communication.Orleans&version=9.0.0

// Install ManagedCode.Communication.Orleans as a Cake Tool
#tool nuget:?package=ManagedCode.Communication.Orleans&version=9.0.0                

Communication

.NET Coverage Status nuget CodeQL NuGet Package

The Communication library is a convenient wrapper for handling the results of functions that do not throw exceptions. Instead of throwing exceptions, these functions return an object that contains the result of the operation. This makes it easy to handle and process the results of these operations in a consistent, reliable way.

Motivation

Many functions in software development can fail and throw exceptions when something goes wrong. This can make it difficult to handle errors and to read and understand code that uses these functions.

Exceptions are a powerful tool for handling error conditions in your code, but they can also be difficult to manage and can make your code harder to read and understand. Instead of throwing exceptions, the Communication library allows you to return a Result object that contains the result of an operation. This makes it easy to handle and process the results of these operations in a consistent, reliable way.

Features

  • Wraps the result of a function in an object, eliminating the need to handle exceptions.
  • Makes it easy to check whether the function was successful or not.
  • Provides access to the function's output via simple property accessors.

Getting Started

To use the Communication library in your project, you will need to add a reference to the Communication assembly. You can do this by downloading the library from GitHub and adding it to your project, or by installing the Communication NuGet package.

Once you have added a reference to the Communication assembly, you can start using the library in your code. Here is a simple example of how to use the Communication library to handle the result of an operation:

var succeed = Result.Succeed();
if(succeed.IsSuccess)
{
    // do some
}

var fail = Result.Fail();
if(fail.IsFailed)
{
    // do some
}

Generic Result

var succeed = Result<MyObject>.Succeed(new MyObject());
if(succeed.IsSuccess)
{
    succeed.Value // <-- this is the result
    // do some
}

var fail = Result<MyObject>.Fail("Oops!");
if(fail.IsFailed)
{
    // do some
}

Collection Result:

var collection = CollectionResult<int>.Succeed(Enumerable.Repeat(4, 100), 5, 100, 15000);

From:

var succeed = await Result<MyObject>.From(() => GetMyResult());
if(succeed.IsSuccess)
{
    succeed.Value // <-- this is the result
    // do some
}

Global handlers

Also we have global handlers for WebApi and SignalR

builder.Services.AddCommunication(option =>
{
    option.ShowErrorDetails = true;
});
        

SignalR global hub filter

builder.Services.AddSignalR(options => options.AddCommunicationHubFilter());

WebApi middleware

app.UseCommunication();

Orleans

silo:

siloBuilder.UseOrleansCommunication();

client:

clientBuilder.UseOrleansCommunication();

Conclusion

In summary, our library provides a convenient and easy-to-use solution for handling the result of a function that may throw exceptions. It eliminates the need to handle exceptions and makes it easy to check whether the function was successful and to access its output. We hope you find it useful in your own projects!

Product Compatible and additional computed target framework versions.
.NET net9.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (3)

Showing the top 3 NuGet packages that depend on ManagedCode.Communication.Orleans:

Package Downloads
ManagedCode.Orleans.Identity.Client

Identity base on Orleans

ManagedCode.Orleans.Identity.Core

Identity base on Orleans

ManagedCode.Orleans.Identity.Server

Identity base on Orleans

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
9.0.0 93 12/10/2024
8.0.7 1,391 9/12/2024
8.0.6 1,089 6/29/2024
8.0.5 93 6/27/2024
8.0.4 100 6/27/2024
8.0.3 113 6/14/2024
8.0.1 160 5/6/2024
8.0.0 505 11/29/2023
2.0.26 1,582 7/12/2023
2.0.25 753 6/6/2023
2.0.24 19,292 5/22/2023
2.0.23 166 5/21/2023
2.0.22 151 5/17/2023
2.0.21 136 5/17/2023
2.0.20 139 5/17/2023
2.0.19 767 3/15/2023
2.0.18 211 3/14/2023
2.0.17 233 3/12/2023
2.0.16 246 2/21/2023
2.0.15 253 2/17/2023
2.0.14 775 2/7/2023
2.0.13 3,191 12/19/2022
2.0.12 295 12/19/2022
2.0.11 314 12/8/2022
2.0.10 327 12/3/2022