js-trig-parser

JS antlr4 based trig to graph/statements.

##Install

npm i js-trig-parser

umd module included built with webpack

Usage

Loaders have the following api's:

loader.fromFile(filename) //nodejs env only
loader.fromString(trigStr)

Graph Loader

Base Loader

Syntax Tree Loader

Graph Loader

Outputs the following trig document

Trig Document

  {
	prefixes: {prefixKey : prefix},
	graphs: [graph],
	macros: [macroResult],
	errors: [errorResult],
	allGraphs: this.graphs + [defaultGraph],
	defaultGraph: { graph },
	getStatements(): [triple]
  }

Graph

{
	iri: String,
	uri: String,
	pos: {line: int, column: int},
	_graph: { ExpandedParseObject },
	getStatements(): [triple]
	
}	

Prefixes

{
	name: String,
	value: String,
	pos: {line: int, column: int}
}

Expanded Parse Object

This is a trimmed down and flattened version of the ANTLR parse token

Expressions(Rules)
{
	pos: {line: int, column: int},
	start: {},
	stop: {},
	type: String, //antlr rule name
	token: String,
	children: [ExpandedParseObject]
	
}


Terminals(Symbols/Literals)
{
	pos: {line: int, column: int},
	start: {},
	stop: {},
	type: String, //antlr rule name
	token: String
	
	
}

Statement

{
	subject: String,//prefix expanded form/URI
	predicate: String,
	object: Value(String | Number | boolean),
	
	iriSubject: String, //original form found in the document
	iriPredicate: String,
	iriObject: String,
	
	_s: { ExpandedParseObject },
	_p: { ExpandedParseObject },
	_o: { ExpandedParseObject },
	_g: { ExpandedParseObject },
	graph: { graph }
}

Literals

IRIed literals

XSD literals are converted to their corresponding types when possible.

Special XSD integer types(i.e. non-negative postitive) are bit validated.

Non-standard IRIed literals("some literal"^^some:iri) are treated like strings but the original parser tokens can be retrieved by looking at the _o object on the statement. Planning to clean this up/simply this in a later version.

DateTime literals

DateTime/Date parsed by moment format strings:

DateTime: 'YYYY-MM-DD HH:mm:ss Z'
Date: 'YYYY-MM-DDZ'

Numeric Values

xsd:decimal or decimal literal are converted using parseFloat.

Anything else is converted to Number using parseInt.

Keywords Not Currently Supported by GraphLoader

@base
PREFIX/BASE
GRAPH
EXPONENT

Base Loader

{
	expressions: [ExpandedParseObjects],
	terminals: [ExpandedParseObjects],
	errors: [ParseObjects]
	
}

Syntax Tree Loader

Raw result of running the ANTLR4 parser using the trigDoc rule on the provided trig file.

{
	tree: ANTLR parser trig doc/root rule,
	parser: antlrParser
}

##Tests

For the profiler to work you need to install devutils(chromium nodejs debugging)

npm test
npm profile