ArgParse.jl

Package for parsing command-line arguments to Julia programs.
Popularity
231 Stars
Updated Last
2 Months Ago
Started In
November 2012

ArgParse.jl

DOCS CI CODECOV

ArgParse.jl is a package for parsing command-line arguments to Julia programs.

Installation and usage

To install the module, use Julia's package manager: start pkg mode by pressing ] and then enter:

(v1.5) pkg> add ArgParse

The module can then be loaded like any other Julia module:

julia> using ArgParse

Documentation

Changes in release 1.2.0

  • Add options to control the help text formatting (#132)
  • Allow defaults that can be converted into the target argument type (#133)

Changes in release 1.1.5

  • Fix ambiguity with julia 1.11 new wrap function (see #128)
  • Throw a new ArgParseSettingError for all settings-related errors
  • Fixed some tests

Changes in release 1.1.4

  • Fix in @project_version macro (see #107)

Changes in release 1.1.3

  • Added a @project_version macro (see #106)

Changes in release 1.1.2

  • Faster startup time by disabling optimizations/inference (see #104)

Changes in release 1.1.1

  • Fixed the case when using symbol keys, commands are not required, no command is provided

Changes in release 1.1.0

  • Try using the constructor for types that don't define a convert method from AbstractString

Changes in release 1.0.1

  • Small fixes in docs

Changes in release 1.0.0

  • Drop support for Julia versions v0.6/v0.7
  • Renamed a few functions and macros (old versions can be used but produce deprecation warnings):
    • @add_arg_table@add_arg_table!
    • add_arg_tableadd_arg_table!
    • add_arg_groupadd_arg_group!
    • set_default_arg_groupset_default_arg_group!
    • import_settingsimport_settings!. The signature of this function has also changed: args_only is now a keyword argument
  • Parsing does not exit julia by default when in interactive mode now
  • Added mutually-exclusive and/or required argument groups
  • Added command aliases

Changes in release 0.6.2

  • Fix a remaining compatibility issue (@warn)

Changes in release 0.6.1

  • Testing infrastructure update, tiny docs fixes

Changes in release 0.6.0

  • Added support for Julia v0.7, dropped support for Julia v0.5.
  • Added exit_after_help setting to control whether to exit julia after help/version info is displayed (which is still the defult) or to just abort the parsing and return nothing instead.

Changes in release 0.5.0

  • Added support for Julia v0.6, dropped support for Julia v0.4.
  • The default output type is now Dict{String,Any}, as stated in the docs, rather than Dict{AbstractString,Any}.
  • Added docstrings, moved documentation to Documenter.jl

Changes in release 0.4.0

New features

  • Added support for vectors of METAVAR names (see #33)

Other changes

  • Support for Julia v0.3 was dropped.

Changes in release 0.3.1

New available settings

  • fromfile_prexif_chars (see #27)
  • preformatted_desciption/preformatted_epilog (see #28)

Changes in release 0.3.0

Breaking changes

Upgrading from versions 0.2.X to 0.3.X, the following API changes were made, which may break existing code:

  • Option arguments are no longer evaluated by default. This is for security reasons. Evaluation can be forced on a per-option basis with the eval_arg=true setting (although this is discuraged).
  • The syntax of the add_arg_table function has changed, it now takes a Dict object instead of an @options opbject, since the dependency on the Options.jl module was removed. (The @add_arg_table macro is unchanged though.)

Other changes

  • Documented that overloading the function ArgParse.parse_item can be used to instruct ArgParse on how to parse custom types. Parse error reporting was also improved
  • Removed dependecy on the Options.jl module
  • Enabled precompilation on Julia 0.4

Required Packages