feat!: Support Django 4.2

.github/workflows/django_tests_against_emulator0.yml → .github/workflows/django4.2_tests_against_emulator0.yml

@@ -3,7 +3,7 @@ on:
     branches:
       - main
   pull_request:
-name: django-tests0
+name: django4.2-tests0
 jobs:
   system-tests:
     runs-on: ubuntu-latest
@@ -22,11 +22,11 @@ jobs:
         with:
           python-version: 3.8
       - name: Run Django tests
-        run: sh django_test_suite.sh
+        run: sh django_test_suite_4.2.sh
         env:
           SPANNER_EMULATOR_HOST: localhost:9010
           GOOGLE_CLOUD_PROJECT: emulator-test-project
           GOOGLE_CLOUD_TESTS_CREATE_SPANNER_INSTANCE: true
           RUNNING_SPANNER_BACKEND_TESTS: 1
           SPANNER_TEST_INSTANCE: google-cloud-django-backend-tests
-          DJANGO_TEST_APPS: admin_changelist admin_ordering aggregation choices distinct_on_fields expressions_window fixtures_model_package datetimes custom_methods generic_inline_admin field_defaults datatypes empty m2o_recursive many_to_one_null migration_test_data_persistence admin_docs invalid_models_tests migrate_signals model_forms.test_uuid model_forms.test_modelchoicefield syndication_tests view_tests update test_utils select_related_onetoone sessions_tests
+          DJANGO_TEST_APPS: admin_changelist admin_ordering aggregation distinct_on_fields expressions_window fixtures_model_package datetimes custom_methods generic_inline_admin field_defaults datatypes empty m2o_recursive many_to_one_null migration_test_data_persistence admin_docs invalid_models_tests migrate_signals model_forms.test_uuid model_forms.test_modelchoicefield syndication_tests view_tests update test_utils select_related_onetoone sessions_tests

.github/workflows/django_tests_against_emulator1.yml → .github/workflows/django4.2_tests_against_emulator1.yml

@@ -3,7 +3,7 @@ on:
     branches:
       - main
   pull_request:
-name: django-tests1
+name: django4.2-tests1
 jobs:
   system-tests:
     runs-on: ubuntu-latest
@@ -22,7 +22,7 @@ jobs:
         with:
           python-version: 3.8
       - name: Run Django tests
-        run: sh django_test_suite.sh
+        run: sh django_test_suite_4.2.sh
         env:
           SPANNER_EMULATOR_HOST: localhost:9010
           GOOGLE_CLOUD_PROJECT: emulator-test-project

.github/workflows/django_tests_against_emulator2.yml → .github/workflows/django4.2_tests_against_emulator2.yml

@@ -3,7 +3,7 @@ on:
     branches:
       - main
   pull_request:
-name: django-tests2
+name: django4.2-tests2
 jobs:
   system-tests:
     runs-on: ubuntu-latest
@@ -22,7 +22,7 @@ jobs:
         with:
           python-version: 3.8
       - name: Run Django tests
-        run: sh django_test_suite.sh
+        run: sh django_test_suite_4.2.sh
         env:
           SPANNER_EMULATOR_HOST: localhost:9010
           GOOGLE_CLOUD_PROJECT: emulator-test-project

.github/workflows/django_tests_against_emulator3.yml → .github/workflows/django4.2_tests_against_emulator3.yml

@@ -3,7 +3,7 @@ on:
     branches:
       - main
   pull_request:
-name: django-tests3
+name: django4.2-tests3
 jobs:
   system-tests:
     runs-on: ubuntu-latest
@@ -22,7 +22,7 @@ jobs:
         with:
           python-version: 3.8
       - name: Run Django tests
-        run: sh django_test_suite.sh
+        run: sh django_test_suite_4.2.sh
         env:
           SPANNER_EMULATOR_HOST: localhost:9010
           GOOGLE_CLOUD_PROJECT: emulator-test-project

