DudNet by jwshyns
Nuget / site data
Details
Info
info
Name: DudNet
Proxy-pattern source generator
Author: jwshyns
NuGet: https://www.nuget.org/packages/Jwshyns.DudNet/
You can find more details at https://github.com/jwshyns/DudNet
Source : https://github.com/jwshyns/DudNet
Original Readme
note
DudNet 
DudNet is a C# source generator for implementing a proxy pattern.
Example
Generating a proxy for a class is as simple as marking it with the ProxyServiceAttribute as follows:
using DudNet.Attributes;
public interface IExampleService {
public void ExampleFunction();
public int ExampleFunctionWithArgumentAndReturn(int number);
}
[ProxyService]
public class ExampleService : IExampleService {
public void ExampleFunction(){
// omitted for brevity
}
public int ExampleFunctionWithArgumentAndReturn(int number){
// omitted for brevity
}
public void FunctionNotOnInterface(){
// ommitted for brevity
}
}
Which would generate the following two classes:
using System.Runtime.CompilerServices;
using DudNet.Attributes;
public partial class ExampleServiceProxy : IExampleService {
private readonly IExampleService _service;
public void ExampleFunction() {
Interceptor();
ExampleFunctionInterceptor();
_service.ExampleFunction();
}
public int ExampleFunctionWithArgumentAndReturn(int number) {
Interceptor();
ExampleFunctionWithArgumentAndReturnInterceptor(number);
_service.ExampleFunctionWithArgumentAndReturn(number);
}
partial void Interceptor([CallerMemberName]string callerName = null);
partial void ExampleFunctionInterceptor();
partial void ExampleFunctionWithArgumentAndReturnInterceptor(int number);
}
and
using DudNet.Attributes;
public class ExampleServiceDud : IExampleService {
public void ExampleFunction() {
}
public int ExampleFunctionWithArgumentAndReturn(int number) {
}
}
These generated classes can be used by further implementing the partial proxy class as follows:
public partial class ExampleServiceProxy : IExampleService {
public ExampleServiceProxy(ExampleProxyService service) {
// Some logic to determine whether you want to effectively "disable" the service
if (Random.Shared.NextDouble() > 0.5)
{
_service = service;
return;
}
_service = new ExampleServiceDud();
}
partial void Interceptor([CallerMemberName]string callerName = null) {
Console.Writeline("'{caller}' was called", callerName);
}
partial void ExampleFunctionWithArgumentAndReturnInterceptor(int number) {
if(number > 5)
{
throw new Exception("Received number value '{number}' - too high!", number);
}
}
}
About
note
Generate proxy classes for the principal classes
How to use
Example ( source csproj, source files )
- CSharp Project
- Program.cs
- Person.cs
This is the CSharp Project that references DudNet
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>net7.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Jwshyns.DudNet" Version="1.2.0" />
</ItemGroup>
<PropertyGroup>
<EmitCompilerGeneratedFiles>true</EmitCompilerGeneratedFiles>
<CompilerGeneratedFilesOutputPath>$(BaseIntermediateOutputPath)\GX</CompilerGeneratedFilesOutputPath>
</PropertyGroup>
</Project>
This is the use of DudNet in Program.cs
using DudNetDemo;
var p = new Person();
var p1= new PersonProxy(p);
p1.FirstName = "John";
p1.LastName = "Doe";
Console.WriteLine(p.FullName());
Console.WriteLine(p1.FullName());
This is the use of DudNet in Person.cs
using DudNet.Attributes;
using System.Runtime.CompilerServices;
namespace DudNetDemo;
[ProxyService]
public partial class Person : IPerson
{
public string? FirstName { get; set; }
public string? LastName { get; set; }
public string FullName()
{
return FirstName + " " + LastName;
}
}
Generated Files
Those are taken from $(BaseIntermediateOutputPath)\GX
- PersonDud.g.cs
- PersonProxy.g.cs
using System.Runtime.CompilerServices;
using DudNet.Attributes;
using System.Runtime.CompilerServices;
namespace DudNetDemo;
/// <inheritdoc cref="IPerson"/>
public partial class PersonDud : IPerson {
public string? FirstName {
get {
return (string?) default;
}
set {
}
}
public string? LastName {
get {
return (string?) default;
}
set {
}
}
public string FullName() {
return (string) default;
}
}
using System.Runtime.CompilerServices;
using DudNet.Attributes;
using System.Runtime.CompilerServices;
namespace DudNetDemo;
/// <inheritdoc cref="IPerson"/>
public partial class PersonProxy : IPerson {
private readonly IPerson _service;
public string? FirstName {
get {
Interceptor();
get_FirstNameInterceptor();
return _service.FirstName;
}
set {
Interceptor();
set_FirstNameInterceptor(value);
_service.FirstName = value;
}
}
public string? LastName {
get {
Interceptor();
get_LastNameInterceptor();
return _service.LastName;
}
set {
Interceptor();
set_LastNameInterceptor(value);
_service.LastName = value;
}
}
public string FullName() {
Interceptor();
FullNameInterceptor();
return _service.FullName();
}
partial void Interceptor([CallerMemberName]string callerName = null);
partial void get_FirstNameInterceptor();
partial void set_FirstNameInterceptor(string? value);
partial void get_LastNameInterceptor();
partial void set_LastNameInterceptor(string? value);
partial void FullNameInterceptor();
}
Usefull
Download Example (.NET C# )
Share DudNet
https://ignatandrei.github.io/RSCG_Examples/v2/docs/DudNet