v3.4.0

3.4.0 is a pretty big release containing mostly bug fixes but a heap of little features and improvements to make it easier to get started and use GitVersion.

Highlights are:

• When GitVersion runs on buildservers which do not allow fetch, it gets the branchname from environmental variables to prevent a fetch by default. This should make it much easier to just grab GitVersion and get started. It also reduces the need for dynamic repositories.
• You can now use {BranchName} in your tag config. So for feature branches you could do alpha.{BranchName}
• Can rebuild tags now without errors on the build server
• Heaps of small commit counting/branch normalisation fixes
• GitVersion now caches results, this speeds up a number of scenarios
• Lots of small docs improvements to make things clearer

Complete Release notes

• #768 - Document branch name variable usage in tag configuration #664 contributed by Gusztáv Varga (gusztavvargadr)
• #767 - Fixed json serialisation of 0's contributed by Jake Ginnivan (JakeGinnivan) fixes #762 - Flakey data types of returned JSON data +fix
• #765 - Perf improve part1 contributed by Eben Zhang (EbenZhangEmbed)
• #764 - Test to make sure #675 is really fixed contributed by Jake Ginnivan (JakeGinnivan)
• #763 - Fixed issue where config is no longer discovered contributed by Jake Ginnivan (JakeGinnivan)
• #758 - +0 in Version numbers (VSTS)
• #754 - Merge pull request #1 from GitTools/master contributed by oSilas (oSilas)
• #752 - Add test which verifies #257 is fixed contributed by Jake Ginnivan (JakeGinnivan)
• #744 - Bump develop when release branch is created contributed by Jake Ginnivan (JakeGinnivan)
• #753 #742 - Create PreReleaseLabel and PreReleaseNumber #742 contributed by Guillaume Rouchon (qetza)
• #738 - Fixed error contributed by Jake Ginnivan (JakeGinnivan) - fixes #731 - Unexpected error
• #733 - Unit Tests for Issue #728 contributed by Nithin Shenoy (nshenoy)
• #727 - Make sure to convert the whole object back to the JSON file contributed by Pascal Berger (pascalberger)
• #724 - Remove requirement on master branch existing contributed by Gary Ewan Park (gep13)
• #723 - Running in AppVeyor produces invalid semver for NuGet
• #722 - A peeled target isn't necessarily a commit contributed by Asbjørn Ulsberg (asbjornu) - fixes #721 - InvalidCastException on untagged branch though tag on merged branch exists
• #718 - VSO Task doesn't allow updated assembly info to be written to a specfic file
• #717 - Converted VSO Task to use PowerShell contributed by John Kattenhorn (johnkattenhorn)
• #716 - Tests to ensure up to date documentation contributed by Asbjørn Ulsberg (asbjornu)
• #712 - More informative crash on invalid working directory contributed by Asbjørn Ulsberg (asbjornu)
• #711 - Cache version information to disk contributed by Asbjørn Ulsberg (asbjornu)
• #710 #709 - Added global:: prefix in AssemblyInfoBuilder to avoid namespace conflicts. contributed by (sponge-b0b) - #703 - Add documentation about support of VB.NET contributed by Pascal Berger (pascalberger)
• #702 - Formatted the semver token explanation contributed by Asbjørn Ulsberg (asbjornu)
• #701 - Add property to always expose commits since last version contributed by Oren Novotny (onovotny) - #700 - Commit count resets to 0 when merge detected on branches - #687 - Conditional ms build tasks contributed by (pi3k14)
• #743 #681 - No longer resets commit count when branch is forward merged contributed by Jake Ginnivan (JakeGinnivan)
• #675 - When running GitVersion on buildserver /output json is ignored
• #766 #664 - Support branch name variable in tag configuration #664 contributed by Gusztáv Varga (gusztavvargadr)
• #746 #690 #642 - Fix branch normalisation when building a non-tip tag. Fixes #690 contributed by Jake Ginnivan (JakeGinnivan)
• #613 - Add /nofetch to argument help +fix
• #713 - Improve documentation contributed by Asbjørn Ulsberg (asbjornu)
• #751 #605 - Display nicer error message when git is not on the path and GitVersio… contributed by Jake Ginnivan (JakeGinnivan)
• #755 #606 #604 #628 - Prevent fetch for Vso and Jenkins, TeamCity contributed by Jake Ginnivan (JakeGinnivan)
• #750 #548 - Do not pick up version in merge target contributed by Jake Ginnivan (JakeGinnivan)
• #714 #473 - Add version info if it does not exist contributed by Josh Hobbs (FunnyFry)
• #257 - Allows assembly info update to run multiple times +enhancement

