Add revision support to versioning

[mateusrodrigues]

This PR adds revision support to component versioning. This will allow the release of updates when the upstream .NET version of a component does not change.

How it works

Revision works by appending a +<number> to the end of the version string of a component, e.g.

   {
      "key": "aspnetcore-runtime-8.0.3+2",
      "name": "aspnetcore-runtime",
      "description": "ASP.NET Core",
      "baseUrl": "https://launchpad.net/ubuntu/+archive/primary/+files/",
      "version": "8.0.3+2",
      "packages": [
         {
            "name": "aspnetcore-runtime-8.0",
            "version": "8.0.3-0ubuntu1~22.04.1"
         }
      ],
      "dependencies": [
         "dotnet-runtime-8.0.3+2"
      ]
   }

Since the key is a unique parameter, it should also be updated to include the revision to avoid any collisions when merging local and remote manifests.

Any dependency key strings also need updating when the key of a dependent component changes.

Ordering

Revision is an optional parameter, therefore a version 8.0.3 has a revision of null. Subsequently, any +<number> appended to the end of a version string changes the version to have a revision of <number>.

Null revisions take precedence in ordering, such as:

8.0.3 < 8.0.3+2 < 8.0.3+256 < 8.0.4

[github-actions]

Test Results

82 tests  +21   82 ✅ +21   0s ⏱️ ±0s
 1 suites ± 0    0 💤 ± 0 
 1 files   ± 0    0 ❌ ± 0 

Results for commit 308a13e. ± Comparison against base commit e16259b.

This pull request removes 19 and adds 40 tests. Note that renamed tests count towards both.

Dotnet.Installer.Core.Tests.Types.DotnetVersionOperatorsTests ‑ CompareTo_WithEqualVersion_ShouldReturnZero(major: 8, minor: 0, patch: 100, isPreview: False, isRc: True, previewIdentifier: 1)
Dotnet.Installer.Core.Tests.Types.DotnetVersionOperatorsTests ‑ CompareTo_WithEqualVersion_ShouldReturnZero(major: 8, minor: 0, patch: 100, isPreview: True, isRc: False, previewIdentifier: 3)
Dotnet.Installer.Core.Tests.Types.DotnetVersionOperatorsTests ‑ CompareTo_WithEqualVersion_ShouldReturnZero(major: 8, minor: 0, patch: 102, isPreview: False, isRc: False, previewIdentifier: null)
Dotnet.Installer.Core.Tests.Types.DotnetVersionOperatorsTests ‑ CompareTo_WithHigherVersion_ShouldReturnSmallerThanZero(major: 8, minor: 0, patch: 100, isPreview: False, isRc: True, previewIdentifier: 1)
Dotnet.Installer.Core.Tests.Types.DotnetVersionOperatorsTests ‑ CompareTo_WithHigherVersion_ShouldReturnSmallerThanZero(major: 8, minor: 0, patch: 100, isPreview: True, isRc: False, previewIdentifier: 3)
Dotnet.Installer.Core.Tests.Types.DotnetVersionOperatorsTests ‑ CompareTo_WithHigherVersion_ShouldReturnSmallerThanZero(major: 8, minor: 0, patch: 102, isPreview: False, isRc: False, previewIdentifier: null)
Dotnet.Installer.Core.Tests.Types.DotnetVersionOperatorsTests ‑ CompareTo_WithLowerVersion_ShouldReturnGreaterThanZero(major: 8, minor: 0, patch: 100, isPreview: False, isRc: False, previewIdentifier: null)
Dotnet.Installer.Core.Tests.Types.DotnetVersionOperatorsTests ‑ CompareTo_WithLowerVersion_ShouldReturnGreaterThanZero(major: 8, minor: 0, patch: 101, isPreview: False, isRc: True, previewIdentifier: 1)
Dotnet.Installer.Core.Tests.Types.DotnetVersionOperatorsTests ‑ CompareTo_WithLowerVersion_ShouldReturnGreaterThanZero(major: 8, minor: 0, patch: 101, isPreview: True, isRc: False, previewIdentifier: 2)
Dotnet.Installer.Core.Tests.Types.DotnetVersionTests ‑ Constructor_WithInvalidInput_ShouldThrowApplicationException(major: 8, minor: 0, patch: 0, isPreview: False, isRc: False, previewIdentifier: 1)
…

Dotnet.Installer.Core.Tests.Types.DotnetVersionOperatorsTests ‑ CompareTo_WithEqualVersion_ShouldReturnZero(major: 8, minor: 0, patch: 100, isPreview: False, isRc: True, previewIdentifier: 1, revision: null)
Dotnet.Installer.Core.Tests.Types.DotnetVersionOperatorsTests ‑ CompareTo_WithEqualVersion_ShouldReturnZero(major: 8, minor: 0, patch: 100, isPreview: True, isRc: False, previewIdentifier: 3, revision: 2)
Dotnet.Installer.Core.Tests.Types.DotnetVersionOperatorsTests ‑ CompareTo_WithEqualVersion_ShouldReturnZero(major: 8, minor: 0, patch: 102, isPreview: False, isRc: False, previewIdentifier: null, revision: 1)
Dotnet.Installer.Core.Tests.Types.DotnetVersionOperatorsTests ‑ CompareTo_WithHigherVersion_ShouldReturnSmallerThanZero(major: 8, minor: 0, patch: 100, isPreview: False, isRc: True, previewIdentifier: 1, revision: null)
Dotnet.Installer.Core.Tests.Types.DotnetVersionOperatorsTests ‑ CompareTo_WithHigherVersion_ShouldReturnSmallerThanZero(major: 8, minor: 0, patch: 100, isPreview: True, isRc: False, previewIdentifier: 3, revision: null)
Dotnet.Installer.Core.Tests.Types.DotnetVersionOperatorsTests ‑ CompareTo_WithHigherVersion_ShouldReturnSmallerThanZero(major: 8, minor: 0, patch: 102, isPreview: False, isRc: False, previewIdentifier: null, revision: null)
Dotnet.Installer.Core.Tests.Types.DotnetVersionOperatorsTests ‑ CompareTo_WithHigherVersion_ShouldReturnSmallerThanZero(major: 8, minor: 0, patch: 103, isPreview: False, isRc: False, previewIdentifier: null, revision: 1)
Dotnet.Installer.Core.Tests.Types.DotnetVersionOperatorsTests ‑ CompareTo_WithLowerVersion_ShouldReturnGreaterThanZero(major: 8, minor: 0, patch: 100, isPreview: False, isRc: False, previewIdentifier: null, revision: null)
Dotnet.Installer.Core.Tests.Types.DotnetVersionOperatorsTests ‑ CompareTo_WithLowerVersion_ShouldReturnGreaterThanZero(major: 8, minor: 0, patch: 100, isPreview: False, isRc: True, previewIdentifier: 1, revision: 2)
Dotnet.Installer.Core.Tests.Types.DotnetVersionOperatorsTests ‑ CompareTo_WithLowerVersion_ShouldReturnGreaterThanZero(major: 8, minor: 0, patch: 101, isPreview: False, isRc: False, previewIdentifier: null, revision: 1)
…

♻️ This comment has been updated with latest results.