NAME

PYX::SGML::Tags - Processing PYX data or file and write as SGML via Tags.

SYNOPSIS

            

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

METHODS

new

            

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

Constructor.

• input_encoding

  Input encoding for parse_file() and parse_handler() usage.

  Default value is 'utf-8'.

• input_tags_item_callback

  Input 'Tags' item callback. This callback is for Tags::Output::* constructor parameter 'input_tags_item_callback'.

  Default value is undef.

• output_encoding

  Output encoding.

  Default value is 'utf-8'.

• tags

  Tags object. Can be any of Tags::Output::* objects. Default value is Tags::Output::Raw-new('output_handler' => \*STDOUT)>. It's required.

Returns instance of class.

parse

            

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

Parse PYX text or array of PYX text. Output is serialization to SGML by Tags::Output::* module. If $out not present, use 'output_handler'.

Returns undef.

parse_file

            

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

Parse file with PYX data. $input_file file is decoded by 'input_encoding'. Output is serialization to SGML. If $out not present, use 'output_handler'.

Returns undef.

parse_handler

            

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

Parse PYX handler. $input_file_handler handler is decoded by 'input_encoding'. Output is serialization to SGML. If $out not present, use 'output_handler'.

Returns undef.

finalize

            

              
              
$obj->finalize;
Finalize opened tags, if exists.
Returns undef.
            
          

ERRORS

            

              
              
new():
        Bad 'Tags::Output::*' object.
        From Class::Utils::set_params():
                Unknown parameter '%s'.
parse():
        From PYX::Parser::parse():
                Bad PYX line '%s'.
        From Tags::Output::Raw::flush():
                Cannot write to output handler.
parse_file():
        From PYX::Parser::parse_file():
                Bad PYX line '%s'.
                No input handler.
        From Tags::Output::Raw::flush():
                Cannot write to output handler.
parse_handler():
        From PYX::Parser::parse_handler():
                Bad PYX line '%s'.
                No input handler.
        From Tags::Output::Raw::flush():
                Cannot write to output handler.
            
          

EXAMPLE1

            

              
              
use strict;
use warnings;
use PYX::SGML::Tags;
# Input.
my $pyx = <<'END';
(element
-data
)element
END
# Object.
my $obj = PYX::SGML::Tags->new;
# Process.
$obj->parse($pyx);
print "\n";
# Output:
# <element>data</element>
            
          

EXAMPLE2

            

              
              
use strict;
use warnings;
use PYX::SGML::Tags;
use Tags::Output::Indent;
# Input.
my $pyx = <<'END';
(element
-data
)element
END
# Object.
my $obj = PYX::SGML::Tags->new(
        'tags' => Tags::Output::Indent->new(
                'output_handler' => \*STDOUT,
        ),
);
# Process.
$obj->parse($pyx);
print "\n";
# Output:
# <element>data</element>
            
          

EXAMPLE3

            

              
              
use strict;
use warnings;
use PYX::SGML::Tags;
use Tags::Output::Indent;
# Input.
my $pyx = <<'END';
(element
-data
)element
END
# Object.
my $obj = PYX::SGML::Tags->new(
        'input_tags_item_callback' => sub {
                my $tags_ar = shift;
                print '[ '.$tags_ar->[0].' ]'."\n";
                return;
        },
);
# Process.
$obj->parse($pyx);
print "\n";
# Output:
# [ b ]
# [ d ]
# [ e ]
# <element>data</element>
            
          

DEPENDENCIES

Class::Utils, Error::Pure, PYX::Parser, PYX::Utils, Tags::Output::Raw.

SEE ALSO

Task::PYX

Install the PYX modules.

REPOSITORY

https://github.com/michal-josef-spacek/PYX-SGML-Tags

AUTHOR

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

http://skim.cz

LICENSE AND COPYRIGHT

© 2011-2023 Michal Josef Špaček

BSD 2-Clause License

VERSION

0.10

cpanm PYX::SGML::Tags

perl -MCPAN -e shell
install PYX::SGML::Tags