CCLib.Misc

A collection of miscellaneous, general purpose C# helper classes, packaged for NuGet.

Target frameworks: netstandard2.0, net8.0, net10.0.

Installation

dotnet add package CCLib.Misc

Contents

Tests

Unit tests live in tests/CCLib.Misc.Tests (xUnit) and run against every runtime target framework the library ships for:

dotnet test

Versioning

The package version has four parts: MAJOR.MINOR.RELEASE.BUILDNUMBER.

• MAJOR.MINOR.RELEASE comes from <VersionPrefix> in Directory.Build.props and is maintained by hand.

• BUILDNUMBER is computed at build time:

  BUILDNUMBER = floor(days between BuildNumberEpoch and the HEAD commit date) * 10 + BUILD_NUMBER_INCREMENT
  

  BuildNumberEpoch is 2026-01-01. The * 10 leaves room for up to 10 distinct builds of the same commit date, selected with the BUILD_NUMBER_INCREMENT environment variable (0–9, default 0).

Example — a commit dated 2026-07-26 is 206 days after the epoch:

The commit date comes from git log -1 --pretty=format:%cs. Outside a git repository the current UTC date is used instead and a CCLIB0001 warning is emitted, so local builds keep working.

Handy commands

# Print the version that would be produced
dotnet build -t:ShowVersion -v:m -nologo

# Build the package
dotnet pack -c Release -o artifacts

# Second build of the same day
BUILD_NUMBER_INCREMENT=1 dotnet pack -c Release -o artifacts     # bash
$env:BUILD_NUMBER_INCREMENT=1; dotnet pack -c Release -o artifacts  # PowerShell

# Override once, without the environment variable
dotnet pack -c Release -p:BuildNumberIncrement=3 -o artifacts

# Ignore the date logic entirely and just use VersionPrefix
dotnet pack -c Release -p:DisableAutoBuildNumber=true

Symbols and debugging

dotnet pack produces two files:

The symbol package is enabled by IncludeSymbols / SymbolPackageFormat in Directory.Build.props. NuGet.org accepts it next to the main package and serves it from its symbol server, so consumers get proper file names and line numbers in stack traces and — thanks to SourceLink, also enabled there — can step straight into the original source fetched from the matching GitHub commit.

It costs consumers nothing: the .snupkg is only downloaded when a debugger asks for it. dotnet nuget push "artifacts/*.nupkg" uploads the sibling .snupkg automatically, so no extra push step is needed.

Releasing

The pack workflow builds and packs on every push; pushing a tag matching v* publishes to NuGet.org using the NUGET_API_KEY repository secret. BUILD_NUMBER_INCREMENT can be supplied when running the workflow manually.

License

MIT — see LICENSE.