File Coverage

blib/lib/AtteanX/Parser/SPARQLXML.pm

Criterion	Covered	Total	%
statement	37	42	88.1
branch	1	2	50.0
condition			n/a
subroutine	13	13	100.0
pod	5	5	100.0
total	56	62	90.3

# AtteanX::Parser::SPARQLXML
# -----------------------------------------------------------------------------

=head1 NAME

AtteanX::Parser::SPARQLXML - SPARQL XML Parser

=head1 VERSION

This document describes AtteanX::Parser::SPARQLXML version 0.033

=head1 SYNOPSIS

 use Attean;
 my $parser = Attean->get_parser('SPARQLXML')->new();
 $parser->parse_cb_from_io( $fh );

=head1 DESCRIPTION

...

=head1 METHODS

=over 4

=cut

use v5.14;
use warnings;

	use XML::SAX::ParserFactory;
	use Attean;
	use Moo;
	use Encode qw(encode);
	use PerlIO::Layers qw(query_handle);
	use AtteanX::Parser::SPARQLXML::SAXHandler;

=item C<< canonical_media_type >>

Returns the canonical media type for SPARQL XML: application/sparql-results+xml.

=cut


=item C<< media_types >>

Returns a list of media types that may be parsed with the SPARQL XML parser:
application/sparql-results+xml.

=cut

		return [qw(application/sparql-results+xml)];
	}

=item C<< file_extensions >>

Returns a list of file extensions that may be parsed with the parser.

=cut


	with 'Attean::API::ResultOrTermParser';
	with 'Attean::API::PushParser';

=item C<< parse_cb_from_io( $fh ) >>

Calls the C<< $parser->handler >> function once for each
L<Attean::API::Binding> object that result from parsing
the data read from the L<IO::Handle> object C<< $fh >>.

=cut

		my $self	= shift;
		my $fh		= shift;
		my $handler	= AtteanX::Parser::SPARQLXML::SAXHandler->new($self->handler);
		my $p		= XML::SAX::ParserFactory->parser(Handler => $handler);
		if (query_handle($fh, 'utf8')) {
			# the filehandle already has utf-8 decoding applied, but the XML
			# parser is expecting utf-8 *encoded* bytes, so we need to
			# re-encode the data before parsing.
			my $string	= do { local($/); <$fh> };
			my $data	= encode('UTF-8', $string, Encode::FB_CROAK);
			$p->parse_string($data);
		} else {
			$p->parse_file( $fh );
		}
	}

=item C<< parse_cb_from_bytes( $data ) >>

Calls the C<< $parser->handler >> function once for each
L<Attean::API::Binding> object that result from parsing
the data read from the UTF-8 encoded byte string C<< $data >>.

=cut

		my $self	= shift;
		my $data	= shift;

		my $handler	= AtteanX::Parser::SPARQLXML::SAXHandler->new($self->handler);
		my $p		= XML::SAX::ParserFactory->parser(Handler => $handler);
		$p->parse_string( $data );
	}
}


1;


=back

=head1 BUGS

Please report any bugs or feature requests to through the GitHub web interface
at L<https://github.com/kasei/perlrdf/issues>.

=head1 AUTHOR

Gregory Todd Williams  C<< <[e-mail]> >>

=head1 COPYRIGHT

Copyright (c) 2014--2022 Gregory Todd Williams. This
program is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.

=cut