Jeff Pinyan > YAPE-HTML-1.11 > YAPE


Annotate this POD

View/Report Bugs


YAPE - Yet Another Parser/Extractor


  use YAPE::Something;
  my $parser = YAPE::Something->new(...);
  # do magical and wondrous things


The YAPE hierarchy of modules is an attempt at a unified means of parsing and extracting content. It attempts to maintain a generic interface, to promote simplicity and reusability. The API is powerful, yet simple. The modules do tokenization (which can be intercepted) and build trees, so that extraction of specific nodes is doable.

Wishful Thinking

This discipline of parsing/extracting is here in hopes of creating an API that allows you to parse some language -- C, for instance -- and fiddle with it. Here are a couple examples of what YAPE::C might be capable of.

Code Filtering

First, we create a YAPE::C object:

  use YAPE::C;
  open ORIG, "+<myprog.c"
    or die "can't open myprog.c for r/w: $!";
  my $code;
  { local $/; $code = <ORIG>; }
  seek ORIG, 0, 0;
  truncate ORIG, 0;
  my $parser = YAPE::C->new($code);

Now, we go through the code it parses, chunk by chunk (tokenizing):

  while (my $chunk = $parser->next) {
    # turn ' = 2 * 3;'
    # into ' = filter(2 * 3);'
    if (
      $chunk->type eq 'assign' and
      $chunk->lhs->fullstring eq ''
    ) {
      my $func = YAPE::C::function('filter');

Now, we print the modified code:

  print ORIG $parser->fullstring;
  close ORIG;

In an ideal world, that would safely place the filter() function around the arguments of all assignments to

Code Creation

A statement like alpha.beta.gamma = 2 * 3; would be represented as

  my $assign = YAPE::C::statement->new(

The internal tree for this would look like

    TYPE => 'statement',
    CONTENT => [
        TYPE => 'assign',
        LHS => {
          TYPE => 'struct',
          VAL => 'alpha',
          ATTR => {
            TYPE => 'struct',
            VAL = 'beta',
            ATTR => {
              TYPE => 'attr',
              VAL => 'gamma',
        RHS => {
          TYPE => 'op',
          OP => '*',
          TERMS => [
              TYPE => 'num',
              VAL => 2,
              TYPE => 'num',
              VAL => 3,

Code Extraction

If you wanted to extract all the comments from a C program, you would do so in the following manner:

  my $extractor = $parser->extract(-COMMENT);
  my @comments;
  while (my $chunk = $extractor->()) {
    push @comments, $chunk;

Or, if you wanted to find all the if-statements in a program, you might do:

  my $extractor = $parser->extract(if_stmt => []);
  my @if_stmts;
  while (my $chunk = $extractor->()) {
    push @if_stmts, $chunk;

Reality Check

Obviously, YAPE::C would have to do a lot of work to offer the potentially massive requests sent to it ("give me all function calls that use the variable in them"); so this module might be a long way off.

But it's not impossible, if the C code is parsed properly.


Jeff japhy Pinyan is the front-man for the YAPE hierarchy of modules; all requests/candidates for a new YAPE module should be sent through him. His contact information is at the bottom of this document. The YAPE web site is at

All YAPE modules are designed to have the same general exterior API. This is like the DBI approach. Jeff intends to keep things this way. If a new feature gets added to YAPE::Foo, that feature should be added (even if only as a no-op if not applicable) to all other YAPE modules. This is only true for the parser's API; individual elements (such as HTML tags, or C operators, or regular expression nodes) can behave in their own idiom.


  Jeff "japhy" Pinyan


The YAPE module you're looking for.

syntax highlighting: