# GitVersion **Repository Path**: vcs-all-in-one/GitVersion ## Basic Information - **Project Name**: GitVersion - **Description**: Easy Semantic Versioning (http://semver.org) for projects using Git - **Primary Language**: C# - **License**: MIT - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 5 - **Forks**: 0 - **Created**: 2020-06-15 - **Last Updated**: 2025-05-06 ## Categories & Tags **Categories**: vcs **Tags**: None ## README

Tree GitVersion

Versioning when using git, solved. GitVersion looks at your git history and works out the [semantic version][semver] of the commit being built. [![Build status][appveyor-badge]][appveyor] [![Build status][azure-pipeline-badge]][azure-pipeline] [![Build status][github-actions-badge]][github-actions] [![codecov][codecov-badge]][codecov] [![Gitter][gitter-badge]][gitter] | Artifact | Stable | | :------------------------- | :----------------------------------------------------------------- | | **GitHub Release** | [![GitHub release][gh-rel-badge]][gh-rel] | | **GitVersion.Portable** | [![Chocolatey][choco-badge]][choco] | | **GitVersion.Tool** | [![NuGet][gvgt-badge]][gvgt] | | **GitVersion.CommandLine** | [![NuGet][gvcl-badge]][gvcl] | | **GitVersionTask** | [![NuGet][gvt-badge]][gvt] | | **Azure Pipeline Task** | [![Azure Pipeline Task][az-pipeline-task-badge]][az-pipeline-task] | | **Github Action** | [![Github Action][gh-actions-badge]][gh-actions] | | **Docker** | [![Docker Pulls][dockerhub-badge]][dockerhub] | ## Compatibility GitVersion works on Windows, Linux, and Mac. Tip: If you get `System.TypeInitializationException: The type initializer for 'LibGit2Sharp.Core.NativeMethods' threw an exception. ---> System.DllNotFoundException: lib/linux/x86_64/libgit2-baa87df.so` in versions prior to 5.0.0 You likely need to install `libcurl3`. Run `sudo apt-get install libcurl3` ## Quick Links - [Documentation][docs] - [Contributing][contribute] - [Why GitVersion][why] - [Usage][usage] - [How it works][how] - [FAQ][faq] - [Who is using GitVersion][who] ## GitVersion in action! ![README][gv-in-action] You are seeing: - Pull requests being built as pre-release builds - A branch called `release-1.0.0` producing beta v1 packages ## Icon Tree designed by David Chapman from The Noun Project. [semver]: http://semver.org [gitter]: https://gitter.im/GitTools/GitVersion?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge [gitter-badge]: https://badges.gitter.im/Join+Chat.svg [appveyor]: https://ci.appveyor.com/project/GitTools/gitversion/branch/master [appveyor-badge]: https://ci.appveyor.com/api/projects/status/sxje0wht0cscmn7w/branch/master?svg=true [azure-pipeline]: https://dev.azure.com/GitTools/GitVersion/_build/latest?definitionId=1 [azure-pipeline-badge]: https://dev.azure.com/GitTools/GitVersion/_apis/build/status/GitTools.GitVersion [github-actions]: https://github.com/GitTools/GitVersion/actions [github-actions-badge]: https://github.com/GitTools/GitVersion/workflows/Build/badge.svg [travis]: https://travis-ci.org/GitTools/GitVersion [travis-badge]: https://travis-ci.org/GitTools/GitVersion.svg?branch=master [codecov]: https://codecov.io/gh/GitTools/GitVersion [codecov-badge]: https://codecov.io/gh/GitTools/GitVersion/branch/master/graph/badge.svg [docs]: https://gitversion.net/docs/ [gh-rel]: https://github.com/GitTools/GitVersion/releases/latest [gh-rel-badge]: https://img.shields.io/github/release/gittools/gitversion.svg?logo=github [choco]: https://chocolatey.org/packages/GitVersion.Portable [choco-badge]: https://img.shields.io/chocolatey/v/gitversion.portable.svg?logo=nuget [gvt]: https://www.nuget.org/packages/GitVersionTask [gvt-badge]: https://img.shields.io/nuget/v/GitVersionTask.svg?logo=nuget [gvcl]: https://www.nuget.org/packages/GitVersion.CommandLine [gvcl-badge]: https://img.shields.io/nuget/v/GitVersion.CommandLine.svg?logo=nuget [gvgt]: https://www.nuget.org/packages/GitVersion.Tool [gvgt-badge]: https://img.shields.io/nuget/v/GitVersion.Tool.svg?logo=nuget [brew]: http://brew.sh/ [brew-badge]: https://img.shields.io/homebrew/v/gitversion.svg?logo=homebrew [dockerhub]: https://hub.docker.com/r/gittools/gitversion/ [dockerhub-badge]: https://img.shields.io/docker/pulls/gittools/gitversion.svg?logo=docker [az-pipeline-task]: https://marketplace.visualstudio.com/items?itemName=gittools.gittools [az-pipeline-task-badge]: https://img.shields.io/badge/marketplace-gittools.gittools-blue?logo=visual-studio [gh-actions]: https://github.com/marketplace/actions/use-actions [gh-actions-badge]: https://img.shields.io/badge/marketplace-use--actions-blue?logo=github [contribute]: https://github.com/GitTools/GitVersion/blob/master/CONTRIBUTING.md [why]: https://gitversion.net/docs/why [usage]: https://gitversion.net/docs/usage/usage [how]: https://gitversion.net/docs/more-info/how-it-works [faq]: https://gitversion.net/docs/faq [who]: https://gitversion.net/docs/who [gv-in-action]: https://raw.github.com/GitTools/GitVersion/master/docs/input/docs/img/README.png