[seamstress] new HTML::Element::Library method - "crunch" - feedback welcome

[Terrence B. <met...@gm...>]

I'm uploading to CPAN now. It's on github at 
http://github.com/metaperl/html-element-library

=head2 Tree Rewriting Methods

=head3 "de-prepping" HTML

Oftentimes, the HTML to be worked with will have multiple (too many) 
sample rows:

  <OL>
   <LI>bread
   <LI>butter
   <LI>beer
   <LI>bacon
  </OL>

But, before you begin to rewrite the HTML with your model data, you 
typically only want 1 or 2 sample rows.

Thus, you want to "crunch" the multiple sample rows to a specified 
amount. Hence the C<crunch> method:

  $tree->crunch(look_down => [ '_tag' => 'li' ], leave => 2) ;

The C<leave> argument defaults to 1 if not given. The call above would 
"crunch" the above 4 sample rows to:

  <OL>
   <LI>bread
   <LI>butter
  </OL>