FunFair.BuildVersion.Interfaces 6.2.16.438-main

This is a prerelease version of FunFair.BuildVersion.Interfaces.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package FunFair.BuildVersion.Interfaces --version 6.2.16.438-main
NuGet\Install-Package FunFair.BuildVersion.Interfaces -Version 6.2.16.438-main
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="FunFair.BuildVersion.Interfaces" Version="6.2.16.438-main" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add FunFair.BuildVersion.Interfaces --version 6.2.16.438-main
#r "nuget: FunFair.BuildVersion.Interfaces, 6.2.16.438-main"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install FunFair.BuildVersion.Interfaces as a Cake Addin
#addin nuget:?package=FunFair.BuildVersion.Interfaces&version=6.2.16.438-main&prerelease

// Install FunFair.BuildVersion.Interfaces as a Cake Tool
#tool nuget:?package=FunFair.BuildVersion.Interfaces&version=6.2.16.438-main&prerelease

Build Version

Simpler/faster git specific version builder

Build Status

Branch Status
main Build: Pre-Release
release Build: Release

Release Notes/Changelog

View changelog

Installation

Install as a global tool

dotnet tool install FunFair.BuildVersion

To update to latest released version

dotnet tool update FunFair.BuildVersion

Install as a local tool

dotnet new tool-manifest
dotnet tool install FunFair.BuildVersion --local

To update to latest released version

dotnet tool update FunFair.BuildVersion --local

Supported Branch formats

Supports release and hotfix branches in the following formats

  • release/version
  • release/package/version
  • release-platform/package/version
  • release-platform/version
  • hotfix/version
  • hotfix/package/version
  • hotfix-platform/package/version
  • hotfix-platform/version

version can be in the following formats:

  • 1
  • 1.2
  • 1.2.3

Output Release Formats

  • Release branches: 1.2.3.4;
    • where 4 is a build number passed to the tool
  • Pre-Release branches 1.2.3.4-tag
    • where 4 is a build number passed to the tool
    • where tag is generated from the branch name (or matching branch for a pull request if it can be located)

Tag restrictions

  • Maximum length before truncating after any processing: 15 characters
  • Non alphanumeric characters are replaced with -
  • Multiple - consecutive characters are shrunk to a single one
  • removes the top folder of the branch when using branches like feature/name so that tag is processed on name only
  • For Pull requests, if a branch cannot be located by its SHA hash then the tag will become pr-id where id is the id of the pull request
  • if no suitable tag can be generated the tag prerelease will be used.

Command line arguments

  -x, --WarningsAsErrors    (Default: false) Whether warnings should be errors
  -b, --BuildNumber         (Default: -1) The build number (use BUILD_NUMBER envrionment variable)
  -s, --ReleaseSuffix       (Default: ) The release suffix
  -p, --Package             (Default: ) The package being released
  --help                    Display this help screen.
  --version                 Display version information.
Running without arguments

This will attempt to retrieve the build number (counter) from an environment variable:

  • BUILD_NUMBER (Set by CI tools like TeamCity)
dotnet buildversion
Running with release branches in format /release/version
dotnet buildversion --BuildNumber 272

or

dotnet buildversion --b272
Running with release branches in format /release-product/version
dotnet buildversion --BuildNumber 272 --ReleaseSuffix "product"

or

dotnet buildversion -b272  -s"product"
Running with release branches in format /release-product/package/version
dotnet buildversion --BuildNumber 272 --ReleaseSuffix "product" --Package "package"

or

dotnet buildversion -b272  -s"product" -p"package"
Running with release branches in format /release/package/version
dotnet buildversion --BuildNumber 272 --Package "package"

or

dotnet buildversion -b272 -p"package"

Integrations

TeamCity

  • Picks up the BUILD_NUMBER environment variable for the build number
  • If TEAMCITY_VERSION environment variable is defined then the system.build.version and buildNumber variables will be set to match the build version that the tool produces

GitHub Actions

  • If GITHUB_ENV environment variable is defined then the BUILD_VERSION environment variable will be set to match the build version that the tool produces.
Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 is compatible.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (2)

Showing the top 2 NuGet packages that depend on FunFair.BuildVersion.Interfaces:

Package Downloads
FunFair.BuildVersion.Detection

Build versioning.

FunFair.BuildVersion.Publishers

