NAME

XML::Axk::App - awk-like XML processor, command-line interface

USAGE

axk [options] [--] [input filename or script]

INPUTS

A filename of - represents standard input. To actually process a file named -, you will need to use shell redirection (e.g., axk < -). Standard input is the default if no input filenames are given.

The first non-option argument is used for program text if no -e or -f are given. If that argument names a readable regular file or symlink, an axk program will be loaded from that file. Otherwise, that argument is used as an axk program directly.

The script language version for a -e will default to the latest if the text on the command line doesn't specify a language version.

# TODO make -L and -B apply to following -e's

OPTIONS

-B, --backend bkend

Not yet implemented: Take input using the backend bkend.

-e, --source text

Run the axk code given as text.

-f, --file filename

Run the axk code given in the file called filename.

-L, --language lang

Not yet implemented: Interpret the following -e in axk language lang.

--show what

Show debugging information. Currently-implemented what values are:

source

Show the Perl source generated from the provided axk code.

-v, --var name=value

Not yet implemented: Set name=value.

--version

Print the version of axk and exit

PERL INTERFACE

For use in Perl programs:

use XML::Axk::App;      # pick whichever you want,
use XML::Axk::Core;     # or both

# Canned interface, as if run from the command line
XML::Axk::App::Main(\@ARGV)

# Perl interface
my $axk = XML::Axk::Core->new();

For details about the library interface, see XML::Axk::Core.

AUTHOR

Christopher White, cxwembedded at gmail.com

SUPPORT

You can find documentation for this module with the perldoc command.

perldoc XML::Axk::App

You can also look for information at:

LICENSE AND COPYRIGHT

Copyright (c) 2018 Christopher White. All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the the Artistic License (2.0). Details are in the LICENSE file accompanying this distribution.