Rename samples and test files in order to be consistent.

Author: anthony-tuininga

doc/src/api_manual/cursor.rst

@@ -68,7 +68,7 @@ Cursor Object
     contiguous keys. For PL/SQL associative arrays with sparsely populated keys
     or for varrays and nested tables, the approach shown in this
     `example <https://github.com/oracle/python-cx_Oracle/blob/master/
-    samples/PLSQLCollection.py>`__ needs to be used.
+    samples/plsql_collection.py>`__ needs to be used.
 
     .. note::
 

doc/src/release_notes.rst

@@ -1001,10 +1001,10 @@ Version 6.0 beta 1 (April 2017)
 #)  Added parameter edition to the :meth:`cx_Oracle.SessionPool` method.
 #)  Added support for
     `universal rowids <https://github.com/oracle/python-cx_Oracle/blob/master/
-    samples/UniversalRowids.py>`__.
+    samples/universal_rowids.py>`__.
 #)  Added support for `DML Returning of multiple rows
     <https://github.com/oracle/python-cx_Oracle/blob/master/samples/
-    DMLReturningMultipleRows.py>`__.
+    dml_returning_multiple_rows.py>`__.
 #)  Added attributes :attr:`Variable.actualElements` and
     :attr:`Variable.values` to variables.
 #)  Added parameters region, sharding_key and super_sharding_key to the
@@ -1033,19 +1033,19 @@ Version 6.0 beta 1 (April 2017)
 #)  Dropped deprecated parameters action, module and clientinfo from the
     :meth:`cx_Oracle.connect` method. The appcontext parameter should be used
     instead as shown in this `sample <https://github.com/oracle/
-    python-cx_Oracle/blob/master/samples/AppContext.py>`__.
+    python-cx_Oracle/blob/master/samples/app_context.py>`__.
 #)  Dropped deprecated attribute numbersAsString from
     :ref:`cursor objects <cursorobj>`. Use an output type handler instead as
     shown in this `sample <https://github.com/oracle/python-cx_Oracle/blob/
-    master/samples/ReturnNumbersAsDecimals.py>`__.
+    master/samples/return_numbers_as_decimals.py>`__.
 #)  Dropped deprecated attributes cqqos and rowids from
     :ref:`subscription objects <subscrobj>`. Use the qos attribute instead as
     shown in this `sample <https://github.com/oracle/python-cx_Oracle/blob/
-    master/samples/CQN.py>`__.
+    master/samples/cqn.py>`__.
 #)  Dropped deprecated parameters cqqos and rowids from the
     :meth:`Connection.subscribe()` method. Use the qos parameter instead as
     shown in this `sample <https://github.com/oracle/python-cx_Oracle/blob/
-    master/samples/CQN.py>`__.
+    master/samples/cqn.py>`__.
 
 
 Version 5.3 (March 2017)

doc/src/user_guide/cqn.rst

@@ -153,5 +153,5 @@ which should print something like the following::
     INSERT of rowid: AAA7EsAAHAAAFS/AAA
 
 See `GitHub Samples
-<https://github.com/oracle/python-cx_Oracle/blob/master/samples/CQN.py>`__
+<https://github.com/oracle/python-cx_Oracle/blob/master/samples/cqn.py>`__
 for a runnable CQN example.

doc/src/user_guide/ha.rst

@@ -213,4 +213,4 @@ In the Python application code:
 
 See the `Transaction Guard Sample
 <https://github.com/oracle/python-cx_Oracle/blob/master/
-samples/TransactionGuard.py>`__ for further details.
+samples/transaction_guard.py>`__ for further details.

doc/src/user_guide/sql_execution.rst

@@ -289,7 +289,7 @@ should be used.
 
 Examples of output handlers are shown in :ref:`numberprecision`,
 :ref:`directlobs` and :ref:`fetching-raw-data`.  Also see samples such as `samples/TypeHandlers.py
-<https://github.com/oracle/python-cx_Oracle/blob/master/samples/TypeHandlers.py>`__
+<https://github.com/oracle/python-cx_Oracle/blob/master/samples/type_handlers.py>`__
 
 .. _numberprecision:
 
@@ -340,8 +340,8 @@ The Python ``decimal.Decimal`` converter gets called with the string
 representation of the Oracle number.  The output from ``decimal.Decimal`` is
 returned in the output tuple.
 
-See `samples/ReturnNumbersAsDecimals.py
-<https://github.com/oracle/python-cx_Oracle/blob/master/samples/ReturnNumbersAsDecimals.py>`__
+See `samples/return_numbers_as_decimals.py
+<https://github.com/oracle/python-cx_Oracle/blob/master/samples/return_numbers_as_decimals.py>`__
 
 
 .. _fetching-raw-data:

doc/src/user_guide/tracing_sql.rst

