Add example for bearer auth (#623)

Additionally turning the kerberos example from being skipped into a mock test
to at least catch changes in the driver's API

Author: robsdedude

tests/integration/examples/test_bearer_auth_example.py

@@ -0,0 +1,64 @@
+#!/usr/bin/env python
+# -*- encoding: utf-8 -*-
+
+# Copyright (c) "Neo4j"
+# Neo4j Sweden AB [http://neo4j.com]
+#
+# This file is part of Neo4j.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+import pytest
+
+import neo4j
+# tag::bearer-auth-import[]
+from neo4j import (
+    bearer_auth,
+    GraphDatabase,
+)
+# end::bearer-auth-import[]
+
+from tests.integration.examples import DriverSetupExample
+
+
+# python -m pytest tests/integration/examples/test_bearer_auth_example.py -s -v
+
+
+class BearerAuthExample(DriverSetupExample):
+
+    # tag::bearer-auth[]
+    def __init__(self, uri, token):
+        self.driver = GraphDatabase.driver(uri, auth=bearer_auth(token))
+    # end::bearer-auth[]
+
+
+def test_example(uri, mocker):
+    # Currently, there is no way of running the test against a server with SSO
+    # setup.
+    mocker.patch("neo4j.GraphDatabase.bolt_driver")
+    mocker.patch("neo4j.GraphDatabase.neo4j_driver")
+
+    token = "myToken"
+    BearerAuthExample(uri, token)
+    calls = (neo4j.GraphDatabase.bolt_driver.call_args_list
+             + neo4j.GraphDatabase.neo4j_driver.call_args_list)
+    assert len(calls) == 1
+    args_, kwargs = calls[0]
+    auth = kwargs.get("auth")
+    assert isinstance(auth, neo4j.Auth)
+    assert auth.scheme == "bearer"
+    assert not hasattr(auth, "principal")
+    assert auth.credentials == token
+    assert not hasattr(auth, "parameters")
+

tests/integration/examples/test_kerberos_auth_example.py

@@ -19,8 +19,7 @@
 # limitations under the License.
 
 
-import pytest
-
+import neo4j
 # tag::kerberos-auth-import[]
 from neo4j import (
     GraphDatabase,
@@ -40,5 +39,21 @@ def __init__(self, uri, ticket):
     # end::kerberos-auth[]
 
 
-def test_example():
-    pytest.skip("Currently no way to test Kerberos auth")
+def test_example(uri, mocker):
+    # Currently, there is no way of running the test against a server with SSO
+    # setup.
+    mocker.patch("neo4j.GraphDatabase.bolt_driver")
+    mocker.patch("neo4j.GraphDatabase.neo4j_driver")
+
+    ticket = "myTicket"
+    KerberosAuthExample(uri, ticket)
+    calls = (neo4j.GraphDatabase.bolt_driver.call_args_list
+             + neo4j.GraphDatabase.neo4j_driver.call_args_list)
+    assert len(calls) == 1
+    args_, kwargs = calls[0]
+    auth = kwargs.get("auth")
+    assert isinstance(auth, neo4j.Auth)
+    assert auth.scheme == "kerberos"
+    assert auth.principal == ""
+    assert auth.credentials == ticket
+    assert not hasattr(auth, "parameters")