Metadata-Version: 2.1
Name: aiosparql
Version: 0.12.0
Summary: An asynchronous SPARQL library using aiohttp
Home-page: https://github.com/aio-libs/aiosparql
Maintainer: Cecile Tonglet
Maintainer-email: cecile.tonglet@gmail.com
License: Apache 2
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Other Environment
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: Apache Software License
Requires-Python: >=3.6.0
Requires-Dist: aiohttp (>=3.5.0)

.. 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("<subject>", {
       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/>`_.