Build version publishing.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
6.2.16.466-main 84 6/15/2024
6.2.16.465-main 78 6/13/2024
6.2.16.464-main 76 6/13/2024
6.2.16.463-main 71 6/12/2024
6.2.16.462-main 68 6/12/2024
6.2.16.461-main 67 6/12/2024
6.2.16.460-main 68 6/12/2024
6.2.16.459-main 64 6/11/2024
6.2.16.458-main 69 6/11/2024
6.2.16.457-main 69 6/10/2024
6.2.16.456-main 67 6/10/2024
6.2.16.455-main 69 6/10/2024
6.2.16.451-main 66 6/6/2024
6.2.16.449-main 77 6/2/2024
6.2.16.448-main 82 6/2/2024
6.2.16.447-main 76 5/31/2024
6.2.16.445-main 80 5/30/2024
6.2.16.444-main 82 5/30/2024
6.2.16.443-main 83 5/29/2024
6.2.16.441-main 80 5/25/2024
6.2.16.440-main 75 5/25/2024
6.2.16.438-main 86 5/24/2024
6.2.16.436-main 84 5/23/2024
6.2.16.432-main 84 5/22/2024
6.2.16.428-main 77 5/19/2024
6.2.16.427-main 69 5/19/2024
6.2.16.426-main 71 5/18/2024
6.2.16.425-main 81 5/17/2024
6.2.16.424-main 76 5/17/2024
6.2.16.423-main 77 5/17/2024
6.2.16.422-main 81 5/17/2024
6.2.16.421-main 80 5/17/2024
6.2.16.420-main 84 5/17/2024
6.2.16.419-main 76 5/17/2024
6.2.16.418-main 72 5/17/2024
6.2.16.417-main 76 5/17/2024
6.2.16.416-main 86 5/17/2024
6.2.16.415-main 74 5/17/2024
6.2.16.414-main 77 5/16/2024
6.2.16.413-main 74 5/16/2024
6.2.16.412-dotnet-sdk-8-0 74 5/16/2024
6.2.16.411-main 62 5/1/2024
6.2.16.409-main 99 4/30/2024
6.2.16.408-main 98 4/30/2024
6.2.16.406-main 88 4/30/2024
6.2.16.403-main 81 4/29/2024
6.2.16.401-main 98 4/25/2024
6.2.16.400-main 83 4/24/2024
6.2.16.398-main 75 4/23/2024
6.2.16.397-main 97 4/23/2024
6.2.16.393-main 83 4/18/2024
6.2.16.390-main 80 4/18/2024
6.2.16.389-main 83 4/16/2024
6.2.16.388-main 81 4/16/2024
6.2.16.386-main 77 4/15/2024
6.2.16.383-main 76 4/10/2024
6.2.16.382-main 87 4/10/2024
6.2.16.381-main 92 4/10/2024
6.2.16.380-main 74 4/10/2024
6.2.16.379-main 75 4/10/2024
6.2.16.378-main 79 4/10/2024
6.2.16.377-dotnet-sdk-8-0 80 4/10/2024
6.2.16.376-main 85 4/8/2024
6.2.16.375-main 81 4/8/2024
6.2.16.374-main 78 4/7/2024
6.2.16.373-main 84 4/7/2024
6.2.16.372-main 80 4/7/2024
6.2.16.371-main 86 4/7/2024
6.2.16.370-main 90 4/3/2024
6.2.16.368-main 81 4/2/2024
6.2.16.367-main 62 4/2/2024
6.2.16.366-main 69 4/2/2024
6.2.16.365-main 87 3/30/2024
6.2.16.364-main 79 3/29/2024
6.2.16.363-main 83 3/27/2024
6.2.16.361-main 77 3/26/2024
6.2.16.360-main 76 3/26/2024
6.2.16.359-main 92 3/25/2024
6.2.16.358-main 85 3/25/2024
6.2.16.355-main 92 3/25/2024
6.2.16.352-main 87 3/25/2024
6.2.16.351-main 84 3/20/2024
6.2.16.350-main 83 3/20/2024
6.2.16.349-main 82 3/20/2024
6.2.16.348-main 83 3/20/2024
6.2.16.347-main 77 3/19/2024
6.2.16.346-main 77 3/19/2024
6.2.16.344-main 80 3/19/2024
6.2.16.343-main 90 3/14/2024
6.2.16.341-main 85 3/8/2024
6.2.16.340-main 82 3/8/2024
6.2.16.338-main 79 3/7/2024
6.2.16.337-main 77 3/7/2024
6.2.16.336-main 84 3/4/2024
6.2.16.335-main 79 2/27/2024
6.2.16.334-main 70 2/27/2024
6.2.16.333-main 75 2/26/2024
6.2.16.332-main 65 2/26/2024
6.2.16.331-main 66 2/26/2024
6.2.16.330-main 72 2/25/2024
6.2.16.329-main 66 2/25/2024
6.2.16.327-main 71 2/25/2024
6.2.16.326-main 73 2/25/2024
6.2.16.325-main 66 2/25/2024
6.2.16.324-main 77 2/25/2024
6.2.16.323-main 60 2/24/2024
6.2.16.322-main 84 2/20/2024
6.2.16.321-main 78 2/20/2024
6.2.16.320-main 78 2/20/2024
6.2.16.319-main 63 2/19/2024
6.2.16.317-main 75 2/12/2024
6.2.16.316-main 77 2/12/2024
6.2.16.315-main 66 2/12/2024
6.2.16.314-main 77 2/11/2024
6.2.16.313-main 81 2/9/2024
6.2.16.312-main 73 2/9/2024
6.2.16.311-update-funfair 71 2/9/2024
6.2.16.310-update-funfair 70 2/9/2024
6.2.16.309-main 73 2/8/2024
6.2.16.308-main 69 2/8/2024
6.2.16.305-main 70 2/7/2024
6.2.16.304-main 79 2/7/2024
6.2.16.303-main 81 2/7/2024
6.2.16.302-main 72 2/7/2024
6.2.16.301-main 74 2/6/2024
6.2.16.300-main 78 2/6/2024
6.2.16.299-main 79 2/6/2024
6.2.16.298-main 65 2/5/2024
6.2.16.297-main 71 2/5/2024
6.2.16.296-main 74 1/31/2024
6.2.16.295-main 66 1/31/2024
6.2.16.293-main 73 1/30/2024
6.2.16.292-main 68 1/29/2024
6.2.16.291-build 65 1/29/2024
6.2.16.290-build 67 1/29/2024
6.2.16.289-build 71 1/29/2024
6.2.16.288-build 64 1/29/2024
6.2.16.287-build 66 1/29/2024
6.2.16.286-main 65 1/29/2024
6.2.16.285-main 69 1/27/2024
6.2.16.284-main 71 1/26/2024
6.2.16.283-main 67 1/25/2024
6.2.16.282-main 68 1/24/2024
6.2.16.281-main 72 1/23/2024
6.2.16.280-main 70 1/17/2024
6.2.16.279-main 75 1/16/2024
6.2.16.278-main 67 1/15/2024
6.2.16.277-main 72 1/15/2024
6.2.16.276-main 73 1/15/2024
6.2.16.275-main 66 1/14/2024
6.2.16.274-main 78 1/13/2024
6.2.16.273-main 77 1/13/2024
6.2.16.272-main 74 1/10/2024
6.2.16.271-main 85 1/9/2024
6.2.16.270-main 89 1/7/2024
6.2.16.269-main 89 1/6/2024
6.2.16.268-main 95 1/6/2024
6.2.16.266-main 84 1/5/2024
6.2.16.265-main 88 1/5/2024
6.2.16.264-main 84 1/5/2024
6.2.16.263-main 85 1/5/2024
6.2.16.262-main 88 1/5/2024
6.2.16.261-main 86 1/5/2024
6.2.16.260-main 78 1/4/2024
6.2.16.259-main 81 1/4/2024
6.2.16.258-main 92 1/2/2024
6.2.16.256-main 111 12/30/2023
6.2.16.255-main 98 12/30/2023
6.2.16.254-main 95 12/28/2023
6.2.16.253-main 116 12/28/2023
6.2.16.252-main 84 12/26/2023
6.2.16.251-main 88 12/26/2023
6.2.15.250 3,259 12/24/2023
6.2.15.249-main 127 12/24/2023
6.2.15.248-main 106 12/23/2023
6.2.15.247-main 121 12/23/2023
6.2.15.246-main 114 12/23/2023
6.2.15.245-main 106 12/23/2023
6.2.15.244-main 109 12/23/2023
6.2.15.243-main 105 12/23/2023
6.2.15.242-main 117 12/23/2023
6.2.15.241-main 113 12/23/2023
6.2.15.240-main 152 12/21/2023
6.2.15.239-main 94 12/21/2023
6.2.15.238-main 109 12/21/2023