ThisAssembly.Git 1.4.0
This package generates a static ThisAssembly.Git class with constants
for the following Git properties from the current project:
- Commit
- Sha (first 9 chars from Commit)
- Root (normalized to forward slashes)
- Url (if PublishRepositoryUrl=true)
- Branch (from CI environment variables)
This package relies on your project's installed Microsoft.SourceLink.* package reference according to your specific Git-based source control server (such as GitHub, Azure DevOps, BitBucket, etc).
The Branch property is populated from environment variables provided
by the currently supported CI systems: GitHub Actions, Azure DevOps,
AppVeyor, TeamCity, Travis CI, Circle CI, GitLab CI, Buddy, and Jenkins.
Whenever the CI system provides a pull request number, the branch name is
pr[NUMBER], such as pr123. This makes it easy to use it as a semver
metadata label.
Note: by default, the values of these constants are populated during "real" builds (that is, not IDE/design-time builds used to populate intellisense). This is to avoid negatively affecting the editor's performance. This means, however, that the properties will seem to always be empty when inspecting them in the IDE (although never at run-time). If you want to force population of these values for design-time builds, set the
EnableSourceControlManagerQueriesproperty totrue. This property is defined and documented by dotnet/sourcelink.
At the MSBuild level, targets can take a dependency on the provided
InitializeGitInformation target, which sets the equivalent properties
named:
- RepositoryCommit
- RepositorySha
- RepositoryRoot
- RepositoryUrl
- RepositoryBranch
The names of these properties were chosen on purpose to match the properties used by nuget pack and nugetizer to populate the relevant package metadata.
So if you have a GitHub repository, installing these three packages will ensure you have the proper metadata out of the box and the simplest packaging experience possible:
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>netstandard2.0</TargetFramework>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Microsoft.SourceLink.GitHub" />
<PackageReference Include="ThisAssembly.Git" />
<PackageReference Include="NuGetizer" />
</ItemGroup>
</Project>
Sponsors
