NAME

Form::Factory::Interface::CLI - Command-line interface builder for form factory

VERSION

version 0.022

SYNOPSIS

            

              
              
#/usr/bin/perl
use strict;
use warnings;
use Form::Factory;
my $cli = Form::Factory->new_interface('CLI');
my $action = $cli->new_action(shift @ARGV);
$action->consume_and_clean_and_check_and_process;
if ($action->is_valid and $action->is_success) {
    print "done.\n";
}
else {
    my $messages = $action->results->all_messages;
    print $messages;
    print "usage: $0 OPTIONS\n\n";
    print "Options:\n";
    $action->render;
}
            
          

DESCRIPTION

Provides a simple interface for building command-line tools that manipulate actions.

ATTRIBUTES

renderer

This is a subroutine responsible for returning the usage parameters back to the user. The default prints to STDOUT.

get_args

This is a subroutine responsible for return a list of command-line arguments. The default implementation returns a reference to @ARGV.

get_file

This is a subroutine responsible for returning the contents of files used on the command-line. It is passed the interface object and then the name of the file to load. The default implementation slurps up the named file or, in the case of the name begin "-", returns the contents of STDIN.

METHODS

render_control

Prints a usage line for each control.

consume_control

Consumes the command-line arguments and files specified on the command-line to fill in the action.

AUTHOR

Andrew Sterling Hanenkamp <hanenkamp@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2015 by Qubling Software LLC.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.