| 1 | =head1 NAME | ||||||||||
| 2 | |||||||||||
| 3 | AtteanX::Serializer::Turtle - Turtle Serializer | ||||||||||
| 4 | |||||||||||
| 5 | =head1 VERSION | ||||||||||
| 6 | |||||||||||
| 7 | This document describes AtteanX::Serializer::Turtle version 0.040 | ||||||||||
| 8 | |||||||||||
| 9 | =head1 SYNOPSIS | ||||||||||
| 10 | |||||||||||
| 11 | use Attean; | ||||||||||
| 12 | my $serializer = Attean->get_serializer('Turtle')->new(); | ||||||||||
| 13 | $serializer->serialize_iter_to_io( $io, $fh ); | ||||||||||
| 14 | |||||||||||
| 15 | =head1 DESCRIPTION | ||||||||||
| 16 | |||||||||||
| 17 | ... | ||||||||||
| 18 | |||||||||||
| 19 | =head1 ATTRIBUTES | ||||||||||
| 20 | |||||||||||
| 21 | =over 4 | ||||||||||
| 22 | |||||||||||
| 23 | =item C<< canonical_media_type >> | ||||||||||
| 24 | |||||||||||
| 25 | =item C<< media_types >> | ||||||||||
| 26 | |||||||||||
| 27 | =item C<< handled_type >> | ||||||||||
| 28 | |||||||||||
| 29 | =item C<< file_extensions >> | ||||||||||
| 30 | |||||||||||
| 31 | =back | ||||||||||
| 32 | |||||||||||
| 33 | =head1 METHODS | ||||||||||
| 34 | |||||||||||
| 35 | =over 4 | ||||||||||
| 36 | |||||||||||
| 37 | =cut | ||||||||||
| 38 | |||||||||||
| 39 | 3 | ▶ | use v5.14; | ||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||
| 40 | 3 | ▶ | use warnings; | ||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||
| 41 | |||||||||||
| 42 | 2 | package AtteanX::Serializer::Turtle 0.040 { | |||||||||
| 43 | 3 | ▶ | use Moo; | ||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||
| 44 | 3 | ▶ | use Data::Dumper; | ||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||
| 45 | 3 | ▶ | use Encode qw(encode); | ||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||
| 46 | 3 | ▶ | use Attean::ListIterator; | ||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||
| 47 | 3 | ▶ | use List::Util qw(any); | ||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||
| 48 | 3 | ▶ | use AtteanX::Parser::Turtle::Constants; | ||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||
| 49 | 3 | ▶ | use AtteanX::Parser::Turtle::Token; | ||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||
| 50 | 3 | ▶ | use AtteanX::Serializer::TurtleTokens; | ||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||
| 51 | 3 | ▶ | use Types::Standard qw(InstanceOf HashRef ArrayRef Bool Str); | ||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||
| 52 | 3 | ▶ | use namespace::clean; | ||||||||
|
Subroutine
BEGIN: called CC=1 SCAR=0.0
| |||||||||||
| 53 | 2 | with 'Attean::API::AbbreviatingSerializer'; | |||||||||
| 54 | 2 | with 'Attean::API::AppendableSerializer'; | |||||||||
| 55 | 2 | with 'Attean::API::TripleSerializer'; | |||||||||
| 56 | |||||||||||
| 57 | 1 | ▶ | sub canonical_media_type { return "text/turtle" } | ||||||||
|
Subroutine
canonical_media_type: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||
| 58 | |||||||||||
| 59 | 13 | ▶ | sub media_types { | ||||||||
|
Subroutine
media_types: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||
| 60 | 13 | return [qw(text/turtle)]; | |||||||||
| 61 | } | ||||||||||
| 62 | |||||||||||
| 63 | 5 | ▶ | sub handled_type { | ||||||||
|
Subroutine
handled_type: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||
| 64 | 5 | state $ITEM_TYPE = Type::Tiny::Role->new(role => 'Attean::API::Triple'); | |||||||||
| 65 | 5 | return $ITEM_TYPE; | |||||||||
| 66 | } | ||||||||||
| 67 | |||||||||||
| 68 | =item C<< file_extensions >> | ||||||||||
| 69 | |||||||||||
| 70 | Returns a list of file extensions associated with the serialized format. | ||||||||||
| 71 | |||||||||||
| 72 | =cut | ||||||||||
| 73 | |||||||||||
| 74 | 2 | ▶ | sub file_extensions { return [qw(ttl)] } | ||||||||
|
Subroutine
file_extensions: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||
| 75 | |||||||||||
| 76 | 2 | has 'serializer' => (is => 'rw', isa => InstanceOf['AtteanX::Serializer::TurtleTokens']); | |||||||||
| 77 | |||||||||||
| 78 | 9 | ▶ | sub BUILD { | ||||||||
|
Subroutine
BUILD: called CC=3 SCAR=11.0
Pod
undocumented
| |||||||||||
| 79 | 9 | my $self = shift; | |||||||||
| 80 | 9 | my $s = $self->serializer; | |||||||||
| 81 | 9 | ▶ | unless ($s) { | ||||||||
|
Branch: 1 branch
| |||||||||||
| 82 | 9 | my @args; | |||||||||
| 83 | 9 | ▶ | if (my $map = $self->namespaces) { | ||||||||
|
Branch: 1 branch
| |||||||||||
| 84 | 4 | push(@args, namespaces => $map); | |||||||||
| 85 | } | ||||||||||
| 86 | 9 | $s = AtteanX::Serializer::TurtleTokens->new( @args ); | |||||||||
| 87 | 9 | $self->serializer($s); | |||||||||
| 88 | } | ||||||||||
| 89 | } | ||||||||||
| 90 | |||||||||||
| 91 | =item C<< serialize_iter_to_io( $fh, $iterator ) >> | ||||||||||
| 92 | |||||||||||
| 93 | Serializes the Turtle token objects from C<< $iterator >> to the | ||||||||||
| 94 | L<IO::Handle> object C<< $fh >>. | ||||||||||
| 95 | |||||||||||
| 96 | =cut | ||||||||||
| 97 | |||||||||||
| 98 | 12 | ▶ | sub serialize_iter_to_io { | ||||||||
|
Subroutine
serialize_iter_to_io: called CC=3 SCAR=11.0
Pod
documented
| |||||||||||
| 99 | 12 | my $self = shift; | |||||||||
| 100 | 12 | my $io = shift; | |||||||||
| 101 | 12 | my $iter = shift; | |||||||||
| 102 | 12 | my @buffer; | |||||||||
| 103 | |||||||||||
| 104 | # TODO: look for shared subject-predicate in repeated triples, and emit COMMA syntax | ||||||||||
| 105 | # TODO: look for shared subject in repeated triples, and emit SEMICOLON syntax | ||||||||||
| 106 | |||||||||||
| 107 | 12 | my $dot = AtteanX::Parser::Turtle::Token->dot; | |||||||||
| 108 | 12 | my $comma = AtteanX::Parser::Turtle::Token->comma; | |||||||||
| 109 | 12 | my $semi = AtteanX::Parser::Turtle::Token->semicolon; | |||||||||
| 110 | 12 | ▶ | if (my $map = $self->namespaces) { | ||||||||
|
Branch: 1 branch
| |||||||||||
| 111 | 4 | my $prefix = AtteanX::Parser::Turtle::Token->prefix; | |||||||||
| 112 | 4 | foreach my $ns (sort $map->list_prefixes) { | |||||||||
| 113 | 5 | my $uri = Attean::IRI->new( value => $map->namespace_uri($ns)->as_string ); | |||||||||
| 114 | 5 | my $name = AtteanX::Parser::Turtle::Token->fast_constructor( PREFIXNAME, -1, -1, -1, -1, ["${ns}:"] ); | |||||||||
| 115 | 5 | my $iri = AtteanX::Parser::Turtle::Token->fast_constructor( IRI, -1, -1, -1, -1, [$uri->value] ); | |||||||||
| 116 | 5 | push(@buffer, $prefix); | |||||||||
| 117 | 5 | push(@buffer, $name); | |||||||||
| 118 | 5 | push(@buffer, $iri); | |||||||||
| 119 | 5 | push(@buffer, $dot); | |||||||||
| 120 | } | ||||||||||
| 121 | } | ||||||||||
| 122 | |||||||||||
| 123 | 12 | my $last_subj; | |||||||||
| 124 | my $last_pred; | ||||||||||
| 125 | my $sub = sub { | ||||||||||
| 126 | if (scalar(@buffer)) { | ||||||||||
| 127 | return shift(@buffer); | ||||||||||
| 128 | } | ||||||||||
| 129 | if (my $t = $iter->next) { | ||||||||||
| 130 | my ($subj, $pred, $obj) = $t->values; | ||||||||||
| 131 | if (defined($last_subj) and $subj->equals($last_subj)) { | ||||||||||
| 132 | if (defined($last_pred) and $pred->equals($last_pred)) { | ||||||||||
| 133 | push(@buffer, $comma); | ||||||||||
| 134 | push(@buffer, $obj->sparql_tokens->elements); | ||||||||||
| 135 | } else { | ||||||||||
| 136 | push(@buffer, $semi); | ||||||||||
| 137 | push(@buffer, $pred->sparql_tokens->elements); | ||||||||||
| 138 | push(@buffer, $obj->sparql_tokens->elements); | ||||||||||
| 139 | } | ||||||||||
| 140 | } else { | ||||||||||
| 141 | if (defined($last_pred)) { | ||||||||||
| 142 | push(@buffer, $dot); | ||||||||||
| 143 | } | ||||||||||
| 144 | foreach my $term ($subj, $pred, $obj) { | ||||||||||
| 145 | push(@buffer, $term->sparql_tokens->elements); | ||||||||||
| 146 | } | ||||||||||
| 147 | } | ||||||||||
| 148 | |||||||||||
| 149 | $last_subj = $subj; | ||||||||||
| 150 | $last_pred = $pred; | ||||||||||
| 151 | return shift(@buffer); | ||||||||||
| 152 | } | ||||||||||
| 153 | |||||||||||
| 154 | if (defined($last_subj)) { | ||||||||||
| 155 | push(@buffer, $dot); | ||||||||||
| 156 | $last_subj = undef; | ||||||||||
| 157 | $last_pred = undef; | ||||||||||
| 158 | return shift(@buffer); | ||||||||||
| 159 | } | ||||||||||
| 160 | |||||||||||
| 161 | return; | ||||||||||
| 162 | 12 | }; | |||||||||
| 163 | |||||||||||
| 164 | 12 | my $titer = Attean::CodeIterator->new( generator => $sub, item_type => 'AtteanX::Parser::Turtle::Token' ); | |||||||||
| 165 | 12 | return $self->serializer->serialize_iter_to_io($io, $titer); | |||||||||
| 166 | } | ||||||||||
| 167 | |||||||||||
| 168 | =item C<< serialize_iter_to_bytes( $iterator ) >> | ||||||||||
| 169 | |||||||||||
| 170 | Serializes the Turtle token objects from C<< $iterator >> | ||||||||||
| 171 | and returns the serialization as a UTF-8 encoded byte string. | ||||||||||
| 172 | |||||||||||
| 173 | =cut | ||||||||||
| 174 | |||||||||||
| 175 | 10 | ▶ | sub serialize_iter_to_bytes { | ||||||||
|
Subroutine
serialize_iter_to_bytes: called CC=1 SCAR=0.0
Pod
documented
| |||||||||||
| 176 | 10 | my $self = shift; | |||||||||
| 177 | 10 | my $iter = shift; | |||||||||
| 178 | 10 | my $data = encode('UTF-8', ''); | |||||||||
| 179 | 10 | open(my $fh, '>', \$data); | |||||||||
| 180 | 10 | $self->serialize_iter_to_io($fh, $iter); | |||||||||
| 181 | 10 | close($fh); | |||||||||
| 182 | 10 | return $data; | |||||||||
| 183 | } | ||||||||||
| 184 | } | ||||||||||
| 185 | |||||||||||
| 186 | 2 | 1; | |||||||||
| 187 | |||||||||||
| 188 | __END__ | ||||||||||