v3.3.0

Highlights for this release are the ability to format AssemblyInformationalVersion in config using string interpolation ({Major}.{Minor}.{Patch} etc using the GitVersion variables), better build number. Pascal Berger (pascalberger) also improved the docs quite a bit!

• #696 - Performance fix contributed by Jake Ginnivan (JakeGinnivan)
• #693 - Development branch version not updated after creating a release branch
• #689 - Enable use of GitVersion variables in the VSO BuildNumber contributed by Oren Novotny (onovotny)
• #684 - Don't check excluded branches for commits
• #680 - Make sure that we're not evaluating excluded branches contributed by Örjan Sjöholm (orjan)
• #678 - Add support for relative logfile paths contributed by Asbjørn Ulsberg (asbjornu)
• #676 - Conditional ms build tasks contributed by (pi3k14)
• #660 - Add support and tests for AssemblyInformationalVersion configurability contributed by Mark Zuber (MarkZuber)
• #618 #674 - NullReferenceException in FindCommitBranchWasBranchedFrom
• #368 - Allow configuring AssemblyInformationalVersion contents +enhancement

v3.2.0

• #683 - Improve usage documentation contributed by Pascal Berger (pascalberger)
• #682 - Build Metadata for branch includes invalid characters from branch name contributed by Ronny Hanssen (Spiralis)
• #677 #674 - FindCommitBranchWasBranchedFrom should not throw NullReferenceException contributed by Asbjørn Ulsberg (asbjornu)
• #670 - Add missing NuGet package contributed by Eberhard Beilharz (ermshiperete)
• #669 - Allow building on Linux contributed by Eberhard Beilharz (ermshiperete)
• #667 #672 - TFS Build vNext Documentation also for TFS On-Prem contributed by Pascal Berger (pascalberger)
• #665 #663 - Update build version from VSO Agent task. contributed by Pascal Berger (pascalberger)
• #661 #557 #659 #557 - Feature/659 fix ip should not be matched as versions contributed by Marcel Körtgen (mkoertgen)
• #654 - Removed dead projects contributed by Cameron MacFarland (distantcam)
• #653 - Expose NoFetch to fix #646 contributed by Oren Novotny (onovotny)
• #650 - Fix link to architecture documentation contributed by Pascal Berger (pascalberger)
• #649 - Update who.md contributed by Asbjørn Ulsberg (asbjornu)
• #646 - GitVersionTask 3.1.2 tries to fetch on VsoAgent
• #645 - Git tools core integration contributed by Jake Ginnivan (JakeGinnivan)
• #641 - Improve formatting and fix some typos contributed by Eberhard Beilharz (ermshiperete)
• #640 - Upgraded to GitTools.Testing contributed by Jake Ginnivan (JakeGinnivan)
• #631 - re #630 - optionally allows /updateassemblyinfofilename to be generated contributed by Phil Oyston (Philo)

Commits: 5e40599...fd77425

3.1.2

• #634 - Automatically increment version numbers for hotfixes?
• #627 - Default config updates to recognize more defaults
  contributed by Oren Novotny (onovotny)
• #627 - Make padding configurable and add padded BuildMetaData
  contributed by Oren Novotny (onovotny)
