NAME

hekeln - command line interface to the Hekeln SAX stream editor

SYNOPSIS

  hekeln scriptfile < some.xml > some_processed.xml

DESCRIPTION

Hekeln is a PerlSAX stream editor. The hekeln script provides a shell interface for this tool, that could be used for testing hekeln scripts or to embed them into other languages.

OPTIONS

  Currently no options ;-( 

I think that the set of options used in YAWriter are a good start, lets look what we additonal need for processing batches.

ABUSE

Its possible to "chmod u+x" a Hekeln script, but syntax is a bit nasty! Lets look at a template :

        #!/usr/bin/perl /usr/bin/hekeln
        #       this comment is IMPORTANT
  <blank-line>
        start_element:topmost_element
        !       $self->handle('start_document',{});
        <       top_tag >
  <blank-line>
        start_element:second_element
        <       second_tag      >
        ++      process_it
  <blank-line>
        start_element:second_element
        --      process_it
        </      second_tag      >
  <blank-line>
        start_element:topmost_element
        </      top_tag >
        !       $self->handle('end_document',{});
  <blank-line>
        character:process_it
                ~Data~

This script would search through an xml for the occurance of the 'topmost_element' to open a new xml output document. Any character data in a 'second_element' will be dumped.

How blank lines and tabs are aranged is for importance! In a Hekeln script any paragraph that starts with a '#' is ignored, so we need the blank line, and therefore at least one comment in any script!

Also paragraphs that do not match the '^[^:]+:[^:]+$' template for the first line and any line in an interpreted paragraph that does have a valid indicator are silently ignored. Perhaps future version will raise warnings and errors.

AUTHOR

  Michael Koehne, Kraehe@Copyleft.De
  (c) 2000 GNU General Public License

SEE ALSO

XML::Parser::PerlSAX and XML::Filter::Hekeln