Fortran command Line Arguments Parser for poor people

a pure Fortran 2003+ library for building elegant CLIs, inspired by Python's argparse.

Documentation

For full documentation (guide, API reference, examples, etc...) see the FLAP website.

• Stefano Zaghi — @szaghi

Contributions are welcome — see the Contributing page.

This project is distributed under a multi-licensing system:

• FOSS projects: GPL v3
• Closed source / commercial: BSD 2-Clause, BSD 3-Clause, or MIT

Anyone interested in using, developing, or contributing to this project is welcome — pick the license that best fits your needs.

program minimal
  use flap
  implicit none
  type(command_line_interface) :: cli
  character(99) :: string
  integer       :: error

  call cli%init(description='minimal FLAP example')
  call cli%add(switch='--string', switch_ab='-s', help='a string', &
               required=.true., act='store', error=error)
  if (error /= 0) stop
  call cli%parse(error=error)
  if (error /= 0) stop
  call cli%get(switch='-s', val=string, error=error)
  if (error /= 0) stop

  print '(A)', 'String = ' // trim(string)
end program minimal

See src/tests/ for more examples including nested subcommands, mutually exclusive groups, choices, and bash completion.

Standalone — clone, fetch dependencies, and build:

git clone https://github.com/szaghi/FLAP && cd FLAP
FoBiS.py fetch                        # fetch PENF, FACE
FoBiS.py build -mode static-gnu       # build static library

As a project dependency — declare FLAP in your fobos and run fetch:

[dependencies]
deps_dir = src/third_party
FLAP = https://github.com/szaghi/FLAP

FoBiS.py fetch           # fetch and build
FoBiS.py fetch --update  # re-fetch and rebuild

Add to your fpm.toml:

[dependencies]
FLAP = { git = "https://github.com/szaghi/FLAP" }

fpm build
fpm test

cmake -B build && cmake --build build

make