• #627 - Update build server documentation contributed by Pascal Berger (pascalberger)
• #626 - Should not checkout branch on update contributed by Örjan Sjöholm (orjan)
• #624 - Mixed up branches when running in TeamCity
• #616 - Remove fixed known issue contributed by Pascal Berger (pascalberger)
• #615 - Fix effective configuration using minor version bump regex instead of patch regex contributed by Thomas Gillen (TomGillen)
• #614 - GitFlow Feature Branches not incrementing
• #611 - GitVersion fails to pull a dymanic repository when on TeamCity
• #609 - GitVersionTask modifies files even if no change is required

v3.1.1

• #611 - GitVersion fails to pull a dymanic repository when on TeamCity - contributed by Phil Oyston
• #609 - GitVersionTask modifies files even if no change is required - contributed by Oren Novotny

v3.1.0

There are a few nice new features in this release:

• Added support for Visual Studio Build vNext. For those of you who are not aware, TFS has a new build system. Attached to this release is a zip file. See the docs at http://gitversion.readthedocs.org/en/latest/more-info/build-server-setup/tfs-build-vnext/ for more info.
• Support for NuGet 3.1 and UWP now.
• Support for Jenkins
• Can bump version via commit messages! +semver:breaking or +semver:major will bump major, +semver:minor or +semver:feature will bump minor.

There are also a bunch of other fixes around branch normalisation and dynamic repositories. If you have any issues let us know.

• #597 - GitVersionTask uses the project name as the namespace name in GitVersionTaskAssemblyInfo instead of default namespace value
• #596 - Reintegrate develop fix contributed by Jake Ginnivan (JakeGinnivan)
• #595 - Clarify documentation of variables in TFS build contributed by Pascal Berger (pascalberger)
• #594 - fix version cache key in msbuild task contributed by Simon Cropp (SimonCropp)
• #593 - Add generic error message if more than one remote is found contributed by Pascal Berger (pascalberger)
• #591 - Quote source path contributed by Pascal Berger (pascalberger)
• #590 - recursive zip for VSO task contributed by Simon Cropp (SimonCropp)
• #589 - DllNotFoundException in VSO Task
• #588 - Quote source path contributed by Pascal Berger (pascalberger)
• #587 - Fix label for updating AssemblyInfos contributed by Pascal Berger (pascalberger)
• #586 - Integrating Custom VSO Custom Task with GitVersion
• #585 - Updated Octopus Deploy docs contributed by (sstorie)
• #583 - Question - Git flow commands for the "release packages" approach to Octopus Deploy?
• #581 - Restructure headlines & fix some typos in the TFS documentation contributed by Pascal Berger (pascalberger)
• #580 - Improve TFS Build documentation contributed by Pascal Berger (pascalberger)
• #579 - Fix command for uploading of the task contributed by Pascal Berger (pascalberger)
• #578 - Fix gem build contributed by Alexander Groß (agross)
• #577 - Add note that VSO build version cannot be set atm contributed by Pascal Berger (pascalberger)
• #576 - Add link to Octopus Deploy in build server overview contributed by Pascal Berger (pascalberger)
• #574 - use rootNamespace for namespace of generated files contributed by Simon Cropp (SimonCropp)
• #573 - Load lib git from files contributed by Simon Cropp (SimonCropp)
• #571 - Vso build step contributed by Jake Ginnivan (JakeGinnivan)
• #570 - GitVersion of file path where last changed (GitVersion -filter)
• #568 - Calculation of branch configuration will fail if master and develop is equal and is integrated in a feature branch.
• #567 - Removed GitFlow BranchType since it's not used any more contributed by Örjan Sjöholm (orjan)
• #565 - The type initializer for '' threw an exception (Attempted to read or write protected memory)
• #564 - Build metadata commit count not cleared properly for continuous deplo… contributed by Jake Ginnivan (JakeGinnivan)
• #563 - Enable GitVersionTask to work with NuGet v3 contributed by Oren Novotny (onovotny)
• #562 - Support for Visual Studio Online Build vNext - VSO Build Step contributed by Oren Novotny (onovotny)
• #561 - Create VSO Build vNext Build Step for GitVersion
• #560 - Add support for VSO agent #546 contributed by Oren Novotny (onovotny)
• #559 - BuildMetaData and FullBuildMetaData wrong?
• #558 - AssemblyInfoBuilder namespace should use default namespace as defined in project
• #556 - Fix missing line breaks and typo in githubflow.md contributed by Thomas Gillen (TomGillen)
• #555 - Namespace name cannot start with numbers contributed by Cristian Iorga (cristianiorga)
• #554 - Update myget.md contributed by Xavier Decoster (xavierdecoster)
• #553 - GitVersion not workig for detached head - TFS Build vNext
• #552 - Fixed path too long problem. contributed by Dan Lewi Harkestad (baltie)
• #551 - Support for Jenkins CI contributed by Marijn van der Zee (serra)
• #550 - NuGet 3.1, GitVersion and Universal Windows Platform(UWP)
• #547 - Commit Counts and Tags
• #546 - $(GitVersion_NuGetVersion) does seem to get set when Solution is built using TFS Build vNext
• #543 - [Improvement] The executable 'git' could not be found
• #542 - [Improvement] Do complete checkout when updating local branch fails
• #540 - GitVersionTaskAssemblyInfo.g.cs Namespace GitVersionTask
• #534 - Add /output props contributed by Marijn van der Zee (serra)
• #518 - Team Build Usage Documentation
• #489 - Add support for indicating change severity in commit messages contributed by Thomas Gillen (TomGillen)
• #488 - Version number is not cached between projects in a solution +fix
• #313 - Support Jenkins CI +enhancement
• #175 - Take pull request branch name into account +enhancement

