NAME

Commandable::Finder - an interface for discovery of Commandable::Commands

METHODS

find_commands

@commands = $finder->find_commands

Returns a list of command instances, in no particular order. Each will be an instance of Commandable::Command.

find_command

$command = $finder->find_command( $cmdname )

Returns a command instance of the given name as an instance of Commandable::Command, or undef if there is none.

find_and_invoke

$result = $finder->find_and_invoke( $cinv )

A convenient wrapper around the common steps of finding a command named after the initial token in a Commandable::Invocation, parsing arguments from it, and invoking the underlying implementation function.

find_and_invoke_ARGV

$result = $finder->find_and_invoke_ARGV()

A further convenience around creating a Commandable::Invocation from the @ARGV array and using that to invoke a command. Often this allows an entire wrapper script to be created in a single line of code:

exit Commandable::Finder::SOMESUBCLASS->new( ... )
   ->find_and_invoke_ARGV();

BUILTIN COMMANDS

The following built-in commands are automatically provided.

help

help

help $commandname

With no arguments, prints a summary table of known command names and their descriptive text.

With a command name argument, prints more descriptive text about that command, additionally detailing the arguments.

AUTHOR

Paul Evans <leonerd@leonerd.org.uk>