Release 2.3.0

These release notes were written for the git hash 09ac54c.

Fixed

• Fixed a bug 'Unable to load file' in altsrc in #1086 via @akramarenkov
• Fixed a bug where App.ErrWriter not being initialized in App.Setup() in #1100 via @Nokel81
• Harmonize BeforeError handling in #1117 via @creekorful
• Fixed a bug where the default value is not set in the Destination field in the StringSliceFlag in #1121 via @sgoroshko
• Fixed a bug where the version flag was shown unexpectedly on commands with subcommands in #1153 via @lrioth
• Fixed a bug where the default StringSlice values would be mutated in #1170 via @tych0
• Fixed a bug where values set by environment var are not saved to existing stringslice reference in #1178 via @alexcb
• Fixed a bug where fish completion did not respect TakesFile on PathFlags in #1198 via @ErinCall

Changed

• Improved ZSH Autocompletion (List files on tab with no completion options) in #1130 via @oleorhagen
• Improved help text rendering in #1175 via @imle

Added

• Added support for Go 1.14 in #1085 via @lynncyrin
• Added support for Powershell autocompletion in #1139 via @kirinnee
• Added support for using Value with TimeStamp flag in #1160 via @vschettino
• Added ShowSubcommandHelpAndExit to print help for the given subcommand and exit with exit code in #1183 via @knqyf263
• Expose the constructor of MapInputSource type in #1194 via @igorrius
• Added support for a App.Reader that defaults to os.Stdin via #1191 via @stellirin

Release 1.22.5

These release notes were written for the git hash af7fa3d.

Fixed

• Fixed a formatting bug in the v1 required flags error message in #1126 via @oleorhagen
• Harmonize BeforeError handling in in #1132 via @creekorful, @VirrageS

Changed

• Improved ZSH Autocompletion (List files on tab with no completion options) in #1133 via @oleorhagen

Release 1.22.4

These release notes were written for the git hash 053ba9d

Fixed

• Fixed a panic with flag completion in #1101 via @unRob, @VirrageS

Release 2.2.0

These release notes were written for the git hash d648edd

Fixed

• Fixed zsh completion scripts in #1062 via @zhsj
• Fixed description of subcommand to be more consistent in #1054 via @itchyny
• Fixed possible runtime panic in slice parsing in #1049 via @saschagrunert
• Fixed invalid man page header generation in #1041 via @saschagrunert

Changed

• Improved auto-completion instructions and added example gifs in #1059 via @masonj188
• Removed the author from generated man pages in #1041 via @saschagrunert

Added

• Added destination field to StringSliceFlag in #1078 via @davidsbond
• Added HideHelpCommand. While HideHelp hides both help command and --help flag, HideHelpCommand only hides help command and leave --help flag as-is in #1083 via @AkihiroSuda
• Added timestampFlag docs in #997 via @drov0
• Added required flags documentation in #1008 via @lynncyrin, @anberns

Release 1.22.3

Fixed

• String flag no longer persists the default value if the flag is explicitly initialized in #981 via @asahasrabuddhe
• context.IsSet() returns true or false correctly regardless of whether the short name or the full name of the flag is passed to it in #978 via @asahasrabuddhe
• Hide version if the version is not set by the user in #954 via @asahasrabuddhe

Release 2.1.1

Fixed a Context regression introduced in v2.1.0 in #1014 via @lynncyrin

Release 2.1.0

These release notes were written for the git hash ae84df4cef4a2a6f1a0cb1d41ea0f3af8755e5a8

Fixed

• Fixed some golint errors in #988 via @liamchampton
• Fixed a panic with flag completion #946 via @unRob

Changed

• Changed docs generation to use visible flags in #999 via @subpop
• Changed App.Run to use an optional context for timeouts and cancellation in #975 via @marwan-at-work
• Changed version info to be hidden if the user has not defined a version in #955 via @asahasrabuddhe
• Changed docs generation to take into account multiple authors in #900 via @saschagrunert
• Changed context to expose a Value accessor in #741 via @corruptmemory

Added

• Added timestamp flag in #987 via @drov0

Release 2.0.0

V2 was merged in #892, which included the work of all of these contributors: @asahasrabuddhe, @meatballhat, @jszwedko, @lynncyrin, @AudriusButkevicius, @saschagrunert, @rliebz, @johnweldon, @nlewo, @grubernaut, @OneOfOne, @VMitov, @cbranch, @marwan-at-work, @uudashr, @bfreis

Discuss the state of V2 here => #826

---

Added

• Added NewStringSlice and NewIntSlice for creating their related types
• Added Float64SliceFlag for unmarshaling a list of floats from the user
• Added Context.Lineage to get all contexts from current up to global
• Added Context.LocalFlagNames to get the flag names from only the current context
• Added BoolFlag.Value to handle both default-false and default-true
• Added IsSet method to the Flag interface which allows us to detect whether or not a flag has been set

Changed

• Occurrences of []Command have been changed to []*Command
• Occurrences of []cli.Flag have been changed to []*cli.Flag
• Context.FlagNames now returns all flags in the context lineage
• Context.IsSet now considers the full context lineage

Removed

• Removed Global* flags since all flags are now global
  • when updating, replace GlobalBool with Bool
  • and GlobalInt with Int
  • and GlobalString with String
  • and so on for any other global flags
• Removed Context.Parent method, as this is now available via Context.Lineage
  • when updating, replace Context.Parent() with Context.Lineage()[1]
• Removed the App.Author and App.Email
  • these have been replaced with the Authors []*Author field
• Removed the ability to specify multiple entries in the Command.Name field
  • when updating, replace Name: "a, b, c" with Name: "a", Aliases: []string{"b", "c"}
• Removed the Command.ShortName field
  • when updating, replace ShortName: "i" with Aliases: []string{"i"}
• Removed all Context.Global* methods, as the non-global versions now traverse up
  the context lineage automatically.
• Removed the ability to specify &StringSlice{...string} or &IntSlice{...int}.
• Removed adapter code for deprecated Action func signature
• Removed BoolTFlag and related code, as this is now available via BoolFlag.Value

Release 1.22.2

Fixed

• Fix v1.21.0 pass through regression in urfave/cli/pull/872 via @lynncyrin
• Fix infinite loop when parsing invalid flags for apps with short option handling in urfave/cli/pull/911 via @rliebz
• Fix zsh autocomplete in urfave/cli/pull/906 via @gnowxilef
• Fix typo in DocGenerationFlag.TakesValue() docstring in urfave/cli/pull/902 via @benmoose
• Avoid panic for missing flag value in urfave/cli/pull/893 via @rliebz

Changed

• Simplify HelpPrinter and CustomHelpPrinter behaviors in urfave/cli/pull/912 via @rliebz

Release 2.0.0 Alpha 2

This is a pre-release meant for internal testing purposes. Please do not use this until you really know what you are doing.