v3.0.2

• Fixed gitversion init crash

v3.0.1

• Fixes issue with commit counting

v3.0.0

GitVersion v3 has been a long time in the making and many people have been using the beta for months. v3 was almost a complete rewrite to enable GitVersion to be more predictable and work for far more workflows and environments.

Blog post at http://jake.ginnivan.net/blog/2015/07/28/gitversion-v3/

Thanks to all the contributors including Sam Harwell (sharwell), Raphael Haddad (RaphHaddad), (Tungsten78), Cameron MacFarland (distantcam), Simon Cropp (SimonCropp), Chris Maffin (Sacrelicious), Anthony Ledesma (arledesma), Marcel Jamin (mjamin), Johannes Egger (eggapauli), Meirion Hughes (MeirionHughes), Asbjørn Ulsberg (asbjornu), Shay Rojansky (roji), Rich Knight (rcknight), Jake Ginnivan (JakeGinnivan), Yannis Güdel (yannisgu), Marcus Griep (neoeinstein), Geert van Horrik (GeertvanHorrik), Henning Moe (GeirGrusom), Örjan Sjöholm (orjan), João Bragança (thefringeninja), (anobleperson), (Martaver), Gary Park (gep13)

Closed Since beta.4

• #524 #516 #502 #209 #122 #220 #293 #374 - Documentation
• #537 - Updated the generated output to include an "auto-generated" header contributed by Sam Harwell (sharwell)
• #536 #530 - Update task contributed by Simon Cropp (SimonCropp)
• #535 - Generated files are missing a standard auto-generated header
• #532 - Init improvements
• #530 - Gfv* variables
• #528 - Caching nuget packages for quicker builds. contributed by Cameron MacFarland (distantcam)
• #527 - Used regex to determine if version attributes are still there. contributed by Cameron MacFarland (distantcam)
• #525 - Added generated classes to their own namespace to avoid conflicts. contributed by Cameron MacFarland (distantcam)
• #523 - Fixes version calculation issue introduced when fixing #465
• #522 #501 #223 - Fix Gem deployment
• #521 #506 - Badges!
• #514 - GitVersion.Portable throws when trying to init a new version number +fix
• #513 - Cryptic exception when the git folder can't be found +enhancement
• #511 #203 - Better exception text for auth error contributed by Raphael Haddad (RaphHaddad)
• #510 - TagPrefix cleanup contributed by (Tungsten78)
• #503 #367 - Dynamic repo should require a branch specified contributed by Raphael Haddad (RaphHaddad)
• #500 - Guess when there are two branches pointing at the same commit. Trying…
• #497 #378 - Filtering passwords at logging level issue #378 contributed by Raphael Haddad (RaphHaddad)
• #496 #495 - Address tag parsing contributed by (Tungsten78)
• #486 #485 - Warning should be info: No specific commit specified or found, falling back to latest commit on specified branch contributed by Oren Novotny (onovotny)
• #484 #452 - #Support specific branches for tracking versions contributed by Geert van Horrik (GeertvanHorrik)
• #483 - Version caching was looking at working directory not git directory contributed by Chris Maffin (Sacrelicious)
• #474 - Replace or update assembly info in files contributed by Chris Maffin (Sacrelicious)
• #470 - Enable config based ignoring of commits/messages that incorrectly inc… contributed by Chris Maffin (Sacrelicious)
• #460 - Discrepencies between GitVersion CommandLine and GitVersionTask
• #448 #121 - GitVersion task assembly version issues
• #403 - ShowVariable switch has incorrect help and fails to work +fix
• #285 - Correct version in TeamCity agent (checkout on agent) when no tags available.

