Add sample for using the call timeout feature available with cx_Oracle 7.0 and

Oracle Client 18.1 and higher.

doc/src/connection.rst

@@ -74,6 +74,8 @@ Connection Object
     that a single round-trip to the database may take before a timeout will
     occur. A value of 0 means that no timeout will take place.
 
+    .. versionadded:: 7.0
+
     .. note::
 
         This attribute is an extension to the DB API definition and is only

samples/CallTimeout.py

@@ -0,0 +1,39 @@
+#------------------------------------------------------------------------------
+# Copyright (c) 2019, Oracle and/or its affiliates. All rights reserved.
+#------------------------------------------------------------------------------
+
+#------------------------------------------------------------------------------
+# CallTimeout.py
+#
+# Demonstrate the use of the Oracle Client 18c feature that enables round trips
+# to the database to time out if a specified amount of time (in milliseconds)
+# has passed without a response from the database.
+#
+# This script requires cx_Oracle 7.0 and higher and Oracle Client 18.1 and
+# higher.
+#------------------------------------------------------------------------------
+
+from __future__ import print_function
+
+import cx_Oracle
+import SampleEnv
+
+connection = cx_Oracle.connect(SampleEnv.GetMainConnectString())
+connection.callTimeout = 2000
+print("Call timeout set at", connection.callTimeout, "milliseconds...")
+
+cursor = connection.cursor()
+cursor.execute("select sysdate from dual")
+today, = cursor.fetchone()
+print("Fetch of current date before timeout:", today)
+
+print("Sleeping...should time out...")
+try:
+    cursor.callproc("dbms_lock.sleep", (3,))
+except cx_Oracle.DatabaseError as e:
+    print("ERROR:", e)
+
+cursor.execute("select sysdate from dual")
+today, = cursor.fetchone()
+print("Fetch of current date after timeout:", today)
+