https://github.com/aio-libs/aiosparql
An asynchronous SPARQL client library using aiohttp
https://github.com/aio-libs/aiosparql
Last synced: 6 months ago
JSON representation
An asynchronous SPARQL client library using aiohttp
- Host: GitHub
- URL: https://github.com/aio-libs/aiosparql
- Owner: aio-libs
- License: apache-2.0
- Created: 2017-04-25T12:10:44.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-08-31T12:41:03.000Z (over 1 year ago)
- Last Synced: 2025-06-29T00:13:44.368Z (7 months ago)
- Language: Python
- Homepage:
- Size: 83 KB
- Stars: 24
- Watchers: 10
- Forks: 11
- Open Issues: 14
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
.. 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 `_.