Rest of issues closed in v3 release

• #482 - Update ArgumentParser to use variables from VersionVariables contributed by Anthony Ledesma (arledesma)
• #480 - Included AssemblyInfo.vb in file update contributed by Marcel Jamin (mjamin)
• #479 - Init improvements
• #478 #465 - Hotfix resets PreReleaseTag.Number to 1
• #477 #472 - Logging improvements (Add logging indent and timing)
• #469 #471 - GitVersionTask does not detect git repo if sln isn't in git root contributed by Chris Maffin (Sacrelicious)
• #468 - Use authentication in GitPreparer.GetRemoteReference contributed by Johannes Egger (eggapauli)
• #467 - Filter out merge messages that look like versions but aren't contributed by Chris Maffin (Sacrelicious)
• #464 - Fix tracking branches in dynamic repositories contributed by Johannes Egger (eggapauli)
• #456 - Failing inheritance fixes
• #453 - Sequence contains more than one matching element
• #451 - Dynamic repo config file
• #442 - Resolve incorrect generation of meta count when there are multiple remote branches contributed by Meirion Hughes (MeirionHughes)
• #440 - Tests fail: Can't find git contributed by Asbjørn Ulsberg (asbjornu)
• #439 - Pick up GitVersionConfig.yaml when using a dynamic repository contributed by Johannes Egger (eggapauli)
• #438 - AssemblyInfo attributes regex fix contributed by Shay Rojansky (roji)
• #437 - Extremely slow UpdateAssemblyInfo in GitVersionTask
• #432 #431 - Add NoFetch option to ...

v3.0.0-beta.4

With this release we are getting very close to releasing v3.0.0. There have been quite a few improvements with the gitversion init configuration tool, give it a spin!

• #482 - Update ArgumentParser to use variables from VersionVariables contributed by Anthony Ledesma (arledesma)
• #480 - Included AssemblyInfo.vb in file update contributed by Marcel Jamin (mjamin)
• #479 - Init improvements
• #478 #465 - Hotfix resets PreReleaseTag.Number to 1
• #477 #472 - Logging improvements (Add logging indent and timing)
• #469 #471 - GitVersionTask does not detect git repo if sln isn't in git root contributed by Chris Maffin (Sacrelicious)
• #468 - Use authentication in GitPreparer.GetRemoteReference contributed by Johannes Egger (eggapauli)
• #467 - Filter out merge messages that look like versions but aren't contributed by Chris Maffin (Sacrelicious)
• #464 - Fix tracking branches in dynamic repositories contributed by Johannes Egger (eggapauli)

Commits: d64f3b5...bec5eb5