/ 
Getopt-Pad-0.04

Changes for version 0.04 - 2026-09-26

  • Config files set the options of every command level: the commands key of a level's section holds one section per command, nested like the commands. Every section is validated on every run, the values only on the levels the command line selects. The autoload chain merges option by option per level
  • --create-default-config writes the defaults of every level
  • Add inherit to option specs: on a level with commands, the option is also accepted after the command word on every level below and read from the declaring level. Given on several levels, it combines as if repeated on one
  • --config and --create-default-config are inherited, so they work after the command word. No level may declare an option of either name when the spec has a config block
  • With a config block, a level with commands may not have a group named commands
  • Rewrite the documentation. Getopt::Pad is a complete reference with a list of all messages. Getopt::Pad::Tutorial and Getopt::Pad::Cookbook are new. The contracts for custom types and config formats are documented in Getopt::Pad::Type and Getopt::Pad::Config::Format
  • New examples for value shapes, config files and value checks

Documentation

README.md
Getopt::Pad::Cookbook
Recipes for common command line tasks with Getopt::Pad
Getopt::Pad::Tutorial
A step-by-step introduction to Getopt::Pad

Modules

Getopt::Pad
Declarative command line parsing with types, subcommands and config files
Getopt::Pad::Completion
Shell completion scripts and their answers (internal)
Getopt::Pad::Config
Reads and writes config files (internal)
Getopt::Pad::Config::Format
Base class of config file formats, and how to add one
Getopt::Pad::Config::Format::Json
The json config file format
Getopt::Pad::Config::Format::Yaml
The yaml config file format
Getopt::Pad::Error
The exception for user errors (internal)
Getopt::Pad::ExitRequest
The exception that ends a parse successfully (internal)
Getopt::Pad::Help
Renders the help and version output of one level (internal)
Getopt::Pad::Parser
Parses a command line against a spec (internal)
Getopt::Pad::Registry
Looks up types and formats by name (internal)
Getopt::Pad::Result
The object GetOptions returns
Getopt::Pad::Result::Generator
Creates the classes of result objects (internal)
Getopt::Pad::Spec
The checked spec of one GetOptions call (internal)
Getopt::Pad::Spec::Arg
One positional arg of a spec (internal)
Getopt::Pad::Spec::Config
The checked config block of a spec (internal)
Getopt::Pad::Spec::Level
One level of a spec: the top level or one command (internal)
Getopt::Pad::Spec::Option
One option of a spec, and how its value is resolved (internal)
Getopt::Pad::Type
Base class of option types, and how to write your own
Getopt::Pad::Type::Dir
The dir option type
Getopt::Pad::Type::File
The file option type
Getopt::Pad::Type::Float
The float option type
Getopt::Pad::Type::Int
The int option type
Getopt::Pad::Type::Number
Base class of the numeric option types
Getopt::Pad::Type::Path
Base class of the file and dir option types
Getopt::Pad::Type::Url
The url option type
Getopt::Pad::Util
Helper functions (internal)

Examples

Other files