@@ -66,7 +66,7 @@ In production applications be careful not to log sensitive information.
 
 See `Subclassing.py
 <https://github.com/oracle/python-cx_Oracle/blob/master/
-samples/Subclassing.py>`__ for an example.
+samples/subclassing.py>`__ for an example.
 
 
 .. _endtoendtracing:

samples/README.md

@@ -3,43 +3,43 @@
 This directory contains samples for [cx_Oracle][6].  Documentation is [here][7].
 
 1. The schemas and SQL objects that are referenced in the samples can be
-   created by running the Python script [SetupSamples.py][1]. The script
+   created by running the Python script [setup_samples.py][1]. The script
    requires SYSDBA privileges and will prompt for these credentials as well as
    the names of the schemas and edition that will be created, unless a number
    of environment variables are set as documented in the Python script
    [sample_env.py][2]. Run the script using the following command:
 
-       python SetupSamples.py
+       python setup_samples.py
 
    Alternatively, the [SQL script][3] can be run directly via SQL\*Plus, which
    will always prompt for the names of the schemas and edition that will be
    created.
 
-       sqlplus sys/syspassword@hostname/servicename @sql/SetupSamples.sql
+       sqlplus sys/syspassword@hostname/servicename @sql/setup_samples.sql
 
 2. Run a Python script, for example:
 
         python Query.py
 
 3. After running cx_Oracle samples, the schemas and SQL objects can be
-   dropped by running the Python script [DropSamples.py][4]. The script
+   dropped by running the Python script [drop_samples.py][4]. The script
    requires SYSDBA privileges and will prompt for these credentials as well as
    the names of the schemas and edition that will be dropped, unless a number
    of environment variables are set as documented in the Python script
    [sample_env.py][2]. Run the script using the following command:
 
-       python DropSamples.py
+       python drop_samples.py
 
    Alternatively, the [SQL script][5] can be run directly via SQL\*Plus, which
    will always prompt for the names of the schemas and edition that will be
    dropped.
 
-       sqlplus sys/syspassword@hostname/servicename @sql/DropSamples.sql
+       sqlplus sys/syspassword@hostname/servicename @sql/drop_samples.sql
 
-[1]: https://github.com/oracle/python-cx_Oracle/blob/master/samples/SetupSamples.py
-[2]: https://github.com/oracle/python-cx_Oracle/blob/master/samples/SampleEnv.py
-[3]: https://github.com/oracle/python-cx_Oracle/blob/master/samples/sql/SetupSamples.sql
-[4]: https://github.com/oracle/python-cx_Oracle/blob/master/samples/DropSamples.py
-[5]: https://github.com/oracle/python-cx_Oracle/blob/master/samples/sql/DropSamples.sql
+[1]: https://github.com/oracle/python-cx_Oracle/blob/master/samples/setup_samples.py
+[2]: https://github.com/oracle/python-cx_Oracle/blob/master/samples/sample_env.py
+[3]: https://github.com/oracle/python-cx_Oracle/blob/master/samples/sql/setup_samples.sql
+[4]: https://github.com/oracle/python-cx_Oracle/blob/master/samples/drop_samples.py
+[5]: https://github.com/oracle/python-cx_Oracle/blob/master/samples/sql/drop_samples.sql
 [6]: https://oracle.github.io/python-cx_Oracle/
 [7]: http://cx-oracle.readthedocs.org/en/latest/index.html

samples/AppContext.py renamed to samples/app_context.py

@@ -1,5 +1,5 @@
 #------------------------------------------------------------------------------
-# Copyright (c) 2016, 2020, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved.
 #
 # Portions Copyright 2007-2015, Anthony Tuininga. All rights reserved.
 #
@@ -8,7 +8,7 @@
 #------------------------------------------------------------------------------
 
 #------------------------------------------------------------------------------
-# AppContext.py
+# app_context.py
 #   This script demonstrates the use of application context. Application
 # context is available within logon triggers and can be retrieved by using the
 # function sys_context().

samples/AdvancedQueuingNotification.py renamed to samples/aq_notification.py

@@ -1,13 +1,13 @@
 #------------------------------------------------------------------------------
-# Copyright (c) 2018, 2020, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2018, 2021, Oracle and/or its affiliates. All rights reserved.
 #------------------------------------------------------------------------------
 
 #------------------------------------------------------------------------------
-# AdvancedQueuingNotification.py
+# aq_notification.py
 #   This script demonstrates using advanced queuing notification. Once this
 # script is running, use another session to enqueue a few messages to the
 # "DEMO_BOOK_QUEUE" queue. This is most easily accomplished by running the
-# ObjectAQ.py sample.
+# object_aq.py sample.
 #
 # This script requires cx_Oracle 6.4 and higher.
 #------------------------------------------------------------------------------

samples/ArrayDMLRowCounts.py renamed to samples/array_dml_rowcounts.py

@@ -1,9 +1,9 @@
 #------------------------------------------------------------------------------
-# Copyright (c) 2016, 2020, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2021, Oracle and/or its affiliates. All rights reserved.
 #------------------------------------------------------------------------------
 
 #------------------------------------------------------------------------------
-# ArrayDMLRowCounts.py
+# array_dml_rowcounts.py
 #
 # Demonstrate the use of the 12.1 feature that allows cursor.executemany()
 # to return the number of rows affected by each individual execution as a list.