Awesome

Incremental Build Information Generator

This project provides a simple and easy-to-use C# source generator that embeds build information, such as the build time, platform, warning level, and configuration, directly into your code. By using the BuildInformation class, you can quickly access and display these details.

Features

• Embeds build date (in UTC) in your code
• Embeds platform (AnyCPU, x86, x64, ...) information in your code
• Embeds compiler warning level in your code
• Embeds build configuration (e.g., Debug, Release) in your code
• Embeds the assembly version and assembly file version in your code
• Embeds the target framework moniker in your code
• Embeds the nullability analysis level in your code
• Embeds the deterministic build flag in your code
• Embeds the project path where the generator is running in your code
• Embeds the language and language version (like "C#" and "12.0")

Configuration

By default the created class is internal and is not under any namespace. This can be changed by adding the following to your project file:

<PropertyGroup>
    <UseRootNamespaceForBuildInformation>true</UseRootNamespaceForBuildInformation>
</PropertyGroup>

<ItemGroup>
    <CompilerVisibleProperty Include="UseRootNamespaceForBuildInformation" />
</ItemGroup>

This will use the root namespace of the project for the generated class. This is especially helpful if the generator is used in multiple projects, that might be visible to each other.

The AllowProjectDirectoryBuildOutput property is used to allow the generator to write the project directory into the generated class. This is disabled by default, as it might leak sensitive information.

<PropertyGroup>
    <AllowProjectDirectoryBuildOutput>true</AllowProjectDirectoryBuildOutput>
</PropertyGroup>

<ItemGroup>
    <CompilerVisibleProperty Include="AllowProjectDirectoryBuildOutput" />
</ItemGroup>

Git Information

By default, the generator does not include git information. If you want to include the git information, you can add the following to your project file:

<PropertyGroup>
    <IncludeGitInformation>true</IncludeGitInformation>
</PropertyGroup>

<ItemGroup>
    <CompilerVisibleProperty Include="IncludeGitInformation" />
</ItemGroup>

This will fill the GitInformation class with the following properties:

Console.WriteLine("Git information:");
Console.WriteLine($"Branch: {GitInformation.Branch}");
Console.WriteLine($"Commit: {GitInformation.Commit}");
Console.WriteLine($"Short commit: {GitInformation.ShortCommit}");
Console.WriteLine($"Nearest tag: {GitInformation.NearestTag}");
Console.WriteLine($"Detailed tag description: {GitInformation.DetailedTagDescription}");

This will spawn a git process to get the information. Therefore, git has to be accessible from the command line. Be advised, that it will increase your build time slightly.

Usage

To use the BuildInformation class in your project, add the NuGet package:

dotnet add package LinkDotNet.BuildInformation

Here is some code how to use the class:

using System;

Console.WriteLine($"Build at: {BuildInformation.BuildAt}");
Console.WriteLine($"Platform: {BuildInformation.Platform}");
Console.WriteLine($"Warning level: {BuildInformation.WarningLevel}");
Console.WriteLine($"Configuration: {BuildInformation.Configuration}");
Console.WriteLine($"Assembly version: {BuildInformation.AssemblyVersion}");
Console.WriteLine($"Assembly file version: {BuildInformation.AssemblyFileVersion}");
Console.WriteLine($"Assembly name: {BuildInformation.AssemblyName}");
Console.WriteLine($"Target framework moniker: {BuildInformation.TargetFrameworkMoniker}");
Console.WriteLine($"Nullability level: {BuildInformation.Nullability}");
Console.WriteLine($"Deterministic build: {BuildInformation.Deterministic}");
Console.WriteLine($"Analysis level: {BuildInformation.AnalysisLevel}");
Console.WriteLine($"Project directory: {BuildInformation.ProjectDirectory}");
Console.WriteLine($"Language: {BuildInformation.Language}");
Console.WriteLine($"Language version: {BuildInformation.LanguageVersion}");

You can also hover over the properties to get the currently held value (xmldoc support). An example output could look like this:

Build at: 24.03.2024 21:32:17
Platform: AnyCpu
Warning level: 7
Configuration: Debug
Assembly version: 1.0
Assembly file version: 1.2
Assembly name: LinkDotNet.BuildInformation.Sample
Target framework moniker: net7.0
Nullability level: enabled
Deterministic build: true
Analysis level: 7.0
Project directory: /Users/example/repo/this/Sample.csproj
Language: C#
Langugage version: 12.0

Contributing

If you would like to contribute to the project, please submit a pull request or open an issue on the project's GitHub page. We welcome any feedback, bug reports, or feature requests.

License

This project is licensed under the MIT License.