Pretune 0.8.6

Pretune

Source-based C# preprocessor generating boilerplate code before compile.

Pros

• Simple. The only things you have to do is adding Nuget package and annotating to class
• Easy to debug. Can see the generated codes in IDE.
• Depends on only .net 3.1 runtime.
• No additional assembly dependencies embedded for publishing.
• Using C# code as DSL, c# compiler will verify input is well-typed.

Features

• Generating constructor (for data only classes)
• Implementing INotifyPropetyChanged
• Implementing IEquatable

Generate Constuctor <a name="auto_constructor"> </a>

Pretune generates constructor by adding 'AutoConstructor' attibute to class.

make this code

// MyClass.cs
[AutoConstructor]
partial class MyClass
{
    int a;
    string b;
}

and build then you will get following code

// PretuneGenerated/MyClass.g.cs
partial class MyClass
{
    public MyClass(int a, string b)
    {
        this.a = a;
        this.b = b;
    }
}

NOTICE Though this feature can be replaced by record of C# 9, it's still useful for the project that needs previous version of C#. And it also supports struct.

Implementing INotifyPropetyChanged <a name="implement_inotifypropertychanged"> </a>

make this code

// ViewModel.cs
[ImplementINotifyPropertyChanged]
public partial class ViewModel
{
    string firstName;
    string lastName;
    
    [DependsOn(nameof(firstName), nameof(lastName)]
    public string FamilyName { get => $"{firstName} {lastName}"; }
}    

and build then you will get following code

// PretuneGenerated/ViewModel.g.cs
partial class ViewModel
{
    public event System.ComponentModel.PropertyChangedEventHandler PropertyChanged;
    public string FirstName
    {
        get => firstName;
        set
        {
            if (!firstName.Equals(value))
            {
                firstName = value;
                PropertyChanged?.Invoke(this, new System.ComponentModel.PropertyChangedEventArgs("FirstName"));
                PropertyChanged?.Invoke(this, new System.ComponentModel.PropertyChangedEventArgs("FamilyName"));
            }
        }
    }

    public string LastName
    {
        get => lastName;
        set
        {
            if (!lastName.Equals(value))
            {
                lastName = value;
                PropertyChanged?.Invoke(this, new System.ComponentModel.PropertyChangedEventArgs("LastName"));
                PropertyChanged?.Invoke(this, new System.ComponentModel.PropertyChangedEventArgs("FamilyName"));
            }
        }
    }
}

Implementing IEquatable <a name="implement_iequatable"> </a>

make this code

// Script.cs
using Pretune;

namespace N
{
    [ImplementIEquatable]
    public partial class Script
    {
        int x;
        public string Y { get; }
    }
}

and build then you will get following code

// PretuneGenerated/Script.g.cs
#nullable enable

using Pretune;

namespace N
{
    public partial class Script : System.IEquatable<Script>
    {
        public override bool Equals(object? obj) => Equals(obj as Script);
        public bool Equals(Script? other)
        {
            if (other == null)
                return false;
            if (!x.Equals(other.x))
                return false;
            if (!Y.Equals(other.Y))
                return false;
            return true;
        }

        public override int GetHashCode()
        {
            var hashCode = new System.HashCode();
            hashCode.Add(this.x.GetHashCode());
            hashCode.Add(this.Y.GetHashCode());
            return hashCode.ToHashCode();
        }
    }
}

Installation

Visual Studio

Add 'Pretune' package from nuget

CLI

dotnet add package Pretune

Requirements

• .net core runtime 3.1