.github/workflows/django_tests_against_emulator4.yml → .github/workflows/django4.2_tests_against_emulator4.yml

@@ -3,7 +3,7 @@ on:
     branches:
       - main
   pull_request:
-name: django-tests4
+name: django4.2-tests4
 jobs:
   system-tests:
     runs-on: ubuntu-latest
@@ -22,7 +22,7 @@ jobs:
         with:
           python-version: 3.8
       - name: Run Django tests
-        run: sh django_test_suite.sh
+        run: sh django_test_suite_4.2.sh
         env:
           SPANNER_EMULATOR_HOST: localhost:9010
           GOOGLE_CLOUD_PROJECT: emulator-test-project

.github/workflows/django_tests_against_emulator5.yml → .github/workflows/django4.2_tests_against_emulator5.yml

@@ -3,7 +3,7 @@ on:
     branches:
       - main
   pull_request:
-name: django-tests5
+name: django4.2-tests5
 jobs:
   system-tests:
     runs-on: ubuntu-latest
@@ -22,7 +22,7 @@ jobs:
         with:
           python-version: 3.8
       - name: Run Django tests
-        run: sh django_test_suite.sh
+        run: sh django_test_suite_4.2.sh
         env:
           SPANNER_EMULATOR_HOST: localhost:9010
           GOOGLE_CLOUD_PROJECT: emulator-test-project

.github/workflows/django_tests_against_emulator6.yml → .github/workflows/django4.2_tests_against_emulator6.yml

@@ -3,7 +3,7 @@ on:
     branches:
       - main
   pull_request:
-name: django-tests6
+name: django4.2-tests6
 jobs:
   system-tests:
     runs-on: ubuntu-latest
@@ -22,7 +22,7 @@ jobs:
         with:
           python-version: 3.8
       - name: Run Django tests
-        run: sh django_test_suite.sh
+        run: sh django_test_suite_4.2.sh
         env:
           SPANNER_EMULATOR_HOST: localhost:9010
           GOOGLE_CLOUD_PROJECT: emulator-test-project

.github/workflows/django_tests_against_emulator7.yml → .github/workflows/django4.2_tests_against_emulator7.yml

@@ -3,7 +3,7 @@ on:
     branches:
       - main
   pull_request:
-name: django-tests7
+name: django4.2-tests7
 jobs:
   system-tests:
     runs-on: ubuntu-latest
@@ -22,7 +22,7 @@ jobs:
         with:
           python-version: 3.8
       - name: Run Django tests
-        run: sh django_test_suite.sh
+        run: sh django_test_suite_4.2.sh
         env:
           SPANNER_EMULATOR_HOST: localhost:9010
           GOOGLE_CLOUD_PROJECT: emulator-test-project

.github/workflows/django_tests_against_emulator8.yml → .github/workflows/django4.2_tests_against_emulator8.yml

@@ -3,7 +3,7 @@ on:
     branches:
       - main
   pull_request:
-name: django-tests8
+name: django4.2-tests8
 jobs:
   system-tests:
     runs-on: ubuntu-latest
@@ -22,7 +22,7 @@ jobs:
         with:
           python-version: 3.8
       - name: Run Django tests
-        run: sh django_test_suite.sh
+        run: sh django_test_suite_4.2.sh
         env:
           SPANNER_EMULATOR_HOST: localhost:9010
           GOOGLE_CLOUD_PROJECT: emulator-test-project

.github/workflows/django_tests_against_emulator9.yml → .github/workflows/django4.2_tests_against_emulator9.yml

@@ -3,7 +3,7 @@ on:
     branches:
       - main
   pull_request:
-name: django-tests9
+name: django4.2-tests9
 jobs:
   system-tests:
     runs-on: ubuntu-latest
@@ -22,7 +22,7 @@ jobs:
         with:
           python-version: 3.8
       - name: Run Django tests
