Make sure transactions are correctly crafted.

Author: softlion

README.md

@@ -5,7 +5,7 @@ Add this package to a netstandard compatible project:
 [![NuGet](https://img.shields.io/nuget/v/sqlite-net2.svg)](https://www.nuget.org/packages/sqlite-net2/)  
 ![Nuget](https://img.shields.io/nuget/dt/sqlite-net2)
 
-**Required**: add ONLY ONE of the followin packages to your common project:
+**Required**: add ONLY ONE of the following packages to your common project:
 - [SQLitePCLRaw.bundle_e_sqlite3](https://www.nuget.org/packages/SQLitePCLRaw.bundle_e_sqlite3) for a normal database file
 - [SQLitePCLRaw.bundle_e_sqlcipher](https://www.nuget.org/packages/SQLitePCLRaw.bundle_e_sqlcipher) for an encrypted database file
 
@@ -49,7 +49,7 @@ For a key/value store based on sqlite, or a drop-in replacement (alternative) to
  Usage: `ExecuteSimpleQuery<string>("select 'drop table ' || name || ';' from sqlite_master where type = 'table'")`		
 
 * No asynchronous API. Use Task.Run() if you want asynchronous calls.  
-Note that while SQLitePCLRaw states that the database can be accessed by mutiple threads simultaneously, experience proves that you should always prevent multithread access, otherwise rare random crash occur. You can use `SemaphoreSlim` to serialize calls.
+Note that while SQLitePCLRaw states that the database can be accessed by multiple threads simultaneously, experience proves that you should always prevent multithreaded access, otherwise rare random crash occur. You can use `SemaphoreSlim` to serialize calls.
 
 * Another trick  
 Use transactions! In sqlite they speed up all queries a lot.
@@ -192,3 +192,33 @@ if (String.IsNullOrWhiteSpace(cipherVer))
     throw new Exception("This build is not using SQL CIPHER");
 ```
 
+## Using transactions
+
+Warning: all transactions methods create a state in this connection (the transaction depth).    
+Be sure to not share the connection with other simultaneous threads.
+
+Especially these methods create by default an implicit transaction:  
+`InsertAll(), InsertOrUpdateAll(), ReplaceAll()`  
+They all have a boolean parameter to disable the implicit transaction (beware of performances).
+
+Standard transaction:
+```c#
+BeginTransaction();
+...
+Commit(); 
+//or 
+Rollback();
+```
+
+Nested transactions:
+```c#
+var savepoint=SaveTransactionPoint();
+...
+Release(savepoint);
+//or
+RollbackTo(savepoint);
+```
+
+## Limitations
+
+Most databases (except SQLServer) store DateTimeOffset as UTC, forgetting the offset part. SQlite is not an exception.

SQLite.Net.Tests/InsertTest.cs

@@ -143,11 +143,7 @@ public void InsertAllFailureOutsideTransaction()
         [Test]
         public void InsertAllSuccessInsideTransaction()
         {
-            List<UniqueObj> testObjects = Enumerable.Range(1, 20).Select(i => new UniqueObj
-            {
-                Id = i
-            }).ToList();
-
+            var testObjects = Enumerable.Range(1, 20).Select(i => new UniqueObj { Id = i }).ToList();
             _db.RunInTransaction(() => { _db.InsertAll(testObjects); });
 
             Assert.AreEqual(testObjects.Count, _db.Table<UniqueObj>().Count());

SQLite.Net.Tests/SQLite.Net2.Tests.csproj

@@ -7,12 +7,12 @@
   </PropertyGroup>
 
   <ItemGroup>
-    <PackageReference Include="nunit" Version="3.13.2" />
+    <PackageReference Include="nunit" Version="3.13.3" />
     <PackageReference Include="NUnit3TestAdapter" Version="4.2.1">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers; buildtransitive</IncludeAssets>
     </PackageReference>
-    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="16.11.0" />
+    <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.1.0" />
     <PackageReference Include="SQLitePCLRaw.bundle_e_sqlite3" Version="2.0.7" />
   </ItemGroup>
 

nuget/pack.ps1

@@ -6,8 +6,8 @@ if ($IsMacOS) {
     $msbuild = & $vswhere -latest -products * -requires Microsoft.Component.MSBuild -property installationPath
     $msbuild = join-path $msbuild 'MSBuild\Current\Bin\MSBuild.exe'
 }
-$version="2.0.7"
-$versionSuffix=""
+$version="2.1.0"
+$versionSuffix="-pre1"
 
 #####################
 #Build release config

src/SQLite.Net/Interop/SQLiteApi.cs

@@ -222,6 +222,15 @@ public ReadOnlySpan<byte> ColumnByteArray(IDbStatement stmt, int index)
             return raw.sqlite3_column_blob(internalStmt.StmtPtr, index);
         }
 
+        /// <summary>
+        /// http://www.sqlite.org/c3ref/get_autocommit.html
+        /// </summary>
+        public int GetAutoCommit(IDbHandle db)
+        {
+            var internalDbHandle = (DbHandle)db;
+            return raw.sqlite3_get_autocommit(internalDbHandle.DbPtr);
+        }
+
         #region Backup
 
         public IDbBackupHandle BackupInit(IDbHandle destHandle, string destName, IDbHandle srcHandle, string srcName)