Spelling updates from John Bampton (#479).

anthony-tuininga · anthony-tuininga · commit 475a51b1dd7a · 2025-04-04T09:15:31.000-06:00
diff --git a/README.md b/README.md
@@ -59,7 +59,7 @@ Examples can be found in the [/samples][samples] directory and the
 
 ## Help
 
-Questions can be asked in [Github Discussions][ghdiscussions].
+Questions can be asked in [GitHub Discussions][ghdiscussions].
 
 Problem reports can be raised in [GitHub Issues][ghissues].
 
diff --git a/doc/src/api_manual/module.rst b/doc/src/api_manual/module.rst
@@ -2664,7 +2664,7 @@ Oracledb Methods
     are parsed by python-oracledb itself and a generated connect descriptor is
     sent to the Oracle Client libraries. This value is only used in the
     python-oracledb Thick mode. The default value is
-    :attr:`defualts.thick_mode_dsn_passthrough`. For more information, see
+    :attr:`defaults.thick_mode_dsn_passthrough`. For more information, see
     :ref:`usingconfigfiles`.
 
     The ``extra_auth_params`` parameter is expected to be a dictionary
diff --git a/doc/src/release_notes.rst b/doc/src/release_notes.rst
@@ -29,6 +29,9 @@ Thick Mode Changes
 Common Changes
 ++++++++++++++
 
+#)  Miscellaneous grammar and spelling fixes by John Bampton
+    (`PR 479 <https://github.com/oracle/python-oracledb/pull/479>`__).
+
 
 oracledb 3.1.0 (April 2025)
 ---------------------------
@@ -342,7 +345,7 @@ Thin Mode Changes
     connection string.
 #)  Added :meth:`oracledb.enable_thin_mode()` as a means of enabling
     python-oracledb Thin mode without waiting for an initial connection to be
-    succesfully established. Since python-oracledb defaults to Thin mode, this
+    successfully established. Since python-oracledb defaults to Thin mode, this
     method is mostly useful for applications with multiple threads concurrently
     creating connections to databases when the application starts
     (`issue 408 <https://github.com/oracle/python-oracledb/issues/408>`__).
@@ -1719,7 +1722,7 @@ cx_Oracle 8.2 (May 2021)
     connection.
 #)  Eliminated a memory leak when calling :meth:`SodaOperation.filter()` with a
     dictionary.
-#)  The distributed transaction handle assosciated with the connection is now
+#)  The distributed transaction handle associated with the connection is now
     cleared on commit or rollback (`issue 530
     <https://github.com/oracle/python-cx_Oracle/issues/530>`__).
 #)  Added a check to ensure that when setting variables or object attributes,
diff --git a/doc/src/user_guide/appendix_b.rst b/doc/src/user_guide/appendix_b.rst
@@ -148,7 +148,7 @@ differs from the python-oracledb Thick mode in the following ways:
   ``handle`` parameters.  The parameters that are ignored in the Thick mode
   include ``wallet_password``, ``disable_oob``, and ``debug_jdwp`` parameters.
 
-* The python-oracledb Thin mode only suppports :ref:`homogeneous
+* The python-oracledb Thin mode only supports :ref:`homogeneous
   <connpooltypes>` pools.
 
 * The python-oracledb Thin mode creates connections in a daemon thread and so
diff --git a/doc/src/user_guide/connection_handling.rst b/doc/src/user_guide/connection_handling.rst
@@ -2512,7 +2512,7 @@ The :meth:`Connection.is_healthy()` method is an alternative to
 it does not perform a full connection check.
 
 If the ``getmode`` parameter in :meth:`oracledb.create_pool()` is set to
-:data:`oracledb.POOL_GETMODE_TIMEDWAIT`, then the maxium amount of time an
+:data:`oracledb.POOL_GETMODE_TIMEDWAIT`, then the maximum amount of time an
 :meth:`~ConnectionPool.acquire()` call will wait to get a connection from the
 pool is limited by the value of the :data:`ConnectionPool.wait_timeout`
 parameter.  A call that cannot be immediately satisfied will wait no longer
diff --git a/doc/src/user_guide/exception_handling.rst b/doc/src/user_guide/exception_handling.rst
@@ -84,7 +84,7 @@ in the examples below:
     DPY-4010: a bind variable replacement value for placeholder ":1" was not provided
 
 * Connection messages: The python-oracledb Thin mode connection and networking
-  is handled by Python itself.  Some errors portable accross operating systems
+  is handled by Python itself.  Some errors portable across operating systems
   and Python versions have DPY-prefixed errors displayed by python-oracledb.
   Other messages are returned directly from Python and may vary accordingly.
   The traditional Oracle connection errors with prefix "ORA" are not shown. For
diff --git a/doc/src/user_guide/extending.rst b/doc/src/user_guide/extending.rst
@@ -16,7 +16,7 @@ Subclassing Connections
 =======================
 
 Subclassing enables applications to change python-oracledb, for example by
-extending connection and statement execution behvior. This can be used to
+extending connection and statement execution behavior. This can be used to
 alter, or log, connection and execution parameters, or to further change
 python-oracledb functionality.
 
@@ -220,7 +220,7 @@ strings prefixed with "myprefix://".
         In myhookfunc: protocol=myprefix arg=localhost/orclpdb1
         host=localhost, port=1521, service name=orclpdb1
 
-7. To uninstall the plugin, simply remove the packge::
+7. To uninstall the plugin, simply remove the package::
 
        python -m pip uninstall myplugin
 
diff --git a/doc/src/user_guide/initialization.rst b/doc/src/user_guide/initialization.rst
@@ -317,7 +317,7 @@ going to be used.  In one special case, you may wish to explicitly enable Thin
 mode to prevent Thick mode from being enabled later.
 
 To allow application portability, the driver's internal logic allows
-applications to initally attempt :ref:`standalone connection
+applications to initially attempt :ref:`standalone connection
 <standaloneconnection>` creation in Thin mode, but then lets them :ref:`enable
 Thick mode <enablingthick>` if that connection is unsuccessful.  An example is
 when trying to connect to an Oracle Database that turns out to be an old
diff --git a/samples/bind_insert.py b/samples/bind_insert.py
@@ -86,7 +86,7 @@
 # Inserting a single bind still needs tuples
 # -----------------------------------------------------------------------------
 
-rows = [("Eleventh",), ("Twelth",)]
+rows = [("Eleventh",), ("Twelfth",)]
 
 with connection.cursor() as cursor:
     cursor.executemany("insert into mytab(id, data) values (12, :1)", rows)
diff --git a/samples/bind_insert_async.py b/samples/bind_insert_async.py
@@ -92,7 +92,7 @@ async def main():
     # Inserting a single bind still needs tuples
     # -------------------------------------------------------------------------
 
-    rows = [("Eleventh",), ("Twelth",)]
+    rows = [("Eleventh",), ("Twelfth",)]
 
     await connection.executemany(
         "insert into mytab(id, data) values (12, :1)", rows
diff --git a/samples/containers/app_dev/README.md b/samples/containers/app_dev/README.md
@@ -23,7 +23,7 @@ It has been tested on macOS using podman and docker.
 
   By default, Apache has SSL enabled and is listening on port 8443.
 
-## Usage for Application Devlopment
+## Usage for Application Development
 
 - Run a container:
 
diff --git a/samples/cqn.py b/samples/cqn.py
@@ -55,7 +55,7 @@ def callback(message):
         registered = False
         return
     print("Message database name:", message.dbname)
-    print("Message tranasction id:", message.txid)
+    print("Message transaction id:", message.txid)
     print("Message queries:")
     for query in message.queries:
         print("--> Query ID:", query.id)
diff --git a/samples/database_change_notification.py b/samples/database_change_notification.py
@@ -55,7 +55,7 @@ def callback(message):
         registered = False
         return
     print("Message database name:", message.dbname)
-    print("Message tranasction id:", message.txid)
+    print("Message transaction id:", message.txid)
     print("Message tables:")
     for table in message.tables:
         print("--> Table Name:", table.name)
diff --git a/samples/json_blob.py b/samples/json_blob.py
@@ -57,7 +57,7 @@
     client_version = oracledb.clientversion()[0]
 db_version = int(connection.version.split(".")[0])
 
-# Minimum database vesion is 12
+# Minimum database version is 12
 if db_version < 12:
     sys.exit("This example requires Oracle Database 12.1.0.2 or later")
 
diff --git a/samples/json_blob_async.py b/samples/json_blob_async.py
@@ -54,7 +54,7 @@ async def main():
         params=sample_env.get_connect_params(),
     )
 
-    # Minimum database vesion is 12
+    # Minimum database version is 12
     db_version = int(connection.version.split(".")[0])
     if db_version < 12:
         sys.exit("This example requires Oracle Database 12.1.0.2 or later")
diff --git a/samples/tutorial/Python-and-Oracle-Database-The-New-Wave-of-Scripting.html b/samples/tutorial/Python-and-Oracle-Database-The-New-Wave-of-Scripting.html
@@ -860,7 +860,7 @@ <h4>2.2 Connection pool experiments</h4>
     <code>numberOfThreads</code>. </p>
 
     <p>Try changing <code>getmode</code> to
-    <code>oracledb.POOL_GETMODE_NOWAIT</code>, reducing the maxium pool size to
+    <code>oracledb.POOL_GETMODE_NOWAIT</code>, reducing the maximum pool size to
     2, and increasing the number of threads to 3.  When
     <code>number_of_threads</code> exceeds the maximum size of the pool, the
     <code>acquire()</code> call will now generate an error such as
@@ -1073,7 +1073,7 @@ <h4>2.5 More DRCP investigation</h4>
     <code>oracledb.PURITY_NEW</code> to see the effect on the DRCP NUM_MISSES
     statistic.</p>
 
-    <p>Another experiement is to include the <code>time</code> module at the
+    <p>Another experiment is to include the <code>time</code> module at the
     file top:</p>
 
     <pre>
@@ -2496,7 +2496,7 @@ <h4>12.1 How to bind named objects</h4>
 
 <p>This uses <code>gettype()</code> to get the database types of the SDO
 and its object attributes. The <code>newobject()</code> calls create
-Python representations of those objects. The python object atributes are
+Python representations of those objects. The python object attributes are
 then set.  Oracle VARRAY types such as SDO_ELEM_INFO_ARRAY are set with
 <code>extend()</code>.</p>
 
@@ -3230,7 +3230,7 @@ <h2> <a name="pipelining">18. Pipelining multiple operations</a></h2>
 </pre>
 
     <p>Connection is established using <code>oracledb.connect_async()</code>.
-    Asynchronous methods are awated.</p>
+    Asynchronous methods are awaited.</p>
 
     <p>The script creates a pipeline with <code>create_pipeline()</code> and
     adds two database operations.  The use of <code>asyncio.gather()</code>
@@ -3265,7 +3265,7 @@ <h2> <a name="thick">19. Python-oracledb Thick mode</a></h2>
 connectivity to Oracle Database.  There are some additional features these
 libraries provide which are therefore only available in python-oracledb Thick
 mode. The next example shows one of these. Other Oracle Database features that
-require python-oracledb Thick mode include Application Continurity, and
+require python-oracledb Thick mode include Application Continuity, and
 Continuous Query Notification. <em>Documentation link for further reading: <a
 href="https://python-oracledb.readthedocs.io/en/latest/user_guide/initialization.html#enabling-python-oracledb-thick-mode"
 >Enabling python-oracledb Thick mode</a></em>.</p>
@@ -3785,7 +3785,7 @@ <h4>Modules</h4>
 These can be installed from PyPI, for example from <a
 href="https://pypi.org/project/oracledb/" >pypi.org/project/oracledb/</a> (as
 shown in the tutorial <a href="#setup" >setup</a> instructions). In some
-enviroments you may prefer to install using a package repository such as <a
+environments you may prefer to install using a package repository such as <a
 href="https://yum.oracle.com/oracle-linux-python.html" >yum.oracle.com</a> for
 Oracle Linux.</p>
 
diff --git a/samples/tutorial/setup_tutorial.py b/samples/tutorial/setup_tutorial.py
@@ -35,7 +35,7 @@
     user=db_config.user, password=db_config.pw, dsn=db_config.dsn
 )
 
