RubenVerborgh/SPARQL.js


A parser for the SPARQL query language in JavaScript

License: Other

Language: Yacc

Keywords: parser, rdf, serializer, sparql


SPARQL.js – A SPARQL 1.1 parser for JavaScript

Build Status npm version DOI

The SPARQL 1.1 Query Language allows to query datasources of RDF triples. SPARQL.js translates SPARQL into JSON and back, so you can parse and build SPARQL queries in your JavaScript applications.

It fully supports the SPARQL 1.1 specification, including property paths, federation, and updates.

Usage

Library

// Parse a SPARQL query to a JSON object
var SparqlParser = require('sparqljs').Parser;
var parser = new SparqlParser();
var parsedQuery = parser.parse(
  'PREFIX foaf: <http://xmlns.com/foaf/0.1/> ' +
  'SELECT * { ?mickey foaf:name "Mickey Mouse"@en; foaf:knows ?other. }');

// Regenerate a SPARQL query from a JSON object
var SparqlGenerator = require('sparqljs').Generator;
var generator = new SparqlGenerator();
parsedQuery.variables = ['?mickey'];
var generatedQuery = generator.stringify(parsedQuery);

Standalone

$ sparql-to-json query.sparql

Representation

Queries are represented in a JSON structure. The most easy way to get acquainted with this structure is to try the examples in the queries folder through sparql-to-json. All examples of the SPARQL 1.1 specification have been included, in case you wonder how a specific syntactical construct is represented.

Here is a simple query in SPARQL:

PREFIX dbpedia-owl: <http://dbpedia.org/ontology/>
SELECT ?p ?c WHERE {
    ?p a dbpedia-owl:Artist.
    ?p dbpedia-owl:birthPlace ?c.
    ?c <http://xmlns.com/foaf/0.1/name> "York"@en.
}

And here is the same query in JSON:

{
  "type": "query",
  "prefixes": {
    "dbpedia-owl": "http://dbpedia.org/ontology/"
  },
  "queryType": "SELECT",
  "variables": [ "?p", "?c" ],
  "where": [
    {
      "type": "bgp",
      "triples": [
        {
          "subject": "?p",
          "predicate": "http://www.w3.org/1999/02/22-rdf-syntax-ns#type",
          "object": "http://dbpedia.org/ontology/Artist"
        },
        {
          "subject": "?p",
          "predicate": "http://dbpedia.org/ontology/birthPlace",
          "object": "?c"
        },
        {
          "subject": "?c",
          "predicate": "http://xmlns.com/foaf/0.1/name",
          "object": "\"York\"@en"
        }
      ]
    }
  ]
}

The representation of triples is the same as in N3.js 0.x, but will switch to RDF/JS representation in the future.

Installation

$ [sudo] npm [-g] install sparqljs

License, status and contributions

The SPARQL.js library is copyrighted by Ruben Verborgh and released under the MIT License.

Contributions are welcome, and bug reports or pull requests are always helpful.

Contributors

Project Statistics

Sourcerank 10
Repository Size 369 KB
Stars 196
Forks 38
Watchers 25
Open issues 8
Dependencies 72
Contributors 13
Tags 25
Created
Last updated
Last pushed

Top Contributors See all

Ruben Verborgh Alexey Morozov Joachim Van Herwegen Natanael Arndt Artem Kozlov Johannes Trame Tim Ermilov Ruben Taelman Shad Reynolds James Michael DuPont Benjamin Forster Lucas Werkmeister Edgar Rodriguez-Diaz

Packages Referencing this Repo

sparqljs
A parser for the SPARQL query language
Latest release 2.2.1 - Updated - 196 stars

Recent Tags See all

v2.2.1 January 02, 2019
v2.2.0 December 31, 2018
v2.1.1 December 30, 2018
v2.1.0 August 14, 2018
v2.0.3 February 13, 2018
v2.0.2 January 11, 2018
v2.0.1 January 11, 2018
v2.0.0 December 03, 2017
v1.5.2 September 28, 2017
v1.5.1 May 18, 2017
v1.5.0 May 11, 2017
v1.4.1 April 20, 2017
v1.4.0 April 15, 2017
v1.3.0 December 04, 2016
v1.2.0 November 15, 2016

Interesting Forks See all

metaphacts/SPARQL.js
A parser for the SPARQL query language in JavaScript
JavaScript - Last pushed - 1 stars

Something wrong with this page? Make a suggestion

Last synced: 2019-01-02 11:27:26 UTC

Login to resync this repository