1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
|
# JSONLD
## A Perl toolkit for interacting with JSON-LD data.
## VERSION
This document describes JSONLD version 0.004_01.
## SYNOPSIS
### Command Line Tools
% jsonld-expand input.jsonld
Prints the JSON-LD 1.1 *expansion* of the data in `input.jsonld` to standard out.
% jsonld-compact input.jsonld
Prints the JSON-LD 1.1 *compaction* of the data in `input.jsonld` to standard out.
% jsonld-nq input.jsonld
Prints the JSON-LD 1.1 *deserialization* of the data in `input.jsonld` to standard out in the N-Quads format.
### JSON-LD Perl API
use v5.14;
use JSON qw(decode_json);
use JSONLD;
my $infile = 'test.jsonld';
open(my $fh, '<:utf8', $infile) or die $!;
my $content = do { local($/); <$fh> };
my $data = decode_json($content);
my $jld = JSONLD->new();
my $expanded = $jld->expand($data);
## DESCRIPTION
This module implements part of the JSON-LD 1.1 standard for manipulating JSON
data as linked data.
This version provides full support for the JSON-LD 1.1 "Expansion" and
"toRdf" transformations (the latter primarily being useful through a subclass
of JSON-LD, such as that provided by L<AtteanX::Parser::JSONLD>).
Partial support for the "Compaction" transformation is provided, but it
contains many known deficiencies. Full support for "Compaction" may be
forthcoming in a future release.
No other JSON-LD transformation are supported at this time.
## METHODS
`expand( $data )`
Returns the JSON-LD expansion of `$data`.
`to_rdf( $data )`
Returns the dataset generated by turning the JSON-LD expansion of
`$data` into RDF.
Note: this method must be called on a `JSONLD` subclass which
implements the RDF-related methods listed below.
See [AtteanX::Parser::JSONLD](https://metacpan.org/pod/AtteanX::Parser::JSONLD)
for an implementation of such a subclass.
* `default_graph()`
* `new_dataset()`
* `new_triple($s, $p, $o)`
* `new_quad($s, $p, $o, $g)`
* `new_iri($value)`
* `new_graphname($value)`
* `new_blank( [$id] )`
* `new_lang_literal($value, $lang)`
* `new_dt_literal($value, $datatype)`
* `add_quad($quad, $dataset)`
## BUGS
Please report any bugs or feature requests to through the GitHub web
interface at <https://github.com/kasei/perl-jsonld/issues>.
## SEE ALSO
* <irc://irc.perl.org/#perlrdf>
* [AtteanX::Parser::JSONLD](https://metacpan.org/pod/AtteanX::Parser::JSONLD)
* <https://www.w3.org/TR/json-ld11/>
* <https://www.w3.org/TR/json-ld-api/>
* <MooX::Role::JSON_LD>
## AUTHOR
Gregory Todd Williams <gwilliams@cpan.org>
## COPYRIGHT
Copyright (c) 2019--2020 Gregory Todd Williams. This program is free
software; you can redistribute it and/or modify it under the same terms
as Perl itself.
|
