Added mode cx_Oracle.DEFAULT_AUTH as requested

(https://github.com/oracle/python-cx_Oracle/issues/293) and adjusted
documentation for other cases that specified None where None is not actually
a valid value.

doc/src/module.rst

@@ -36,16 +36,17 @@ Module Interface
         This method is an extension to the DB API definition.
 
 
-.. function:: Connection(user=None, password=None, dsn=None, mode=None, \
+.. function:: Connection(user=None, password=None, dsn=None, \
-        handle=None, pool=None, threaded=False, events=False, cclass=None, \
+        mode=cx_Oracle.DEFAULT_AUTH, handle=0, pool=None, threaded=False, \
-        purity=None, newpassword=None, encoding=None, nencoding=None, \
+        events=False, cclass=None, purity=cx_Oracle.ATTR_PURITY_DEFAULT, \
-        edition=None, appcontext=[], tag=None, matchanytag=False, \
-        shardingkey=[], supershardingkey=[])
-    connect(user=None, password=None, dsn=None, mode=None, handle=None, \
-        pool=None, threaded=False, events=False, cclass=None, purity=None, \
         newpassword=None, encoding=None, nencoding=None, edition=None, \
-        appcontext=[], tag=None, matchanytag=None, shardingkey=[], \
+        appcontext=[], tag=None, matchanytag=False, shardingkey=[], \
         supershardingkey=[])
+    connect(user=None, password=None, dsn=None, mode=cx_Oracle.DEFAULT_AUTH, \
+        handle=0, pool=None, threaded=False, events=False, cclass=None, \
+        purity=cx_Oracle.ATTR_PURITY_DEFAULT, newpassword=None, \
+        encoding=None, nencoding=None, edition=None, appcontext=[], tag=None, \
+        matchanytag=None, shardingkey=[], supershardingkey=[])
 
     Constructor for creating a connection to the database. Return a
     :ref:`connection object <connobj>`. All parameters are optional and can be
@@ -57,12 +58,9 @@ Module Interface
     string is assumed which is to be of the format ``user/password@dsn``, the
     same format accepted by Oracle applications such as SQL\*Plus.
 
-    If the mode is specified, it must be one of :data:`~cx_Oracle.SYSDBA`,
+    If the mode is specified, it must be one of the
-    :data:`~cx_Oracle.SYSASM`, :data:`~cx_Oracle.SYSOPER`,
+    :ref:`connection authorization modes<connection-authorization-modes>`
-    :data:`~cx_Oracle.SYSBKP`, :data:`~cx_Oracle.SYSDGD`,
+    which are defined at the module level.
-    :data:`~cx_Oracle.SYSKMT` or :data:`~cx_Oracle.SYSRAC` which are defined
-    at the module level; otherwise, it defaults to the normal mode of
-    connecting.
 
     If the handle is specified, it must be of type OCISvcCtx\* and is only of
     use when embedding Python in an application (like PowerBuilder) which has
@@ -584,6 +582,8 @@ constants used in advanced queuing.
     default value.
 
 
+.. _connection-authorization-modes:
+
 Connection Authorization Modes
 ------------------------------
 
@@ -591,6 +591,11 @@ These constants are extensions to the DB API definition. They are possible
 values for the mode parameter of the :meth:`connect()` method.
 
 
+.. data:: DEFAULT_AUTH
+
+    This constant is used to specify that default authentication is to take
+    place. This is the default value if no mode is passed at all.
+
 .. data:: PRELIM_AUTH
 
     This constant is used to specify that preliminary authentication is to be

src/cxoModule.c

@@ -406,6 +406,7 @@ static PyObject *cxoModule_initialize(void)
         return NULL;
 
     // add constants for authorization modes
+    CXO_ADD_INT_CONSTANT("DEFAULT_AUTH", DPI_MODE_AUTH_DEFAULT)
     CXO_ADD_INT_CONSTANT("SYSASM", DPI_MODE_AUTH_SYSASM)
     CXO_ADD_INT_CONSTANT("SYSBKP", DPI_MODE_AUTH_SYSBKP)
     CXO_ADD_INT_CONSTANT("SYSDBA", DPI_MODE_AUTH_SYSDBA)