🚧 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

🚧 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

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

Fixed

• Fix using "slice" flag types with EnvVar in urfave/cli/pull/687 via @joshuarubin
• Fix regression of SkipFlagParsing behavior in urfave/cli/pull/697 via @jszwedko
• Fix handling ShortOptions and SkipArgReorder in urfave/cli/pull/686 via @baude
• Fix args reordering when bool flags are present in urfave/cli/pull/712 via @windler
• Fix parsing of short options in urfave/cli/pull/758 via @vrothberg

Added / Changed

• Added "required flags" support in urfave/cli/pull/819 via @lynncyrin
• Cleaned up help output in urfave/cli/pull/664 via @maguro
• Case is now considered when sorting strings in urfave/cli/pull/676 via @rliebz
• Backport JSON InputSource to v1 in urfave/cli/pull/598 via @jszwedko
• Allow more customization of flag help strings in urfave/cli/pull/661 via @rliebz
• Allow custom ExitError handler function in urfave/cli/pull/628 via @phinnaeus
• Allow loading a variable from a file in urfave/cli/pull/675 via @jmccann
• Allow combining short bool names in urfave/cli/pull/684 via @baude

Fixed

• Fixes regression introduced in 1.19.0 where using an ActionFunc as
  the Action for a command would cause it to error rather than calling the
  function. Should not have a affected declarative cases using func(c *cli.Context) err).
• Shell completion now handles the case where the user specifies
  --generate-bash-completion immediately after a flag that takes an argument.
  Previously it call the application with --generate-bash-completion as the
  flag value.

Added

• FlagsByName was added to make it easy to sort flags (e.g. sort.Sort(cli.FlagsByName(app.Flags)))
• A Description field was added to App for a more detailed description of
  the application (similar to the existing Description field on Command)
• Flag type code generation via go generate
• Write to stderr and exit 1 if action returns non-nil error
• Added support for TOML to the altsrc loader
• SkipArgReorder was added to allow users to skip the argument reordering.
  This is useful if you want to consider all "flags" after an argument as
  arguments rather than flags (the default behavior of the stdlib flag
  library). This is backported functionality from the removal of the flag
  reordering in the unreleased version
  2
• For formatted errors (those implementing ErrorFormatter), the errors will
  be formatted during output. Compatible with pkg/errors.

Changed

• Raise minimum tested/supported Go version to 1.2+

Fixed

• Consider empty environment variables as set (previously environment variables
  with the equivalent of "" would be skipped rather than their value used).
• Return an error if the value in a given environment variable cannot be parsed
  as the flag type. Previously these errors were silently swallowed.
• Print full error when an invalid flag is specified (which includes the invalid flag)
• App.Writer defaults to stdout when nil
• If no action is specified on a command or app, the help is now printed instead of panicing
• App.Metadata is initialized automatically now (previously was nil unless initialized)
• Correctly show help message if -h is provided to a subcommand
• context.(Global)IsSet now respects environment variables. Previously it
  would return false if a flag was specified in the environment rather than
  as an argument
• Removed deprecation warnings to STDERR to avoid them leaking to the end-user
• altsrcs import paths were updated to use gopkg.in/urfave/cli.v1. This
  fixes issues that occurred when gopkg.in/urfave/cli.v1 was imported as well
  as altsrc where Go would complain that the types didn't match

Fixed

• Removed deprecation warnings to STDERR to avoid them leaking to the end-user (backported)

Fixed

• Removed deprecation warnings to STDERR to avoid them leaking to the end-user (backported)

Fixed

• Removed deprecation warnings to STDERR to avoid them leaking to the end-user (backported)

Added

• ./runtests test runner with coverage tracking by default
• testing on OS X
• testing on Windows
• UintFlag, Uint64Flag, and Int64Flag types and supporting code

Changed

• Use spaces for alignment in help/usage output instead of tabs, making the
  output alignment consistent regardless of tab width

Fixed

• Printing of command aliases in help text
• Printing of visible flags for both struct and struct pointer flags
• Display the help subcommand when using CommandCategories
• No longer swallows panics that occur within the Actions themselves when
  detecting the signature of the Action field

Added

• Pluggable flag-level help text rendering via cli.DefaultFlagStringFunc
• context.GlobalBoolT was added as an analogue to context.GlobalBool
• Support for hiding commands by setting Hidden: true -- this will hide the
  commands in help output

Changed

• Float64Flag, IntFlag, and DurationFlag default values are no longer
  quoted in help text output.
• All flag types now include (default: {value}) strings following usage when a
  default value can be (reasonably) detected.
• IntSliceFlag and StringSliceFlag usage strings are now more consistent
  with non-slice flag types
• Apps now exit with a code of 3 if an unknown subcommand is specified
  (previously they printed "No help topic for...", but still exited 0. This
  makes it easier to script around apps built using cli since they can trust
  that a 0 exit code indicated a successful execution.
• cleanups based on Go Report Card
  feedback