MartinCostello.DotNetBumper 0.1.0

.NET Bumper ⛐📦⤴️✨

[!NOTE] This project is currently experimental.

Overview

.NET Bumper is a .NET Global Tool to upgrade projects to a newer version of .NET.

Bumper helps you upgrade your .NET projects to a newer version by taking care of some of the steps required to move from one version to another. Bumper supports upgrading to both Long Term Support (LTS) and Standard Term Support (STS) versions of .NET, and the latest preview versions of .NET. 🚀

Steps the tool can perform on your behalf include:

• Updating the .NET SDK version in global.json 🧑‍💻
• Upgrading the Target Framework of your project files ⚙️
• Upgrading .NET, ASP.NET Core and EFCore NuGet packages to the appropriate versions 📦
• Updating image tags in Dockerfiles 🐳
• Running dotnet test to validate the upgrade 🧪

[!NOTE] Upgrades are made on a best-effort basis. You should always review the changes made by the tool and test any changes made to validate the upgrade.

Quick Start

To install the tool and upgrade a .NET 6 or later project to the latest Long Term Support (LTS) version of .NET, run the following command:

dotnet tool install --global MartinCostello.DotNetBumper
dotnet bumper .

Usage

For a full list of options, run dotnet bumper --help.

An example of the output is shown below.

Examples

Upgrade a project to the current LTS version of .NET

dotnet bumper ~/projects/awesome-project

Upgrade a project to the latest version of .NET

dotnet bumper ~/projects/awesome-project --upgrade-type Latest

Upgrade a project to the preview version of .NET

dotnet bumper ~/projects/awesome-project --upgrade-type Preview

Upgrade a project to a specific version of .NET

dotnet bumper ~/projects/awesome-project --channel 8.0

Upgrade a project to the current LTS version of .NET and then run dotnet test after the upgrade has completed

dotnet bumper ~/projects/awesome-project --test

Options

> dotnet bumper --help
Upgrades projects to a newer version of .NET. 0.1.0

Usage: dotnet bumper [options] <ProjectPath>

Arguments:
  ProjectPath               The path to directory containing a .NET 6+ project to be upgraded. If not specified, the
                            current directory will be used.

Options:
  -v|--verbose              Show verbose output
  --version                 Show version information.
  -?|-h|--help              Show help information.
  -c|--channel <CHANNEL>    The .NET release channel to upgrade to in the format "major.minor".
  -t|--upgrade-type <TYPE>  The type of upgrade to perform.
                            Allowed values are: Lts, Latest, Preview.
  -test|--test              Test the upgrade by running dotnet test on completion.
  -e|--warnings-as-errors   Treat any warnings encountered during the upgrade as errors.

Pre-requisites

• .NET 8 must be installed to use the tool
  • The .NET SDK version to upgrade to must also be installed if this is different
• The dotnet-outdated .NET Global tool must also be installed
• Any project being upgraded must already target at least .NET 6

Building and Testing

Compiling the application yourself requires Git and the .NET SDK to be installed.

To build and test the application locally from a terminal, run the following set of commands:

git clone https://github.com/martincostello/dotnet-bumper.git
cd dotnet-bumper
dotnet tool restore
./build.ps1

Feedback

Any feedback or issues can be added to the issues for this project in GitHub.

Repository

The repository is hosted in GitHub: https://github.com/martincostello/dotnet-bumper.git

License

This project is licensed under the Apache 2.0 license.