DotBump 0.2.1

DotBump

.NET tool to automate dependency upgrade tasks in .NET solutions.

Installation

dotnet tool install DotBump

Features

Bump the .NET SDK version

Bump the global.json SDK version to the latest specified SDK version based on the current release index.

DESCRIPTION:
Bump the global.json SDK version. Use the 'minor' type option to bump the SDK to
the latest minor or patch version for the current major version. Use the 'patch'
type option to bump the SDK to the latest patch version for the current minor
version.

USAGE:
    dotnet dotbump sdk [OPTIONS]

EXAMPLES:
    dotnet dotbump sdk
    dotnet dotbump sdk --type patch
    dotnet dotbump sdk --file ./other/global.json --output bump-sdk-report.json
    dotnet dotbump sdk --security-only true --debug true --logfile bump-sdk-log.txt


OPTIONS:
    -h, --help             Prints help information                              
        --debug            Enable debug logging for troubleshooting. Includes   
                           response data                                        
        --logfile          The file to send the log output to                   
    -t, --type             The bump type. Defaults to `minor`. Available options
                           are `minor` and `patch`                              
    -f, --file             The global.json file to update. Defaults to          
                           `./global.json`                                      
    -o, --output           Output file name. The name of the file to write the  
                           result to. The output format is json                 
    -s, --security-only    Only bump the version if the new release is a        
                           security release. Defaults to false      

Bump the Local .NET Tools versions

DESCRIPTION:
Bump the local .NET tools versions. Use the 'minor' type option to bump the tools to
the latest minor or patch versions for the current major version. Use the 'patch' type 
option to bump the tools to the latest patch version for the current minor version. 

USAGE:
    dotnet dotbump tools [OPTIONS]

EXAMPLES:
    dotnet dotbump tools
    dotnet dotbump tools --type patch
    dotnet dotbump tools --config ./custom-nuget.config --output bump-tools-report.json
    dotnet dotbump tools --debug true --logfile bump-tools-log.txt


OPTIONS:
    -h, --help       Prints help information                                                                 
        --debug      Enable debug logging for troubleshooting. Includes response data                        
        --logfile    The file to send the log output to                                                      
    -t, --type       The bump type. Defaults to `minor`. Available options are `minor` and `patch`           
    -o, --output     Output file name. The name of the file to write the result to. The output format is json
    -c, --config     The nuget config file to use. Defaults to `./nuget.config`     

Pre-releases

If the current .NET tool version is a pre-release version, pre-release versions will be taken into account for new versions.

Private Feeds

Private feeds are supported using environment variables.

See credentials in NuGet config files and using environment variables for more information.

The username and plain text password in a nuget.config file can use an environment variable by adding % to the beginning and end of the environment variable name you would like to use.

Example:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="myfeed" value="https://nuget.pkg.github.com/robyvandamme/index.json" protocolVersion="3" />
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
  </packageSources>
  <packageSourceCredentials>
    <myfeed>
      <add key="Username" value="%PRIVATE_GITHUB_FEED_USER%" />
      <add key="ClearTextPassword" value="%PRIVATE_GITHUB_FEED_PASSWORD%" />
    </myfeed>
  </packageSourceCredentials> 
</configuration>