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.

Release 2.0.0 Alpha

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

Release 1.22.1

🚧 Watch out! There's a known regression in this release! #850 🚧

Fixed

• Hide output of hidden commands on man pages in urfave/cli/pull/889 via @crosbymichael
• Don't generate fish completion for hidden commands urfave/cli/pull/891 via @saschagrunert
• Using short flag names for required flags throws an error in urfave/cli/pull/890 via @asahasrabuddhe

Changed

• Remove flag code generation logic, legacy python test runner in urfave/cli/pull/883 via @asahasrabuddhe
• Enable Go Modules support, drop support for Go 1.10 add support for Go 1.13 in urfave/cli/pull/885 via @asahasrabuddhe

Release 1.22.0

🚧 Watch out! There's a known regression in this release! #850 🚧

Fixed

• Fix Subcommands not falling back to app.ExitEventHandler in urfave/cli/pull/856 via @FaranIdo

Changed

• Clarify that altsrc supports both TOML and JSON in urfave/cli/pull/774 via @whereswaldon
• Made the exit code example more clear in urfave/cli/pull/823 via @xordspar0
• Removed the use of python for internal flag generation in urfave/cli/pull/836 via @asahasrabuddhe
• Changed the supported go versions to 1.10, 1.11, 1.12 in urfave/cli/pull/843 via @lafriks
• Changed the v1 releases section in the readme in urfave/cli/pull/862 via @russoj88
• Cleaned up go modules in urfave/cli/pull/874 via @saschagrunert

Added

• Added UseShortOptionHandling for combining short flags in urfave/cli/pull/735 via @rliebz
• Added support for flags bash completion in urfave/cli/pull/808 via @yogeshlonkar
• Added the TakesFile indicator to flag in urfave/cli/pull/851 via @saschagrunert
• Added fish shell completion support in urfave/cli/pull/848 via @saschagrunert