STAG-HANDLE(1p) 					User Contributed Perl Documentation					   STAG-HANDLE(1p)

NAME

       stag-handle - streams a stag file through a handler into a writer

SYNOPSIS

	 stag-handle -w itext -c my-handler.pl myfile.xml > processed.itext
	 stag-handle -w itext -p My::Parser -m My::Handler myfile.xml > processed.itext

DESCRIPTION

       will take a Stag compatible format (xml, sxpr or itext), turn the data into an event stream passing it through my-handler.pl

ARGUMENTS

       -help|h
	   shows this document

       -module|m PERLMODULE
	   A module that is used to transform the input events the module should inherit from Data::Stag::BaseHandler

       -unit|u NODE_NAME
	   (you should always use this option if you specify -m)

	   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

       -writer|w WRITER
	   writer for final transformed tree; can be xml, sxpr or itext

       -module|m MODULE
	   perl modules for handling events

       -codefile|c FILE
	   a file containing a perlhashref containing event handlers - see below

       -sub|s PERL
	   a perl hashref containing handlers

       -trap|t ELEMENT=SUB

EXAMPLES

	 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;
	   },
	 }

perl v5.10.0							    2008-12-23							   STAG-HANDLE(1p)