Add TestSqliteAsync script, the async version of TestSqlite

Author: gilzoide

Samples~/Readme/TestSqlite.cs

@@ -19,7 +19,9 @@ void Start()
             // 1. Create a connection to the database.
             // The special ":memory:" in-memory database and
             // URIs like "file:///somefile" are also supported
-            var db = new SQLiteConnection($"{Application.persistentDataPath}/MyDb.db");
+            var path = $"{Application.persistentDataPath}/MyDb.db";
+            Debug.Log($"Opening database '{path}'");
+            var db = new SQLiteConnection(path);
 
             // 2. Once you have defined your entity, you can automatically
             // generate tables in your database by calling CreateTable

Samples~/Readme/TestSqliteAsync.cs

@@ -0,0 +1,52 @@
+using SQLite;
+using UnityEngine;
+
+namespace Gilzoide.SqliteNet.Samples.Readme
+{
+    public class TestSqliteAsync : MonoBehaviour
+    {
+        async void Start()
+        {
+            // 1. Create a connection to the database.
+            // The special ":memory:" in-memory database and
+            // URIs like "file:///somefile" are also supported
+            var path = $"{Application.persistentDataPath}/MyDb.db";
+            Debug.Log($"Opening database '{path}'");
+            var db = new SQLiteAsyncConnection(path);
+
+            // 2. Once you have defined your entity, you can automatically
+            // generate tables in your database by calling CreateTableAsync
+            await db.CreateTableAsync<Player>();
+
+            // 3. You can insert rows in the database using InsertAsync
+            // The Insert call fills Id, which is marked with [AutoIncremented]
+            var newPlayer = new Player
+            {
+                Name = "gilzoide",
+            };
+            await db.InsertAsync(newPlayer);
+            Debug.Log($"Player new ID: {newPlayer.Id}");
+            // Similar methods exist for Update and Delete.
+
+            // 4.a The most straightforward way to query for data
+            // is using the Table method. This can take predicates
+            // for constraining via WHERE clauses and/or adding ORDER BY clauses
+            var query = await db.Table<Player>().Where(p => p.Name.StartsWith("g")).ToListAsync();
+            foreach (Player player in query)
+            {
+                Debug.Log($"Found player named {player.Name} with ID {player.Id}");
+            }
+
+            // 4.b You can also make queries at a low-level using the QueryAsync method
+            var players = await db.QueryAsync<Player>("SELECT * FROM Player WHERE Id = ?", 1);
+            foreach (Player player in players)
+            {
+                Debug.Log($"Player with ID 1 is called {player.Name}");
+            }
+
+            // 5. You can perform low-level updates to the database using the
+            // ExecuteAsync method, for example for running PRAGMAs or VACUUM
+            await db.ExecuteAsync("VACUUM");
+        }
+    }
+}