.. image:: https://img.shields.io/badge/License-Apache%202.0-blue.svg :target: https://opensource.org/licenses/Apache-2.0 :alt: License

.. image:: https://travis-ci.org/aio-libs/aiosparql.svg?branch=master :target: https://travis-ci.org/aio-libs/aiosparql :alt: Build Status

.. image:: https://codecov.io/gh/aio-libs/aiosparql/branch/master/graph/badge.svg :target: https://codecov.io/gh/aio-libs/aiosparql :alt: Code Coverage

An asynchronous SPARQL library using aiohttp

Synopsis

::

from aiosparql.syntax import ( IRI, Namespace, Node, PrefixedName, RDF, RDFTerm, Triples)

define a namespace

class Boo(Namespace): iri = IRI("http://boo#") SomeClass = PrefixedName website = PrefixedName label = PrefixedName

create a node

node = Node("", { RDF.type: Boo.SomeClass, Boo.website: IRI("http://example.org"), Boo.label: "some label", # "some label" will be automatically escaped })

missing prefixed names will show on your IDE and fail on execution

print(Boo.something) # AttributeError!

create triples

triples = Triples([("s", "p", "o")]) # o is automatically escaped triples.append(("s", Boo.website, IRI("http://example.org"))) triples.extend([("s", Boo.website, IRI("http://example.org"))])

print(triples) # print the triples is a format usable directly in a SPARQL # query. It also groups by subject automatically for you

from aiosparql.client import SPARQLClient

client = SPARQLClient("http://dbpedia.org/sparql") result = await client.query("select * where {?s ?p ?o} limit 1")

result is a dict of the JSON result

result = await client.update(""" with {{graph}} insert data { {{}} } """, triples)

the triples will be automatically indented to produce a beautiful query

from aiosparql.escape import escape_any

print(escape_any(True)) # "true" print(escape_any("foo")) # "foo" print(escape_any(5)) # "5" print(escape_any(5.5)) # "5.5"^^xsd:double

Installation

• User space installation

  ::

  easy_install --user aiosparql

• System wide installation

  ::

  easy_install aiosparql

Requirements ^^^^^^^^^^^^

• Python >= 3.5

Testing

In order for the tests to run, you must have the following Docker containers started:

::

  docker run -d --name travis-virtuoso -p 8890:8890 -e SPARQL_UPDATE=true tenforce/virtuoso:1.2.0-virtuoso7.2.2
  docker run -d -p 3030:3030 --name travis-fuseki -e ADMIN_PASSWORD=PASSWORD -e ENABLE_DATA_WRITE=true -e ENABLE_UPDATE=true -e ENABLE_UPLOAD=true secoresearch/fuseki

Credits

This software has been produced by Dacota One <http://www.dacota.one/>_.