RubyGems - rdf_context - Versions diffs - 0.5.7 → 0.5.8.1 - Mend

rdf_context 0.5.7 → 0.5.8.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (59) hide show

data/History.rdoc +15 -1
data/README.rdoc +2 -0
data/Rakefile +2 -4
data/VERSION +1 -1
data/bin/rdf_context +5 -54
data/lib/rdf_context.rb +5 -0
data/lib/rdf_context/graph.rb +68 -49
data/lib/rdf_context/n3parser.rb +2 -2
data/lib/rdf_context/namespace.rb +1 -1
data/lib/rdf_context/nokogiri_hacks.rb +7 -0
data/lib/rdf_context/parser.rb +57 -13
data/lib/rdf_context/rdfaparser.rb +200 -130
data/lib/rdf_context/rdfxmlparser.rb +8 -8
data/lib/rdf_context/serializer/recursive_serializer.rb +1 -1
data/lib/rdf_context/serializer/turtle_serializer.rb +15 -15
data/lib/rdf_context/serializer/xml_serializer.rb +8 -8
data/lib/rdf_context/store/memory_store.rb +14 -14
data/lib/rdf_context/store/sqlite3_store.rb +4 -4
data/lib/rdf_context/uriref.rb +11 -4
data/script/console +1 -3
data/script/tc +44 -0
data/spec/.gitignore +1 -0
data/spec/aggregate_graph_spec.rb +1 -0
data/spec/bnode_spec.rb +2 -1
data/spec/conjunctive_graph_spec.rb +1 -0
data/spec/cwm_spec.rb +1 -0
data/spec/duration_spec.rb +1 -0
data/spec/graph_spec.rb +27 -0
data/spec/list_store_spec.rb +1 -0
data/spec/literal_spec.rb +1 -0
data/spec/matchers.rb +1 -1
data/spec/memory_store_spec.rb +1 -0
data/spec/n3parser_spec.rb +1 -0
data/spec/namespaces_spec.rb +1 -0
data/spec/parser_spec.rb +1 -0
data/spec/rdf_helper.rb +4 -4
data/spec/rdfa_helper.rb +24 -0
data/spec/rdfa_parser_spec.rb +6 -36
data/spec/rdfcore/.gitignore +1 -0
data/spec/rdfxml_spec.rb +1 -0
data/spec/sqlite3_store_spec.rb +1 -0
data/spec/string_hacks_spec.rb +2 -0
data/spec/swap_test/.gitignore +1 -0
data/spec/triple_spec.rb +1 -0
data/spec/turtle/.gitignore +1 -0
data/spec/turtle_serializer_spec.rb +3 -2
data/spec/turtle_spec.rb +1 -0
data/spec/uriref_spec.rb +13 -12
data/spec/xml_serializer_spec.rb +7 -6
metadata +26 -61
data/spec/html4-manifest.yml +0 -4937
data/spec/html5-manifest.yml +0 -4937
data/spec/rdfcore/Manifest.yml +0 -6242
data/spec/swap_test/n3parser.yml +0 -773
data/spec/swap_test/regression.yml +0 -902
data/spec/turtle/manifest-bad.yml +0 -807
data/spec/turtle/manifest.yml +0 -807
data/spec/xhtml-manifest.yml +0 -3901
data/spec/xhtml11-manifest.yml +0 -4405

data/History.rdoc CHANGED Viewed

@@ -1,3 +1,17 @@
+=== 0.5.8.1
+=== 0.5.8
+* Remove dependency on whatlanguage.
+* Added support for Processor Graphs.
+* Change Graph#seq to specifically look for subject type of rdf:Seq, rdf:Bag or rdf:Alt to trigger rdf:_n processing.
+* Update RDFa processing to WD-rdfa-core-20100803 semantics
+  * Added Processor Graph and required output
+  * Reverse order of processing profiles
+  * Don't process element if any profile fails
+  * XMLLiterals must be explicitly specified as @datatype
+  * TERMorCURIEorAbsURI requires an absolute URI, not document relative
+  * Move @profile parsing before @vocabulary.
+  * Extract a new default vocabulary from @profile.*
 === 0.5.7
 * Add back support for RDFa 1.0 as well as RDFa 1.1. Parser checks @version to determine which
 * Remove specs for html4 and html5 until sorted out.