-# create sample schemas and defintions for the tutorial
+# create sample schemas and definitions for the tutorial
 print("Setting up the sample tables and other DB objects for the tutorial...")
 run_sql_script.run_sql_script(
     con, "setup_tutorial", user=db_config.user, pw=db_config.pw
diff --git a/setup.py b/setup.py
@@ -78,7 +78,7 @@
 thin_depends.append(base_pxd)
 
 # if the platform is macOS:
-#  - target the minimim OS version that current Python packages work with.
+#  - target the minimum OS version that current Python packages work with.
 #    (Use 'otool -l /path/to/python' and look for 'version' in the
 #    LC_VERSION_MIN_MACOSX section)
 #  - add argument required for cross-compilation for both x86_64 and arm64
diff --git a/src/oracledb/driver_mode.py b/src/oracledb/driver_mode.py
@@ -127,7 +127,7 @@ def is_thin_mode() -> bool:
     oracledb.init_oracle_client() is called successfully, then a subsequent
     call to is_thin_mode() will return False indicating that Thick mode is
     enabled.  Once the first standalone connection or connection pool is
-    created succesfully, or a call to oracledb.init_oracle_client() is made
+    created successfully, or a call to oracledb.init_oracle_client() is made
     successfully, then python-oracledb's mode is fixed and the value returned
     by is_thin_mode() will never change for the lifetime of the process.
 
