Getopt::Long::Grammar

Raku package for parsing Getopt specs and Python CLI specs.

Motivation

Given a Jupyter chatbook made with the Python kernel I want to be able to switch to a Raku kernel for that chatbook and use the chat cells as they are, without changing the "magic specs." This means, being able to parse the magic argument specs in the way the Jupyter Python Kernel uses them. (See "IPython extensions" and "argparse".)

Installation

From Zef ecosystem:

zef install Getopt::Long::Grammar

From GitHub:

zef isntall https://github.com/antononcube/Raku-Getopt-Long-Grammar.git

Usage examples

Load the package and parse a typical magic command:

use Getopt::Long::Grammar;

my $cmd = '%%chat_meta cw1 --api_key=cd77fdfw1 --prompt';

getopt-parse($cmd);

# ｢%%chat_meta cw1 --api_key=cd77fdfw1 --prompt｣
#  command => ｢%%chat_meta｣
#   gen-arg => ｢%%chat_meta｣
#  arguments => ｢cw1｣
#   argument => ｢cw1｣
#    gen-arg => ｢cw1｣
#  options => ｢--api_key=cd77fdfw1 --prompt｣
#   option => ｢--api_key=cd77fdfw1｣
#    long-opt => ｢api_key=cd77fdfw1｣
#     opt-name => ｢api_key｣
#      gen-arg => ｢api_key｣
#     opt-arg => ｢cd77fdfw1｣
#      gen-arg => ｢cd77fdfw1｣
#   option => ｢--prompt｣
#    long-opt => ｢prompt｣
#     opt-name => ｢prompt｣
#      gen-arg => ｢prompt｣

Interpret:

getopt-interpret($cmd);

# {arguments => (cw1), command => %%chat_meta, options => {api_key => cd77fdfw1, prompt => True}}