Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
STAG-HANDLE(1)	      User Contributed Perl Documentation	STAG-HANDLE(1)

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

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

POD ERRORS
       Hey! The	above document had some	coding errors, which are explained
       below:

       Around line 138:
	   =over should	be: '=over' or '=over positive_number'

perl v5.24.1			  2009-12-14			STAG-HANDLE(1)

NAME | SYNOPSIS | DESCRIPTION | EXAMPLES | POD ERRORS

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=stag-handle.pl&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help