Upgrade urfave/cli to handle Sources on Int and FloatFlags #59
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
We have been using a workaround package that implements
HideDefault
to get around the limitation that existed in urfave/cli v3.0.0-alpha9 (urfave/cli#1925). However, our workaround did not support additional sources for the value of Int or Float flags, and it was thus not possible to supply values forrooms-per-process
and a number of other variables via config file.The limitation is fixed in the latest alpha, so this PR upgrades to the most recent version of the package. Because of this, we can remove the workaround package and also get the benefit of
Sources
working again for integer and float flags. However, there are some other breaking changes in the latest release that also needed to be accounted for.Persistent & Local Flags
Flags were previously local by default and could be set as persistent using the
Persistent
field. In the most recent release, flags are persistent by default, there is noPersistent
field, and making a flag local requires setting theLocal
field. See urfave/cli#976 for context.Stateful Flags
The documented behavior of flags in the library is that they are stateful and should not be reused. However in the version of the library we were using this seemed to not be the case and we were able to make all of our flags
var
s and the tests mostly ran (see: urfave/cli#2007). In the most recent release the behavior matches the documented behavior, so to continue with our current testing strategy all flags need to be used only once. To accomplish this this PR changes all flags and commands to be constructed via factory functions, so each test gets its own instance of the flag and previous cases don't cause unexpected issues in test runs.Due to this behavior and the special implementation of the help flag in the library, the tests for the "help" commands were removed.
Double specification of global flags
We previously specified global flags both on the root command and on individual commands using the
subcommandFlags
function. This likely didn't matter because the flags in both cases were the same object. However, with the other changes in this PR, these are no longer the same object, and this ended up being a problem for parsing. Luckily, recent changes to the library have allowed global flags to be parsed in any order (urfave/cli#1987) and the fix for this was to remove thesubcommandFlags
function altogether.