Utilities

Ayaka.Nuke provides a set of utility methods that can improve the readability of your build scripts or provide other useful functionality.

WhenNotNull

public static T WhenNotNull<T, TObject>(this T settings, TObject? obj, Func<T, TObject, T> configurator)

Invokes a configurator method, but only if the passed in obj is not null.

The configurator method receives both, the object the method is called on and the obj parameter, and should return the same object it is called on (at least of the same type, if you care for immutability), so multiple calls can be chained.

TIP

This method is especially useful to make otherwise ugly safe casts and null checks more readable.

Usage for Settings

Configure<DotNetBuildSettings> ICanDotNetBuild.DotNetBuild
        => dotnet => dotnet
            .WhenNotNull(
                this as IHaveGitVersion,
                (d, o) => d
                    .SetAssemblyVersion(o.Versioning.AssemblySemVer)
                    .SetFileVersion(o.Versioning.AssemblySemFileVer)
                    .SetInformationalVersion(o.Versioning.InformationalVersion));

Usage in Targets

Target Default => target => target
    .Executes(() =>
    {
        ReportSummary(
            summary => summary
                .WhenNotNull(
                    this as IHaveGitVersion,
                    (s, o) => s.AddPair("Version", o.Versioning.NuGetVersionV2))
        );
    });

Chaining multiple calls

Configure<DotNetPackSettings> ICanDotNetPack.DotNetPackSettings
        => dotnet => dotnet
            .WhenNotNull(
                this as IHaveGitRepository,
                (d, o) => d.SetRepositoryUrl(o.GitRepository.HttpsUrl))
            .WhenNotNull(
                this as IHaveGitVersion,
                (d, o) => d.SetVersion(o.Versioning.NuGetVersionV2));