Latest release


@matejak matejak released this Mar 4, 2018 · 28 commits to master since this release


  • Fixed the installation issue related to bash completion.
  • Allowed docopt and completion output even in case of stdin input and stdout output.


@matejak matejak released this Feb 27, 2018 · 33 commits to master since this release

New features:

  • Initial support for bash completion.
  • Introduction of the --strip argument to argbash (deprecates the --library option).
  • Initial support for docopt output.


  • Fixed wrapping of scripts with repeated optional arguments.
  • All scripts + tests are checked by Shellcheck.
  • The ARGBASH_WRAP macro now supports looking for templates in subdirectories.
  • Documentation expansion.


@matejak matejak released this Dec 6, 2017 · 73 commits to master since this release

This is a bugfix release that will please advanced users of Argbash.


  • Fixed argbash-init corner cases (wrong output filename).
  • Corrected argbash-init hint mode.
  • Allowed argbash to wrap scripts in files with no extension.
  • Fixed compatibility with the -e (i.e. "strict") mode (fixed #30).


@matejak matejak released this Sep 3, 2017 · 87 commits to master since this release

New features:

  • The generated shell case statement is considerably nicer.
  • Support for having more Argbash versions simultainously (applies to Argbash version that implement the make alt(un)install targets)
  • Argbash functionality is now encapsulated in shell functions.
  • API macros have checks against wrong number of arguments supplied.
  • Short options can be also numeric.
  • Introduced DIY mode as a preview feature.
  • A Docker image of argbash is available on Docker hub. Thanks to Peter Cummuskey!


  • Improved feedback when users provide invalid input (fixed #8, #9).
  • The underlying code has been cleaned and distributed into multiple files.
  • Fixed m4_list_indices to be consistent with m4_list_nth.
  • Much-improved handling of typed arguments (fixed #25, #26).
  • Improved documentation. Thanks to Bianca Tamayo!


@matejak matejak released this Apr 10, 2017 · 145 commits to master since this release

The main highlight of this version of argbash is the getopts feature parity - the generated code is supposed to support all features of getopts related to short options.

New features:

  • Implemented getopts-like behavior (so e.g. -gIinclude equals to -g -I include etc.).
  • Improved feedback in case of mismatch between expected / received arguments.


  • Argbash-powered scripts with positional arguments can be sourced consecutively without having to manually perform variable reset.
  • Fixed issue #7 with newlines in help strings.
  • The argbash.spec file has been corrected, so there is a hope that Argbash will make it to Fedora Linux distribution.


@matejak matejak released this Feb 7, 2017 · 161 commits to master since this release

New features:

  • Behavior that raises an error when a script argument's value looks like option - enabled by the ARG_RESTRICT_VALUES.

New minor features:

  • argbash provides more useful feedback in case of unmatched square brackets in the input
  • argbash in standalone mode now uses the more fresh of the parsing code .sh or .m4 templates (was undocumented, but the .sh one was always preferred over the .m4).


@matejak matejak released this Dec 20, 2016 · 173 commits to master since this release

New minor features:

  • argbash tries to warn you when it looks like you have made a typo when attempting to use macros.
  • argbash supports commented mode, when the parsing code is explained in detail


  • Fixed handling of help messages in case of missing ARG_HELP macro


@matejak matejak released this Nov 22, 2016 · 181 commits to master since this release

New minor features:

  • Added the --mode option to argbash-init.
  • Improved help messages for arguments with typed values (experimental).


  • Fixed quoting-related issues of the underlying code.

(The release 2.2.1 was accidentally skipped).


@matejak matejak released this Nov 7, 2016 · 193 commits to master since this release

New features:

  • KILLER FEATURE: Introduced the argbash-init simple template generator.
  • argbash can read from stdin.
  • ARG_HELP gains second argument.
  • Preview (preliminary) support for argument values types (a.k.a. typed arguments)


  • Improved defaults indications in help messages.
  • Overall internal code beautification