@@ -35,7 +49,7 @@
 * Remove old binding for a namespace URI creating a new binding
 === 0.5.1
-* Avoid stack-overflow when checking graph size (if $DEBUG == true)
+* Avoid stack-overflow when checking graph size (if ::RdfContext::debug? == true)
 * Refactor serializers to be based on AbstractSerializer
 * Graph
   * Add Graph#serialize taking a serializer or symbol identifing a serialzer and a base URI

data/README.rdoc CHANGED Viewed

@@ -192,6 +192,8 @@ These interfaces work on contexts and formulae (for stores that are formula-awar
 * Reasoner/inference engine
 * SPARQL
 * RDFS logic and RDF entailment tests
+* OWL 2 Test Cases
+  * http://owl.semanticweb.org/page/OWL_2_Test_Cases
 == Resources:
 * Distiller[http://kellogg-assoc/distiller]

data/Rakefile CHANGED Viewed

@@ -22,12 +22,10 @@ begin
     gemspec.email = "gregg@kellogg-assoc.com"
     gemspec.homepage = "http://github.com/gkellogg/rdf_context"
     gemspec.authors = ["Gregg Kellogg"]
-    gemspec.add_dependency('addressable', '>= 2.0.0')
+    gemspec.add_dependency('addressable', '>= 2.2.0')
     gemspec.add_dependency('treetop',  '>= 1.4.0')
-    gemspec.add_dependency('whatlanguage', '>= 1.0.0')
-    gemspec.add_dependency('nokogiri', '>= 1.3.3')
+    gemspec.add_dependency('nokogiri', '>= 1.4.3')
     gemspec.add_dependency('builder', '>= 2.1.2')
-    gemspec.add_dependency('patron', '>= 0.4.6')
     gemspec.add_development_dependency('rspec')
     gemspec.add_development_dependency('activesupport', '>= 2.3.0')
     gemspec.add_development_dependency('yard')

data/VERSION CHANGED Viewed

	@@ -1 +1 @@
1	- 0.5.7
1	+ 0.5.8.1

data/bin/rdf_context CHANGED Viewed

@@ -10,9 +10,7 @@ class Parse
     graph_opts[:store] = store if store
     parser = Parser.new(:graph => Graph.new(graph_opts))
     parser.parse(file.respond_to?(:read) ? file : File.open(file), base_uri, :strict => true)
-    output = parser.graph.serialize(:format => $format.to_sym, :base => base_uri)
-    puts output unless $quiet
+    puts parser.graph.serialize(:format => $format.to_sym, :base => base_uri) unless $quiet
     puts parser.debug.to_a.join("\n\t") if $verbose
   rescue RdfException => e
     puts "Parse failure: #{e.message}"
@@ -25,44 +23,12 @@ class Parse
   end
 end
-TEST_DIR = File.join(File.dirname(__FILE__), '..', 'spec', 'rdfa-test-suite', 'tests')
-BASE_MANIFEST_URL = "http://rdfa.digitalbazaar.com/test-suite/"
-BASE_TEST_CASE_URL = "#{BASE_MANIFEST_URL}test-cases/"
-def rdfa_tc(number, parse, store)
-  f = File.expand_path("#{TEST_DIR}/#{number}.txt")
-  found_head = false
-  namespaces = ""
-  body = File.readlines(f).map do |line|
-    found_head ||= line.match(/<head/)
-    if found_head
-      line.chop
-    else
-      namespaces << line
-      nil
-    end
-  end.compact.join("\n")
-  namespaces.chop!  # Remove trailing newline
-  tcpath = BASE_TEST_CASE_URL + "xhtml1"
-  head = "" +
-  %(<?xml version="1.0" encoding="UTF-8"?>\n) +
-  %(<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML+RDFa 1.0//EN" "http://www.w3.org/MarkUp/DTD/xhtml-rdfa-1.dtd">\n) +
-  %(<html xmlns="http://www.w3.org/1999/xhtml" version="XHTML+RDFa #{$rdfa_version}"\n)
-  tc = head + "#{namespaces}>\n#{body.gsub(/\$TCPATH/, tcpath)}\n</html>"
-  puts "Input file: #{tc}" if $DEBUG || $verbose
-  parse.parse(StringIO.new(tc), "#{tcpath}/#{number}.xhtml")
-end
 mode = ARGV.shift
 raise "Mode must be one of 'parse'" unless mode == "parse"
 $verbose = false
+$quiet = false
 $format = "ttl"
-$rdfa_version = "1.1"
 base_uri  = "http://example.com"
 store = :list_store
 opts = GetoptLong.new(
@@ -71,19 +37,15 @@ opts = GetoptLong.new(
   ["--debug", GetoptLong::NO_ARGUMENT],
   ["--format", GetoptLong::REQUIRED_ARGUMENT],
   ["--store", GetoptLong::REQUIRED_ARGUMENT],
-  ["--uri", GetoptLong::REQUIRED_ARGUMENT],
-  ["--rdfa", GetoptLong::NO_ARGUMENT],
-  ["--1_0", GetoptLong::NO_ARGUMENT]
+  ["--uri", GetoptLong::REQUIRED_ARGUMENT]
 )
 opts.each do |opt, arg|
   case opt
   when '--verbose' then $verbose = true
   when '--quiet' then $quiet = true
-  when '--debug' then $DEBUG = true
+  when '--debug' then ::RdfContext::debug = true
   when '--format' then $format = arg
   when '--uri' then base_uri = arg
-  when '--rdfa' then $rdfa = true
-  when '--1_0' then $rdfa_version = "1.0"
   when '--store'
     case arg
     when /list/
@@ -98,20 +60,9 @@ opts.each do |opt, arg|
 end
 x = Parse.new
-if $rdfa && ARGV.empty?
-  # Run all RDFa test cases
-  Dir.foreach(TEST_DIR) do |f|
-    next unless f.match(/^(.*)\.txt$/)
-    rdfa_tc($1, x, store)
-  end
-elsif ARGV.empty?
+if ARGV.empty?
   s = $stdin.read
   x.parse(StringIO.new(s), base_uri, store)
-elsif $rdfa
-  # Run specified RDFa test cases
-  ARGV.each do |tc|
-    rdfa_tc(tc, x, store)
-  end
 else
   ARGV.each do |test_file|
     x.parse(test_file, base_uri, store)

data/lib/rdf_context.rb CHANGED Viewed

@@ -74,4 +74,9 @@ module RdfContext
   WELLKNOWN_NAMESPACES = [DC_NS, OWL_NS, LOG_NS, RDF_NS, RDFA_NS, RDFS_NS, XHV_NS, XML_NS, XSD_NS, XSI_NS]
   XH_MAPPING  = {"" => Namespace.new("http://www.w3.org/1999/xhtml/vocab\#", nil)}
+  # Control debug output.
+  def self.debug?; @debug; end
+  def self.debug=(value); @debug = value; end
 end

data/lib/rdf_context/graph.rb CHANGED Viewed

@@ -265,39 +265,6 @@ module RdfContext
       self
     end
-    ##
-    # Adds a list of resources as an RDF list by creating bnodes and first/rest triples
-    # @param [URIRef, BNode] subject the subject of the triple
-    # @param [URIRef] predicate the predicate of the triple
-    # @param [Array] objects List of objects to serialize
-    # @return [Graph] Returns the graph
-    # @raise [Error] Checks parameter types and raises if they are incorrect.
-    def add_seq(subject, predicate, objects)
-      if objects.empty?
-        add_triple(subject, predicate, RDF_NS.nil)
-        return self
-      end
-      if RDF_NS.first != predicate
-        bn = BNode.new
-        add_triple(subject, predicate, bn)
-        subject = bn
-      end
-      last = objects.pop
-      objects.each do |o|
-        add_triple(subject, RDF_NS.first, o)
-        bn = BNode.new
-        add_triple(subject, RDF_NS.rest, bn)
-        subject = bn
-      end
-      # Last item in list
-      add_triple(subject, RDF_NS.first, last)
-      add_triple(subject, RDF_NS.rest, RDF_NS.nil)
-    end
     # Remove a triple from the graph. Delegates to store.
     # Nil matches all triples and thus empties the graph
     # @param [Triple] triple
@@ -316,19 +283,24 @@ module RdfContext
     # Returns ordered rdf:_n objects or rdf:first, rdf:rest for a given subject
     # @param [Resource] subject
+    # @param [Resource] predicate defaults to rdf:first, not used of subject is an rdf:List type
     # @return [Array<Resource>]
-    def seq(subject)
+    def seq(subject, predicate = RDF_NS.first)
       props = properties(subject)
-      rdf_type = (props[RDF_TYPE.to_s] || []).map {|t| t.to_s}
+      rdf_type = (props[RDF_TYPE.to_s] || [])
       #puts "seq; #{rdf_type} #{rdf_type - [RDF_NS.Seq, RDF_NS.Bag, RDF_NS.Alt]}"
-      if !(rdf_type - [RDF_NS.Seq, RDF_NS.Bag, RDF_NS.Alt]).empty?
+      if rdf_type.include?(RDF_NS.Seq) || rdf_type.include?(RDF_NS.Bag) || rdf_type.include?(RDF_NS.Alt)
         props.keys.select {|k| k.match(/#{RDF_NS.uri}_(\d)$/)}.
           sort_by {|i| i.sub(RDF_NS._.to_s, "").to_i}.
           map {|key| props[key]}.
           flatten
-      elsif !self.triples(Triple.new(subject, RDF_NS.first, nil)).empty?
+      elsif !self.triples(Triple.new(subject, predicate, nil)).empty?
         # N3-style first/rest chain
+        unless predicate == RDF_NS.first
+          subject = (properties(subject)[predicate.to_s] || []).first
+        end
         list = []
         while subject != RDF_NS.nil
           props = properties(subject)
@@ -346,6 +318,53 @@ module RdfContext
       end
     end
+    ##
+    # Adds a list of resources as an RDF list by creating bnodes and first/rest triples.
+    # Removes existing sequence nodes.
+    #
+    # @param [URIRef, BNode] subject the subject of the triple
+    # @param [URIRef] predicate the predicate of the triple
+    # @param [Array] objects List of objects to serialize
+    # @return [Graph] Returns the graph
+    # @raise [Error] Checks parameter types and raises if they are incorrect.
+    def add_seq(subject, predicate, objects)
+      self.triples(Triple.new(subject, predicate, nil)).each do |t, ctx|
+        bn = t.object
+        while bn != RDF_NS.nil
+          rest = properties(bn)[RDF_NS.rest.to_s].first
+          remove(Triple.new(bn, nil, nil))
+          bn = rest
+        end
+      end
+      remove(Triple.new(subject, predicate, nil))
+      if objects.empty?
+        add_triple(subject, predicate, RDF_NS.nil)
+        return self
+      end
+      if RDF_NS.first != predicate
+        bn = BNode.new
+        add_triple(subject, predicate, bn)
+        subject = bn
+      end
+      last = objects.pop
+      objects.each do |o|
+        add_triple(subject, RDF_NS.first, o)
+        bn = BNode.new
+        add_triple(subject, RDF_NS.rest, bn)
+        subject = bn
+      end
+      # Last item in list
+      add_triple(subject, RDF_NS.first, last)
+      add_triple(subject, RDF_NS.rest, RDF_NS.nil)
+      self
+    end
     # Resource properties
     #
     # Properties arranged as a hash with the predicate Term as index to an array of resources or literals
@@ -388,7 +407,7 @@ module RdfContext
       # Iterate through and add properties to graph
       props.each_pair do |pred, list|
-        predicate = URIRef.new(pred)
+        predicate = URIRef.intern(pred)
         [list].flatten.compact.each do |object|
           add(Triple.new(subject, predicate, object))
         end
@@ -472,25 +491,25 @@ module RdfContext
     # @param [Graph] graph
     # @return [Boolean]
     def eql?(other)
-      #puts "eql? size #{self.size} vs #{other.size}" if $DEBUG
+      #puts "eql? size #{self.size} vs #{other.size}" if ::RdfContext::debug?
       return false if !other.is_a?(Graph) || self.size != other.size
       return false unless other.identifier.to_s == identifier.to_s unless other.identifier.is_a?(BNode) && identifier.is_a?(BNode)
       bn_self = bnodes.values.sort
       bn_other = other.bnodes.values.sort
-      puts "eql? bnodes '#{bn_self.to_sentence}' vs '#{bn_other.to_sentence}'" if $DEBUG
+      puts "eql? bnodes '#{bn_self.to_sentence}' vs '#{bn_other.to_sentence}'" if ::RdfContext::debug?
       return false unless bn_self == bn_other
       # Check each triple to see if it's contained in the other graph
       triples do |t, ctx|
         next if t.subject.is_a?(BNode) || t.predicate.is_a?(BNode) || t.object.is_a?(BNode)
-        puts "eql? contains '#{t.to_ntriples}: #{other.contains?(t)}'" if $DEBUG
+        puts "eql? contains '#{t.to_ntriples}: #{other.contains?(t)}'" if ::RdfContext::debug?
         return false unless other.contains?(t)
       end
       # For each BNode, check permutations of similar bnodes in other graph
       bnode_permutations(bnodes, other.bnodes) do |bn_map|
-        puts "bnode permutations: #{bn_map.inspect}" if $DEBUG
+        puts "bnode permutations: #{bn_map.inspect}" if ::RdfContext::debug?
         # bn_map contains 1-1 mapping of bnodes from self to other
         catch :next_perm do
           triples do |t, ctx|
@@ -500,10 +519,10 @@ module RdfContext
             predicate = bn_map[predicate] if bn_map.has_key?(predicate)
             object = bn_map[object] if bn_map.has_key?(object)
             tn = Triple.new(subject, predicate, object)
-            puts "  eql? contains '#{tn.inspect}': #{other.contains?(tn)}" if $DEBUG
+            puts "  eql? contains '#{tn.inspect}': #{other.contains?(tn)}" if ::RdfContext::debug?
             next if other.contains?(tn)
-            puts "  no, next permutation" if $DEBUG
+            puts "  no, next permutation" if ::RdfContext::debug?
             # Not a match, try next permutation
             throw :next_perm
           end
@@ -543,7 +562,7 @@ module RdfContext
     # Take source keys and run permutations mapping to other keys, if the permutation
     # maps to the same counts for each
     def bnode_permutations(bn_source, bn_other)
-      puts "compare #{bn_source.inspect}\n   with #{bn_other.inspect}" if $DEBUG
+      puts "compare #{bn_source.inspect}\n   with #{bn_other.inspect}" if ::RdfContext::debug?
       source_keys = bn_source.keys
       other_keys = bn_other.keys
@@ -556,14 +575,14 @@ module RdfContext
       when 1
         # All keys have equivalent counts, yield permutations
         if source_keys.length == 1
-          puts "yield #{{source_keys.first => other_keys.first}.inspect}" if $DEBUG
+          puts "yield #{{source_keys.first => other_keys.first}.inspect}" if ::RdfContext::debug?
           yield({source_keys.first => other_keys.first})
         else
           (0..(source_keys.length-1)).to_a.permute do |indicies|
-            puts "indicies #{indicies.inspect}" if $DEBUG
+            puts "indicies #{indicies.inspect}" if ::RdfContext::debug?
             ok = other_keys.dup
             map = indicies.inject({}) { |hash, i| hash[source_keys[i]] = ok.shift; hash}
-            puts "yield #{map.inspect}" if $DEBUG
+            puts "yield #{map.inspect}" if ::RdfContext::debug?
             yield(map)
           end
         end
@@ -581,7 +600,7 @@ module RdfContext
           bn_other_max[bn] = bn_other_min.delete(bn) if v == max
         end
-        puts "yield permutations of multiple with max #{bn_source_max.inspect}\n  and #{bn_other_max.inspect}" if $DEBUG
+        puts "yield permutations of multiple with max #{bn_source_max.inspect}\n  and #{bn_other_max.inspect}" if ::RdfContext::debug?
         # Yield for each permutation of max joined with permutations of min
         bnode_permutations(bn_source_max, bn_other_max) do |bn_perm_max|
           bnode_permutations(bn_source_min, bn_other_min) do |bn_perm_min|

data/lib/rdf_context/n3parser.rb CHANGED Viewed

@@ -35,7 +35,7 @@ module RdfContext
       @graph.allow_n3 = true
       document = parser.parse(@doc)
       unless document
-        puts parser.inspect if $DEBUG
+        puts parser.inspect if ::RdfContext::debug?
         reason = parser.failure_reason
         raise ParserException.new(reason)
       end
@@ -269,7 +269,7 @@ module RdfContext
     def process_uri(uri)
       uri = uri.text_value if uri.respond_to?(:text_value)
-      URIRef.new(uri, @uri, :normalize => false)
+      URIRef.intern(uri, @uri, :normalize => false)
     end
     def process_properties(properties)

data/lib/rdf_context/namespace.rb CHANGED Viewed

@@ -53,7 +53,7 @@ module RdfContext
       prefix = @uri
       suffix = suffix.to_s.sub(/^\#/, "") if prefix.index("#")
       suffix = suffix.to_s.sub(/_$/, '')
-      URIRef.new(prefix + suffix.to_s, :normalize => false, :namespace => self)
+      URIRef.intern(prefix + suffix.to_s, :normalize => false, :namespace => self)
     end
     # Make sure to attach fragment

data/lib/rdf_context/nokogiri_hacks.rb CHANGED Viewed

@@ -5,4 +5,11 @@ class Nokogiri::XML::Node
     ns = self.namespace ? self.namespace.href : RdfContext::XML_NS.uri.to_s
     RdfContext::URIRef.new(ns + self.node_name, :normalize => false)
   end
+  def display_path
+    @display_path ||= case self
+    when Nokogiri::XML::Document then ""
+    when Nokogiri::XML::Element then parent ? "#{parent.display_path}/#{name}" : name
+    when Nokogiri::XML::Attr then "#{parent.display_path}@#{name}"
+    end
+  end
 end

data/lib/rdf_context/parser.rb CHANGED Viewed

@@ -3,20 +3,36 @@ require File.join(File.dirname(__FILE__), 'graph')
 module RdfContext
   # Generic RdfContext Parser class
   class Parser
-    attr_reader :debug, :uri
-    attr_accessor :doc, :graph
+    attr_reader :debug
+    # URI of parsed document
+    # @return [RdfContext::URIRef]
+    attr_reader :uri
+    # Source of parsed document
+    # @return [Nokogiri::XML::Document, #read]
+    attr_accessor :doc
+    # Graph instance containing parsed statements
+    # @return [RdfContext::Graph]
+    attr_accessor :graph
+    # Graph instance containing informationa, warning and error statements
+    # @return [RdfContext::Graph]
+    attr_accessor :processor_graph
     ##
     # Creates a new parser
     #
     # @option options [Graph] :graph (nil) Graph to parse into, otherwise a new RdfContext::Graph instance is created
-    # @option options [Array] :debug (nil) Array to place debug messages
+    # @option options [Graph] :processor_graph (nil) Graph to record information, warnings and errors.
     # @option options [:rdfxml, :html, :n3] :type (nil)
     # @option options [Boolean] :strict (false) Raise Error if true, continue with lax parsing, otherwise
     def initialize(options = {})
       # initialize the triplestore
       @graph = options[:graph]
-      @debug = options[:debug]
+      @processor_graph = options[:processor_graph] if options[:processor_graph]
+      @debug = options[:debug] # XXX deprecated
       @strict = options[:strict]
       @named_bnodes = {}
     end
@@ -25,7 +41,7 @@ module RdfContext
     #
     # @param  [#read, #to_s] stream the HTML+RDFa IO stream, string, Nokogiri::HTML::Document or Nokogiri::XML::Document
     # @param [String] uri (nil) the URI of the document
-    # @option options [Array] :debug (nil) Array to place debug messages
+    # @option options [Graph] :processor_graph (nil) Graph to record information, warnings and errors.
     # @option options [:rdfxml, :html, :n3] :type (nil)
     # @option options [Boolean] :strict (false) Raise Error if true, continue with lax parsing, otherwise
     # @return [Graph] Returns the graph containing parsed triples
@@ -48,7 +64,7 @@ module RdfContext
     #
     # @param  [#read, #to_s] stream the HTML+RDFa IO stream, string, Nokogiri::HTML::Document or Nokogiri::XML::Document
     # @param [String] uri (nil) the URI of the document
-    # @option options [Array] :debug (nil) Array to place debug messages
+    # @option options [Graph] :processor_graph (nil) Graph to record information, warnings and errors.
     # @option options [:rdfxml, :html, :n3] :type (nil)
     # @option options [Boolean] :strict (false) Raise Error if true, continue with lax parsing, otherwise
     # @return [Graph] Returns the graph containing parsed triples
@@ -62,7 +78,8 @@ module RdfContext
         options[:strict] ||= @strict if @strict
         options[:graph] ||= @graph if @graph
-        options[:debug] ||= @debug if @debug
+        options[:debug] ||= @debug if @debug  # XXX deprecated
+        @processor_graph = options[:processor_graph] if options[:processor_graph]
         # Intuit type, if not provided
         options[:type] ||= detect_format(stream, uri)
@@ -89,6 +106,8 @@ module RdfContext
     # @return [Graph]
     def graph; @delegate ? @delegate.graph : (@graph || Graph.new); end
+    # @return [Graph]
+    def processor_graph; @delegate ? @delegate.processor_graph : (@processor_graph || Graph.new); end
     # @return [Array<String>]
     def debug; @delegate ? @delegate.debug : @debug; end
@@ -135,9 +154,8 @@ module RdfContext
     # Figure out the document path, if it is a Nokogiri::XML::Element or Attribute
     def node_path(node)
       case node
-      when Nokogiri::XML::Element, Nokogiri::XML::Attr then "#{node_path(node.parent)}/#{node.name}"
-      when String then node
-      else ""
+      when Nokogiri::XML::Node then node.display_path
+      else node.to_s
       end
     end
@@ -146,10 +164,36 @@ module RdfContext
     # @param [XML Node, any] node:: XML Node or string for showing context
     # @param [String] message::
     def add_debug(node, message)
-      puts "#{node_path(node)}: #{message}" if $DEBUG
-      @debug << "#{node_path(node)}: #{message}" if @debug.is_a?(Array)
+      add_processor_message(node, message, RDFA_NS.InformationalMessage)
     end
+    def add_info(node, message, process_class = RDFA_NS.InformationalMessage)
+      add_processor_message(node, message, process_class)
+    end
+    def add_warning(node, message, process_class = RDFA_NS.MiscellaneousWarning)
+      add_processor_message(node, message, process_class)
+    end
+    def add_error(node, message, process_class = RDFA_NS.MiscellaneousError)
+      add_processor_message(node, message, process_class)
+      raise ParserException, message if @strict
+    end
+    def add_processor_message(node, message, process_class)
+      puts "#{node_path(node)}: #{message}" if ::RdfContext::debug?
+      @debug << "#{node_path(node)}: #{message}" if @debug.is_a?(Array)
+      if @processor_graph
+        @processor_sequence ||= 0
+        n = BNode.new
+        @processor_graph << Triple.new(n, RDF_TYPE, process_class)
+        @processor_graph << Triple.new(n, DC_NS.description, message)
+        @processor_graph << Triple.new(n, DC_NS.date, Literal.build_from(DateTime.now.to_date))
+        @processor_graph << Triple.new(n, RDFA_NS.sequence, Literal.build_from(@processor_sequence += 1))
+        @processor_graph << Triple.new(n, RDFA_NS.source, node_path(node))
+      end
+    end
     # add a triple, object can be literal or URI or bnode
     #
     # If the parser is called with a block, triples are passed to the block rather
@@ -172,7 +216,7 @@ module RdfContext
       triple
     rescue RdfException => e
       add_debug(node, "add_triple raised #{e.class}: #{e.message}")
-      puts e.backtrace if $DEBUG
+      puts e.backtrace if ::RdfContext::debug?
       raise if @strict
     end
   end