n3 2.10.2 → 2.10.4

package/lib/N3Parser.js

@@ -368,10 +368,14 @@ class N3Parser {
       case 'inversePredicate':
         this._inversePredicate = true;
         return this._readPredicateAfterVerb;
+      case '|}':
+        // Expected predicate didn't come, must have been trailing semicolon
+        // or an empty annotation block
+        this._subject = null;
+        return this._readAnnotationBlockPunctuation(token);
       case '.':
       case ']':
       case '}':
-      case '|}':
         // Expected predicate didn't come, must have been trailing semicolon.
         // In N3 mode, a subject (such as a path) can be a statement by itself.
         if (this._predicate === null && !this._n3Mode) return this._error(`Unexpected ${type}`, token);
@@ -876,8 +880,7 @@ class N3Parser {
   // ### `_readPunctuation` reads punctuation between quads or quad parts
   _readPunctuation(token) {
     let next,
-      graph = this._graph,
-      startingAnnotation = false;
+      graph = this._graph;
     const subject = this._subject,
       inversePredicate = this._inversePredicate;
     switch (token.type) {
@@ -902,34 +905,13 @@ class N3Parser {
       case ',':
         next = this._readObject;
         break;
-      // ~ is allowed in the annotation syntax
+      // A reifier or annotation block annotates the triple just read
       case '~':
-        // Only invalidate the cache for a genuinely new triple - chained annotation blocks on the
-        // same triple (subject already null from a preceding annotation) must keep reusing it.
-        if (subject !== null) this._tripleTerm = null;
-        next = this._readReifierInAnnotation;
-        startingAnnotation = true;
-        break;
-      // {| means that the current triple is annotated with predicate-object pairs.
       case '{|':
-        // Continue using the last triple as reified triple subject for the predicate-object pairs.
-        // Same staleness rule as ~ above.
-        if (subject !== null) this._tripleTerm = null;
-        this._subject = this._readTripleTerm();
-        this._inversePredicate = false;
-        this._validAnnotation = false;
-        startingAnnotation = true;
-        next = this._readPredicate;
-        break;
-      // |} means that the current reified triple in annotation syntax is finalized.
+        return this._readAnnotationStart(token);
+      // An annotation block can only be closed from within one
       case '|}':
-        if (!this._annotation) return this._error('Unexpected annotation syntax closing', token);
-        if (!this._validAnnotation) return this._error('Annotation block can not be empty', token);
-        this._subject = null;
-        this._annotation = false;
-        this._inversePredicate = false;
-        next = this._getContextEndReader();
-        break;
+        return this._error('Unexpected annotation syntax closing', token);
       default:
         // An entity means this is a quad (only allowed if not already inside a graph)
         if (this._supportsQuads && this._graph === null && (graph = this._readEntity(token)) !== undefined) {
@@ -939,14 +921,11 @@ class N3Parser {
         return this._error(`Expected punctuation to follow "${this._object.id}"`, token);
     }
     // A quad has been completed now, so return it
-    if (subject !== null && (!startingAnnotation || startingAnnotation && !this._annotation)) {
+    if (subject !== null) {
       const predicate = this._predicate,
         object = this._object;
       this._emit(subject, predicate, object, graph, inversePredicate);
     }
-    if (startingAnnotation) {
-      this._annotation = true;
-    }
     return next;
   }
 
@@ -965,19 +944,15 @@ class N3Parser {
         next = this._readObject;
         break;
       // Annotation syntax applies to the quad just read, exactly as it does
-      // outside of a blank node property list.  `|}` arrives here too, because
-      // the objects inside the annotation block are themselves read within the
-      // enclosing blank node context.
+      // outside of a blank node property list
       case '~':
       case '{|':
+        return this._readAnnotationStart(token);
       case '|}':
-        return this._readPunctuation(token);
+        return this._error('Unexpected annotation syntax closing', token);
       default:
         return this._error(`Expected punctuation to follow "${this._object.id}"`, token);
     }
-    // An annotation block consumes the subject it annotates, so there is
-    // nothing left to share with a following predicate-object pair
-    if (this._subject === null) return this._error('Expected ] to follow annotation', token);
     // A quad has been completed now, so return it
     this._emitCurrent(this._subject, this._predicate, this._object, this._graph);
     if (resetInversePredicate) this._inversePredicate = false;
@@ -1247,32 +1222,27 @@ class N3Parser {
     return this._readReifiedTripleTail;
   }
 
-  // ### `_readReifier` reads the optional triple term identifier after a tilde when in annotation syntax.
-  _readReifierInAnnotation(token) {
-    // If next token is a reifier, read it as such.
-    if (token.type === 'IRI' || token.type === 'typeIRI' || token.type === 'type' || token.type === 'prefixed' || token.type === 'blank' || token.type === 'var') {
-      this._reifier = this._readEntity(token);
-      return this._readAnnotationBlockOrPunctuation;
-    }
-    // Otherwise, emit and assert triple term.
-    this._readTripleTerm();
-    this._subject = null;
-    return this._getContextEndReader().call(this, token);
+  // ### `_readAnnotationStart` reads the first reifier or annotation block after an object,
+  // which completes the annotated quad
+  _readAnnotationStart(token) {
+    this._emitCurrent(this._subject, this._predicate, this._object, this._graph);
+    // A new triple is annotated, so its triple term cannot be reused
+    this._tripleTerm = null;
+    return this._readAnnotation(token);
   }
 
-  // ### `_readAnnotationBlockOrPunctuation` reads what follows an explicit reifier:
-  // either an annotation block, which reuses the reifier as its subject,
-  // or punctuation, in which case the reifier stands alone and its triple
-  // term still needs to be asserted here.
-  _readAnnotationBlockOrPunctuation(token) {
-    if (token.type === '{|') return this._readPunctuation(token);
-    this._readTripleTerm();
-    this._annotation = false;
-    // A shared subject or predicate goes on to reify a *different* triple,
-    // so the term just asserted must not be reused for the next one.
+  // ### `_readAnnotation` reads what follows an annotated quad:
+  // further reifiers or annotation blocks for that same quad, or punctuation
+  _readAnnotation(token) {
+    switch (token.type) {
+      case '~':
+        return this._readReifierInAnnotation;
+      case '{|':
+        return this._readAnnotationBlockHead(token);
+    }
+    // The annotated quad was already emitted when its annotation started,
+    // so continue without emitting it a second time
     this._tripleTerm = null;
-    // The annotated triple was already emitted when the tilde was read,
-    // so continue without letting `_readPunctuation` emit it a second time.
     switch (token.type) {
       // The subject stays shared with the next predicate-object pair
       case ';':
@@ -1283,11 +1253,70 @@ class N3Parser {
         return this._readObject;
       default:
         this._subject = null;
-        // Resume in the enclosing context, which is top-level punctuation
-        // unless the reified triple sits inside a blank node property list
+        // Resume in the enclosing context
         return this._getContextEndReader().call(this, token);
     }
   }
+
+  // ### `_readReifierInAnnotation` reads the optional reifier after a tilde in annotation syntax
+  _readReifierInAnnotation(token) {
+    switch (token.type) {
+      case 'IRI':
+      case 'typeIRI':
+      case 'type':
+      case 'prefixed':
+      case 'blank':
+      case 'var':
+        this._reifier = this._readEntity(token);
+        return this._readAnnotationBlockOrReifier;
+    }
+    // Without an identifier, the reifier is a fresh blank node
+    this._reifier = this._factory.blankNode();
+    return this._readAnnotationBlockOrReifier(token);
+  }
+
+  // ### `_readAnnotationBlockOrReifier` reads what follows a reifier:
+  // either an annotation block, which uses the reifier as its subject,
+  // or anything else, in which case the reifier stands alone
+  _readAnnotationBlockOrReifier(token) {
+    if (token.type === '{|') return this._readAnnotationBlockHead(token);
+    this._readTripleTerm();
+    return this._readAnnotation(token);
+  }
+
+  // ### `_readAnnotationBlockHead` opens an annotation block,
+  // whose predicate-object pairs describe the reifier of the annotated quad
+  _readAnnotationBlockHead(token) {
+    const reifier = this._readTripleTerm();
+    this._saveContext('annotation', this._graph, this._subject, this._predicate, this._object);
+    // Restored when the block closes, so further annotations reuse the same triple term
+    this._contextStack[this._contextStack.length - 1].tripleTerm = this._tripleTerm;
+    this._subject = reifier;
+    this._predicate = this._object = this._tripleTerm = null;
+    this._inversePredicate = false;
+    this._validAnnotation = false;
+    return this._readPredicate;
+  }
+
+  // ### `_readAnnotationBlockPunctuation` reads punctuation inside an annotation block
+  _readAnnotationBlockPunctuation(token) {
+    const stack = this._contextStack;
+    if (token.type === '|}') {
+      if (!stack.length || stack[stack.length - 1].type !== 'annotation') return this._error('Unexpected annotation syntax closing', token);
+      if (!this._validAnnotation) return this._error('Annotation block can not be empty', token);
+      // Emit the last quad of the block, unless a trailing semicolon already did
+      if (this._subject !== null) this._emitCurrent(this._subject, this._predicate, this._object, this._graph);
+      // Return to the annotated quad, which can be followed by more annotations
+      const {
+        tripleTerm
+      } = stack[stack.length - 1];
+      this._restoreContext('annotation', token);
+      this._tripleTerm = tripleTerm;
+      return this._readAnnotation;
+    }
+    // Otherwise, punctuation inside a block works like inside a blank node property list
+    return this._readBlankNodePunctuation(token);
+  }
   _readTripleTerm() {
     const stack = this._contextStack,
       parent = stack.length && stack[stack.length - 1];
@@ -1314,6 +1343,8 @@ class N3Parser {
         return this._readTripleTermTail;
       case '<<':
         return this._readReifiedTripleTailOrReifier;
+      case 'annotation':
+        return this._readAnnotationBlockPunctuation;
     }
   }
 

package/lib/N3Writer.js

@@ -135,7 +135,7 @@ class N3Writer {
 
   // ### `quadToString` serializes a quad as a string
   quadToString(subject, predicate, object, graph) {
-    return `${this._encodeSubject(subject)} ${this._encodeIriOrBlank(predicate)} ${this._encodeObject(object)}${graph && !(0, _N3Util.isDefaultGraph)(graph) ? ` ${this._encodeIriOrBlank(graph)} .\n` : ' .\n'}`;
+    return `${this._encodeSubject(subject)} ${predicate.termType === 'Literal' ? this._encodeLiteral(predicate) : this._encodeIriOrBlank(predicate)} ${this._encodeObject(object)}${graph && !(0, _N3Util.isDefaultGraph)(graph) ? ` ${this._encodeIriOrBlank(graph)} .\n` : ' .\n'}`;
   }
 
   // ### `quadsToString` serializes an array of quads as a string
@@ -147,7 +147,15 @@ class N3Writer {
 
   // ### `_encodeSubject` represents a subject
   _encodeSubject(entity) {
-    return entity.termType === 'Quad' ? this._encodeQuad(entity) : this._encodeIriOrBlank(entity);
+    switch (entity.termType) {
+      case 'Quad':
+        return this._encodeQuad(entity);
+      // Literal subjects are only valid in N3
+      case 'Literal':
+        return this._encodeLiteral(entity);
+      default:
+        return this._encodeIriOrBlank(entity);
+    }
   }
 
   // ### `_encodeIriOrBlank` represents an IRI or blank node
@@ -214,7 +222,15 @@ class N3Writer {
 
   // ### `_encodePredicate` represents a predicate
   _encodePredicate(predicate) {
-    return predicate.value === rdf.type ? 'a' : this._encodeIriOrBlank(predicate);
+    switch (predicate.termType) {
+      case 'NamedNode':
+        return predicate.value === rdf.type ? 'a' : this._encodeIriOrBlank(predicate);
+      // Literal predicates are only valid in N3
+      case 'Literal':
+        return this._encodeLiteral(predicate);
+      default:
+        return this._encodeIriOrBlank(predicate);
+    }
   }
 
   // ### `_encodeObject` represents an object

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n3",
-  "version": "2.10.2",
+  "version": "2.10.4",
   "description": "Lightning fast, asynchronous, streaming Turtle / N3 / RDF library.",
   "author": "Ruben Verborgh <ruben.verborgh@gmail.com>",
   "keywords": [

package/src/N3Parser.js

@@ -371,10 +371,14 @@ export default class N3Parser {
     case 'inversePredicate':
       this._inversePredicate = true;
       return this._readPredicateAfterVerb;
+    case '|}':
+      // Expected predicate didn't come, must have been trailing semicolon
+      // or an empty annotation block
+      this._subject = null;
+      return this._readAnnotationBlockPunctuation(token);
     case '.':
     case ']':
     case '}':
-    case '|}':
       // Expected predicate didn't come, must have been trailing semicolon.
       // In N3 mode, a subject (such as a path) can be a statement by itself.
       if (this._predicate === null && !this._n3Mode)
@@ -952,7 +956,7 @@ export default class N3Parser {
 
   // ### `_readPunctuation` reads punctuation between quads or quad parts
   _readPunctuation(token) {
-    let next, graph = this._graph, startingAnnotation = false;
+    let next, graph = this._graph;
     const subject = this._subject, inversePredicate = this._inversePredicate;
     switch (token.type) {
     // A closing brace ends a graph
@@ -978,38 +982,13 @@ export default class N3Parser {
     case ',':
       next = this._readObject;
       break;
-    // ~ is allowed in the annotation syntax
+    // A reifier or annotation block annotates the triple just read
     case '~':
-      // Only invalidate the cache for a genuinely new triple - chained annotation blocks on the
-      // same triple (subject already null from a preceding annotation) must keep reusing it.
-      if (subject !== null)
-        this._tripleTerm = null;
-      next = this._readReifierInAnnotation;
-      startingAnnotation = true;
-      break;
-    // {| means that the current triple is annotated with predicate-object pairs.
     case '{|':
-      // Continue using the last triple as reified triple subject for the predicate-object pairs.
-      // Same staleness rule as ~ above.
-      if (subject !== null)
-        this._tripleTerm = null;
-      this._subject = this._readTripleTerm();
-      this._inversePredicate = false;
-      this._validAnnotation = false;
-      startingAnnotation = true;
-      next = this._readPredicate;
-      break;
-    // |} means that the current reified triple in annotation syntax is finalized.
+      return this._readAnnotationStart(token);
+    // An annotation block can only be closed from within one
     case '|}':
-      if (!this._annotation)
-        return this._error('Unexpected annotation syntax closing', token);
-      if (!this._validAnnotation)
-        return this._error('Annotation block can not be empty', token);
-      this._subject = null;
-      this._annotation = false;
-      this._inversePredicate = false;
-      next = this._getContextEndReader();
-      break;
+      return this._error('Unexpected annotation syntax closing', token);
     default:
       // An entity means this is a quad (only allowed if not already inside a graph)
       if (this._supportsQuads && this._graph === null && (graph = this._readEntity(token)) !== undefined) {
@@ -1019,13 +998,10 @@ export default class N3Parser {
       return this._error(`Expected punctuation to follow "${this._object.id}"`, token);
     }
     // A quad has been completed now, so return it
-    if (subject !== null && (!startingAnnotation || (startingAnnotation && !this._annotation))) {
+    if (subject !== null) {
       const predicate = this._predicate, object = this._object;
       this._emit(subject, predicate, object, graph, inversePredicate);
     }
-    if (startingAnnotation) {
-      this._annotation = true;
-    }
     return next;
   }
 
@@ -1043,20 +1019,15 @@ export default class N3Parser {
       next = this._readObject;
       break;
     // Annotation syntax applies to the quad just read, exactly as it does
-    // outside of a blank node property list.  `|}` arrives here too, because
-    // the objects inside the annotation block are themselves read within the
-    // enclosing blank node context.
+    // outside of a blank node property list
     case '~':
     case '{|':
+      return this._readAnnotationStart(token);
     case '|}':
-      return this._readPunctuation(token);
+      return this._error('Unexpected annotation syntax closing', token);
     default:
       return this._error(`Expected punctuation to follow "${this._object.id}"`, token);
     }
-    // An annotation block consumes the subject it annotates, so there is
-    // nothing left to share with a following predicate-object pair
-    if (this._subject === null)
-      return this._error('Expected ] to follow annotation', token);
     // A quad has been completed now, so return it
     this._emitCurrent(this._subject, this._predicate, this._object, this._graph);
     if (resetInversePredicate)
@@ -1356,34 +1327,27 @@ export default class N3Parser {
     return this._readReifiedTripleTail;
   }
 
-  // ### `_readReifier` reads the optional triple term identifier after a tilde when in annotation syntax.
-  _readReifierInAnnotation(token) {
-    // If next token is a reifier, read it as such.
-    if (token.type === 'IRI' || token.type === 'typeIRI' || token.type === 'type' || token.type === 'prefixed' || token.type === 'blank' || token.type === 'var') {
-      this._reifier = this._readEntity(token);
-      return this._readAnnotationBlockOrPunctuation;
-    }
-    // Otherwise, emit and assert triple term.
-    this._readTripleTerm();
-    this._subject = null;
-    return this._getContextEndReader().call(this, token);
+  // ### `_readAnnotationStart` reads the first reifier or annotation block after an object,
+  // which completes the annotated quad
+  _readAnnotationStart(token) {
+    this._emitCurrent(this._subject, this._predicate, this._object, this._graph);
+    // A new triple is annotated, so its triple term cannot be reused
+    this._tripleTerm = null;
+    return this._readAnnotation(token);
   }
 
-  // ### `_readAnnotationBlockOrPunctuation` reads what follows an explicit reifier:
-  // either an annotation block, which reuses the reifier as its subject,
-  // or punctuation, in which case the reifier stands alone and its triple
-  // term still needs to be asserted here.
-  _readAnnotationBlockOrPunctuation(token) {
-    if (token.type === '{|')
-      return this._readPunctuation(token);
-
-    this._readTripleTerm();
-    this._annotation = false;
-    // A shared subject or predicate goes on to reify a *different* triple,
-    // so the term just asserted must not be reused for the next one.
+  // ### `_readAnnotation` reads what follows an annotated quad:
+  // further reifiers or annotation blocks for that same quad, or punctuation
+  _readAnnotation(token) {
+    switch (token.type) {
+    case '~':
+      return this._readReifierInAnnotation;
+    case '{|':
+      return this._readAnnotationBlockHead(token);
+    }
+    // The annotated quad was already emitted when its annotation started,
+    // so continue without emitting it a second time
     this._tripleTerm = null;
-    // The annotated triple was already emitted when the tilde was read,
-    // so continue without letting `_readPunctuation` emit it a second time.
     switch (token.type) {
     // The subject stays shared with the next predicate-object pair
     case ';':
@@ -1394,12 +1358,73 @@ export default class N3Parser {
       return this._readObject;
     default:
       this._subject = null;
-      // Resume in the enclosing context, which is top-level punctuation
-      // unless the reified triple sits inside a blank node property list
+      // Resume in the enclosing context
       return this._getContextEndReader().call(this, token);
     }
   }
 
+  // ### `_readReifierInAnnotation` reads the optional reifier after a tilde in annotation syntax
+  _readReifierInAnnotation(token) {
+    switch (token.type) {
+    case 'IRI':
+    case 'typeIRI':
+    case 'type':
+    case 'prefixed':
+    case 'blank':
+    case 'var':
+      this._reifier = this._readEntity(token);
+      return this._readAnnotationBlockOrReifier;
+    }
+    // Without an identifier, the reifier is a fresh blank node
+    this._reifier = this._factory.blankNode();
+    return this._readAnnotationBlockOrReifier(token);
+  }
+
+  // ### `_readAnnotationBlockOrReifier` reads what follows a reifier:
+  // either an annotation block, which uses the reifier as its subject,
+  // or anything else, in which case the reifier stands alone
+  _readAnnotationBlockOrReifier(token) {
+    if (token.type === '{|')
+      return this._readAnnotationBlockHead(token);
+    this._readTripleTerm();
+    return this._readAnnotation(token);
+  }
+
+  // ### `_readAnnotationBlockHead` opens an annotation block,
+  // whose predicate-object pairs describe the reifier of the annotated quad
+  _readAnnotationBlockHead(token) {
+    const reifier = this._readTripleTerm();
+    this._saveContext('annotation', this._graph, this._subject, this._predicate, this._object);
+    // Restored when the block closes, so further annotations reuse the same triple term
+    this._contextStack[this._contextStack.length - 1].tripleTerm = this._tripleTerm;
+    this._subject = reifier;
+    this._predicate = this._object = this._tripleTerm = null;
+    this._inversePredicate = false;
+    this._validAnnotation = false;
+    return this._readPredicate;
+  }
+
+  // ### `_readAnnotationBlockPunctuation` reads punctuation inside an annotation block
+  _readAnnotationBlockPunctuation(token) {
+    const stack = this._contextStack;
+    if (token.type === '|}') {
+      if (!stack.length || stack[stack.length - 1].type !== 'annotation')
+        return this._error('Unexpected annotation syntax closing', token);
+      if (!this._validAnnotation)
+        return this._error('Annotation block can not be empty', token);
+      // Emit the last quad of the block, unless a trailing semicolon already did
+      if (this._subject !== null)
+        this._emitCurrent(this._subject, this._predicate, this._object, this._graph);
+      // Return to the annotated quad, which can be followed by more annotations
+      const { tripleTerm } = stack[stack.length - 1];
+      this._restoreContext('annotation', token);
+      this._tripleTerm = tripleTerm;
+      return this._readAnnotation;
+    }
+    // Otherwise, punctuation inside a block works like inside a blank node property list
+    return this._readBlankNodePunctuation(token);
+  }
+
   _readTripleTerm() {
     const stack = this._contextStack, parent = stack.length && stack[stack.length - 1];
     const parentGraph = parent ? parent.graph : undefined;
@@ -1429,6 +1454,8 @@ export default class N3Parser {
       return this._readTripleTermTail;
     case '<<':
       return this._readReifiedTripleTailOrReifier;
+    case 'annotation':
+      return this._readAnnotationBlockPunctuation;
     }
   }
 

package/src/N3Writer.js

@@ -129,7 +129,8 @@ export default class N3Writer {
   // ### `quadToString` serializes a quad as a string
   quadToString(subject, predicate, object, graph) {
     return  `${this._encodeSubject(subject)} ${
-            this._encodeIriOrBlank(predicate)} ${
+            predicate.termType === 'Literal' ?
+              this._encodeLiteral(predicate) : this._encodeIriOrBlank(predicate)} ${
             this._encodeObject(object)
             }${graph && !isDefaultGraph(graph) ? ` ${this._encodeIriOrBlank(graph)} .\n` : ' .\n'}`;
   }
@@ -144,8 +145,15 @@ export default class N3Writer {
 
   // ### `_encodeSubject` represents a subject
   _encodeSubject(entity) {
-    return entity.termType === 'Quad' ?
-      this._encodeQuad(entity) : this._encodeIriOrBlank(entity);
+    switch (entity.termType) {
+    case 'Quad':
+      return this._encodeQuad(entity);
+    // Literal subjects are only valid in N3
+    case 'Literal':
+      return this._encodeLiteral(entity);
+    default:
+      return this._encodeIriOrBlank(entity);
+    }
   }
 
   // ### `_encodeIriOrBlank` represents an IRI or blank node
@@ -223,7 +231,15 @@ export default class N3Writer {
 
   // ### `_encodePredicate` represents a predicate
   _encodePredicate(predicate) {
-    return predicate.value === rdf.type ? 'a' : this._encodeIriOrBlank(predicate);
+    switch (predicate.termType) {
+    case 'NamedNode':
+      return predicate.value === rdf.type ? 'a' : this._encodeIriOrBlank(predicate);
+    // Literal predicates are only valid in N3
+    case 'Literal':
+      return this._encodeLiteral(predicate);
+    default:
+      return this._encodeIriOrBlank(predicate);
+    }
   }
 
   // ### `_encodeObject` represents an object