Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/doriantaylor/p5-uri-bnode

RDF blank node identifiers which are also URI objects
https://github.com/doriantaylor/p5-uri-bnode

Last synced: about 1 month ago
JSON representation

RDF blank node identifiers which are also URI objects

Host: GitHub
URL: https://github.com/doriantaylor/p5-uri-bnode
Owner: doriantaylor
License: apache-2.0
Created: 2013-10-17T20:33:20.000Z (over 11 years ago)
Default Branch: master
Last Pushed: 2018-05-25T16:52:47.000Z (over 6 years ago)
Last Synced: 2023-03-12T10:11:35.689Z (almost 2 years ago)
Language: Perl
Size: 21.5 KB
Stars: 0
Watchers: 1
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README
- Changelog: Changes
- License: LICENSE

Awesome Lists containing this project

README

NAME
URI::BNode - RDF blank node identifiers which are also URI objects

VERSION
Version 0.06

SYNOPSIS
my $bnode = URI::BNode->new;

print "$bnode\n"; # something like _:EH_kW827XQ6vvX0yF8YzRA

DESCRIPTION
This module has two purposes:

1 Provide a reliable factory interface for generating RDF blank nodes
(via random UUIDs permuted through Data::UUID::NCName).

2 When an RDF blank node class is a subclass of URI, you can use
identity tests to make more robust RDF interfaces, like so:

$node->isa('URI'); # either URI or bnode, but not literal
$node->isa('URI::BNode'); # narrow it down further

Along the same vein, coerce string literals into the correct class
by heuristic:

my $subject = '_:foo';
my $node = URI::BNode->new($subject); # _:foo becomes a bnode

# URI::BNode->new('http://foo/') would properly become
# a URI::http object.

METHODS
new [$ID]
Creates a new blank node identifier. If $ID is undefined or empty, one
will be generated using Data::UUID::NCName. If $ID has a value, it must
either begin with "_:" or conform to the blank node syntax from the
Turtle spec. Other values, including other URIs, will be passed to the
URI constructor.

name [$NEWVAL]
Alias for "opaque".

opaque [$NEWVAL]
Retrieve or, if supplied a value, replace the blank node's value with a
new one. This method will croak if passed a $NEWVAL which doesn't match
the spec in .

from_uuid_urn $UUID
Takes a URI::urn::uuid object and turns it into a blank node. Can be
invoked as either a class or an instance method.

to_uuid_urn
Takes a blank node (in the proper form) and turns it into a
URI::urn::uuid object.

skolemize $AUTHORITY
Return the skolemized URI ("$AUTHORITY/.well-known/genid/...") for a
given blank node. See RDF 1.1 Concepts
.

de_skolemize $URI
Take a skolemized URI like "http://foo.com/.well-known/genid/asdf" and
turn it into "_:asdf".

AUTHOR
Dorian Taylor, ""

BUGS
Please report any bugs or feature requests to "bug-uri-bnode at
rt.cpan.org", or through the web interface at
. I will be
notified, and then you'll automatically be notified of progress on your
bug as I make changes.

SUPPORT
You can find documentation for this module with the perldoc command.

perldoc URI::BNode

You can also look for information at:

* RT: CPAN's request tracker (report bugs here)

* AnnoCPAN: Annotated CPAN documentation

* CPAN Ratings

* Search CPAN