-        run: sh django_test_suite.sh
+        run: sh django_test_suite_4.2.sh
         env:
           SPANNER_EMULATOR_HOST: localhost:9010
           GOOGLE_CLOUD_PROJECT: emulator-test-project

.github/workflows/integration-tests-against-emulator-3.7.yml → .github/workflows/integration-tests-against-emulator-3.10.yml

@@ -3,7 +3,7 @@ on:
     branches:
       - main
   pull_request:
-name: Run Django Spanner integration tests against emulator 3.7
+name: Run Django Spanner integration tests against emulator 3.10
 jobs:
   system-tests:
     runs-on: ubuntu-latest
@@ -18,14 +18,14 @@ jobs:
     steps:
       - name: Checkout code
         uses: actions/checkout@v4
-      - name: Set up Python 3.7
+      - name: Set up Python 3.20
         uses: actions/setup-python@v5
         with:
-          python-version: 3.7
+          python-version: "3.10"
       - name: Install nox
         run: python -m pip install nox
       - name: Run nox
-        run: nox -s unit-3.7
+        run: nox -s unit-3.10
         env:
           SPANNER_EMULATOR_HOST: localhost:9010
           GOOGLE_CLOUD_PROJECT: emulator-test-project

.github/workflows/integration-tests-against-emulator-3.8.yml

@@ -24,8 +24,6 @@ jobs:
           python-version: 3.8
       - name: Install nox
         run: python -m pip install nox
-      with:
-          python-version: 3.8
       - name: Run nox
         run: nox -s unit-3.8
         env:

.github/workflows/integration-tests-against-emulator-3.9.yml

@@ -24,8 +24,6 @@ jobs:
           python-version: 3.9
       - name: Install nox
         run: python -m pip install nox
-      with:
-          python-version: 3.9
       - name: Run nox
         run: nox -s unit-3.9
         env:

README.rst

@@ -140,6 +140,24 @@ configured:
            }
        }
 
+  Transaction support in autocommit mode
+  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+  Django version 4.2 and higher by default supports transactions in autocommit mode.
+  A transaction is automatically started if you define an
+  [atomic block](https://docs.djangoproject.com/en/4.2/topics/db/transactions/#controlling-transactions-explicitly).
+
+  Django version 3.2 and earlier did not support transactions in autocommit mode with Spanner.
+  You can enable transactions in autocommit mode with Spanner with the
+  `ALLOW_TRANSACTIONS_IN_AUTO_COMMIT` configuration option.
+
+  - To enable transactions in autocommit mode in V3.2, set
+  the flag "ALLOW_TRANSACTIONS_IN_AUTO_COMMIT" to True in your
+  settings.py file.
+  - To disable transactions in autocommit mode in V4.2, set
+  the flag "ALLOW_TRANSACTIONS_IN_AUTO_COMMIT" to False in your
+  settings.py file.
+
 
 Set credentials and project environment variables
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

django_spanner/__init__.py

@@ -20,7 +20,6 @@
     Field,
 )
 
-from .expressions import register_expressions
 from .functions import register_functions
 from .lookups import register_lookups
 from .utils import check_django_compatability
@@ -34,22 +33,24 @@
 if django.VERSION[:2] == (3, 2):
     USING_DJANGO_3 = True
 
-if USING_DJANGO_3:
-    from django.db.models.fields import (
-        SmallAutoField,
-        BigAutoField,
-    )
-    from django.db.models import JSONField
+USING_DJANGO_4 = False
+if django.VERSION[:2] == (4, 2):
+    USING_DJANGO_4 = True
+
+from django.db.models.fields import (
+    SmallAutoField,
+    BigAutoField,
+)
+from django.db.models import JSONField
 
 __version__ = pkg_resources.get_distribution("django-google-spanner").version
 
 USE_EMULATOR = os.getenv("SPANNER_EMULATOR_HOST") is not None
 
