rename _start_session()

Author: timgraham

django_mongodb_backend/base.py

@@ -212,22 +212,29 @@ def _rollback(self):
                 self.session.abort_transaction()
             self.session = None
 
-    def _start_session(self):
+    def _start_transaction(self):
         if self.session is None:
             self.session = self.connection.start_session()
             with debug_transaction(self, "session.start_transaction()"):
                 self.session.start_transaction()
 
     def _start_transaction_under_autocommit(self):
+        # Using this method instead of _set_autocommit()) to start a
+        # transaction bypasses BaseDatabaseWrapper.set_autocommit()'s
+        # debug_transaction(self, "BEGIN") which is appropriate for a no-SQL
+        # backend.
         if not self.features.supports_transactions:
             return
-        self._start_session()
+        self._start_transaction()
 
     def _set_autocommit(self, autocommit, force_begin_transaction_with_broken_autocommit=False):
         if self.features.supports_transactions:
             return
+        # Besides @transaction.atomic() (which uses
+        # _start_transaction_under_autocommit(), disabling autocommit is
+        # another way to start a transaction.
         if not autocommit:
-            self._start_session()
+            self._start_transaction()
 
     def _close(self):
         # Normally called by close(), this method is also called by some tests.