Docs about oracledb client mode

Author: amochin

README.md

@@ -52,6 +52,8 @@ Therefore there are some modules, which are "natively" supported in the library
 ## Python modules currently "natively" supported
 ### Oracle
 - [oracledb](https://oracle.github.io/python-oracledb/)
+    - Both thick and thin client modes are supported - you can select one using the `driverMode` parameter.
+    - However, due to current limitations of the oracledb module, **it's not possible to switch between thick and thin modes during a test execution session** - even in different suites.
 - [cx_Oracle](https://oracle.github.io/python-cx_Oracle/)
 ### MySQL
 - [pymysql](https://github.com/PyMySQL/PyMySQL)

src/DatabaseLibrary/connection_manager.py

@@ -52,6 +52,12 @@ def connect_to_database(
         Loads the DB API 2.0 module given `dbapiModuleName` then uses it to
         connect to the database using `dbName`, `dbUsername`, and `dbPassword`.
 
+        The `driverMode` is used to select the *oracledb* client mode.
+        Allowed values are:
+        - _thin_ (default if omitted)
+        - _thick_
+        - _thick,lib_dir=<PATH_TO_ORACLE_CLIENT>_
+
         Optionally, you can specify a `dbConfigFile` wherein it will load the
         default property values for `dbapiModuleName`, `dbName` `dbUsername`
         and `dbPassword` (note: specifying `dbapiModuleName`, `dbName`

test/tests/custom_db_tests/oracle_thick_mode.robot

@@ -2,6 +2,10 @@
 Documentation    Tests of switching between thin and thick mode of oracledb client.
 ...    Require the oracle client libraries installed.
 ...    See more here: https://python-oracledb.readthedocs.io/en/latest/user_guide/initialization.html#initialization
+...
+...    Due to current limitations of the oracledb module it's not possible to switch between thick and thin modes
+...    during a test execution session - even in different suites.
+...    So theses tests should be run separated only.
 
 Resource    ../../resources/common.resource
 Test Teardown    Drop Tables And Disconnect