Module: RDF::Normalize

Included in:

Canonicalize

Defined in:

lib/rdf/normalize.rb,
lib/rdf/normalize/base.rb,
lib/rdf/normalize/format.rb,
lib/rdf/normalize/rdfc10.rb,
lib/rdf/normalize/writer.rb,
lib/rdf/normalize/urgna2012.rb,
lib/rdf/normalize/carroll2001.rb

Overview

RDF::Normalize is an RDF Graph canonicalization plugin for RDF.rb.

Examples:

Requiring the RDF::Normalize module

require 'rdf/normalize'

Returning an iterator for normalized statements

g = RDF::Graph.load("etc/doap.ttl")
RDF::Normalize.new(g).each_statement do |statement
  puts statement.inspect
end

Returning normalized N-Quads

g = RDF::Graph.load("etc/doap.ttl")
g.dump(:normalize) # or :canonicalize

Writing a repository as normalized N-Quads

RDF::Normalize::Writer.open("etc/doap.nq") do |writer|
  writer << RDF::Repository.load("etc/doap.ttl")
end

Author:

• Gregg Kellogg

Defined Under Namespace

Modules: VERSION Classes: Base, Carroll2001, Format, MaxCallsExceeded, RDFC10, URGNA2012, UnknownHashAlgorithm, Writer

Constant Summary

ALGORITHMS =

{
  carroll2001: :Carroll2001,
  urgna2012:   :URGNA2012,
  rdfc10:   :RDFC10
}.freeze

Instance Attribute Summary

• #dataset ⇒ RDF::Enumerable

  Enumerable to normalize.

Class Method Summary

• .new(enumerable, **options) ⇒ RDF::Normalize::Base

  Creates a new normalizer instance using either the specified or default normalizer algorithm.

Instance Attribute Details

#dataset ⇒ RDF::Enumerable

Enumerable to normalize

Returns:

• (RDF::Enumerable)

# File 'lib/rdf/normalize.rb', line 41

def dataset
  @dataset
end

Class Method Details

.new(enumerable, **options) ⇒ RDF::Normalize::Base

Creates a new normalizer instance using either the specified or default normalizer algorithm

Parameters:

• enumerable (RDF::Enumerable)
• options (Hash{Symbol => Object})

Options Hash (**options):

• :algorithm (Base) — default: :rdfc10 —

  One of :carroll2001, :urgna2012, or :rdfc10

• :max_calls (Integer) —

  Maximum number of calls allowed for recursive blank node labeling, as a multiple of the total number of blank nodes in the dataset.

• :identifier_map (Boolean)

Returns:

• (RDF::Normalize::Base)

Raises:

• (ArgumentError) —

  selected algorithm not defined

# File 'lib/rdf/normalize.rb', line 61

def new(enumerable, **options)
  algorithm = options.fetch(:algorithm, :rdfc10)
  raise ArgumentError, "No algoritm defined for #{algorithm.to_sym}" unless ALGORITHMS.has_key?(algorithm)
  algorithm_class = const_get(ALGORITHMS[algorithm])
  algorithm_class.new(enumerable, **options)
end