XML, the Perl way
Latest commit 5f46757 Jun 21, 2016 @mirod committed on GitHub Merge pull request #19 from mishin/master
Update XPath.pm
Failed to load latest commit information.
t Merge pull request #21 from mjg17/mjg17/test_simplify Jun 21, 2016
MANIFEST MANIFEST: remove duplicate entry. Dec 10, 2015
MYMETA.json cleanup, stuff that had not been commited previously May 22, 2014
Makefile.PL last changes before 3.45 Mar 1, 2014
README more tests May 1, 2012
Twig_pm.slow Fix various spelling mistakes Dec 22, 2015
XML-Twig-FAQ.html Fix various spelling mistakes Dec 23, 2015
check_optional_modules refactored used_perl to get the Devel::Cover flag added to it when ne… Sep 21, 2010
cover_twig added the -i option (incremental: do not delete the coverage db) Nov 15, 2012
doc_utf8.xml YAIC Aug 24, 2009
faq.html Fix various spelling mistakes Dec 23, 2015
faq.xml Fix various spelling mistakes Dec 23, 2015
filter_for_5.005 YAIC Aug 24, 2009
list_deps cleanup, stuff that had not been commited previously May 22, 2014
new_changes Fix various spelling mistakes Dec 23, 2015
parse_random_files cleanup, stuff that had not been commited previously May 22, 2014
speedup Escape left braces in regular expressions May 21, 2016
test_uri cleanup, stuff that had not been commited previously May 22, 2014
twig_faq replaced xmltwig.com by xmltwig.org in the docs Sep 21, 2011
upd_changes cleanup, stuff that had not been commited previously May 22, 2014



    XML::Twig - Tree interface to XML documents allowing processing chunk
                by chunk of huge documents.


SUMMARY (see perldoc XML::Twig for full details)

XML::Twig is (yet another!) XML transformation module. 

Its strong points: can be used to process huge documents while still
being in tree mode; not bound by DOM or SAX, so it is very perlish and
offers a very comprehensive set of methods; simple to use; DWIMs as
much as possible

What it doesn't offer: full SAX support (it can export SAX, but only
reads XML), full XPath support (unless you use XML::Twig::XPath), nor
DOM support.

Other drawbacks: it is a big module, and with over 500 methods available
it can be a bit overwhelming. A good starting point is the tutorial at
http://xmltwig.org/xmltwig/tutorial/index.html. In fact the whole
XML::Twig page at http://xmltwig.org/xmltwig/ has plenty of information
to get you started with XML::Twig


XML::Twig comes with a few tools built on top of it:

  xml_pp           XML pretty printer
  xml_grep         XML grep - grep XML files using XML::Twig's subset of XPath
  xml_split        split big XML files
  xml_merge        merge back files created by xml_split
  xml_spellcheck   spellcheck XML files skipping tags

Running perl Makefile.PL will prompt you for each tool installation. 
  perl Makefile.PL -y     will install all of the tools without prompt
  perl Makefile.PL -n     will skip the installation of the tools


  single-tree mode    
    my $t= XML::Twig->new();
    $t->parsefile( 'doc.xml');

  chunk mode 
    # print the document, at most one full section is loaded in memory
    my $t= XML::Twig->new( twig_handlers => { section => \&flush});
    $t->parsefile( 'doc.xml');
    sub flush { (my $twig, $section)= @_; $twig->flush; }
  sub-tree mode 
    # print all section title's in the document,
    # all other elements are ignored (and not stored)
    my $t= XML::Twig->new( 
            twig_roots => { 'section/title' => sub { $_->print, "\n" } }
    $t->parsefile( 'doc.xml');

    perl Makefile.PL
    make test
    make install


    XML::Twig needs XML::Parser (and the expat library) installed
    Modules that can enhance XML::Twig are:

    Scalar::Util or WeakRef 
      to avoid memory leaks
    Encode or Text::Iconv or Unicode::Map8 and Unicode::Strings 
      to do encoding conversions
      to use the keep_atts_order option
      to use XML::Twig::XPath
      to use parseurl
      to use the html_encode filter
      to process HTML instead of XML


    See the Changes file    


    Michel Rodriguez (mirod@cpan.org)
    The Twig page is at http://www.xmltwig.org/xmltwig
    git project repository: http://github.com/mirod/xmltwig
    See the XML::Twig tutorial at http://www.xmltwig.org/xmltwig/tutorial/index.html


       Copyright (c) 1999-2012, Michel Rodriguez. All Rights Reserved.
       This library is free software; you can redistribute it and/or modify
       it under the same terms as Perl itself.