chore: Add guide for building & testing locally

Dockerfile

@@ -1,4 +1,4 @@
-FROM dart:3.7.2
+FROM dart:3.10.2
 
 RUN apt-get update && apt-get install -y --no-install-recommends \
     curl \
@@ -27,5 +27,14 @@ ENV PATH="/root/.cargo/bin:${PATH}"
 
 WORKDIR /app
 
+COPY pubspec.yaml pubspec.lock ./
+COPY third_party/sqlite3.dart/sqlite3 ./third_party/sqlite3.dart/sqlite3
+
+RUN dart pub get
+
+RUN dart --disable-analytics
+
+RUN dart run build_runner build --delete-conflicting-outputs
+
 ENTRYPOINT [ "/bin/zsh" ]
-CMD ["-l"]
+CMD ["-l"]

README.md

@@ -31,3 +31,9 @@ Place it in a standard library path (e.g., `/usr/lib`, or use `/usr/local/lib/`)
 ## 🚀 Usage
 
 Use **any standard SQLite library** in your language/runtime — this project handles the dynamic strategy and connection logic under the hood.
+
+---
+
+## 🧪 How to test
+
+See the dedicated guide: [`README_TESTING.md`](README_TESTING.md).

README_TESTING.md

@@ -0,0 +1,38 @@
+# How To Test
+
+Follow these steps from the project root.
+
+## 1. Pull the submodule dependencies
+
+`pubspec.yaml` uses a local path override from the `third_party/sqlite3.dart` submodule, so initialize and update submodules first.
+
+```bash
+git submodule update --init --recursive third_party/sqlite3.dart
+```
+
+## 2. Build the Docker image
+
+```bash
+docker build -t libturso:sandbox .
+```
+
+## 3. Run the container with the current directory mounted
+
+```bash
+docker run --rm -it \
+  -v "$(pwd):/app" \
+  -w /app \
+  libturso:sandbox
+```
+
+## 4. Compile the binary inside the container
+
+```bash
+cargo build
+```
+
+## 5. Run the Dart file in `bin/` to test
+
+```bash
+dart run bin/libsqlite3_turso.dart
+```

bin/libsqlite3_turso.dart

@@ -30,28 +30,28 @@ void main() async {
 
   final database = AppDatabase();
 
-  await database.transaction(() async {
-    // Create the table if it doesn't exist
-    final result = await database.into(database.todoItems).insert(
-          TodoItemsCompanion.insert(
-            title: 'todo: setup drift',
-            content: 'We need to set up drift for our SQLite database.',
-          ),
-        );
-
-  await (database
-    .update(database.todoItems)
-    ..where((tbl) => tbl.id.equals(result)))
-    .write(TodoItemsCompanion(content: const Value('Updated content')));
-
-
-    print('Inserted item with ID: $result');
-  });
-
-  // final allItems = await database.select(database.todoItems).get();
-  // for (final item in allItems) {
-  //   print('Item: ${item.title}, Content: ${item.content}');
-  // }
+  // await database.transaction(() async {
+  //   // Create the table if it doesn't exist
+  //   final result = await database.into(database.todoItems).insert(
+  //         TodoItemsCompanion.insert(
+  //           title: 'todo: setup drift',
+  //           content: 'We need to set up drift for our SQLite database.',
+  //         ),
+  //       );
+
+  // await (database
+  //   .update(database.todoItems)
+  //   ..where((tbl) => tbl.id.equals(result)))
+  //   .write(TodoItemsCompanion(content: const Value('Updated content')));
+
+
+  //   print('Inserted item with ID: $result');
+  // });
+
+  final allItems = await database.select(database.todoItems).get();
+  for (final item in allItems) {
+    print('Item: ${item.title}, Content: ${item.content}');
+  }
 
   // final server = await HttpServer.bind(InternetAddress.anyIPv4, 8081);