stag-handle.pl - streams a stag file through a handler into a writer
stag-handle.pl -w itext -c my-handler.pl myfile.xml > processed.itext stag-handle.pl -w itext -p My::Parser -m My::Handler myfile.xml > processed.itext
will take a Stag compatible format (xml, sxpr or itext), turn the data into an event stream passing it through my-handler.pl
this is the unit that gets passed to the handler/transformer. this will get set automatically if you use the the -c, -s or -t options
multiple units can be set
-u foo -u bar -u boz
  unix> cat my-handler.pl
  {
    person => sub {
        my ($self, $person) = @_;
        $person->set_fullname($person->get_firstname . ' ' .
                           $person->get_lastname);
        $person;
    },
    address => sub {
        my ($self, $address) = @_;
        # remove addresses altogether from processed file
        return;
    },
  }