Merge pull request #1041 from dwinston/add-service-clause-to-docs

Add SERVICE clause to documentation

docs/intro_to_sparql.rst

@@ -71,6 +71,35 @@ Variables can also be pre-bound, using ``initBindings`` kwarg can be
 used to pass in a ``dict`` of initial bindings, this is particularly
 useful for prepared queries, as described below.
 
+Query a Remote Service
+^^^^^^^^^^^^^^^^^^^^^^
+
+The SERVICE keyword of SPARQL 1.1 can send a query to a remote SPARQL endpoint.
+
+.. code-block:: python
+
+    import rdflib
+
+    g = rdflib.Graph()
+    qres = g.query('''
+    SELECT ?s
+    WHERE {
+      SERVICE <http://dbpedia.org/sparql> {
+        ?s <http://purl.org/linguistics/gold/hypernym> <http://dbpedia.org/resource/Leveller> .
+      }
+    } LIMIT 3''')
+    for row in qres:
+        print(row.s)
+
+This example sends a query to `DBPedia
+<https://dbpedia.org/>`_'s SPARQL endpoint service so that it can run the query and then send back the result:
+
+.. code-block:: text
+
+    http://dbpedia.org/resource/Elizabeth_Lilburne
+    http://dbpedia.org/resource/Thomas_Prince_(Leveller)
+    http://dbpedia.org/resource/John_Lilburne
+
 Prepared Queries
 ^^^^^^^^^^^^^^^^
 

rdflib/plugins/sparql/evaluate.py

@@ -277,7 +277,7 @@ def evalPart(ctx, part):
 def evalServiceQuery(ctx, part):
     res = {}
     match = re.match('^service <(.*)>[ \n]*{(.*)}[ \n]*$',
-                     part.get('service_string', ''), re.DOTALL)
+                     part.get('service_string', ''), re.DOTALL | re.I)
 
     if match:
         service_url = match.group(1)

test/test_sparql_service.py

@@ -99,6 +99,7 @@ def test_service_with_implicit_select_and_prefix():
     for r in results:
         assert len(r) == 3
 
+
 def test_service_with_implicit_select_and_base():
     g = Graph()
     q = '''base <http://example.org/>
@@ -116,6 +117,20 @@ def test_service_with_implicit_select_and_base():
         assert len(r) == 3
 
 
+def test_service_with_implicit_select_and_allcaps():
+    g = Graph()
+    q = '''SELECT ?s
+    WHERE
+    {
+      SERVICE <http://dbpedia.org/sparql>
+      {
+        ?s <http://purl.org/linguistics/gold/hypernym> <http://dbpedia.org/resource/Leveller> .
+      }
+    } LIMIT 3'''
+    results = g.query(q)
+    assert len(results) == 3
+
+
 #def test_with_fixture(httpserver):
 #    httpserver.expect_request("/sparql/?query=SELECT * WHERE ?s ?p ?o").respond_with_json({"vars": ["s","p","o"], "bindings":[]})
 #    test_server = httpserver.url_for('/sparql')