upgrade#

usage: scotty upgrade [-h] [--dryrun] [--format {txt,json}]
                      [--changelog-file CHANGELOG]
                      [--changelog-snippets CHANGELOG_SNIPPETS]
                      rootpath files [files ...]

Check for configuration file upgrades. Prints a list of files that can be/has
been upgraded

positional arguments:
  rootpath              Root path to files (repository root)
  files                 Files to check

options:
  -h, --help            show this help message and exit
  --dryrun              Dry run, do not change files (default: False)
  --format {txt,json}   Format of output (default: json)
  --changelog-file CHANGELOG
                        Create changelog at this path (default: None)
  --changelog-snippets CHANGELOG_SNIPPETS
                        Create per repository changelog snippets at this path
                        (default: None)

Note

upgrade allows you to check for upgrades to one or more kas configuration files.

The command will change the files unless --dryrun is passed as an argument.

If upgrade have been found the path to the file is returned as an output (in the --format chosen).

Implementation notes

We currently only support to upgrade repos entries that either have

  • tag set. Those will be checked if a newer tag on the same branch exists

  • commit + branch. Those will be checked if a newer commit exists on the mentioned branch

All other combinations are skipped automatically