-# Only active LTS django versions (2.2.*, 3.2.*) are supported by this library right now.
-SUPPORTED_DJANGO_VERSIONS = [(2, 2), (3, 2)]
+# Only active LTS django versions (3.2.*, 4.2.*) are supported by this library right now.
+SUPPORTED_DJANGO_VERSIONS = [(3, 2), (4, 2)]
 
 check_django_compatability(SUPPORTED_DJANGO_VERSIONS)
-register_expressions(USING_DJANGO_3)
 register_functions()
 register_lookups()
 
@@ -73,23 +74,24 @@ def autofield_init(self, *args, **kwargs):
 AutoField.__init__ = autofield_init
 AutoField.db_returning = False
 AutoField.validators = []
-if USING_DJANGO_3:
-    SmallAutoField.__init__ = autofield_init
-    BigAutoField.__init__ = autofield_init
-    SmallAutoField.db_returning = False
-    BigAutoField.db_returning = False
-    SmallAutoField.validators = []
-    BigAutoField.validators = []
 
-    def get_prep_value(self, value):
-        # Json encoding and decoding for spanner is done in python-spanner.
-        if not isinstance(value, JsonObject) and isinstance(value, dict):
-            return JsonObject(value)
+SmallAutoField.__init__ = autofield_init
+BigAutoField.__init__ = autofield_init
+SmallAutoField.db_returning = False
+BigAutoField.db_returning = False
+SmallAutoField.validators = []
+BigAutoField.validators = []
+
+
+def get_prep_value(self, value):
+    # Json encoding and decoding for spanner is done in python-spanner.
+    if not isinstance(value, JsonObject) and isinstance(value, dict):
+        return JsonObject(value)
 
-        return value
+    return value
 
-    JSONField.get_prep_value = get_prep_value
 
+JSONField.get_prep_value = get_prep_value
 
 old_datetimewithnanoseconds_eq = getattr(
     DatetimeWithNanoseconds, "__eq__", None

django_spanner/base.py

@@ -17,6 +17,7 @@
 from .introspection import DatabaseIntrospection
 from .operations import DatabaseOperations
 from .schema import DatabaseSchemaEditor
+from django_spanner import USING_DJANGO_3
 
 
 class DatabaseWrapper(BaseDatabaseWrapper):
@@ -123,6 +124,15 @@ def instance(self):
             project=os.environ["GOOGLE_CLOUD_PROJECT"]
         ).instance(self.settings_dict["INSTANCE"])
 
+    @property
+    def allow_transactions_in_auto_commit(self):
+        if "ALLOW_TRANSACTIONS_IN_AUTO_COMMIT" in self.settings_dict:
+            return self.settings_dict["ALLOW_TRANSACTIONS_IN_AUTO_COMMIT"]
+        if USING_DJANGO_3:
+            return False
+        else:
+            return True
+
     @property
     def _nodb_connection(self):
         raise NotImplementedError(
@@ -205,15 +215,14 @@ def is_usable(self):
 
         return True
 
-    # The usual way to start a transaction is to turn autocommit off.
-    # Spanner DB API does not properly start a transaction when disabling
-    # autocommit. To avoid this buggy behavior and to actually enter a new
-    # transaction, an explicit SELECT 1 is required.
     def _start_transaction_under_autocommit(self):
         """
         Start a transaction explicitly in autocommit mode.
-
-        Staying in autocommit mode works around a bug that breaks
-        save points when autocommit is disabled by django.
         """
-        self.connection.cursor().execute("SELECT 1")
+        if self.allow_transactions_in_auto_commit:
+            self.connection.cursor().execute("BEGIN")
+        else:
+            # This won't start a transaction and was a bug in Spanner Django 3.2 version.
+            # Set ALLOW_TRANSACTIONS_IN_AUTO_COMMIT = True in your settings.py file to enable
+            # transactions in autocommit mode for Django 3.2.
+            self.connection.cursor().execute("SELECT 1")