NAME

App::Spec::Tutorial - How to write an app with App::Spec::Run

LINKS

Options and parameters

See App::Spec::Argument for documentation and examples on how to define options and parameters.

GENERATOR

You can generate a boilerplate with appspec:

            

              
              
appspec new --class App::Birthdays --name birthdays.pl
            
          

For documentation, look at appspec and App::AppSpec.

EXAMPLES

A minimal app called birthdays.pl

The smallest example would be the following app. It doesn't use subcommands.

birthdays.pl

            

              
              
use strict;
use warnings;
package App::Birthdays;
use base 'App::Spec::Run::Cmd';
sub execute {
    my ($self, $run) = @_;
    my $date = $run->options->{date};
    my $output = <<"EOM";
Birthdays $date:
EOM
    $output .= "Larry Wall";
    if ($run->options->{age}) {
        $output .= " (Age: unknown)";
    }
    $output .= "\n";
    $run->out($output);
}
package main;
use App::Spec;
App::Spec->read("$Bin/birthdays.yaml")->runner->run;
            
          

birthdays.yaml

Short version:

            

              
              
name: birthdays.pl
title: Show birthdays
appspec: { version: '0.001' }
class: App::Birthdays
options:
- date=s =today --Date
- age           --Show age
            
          

Long version:

            

              
              
name: birthdays.pl
title: Show birthdays
appspec: { version: '0.001' }
class: App::Birthdays
options:
- name: date
  type: string
  default: today
  summary: Date
- name: age
  type: flag
  summary: Show age