# axk: awk for XML files ## INSTALLATION To install this module, run the following commands: perl Makefile.PL make make test make install ## USAGE After installation, run `axk`. Options are similar to `awk`. Input scripts are Perl 5.18 with functions to, e.g., run on any node matching a given XPath. See [L1.md](L1.md) for more details. For example, the script -L1 on { xpath(q) } run { say "$NOW: " . $E->getTagName }; or the equivalent command line axk -e 'on { xpath(q) } run { say "$NOW: " . $E->getTagName }' t/ex/ex1.xml will print the tag name of each `//item` node in the input, along with an indication (`$NOW`) of whether the action is being run when `entering` or `leaving` the node. ## SUPPORT AND DOCUMENTATION After installing, you can find documentation for this module with the perldoc command: - `perldoc XML::Axk::App` for command-line usage instructions - `perldoc XML::Axk::L::L1` or [L1.md](L1.md) for the language reference ## LICENSE AND COPYRIGHT Copyright (C) 2018 Christopher White Licensed under the [Artistic License 2.0](http://perldoc.perl.org/perlartistic.html); see [LICENSE](LICENSE) for more details. **Disclaimer of Warranty: This package is provided by the copyright holder and contributors "as is" and without any express or implied warranties. The implied warranties of merchantability, fitness for a particular purpose, or non-infringement are disclaimed to the extent permitted by your local law. Unless required by law, no copyright holder or contributor will be liable for any direct, indirect, incidental, or consequential damages arising in any way out of the use of the package, even if advised of the possibility of such damage.**