How to specify CLI version?

[mt-akar]

A --version flag is added by default to all CLIs. It prints [ExecutableName] 1.0.0

How does one specify the version of CLI?

[Translucent504]

TLDR:

var builder = CoconaApp.CreateBuilder();
builder.Services.AddSingleton<ICoconaApplicationMetadataProvider, ApplicationMetadataProvider>();
var app = builder.Build();

using Cocona.Application;

class ApplicationMetadataProvider : ICoconaApplicationMetadataProvider
{

    public string GetDescription() => "Eru CLI";

    public string GetExecutableName() => "EruCLI";

    public string GetProductName() => "Eru Cli";

    public string GetVersion() => "1.0.0.0";
}

I had the same question, this is what i found:

• https://github.com/mayuki/Cocona/blob/release/src/Cocona.Core/Application/CoconaApplicationMetadataProvider.cs
• https://github.com/mayuki/Cocona/blob/release/src/Cocona/Hosting/CoconaServiceCollectionExtensions.cs#L66

Idk if there is a cleaner api exposed or if you can just set the assembly attributes elsewhere, but I simply implemented the ICoconaApplicationMetadataProvider myself and provided the name / versions over there.

[DanteDeRuwe]

While you can provide a new implementation for the ICoconaApplicationMetadataProvider, the default (CoconaApplicationMetadataProvider) gets the version from the assembly version.

This means, you can also version your assembly by putting it in the .sln file:

<PropertyGroup>
    <Version>1.2.3</Version>
</PropertyGroup>

For use in CI/CD, you can provide -p:Version=1.2.3 to MSBuild :)

Also, since .NET 8, the commit hash is included in the version by default. To disable this, simply add this to .sln:

<PropertyGroup>
  <IncludeSourceRevisionInInformationalVersion>false</IncludeSourceRevisionInInformationalVersion>
</PropertyGroup>

(learned this from https://anthonysimmon.com/remove-git-hash-from-assembly-informational-version-dotnet-8/)