NAME

PYX::XMLNorm - Processing PYX data or file and do XML normalization.

SYNOPSIS

 use PYX::XMLNorm;

 my $obj = PYX::XMLNorm->new(%parameters);
 $obj->parse($pyx, $out);
 $obj->parse_file($input_file, $out);
 $obj->parse_handler($input_file_handler, $out);

METHODS

new(%parameters)

 my $obj = PYX::XMLNorm->new(%parameters);

Constructor.

• flush_stack

  Flush stack on finalization.

  Default value is 0.

• output_handler

  Output handler.

  Default value is \*STDOUT.

• rules

  XML normalization rules. Parameter is required. Format of rules is: Outer element => list of inner elements. e.g.

   {
           'middle' => ['end'],
   },

  Outer element can be '*'.

  Default value is {}.

Returns instance of object.

parse($pyx[, $out])

 $obj->parse($pyx, $out);

Parse PYX text or array of PYX text. If $out not present, use 'output_handler'.

Returns undef.

parse_file($input_file[, $out])

 $obj->parse_file($input_file, $out);

Parse file with PYX data. If $out not present, use 'output_handler'.

Returns undef.

parse_handler($input_file_handler[, $out])

 $obj->parse_handler($input_file_handler, $out);

Parse PYX handler. If $out not present, use 'output_handler'.

Returns undef.

ERRORS

 new():
         Cannot exist XML normalization rules.
         From Class::Utils::set_params():
                 Unknown parameter '%s'.

EXAMPLE

 use strict;
 use warnings;

 use PYX::XMLNorm;

 # Example data.
 my $pyx = <<'END';
 (begin
 (middle
 (end
 -data
 )middle
 )begin
 END

 # Object.
 my $obj = PYX::XMLNorm->new(
         'rules' => {
                 'middle' => ['end'],
         },
 );

 # Nomrmalize..
 $obj->parse($pyx);

 # Output:
 # (begin
 # (middle
 # (end
 # -data
 # )end
 # )middle
 # )begin

DEPENDENCIES

Class::Utils, Error::Pure, PYX, PYX::Parser.

SEE ALSO

PYX

A perl module for PYX handling.

Task::PYX

Install the PYX modules.

REPOSITORY

https://github.com/michal-josef-spacek/PYX-XMLNorm

AUTHOR

Michal Josef Špaček skim@cpan.org.

LICENSE AND COPYRIGHT

© 2011-2023 Michal Josef Špaček

BSD 2-Clause License

VERSION

0.05

cpanm PYX::XMLNorm

perl -MCPAN -e shell
install PYX::XMLNorm