SDK changes for 5.4.x versions

1. Drop support for Python 2.7
2. Add new protocol version and API that is enabled by that protocol
3. Add default, and per-request namespace option for on-prem use only
4. Cleanup driven by PyCharm

Author: gmfeinberg

CHANGELOG.rst

@@ -4,14 +4,39 @@ All notable changes to this project will be documented in this file.
 
 The format is based on `Keep a Changelog <http://keepachangelog.com/>`_.
 ====================
-Unreleased
+
+Unpublished
 ====================
 
+NOTE: will be 5.4.x -- drop Python 2.7 support
+
 Added
 _____
-
 * Cloud only: New regions: mx-monterrey-1, eu-frankfurt-2,
   eu-madrid-2, eu-jovanovac-1, us-dcc-phoenix-4
+* Support for new, flexible wire protocol (V4) has been added. The previous protocol
+is still supported for communication with servers that do not yet support V4. The
+version negotation is internal and automatic; however, use of V4 features will fail
+at runtime when attempted with an older server. Failure may be an empty or
+undefined result or an exception if the request cannot be serviced at all. The following
+new features or interfaces depend on the new protocol version
+ * added set/get_durability to QueryRequest for queries that modify data
+ * added pagination information to TableUsageResult and TableUsageRequest
+ * added shard percent usage information to TableUsageResult
+ * added IndexInfo.get_field_types to return the type information on an index on a JSON
+field
+ * added the ability to ask for and receive the schema of a query using
+     * PrepareRequest.set_get_query_schema
+     * PreparedStatement.get_query_schema
+ * Cloud only: added use of ETags, DefinedTags and FreeFormTags in TableRequest and TableResult
+* On-premises only. Added support for default namespace and per-request namespace
+  specification
+
+
+Changed
+_______
+
+* Dropped support for Python 2.x
 
 ====================
  5.3.7 - 2022-12-12

README.rst

@@ -5,7 +5,7 @@ Oracle NoSQL Database Python SDK
 About
 =====
 
-This is the Python SDK for Oracle NoSQL Database. Python 2.7+ and 3.5+ are
+This is the Python SDK for Oracle NoSQL Database. Python versions 3.5+ are
 supported. The SDK provides interfaces, documentation, and examples to help
 develop Python applications that connect to the Oracle NoSQL Database Cloud
 Service, Oracle NoSQL Database and to the Oracle NoSQL Cloud Simulator (which
@@ -130,7 +130,7 @@ that the *borneo* package has been installed.
     # which has a number of additional operations.
     #
     # Requirements:
-    #  1. Python 2.7 or 3.5+
+    #  1. Python 3.5+
     #  2. Python dependencies (install using pip or other mechanism):
     #   o requests
     #   o oci (only if running against the Cloud Service)

build_spec.yaml

@@ -1,3 +1,4 @@
+#file: noinspection Annotator
 # Copyright (c) 2023, 2022, Oracle and/or its affiliates.
 
 version: 0.1

docs/conf.py

@@ -24,6 +24,7 @@
 # -- Project information -----------------------------------------------------
 
 project = u'NoSQL Database Python SDK'
+# noinspection PyShadowingBuiltins
 copyright = u'2018, 2023 Oracle'
 author = u'Oracle'
 

examples/config.py

@@ -22,4 +22,4 @@
 endpoint = 'localhost:8080'
 
 # The server type.
-server_type = 'cloudsim'
+server_type = 'cloudsim'

examples/multi_data_ops.py

@@ -25,7 +25,7 @@
 # has a number of additional operations.
 #
 # Requirements:
-#  1. Python 2.7 or 3.5+
+#  1. Python 3.5+
 #  2. Python dependencies (install using pip or other mechanism):
 #   o requests
 #  3. If running against the Cloud Simulator, it can be downloaded from here:

examples/rate_limiting.py

@@ -25,7 +25,7 @@
 # has a number of additional operations.
 #
 # Requirements:
-#  1. Python 2.7 or 3.5+
+#  1. Python 3.5+
 #  2. Python dependencies (install using pip or other mechanism):
 #   o requests
 #  3. If running against the Cloud Simulator, it can be downloaded from here:

examples/single_data_ops.py

@@ -25,7 +25,7 @@
 # has a number of additional operations.
 #
 # Requirements:
-#  1. Python 2.7 or 3.5+
+#  1. Python 3.5+
 #  2. Python dependencies (install using pip or other mechanism):
 #   o requests
 #  3. If running against the Cloud Simulator, it can be downloaded from here:

examples/table_ops.py

@@ -25,7 +25,7 @@
 # has a number of additional operations.
 #
 # Requirements:
-#  1. Python 2.7 or 3.5+
+#  1. Python 3.5+
 #  2. Python dependencies (install using pip or other mechanism):
 #   o requests
 #  3. If running against the Cloud Simulator, it can be downloaded from here:

setup.py

@@ -43,9 +43,9 @@ def open_relative(*path):
 
     # Version should match the system release, but may vary as patches
     # are created.
-    version=version,
+    version=str(version),
     description='Oracle NoSQL Database Python SDK',
-    long_description=readme,
+    long_description=str(readme),
     long_description_content_type='text/x-rst',
 
     author='Oracle',
@@ -73,7 +73,6 @@ def open_relative(*path):
         'License :: OSI Approved :: Universal Permissive License (UPL)',
 
         # Supported Python versions
-        'Programming Language :: Python :: 2.7',
         'Programming Language :: Python :: 3.5',
         'Programming Language :: Python :: 3.6',
         'Programming Language :: Python :: 3.7',