examples: update all

README.md

@@ -134,6 +134,15 @@
    ./example
    ```
 
+## Examples
+
+- [Local](/examples/local)
+- [Remote](/examples/remote)
+- [Sync](/examples/sync)
+- [Vector](/examples/vector)
+- [Transactions](/examples/transactions)
+- [Batch](/examples/batch)
+
 ## Documentation
 
 Visit our [official documentation](https://docs.turso.tech/sdk/c).

examples/Makefile.common

@@ -0,0 +1,19 @@
+CC = gcc
+LDFLAGS = -L../../target/release -Wl,-rpath,../../target/release
+LIBS = -llibsql
+
+TARGET = example
+
+all: $(TARGET)
+
+../../target/release/liblibsql.so:
+	@echo "Building libsql..."
+	@cd ../.. && cargo build --release
+
+$(TARGET): example.c ../../target/release/liblibsql.so
+	$(CC) $(LDFLAGS) -o $@ $< $(LIBS)
+
+clean:
+	rm -f $(TARGET)
+
+.PHONY: all clean

examples/batch/Makefile

@@ -0,0 +1 @@
+../Makefile.common

examples/batch/README.md

@@ -0,0 +1,19 @@
+# Batch
+
+This example demonstrates how to use libsql to execute a batch of SQL statements.
+
+## Building
+
+```bash
+make
+```
+
+## Running
+
+Execute the example:
+
+```bash
+./example
+```
+
+This will create a local database, execute a batch of SQL statements (creating tables, inserting data, etc.), and then query the results.

examples/local/Makefile

@@ -0,0 +1 @@
+../Makefile.common

examples/local/README.md

@@ -0,0 +1,17 @@
+# Local
+
+This example demonstrates how to use libsql with a local SQLite file.
+
+## Building
+
+```bash
+make
+```
+
+## Running
+
+```bash
+./example
+```
+
+This will connect to a local SQLite, insert some data, and query it.

examples/remote/Makefile

@@ -0,0 +1 @@
+../Makefile.common

examples/remote/README.md

@@ -0,0 +1,17 @@
+# Remote
+
+This example demonstrates how to use libsql with a remote database.
+
+## Building
+
+```bash
+make
+```
+
+## Running
+
+```bash
+TURSO_DATABASE_URL="..." TURSO_AUTH_TOKEN="..." ./example
+```
+
+This will connect to a remote database, insert some data, and query it.

examples/sync/Makefile

@@ -0,0 +1 @@
+../Makefile.common

examples/sync/README.md

@@ -0,0 +1,17 @@
+# Sync
+
+This example demonstrates how to use libsql with a synced database (local file synced with a remote database).
+
+## Building
+
+```bash
+make
+```
+
+## Running
+
+```bash
+TURSO_DATABASE_URL="..." TURSO_AUTH_TOKEN="..." ./example
+```
+
+This will create a local database file that syncs with a remote database, insert some data, and query it.

examples/transactions/Makefile

@@ -0,0 +1 @@
+../Makefile.common

examples/transactions/README.md

@@ -0,0 +1,25 @@
+# Transactions
+
+This example demonstrates how to use transactions with libsql. It shows how to start a transaction, perform multiple operations, and then commit or rollback the transaction.
+
+## Building
+
+```bash
+make
+```
+
+## Running
+
+```bash
+./example
+```
+
+This example will:
+
+1. Create a new table called `users`.
+2. Start a transaction.
+3. Insert multiple users within the transaction.
+4. Demonstrate how to rollback a transaction.
+5. Start another transaction.
+6. Insert more users and commit the transaction.
+7. Query and display the final state of the `users` table.

examples/vector/Makefile

@@ -0,0 +1 @@
+../Makefile.common

examples/vector/README.md

@@ -0,0 +1,17 @@
+# Vector
+
+This example demonstrates how to use libsql vector search with a local database.
+
+## Building
+
+```bash
+make
+```
+
+## Running
+
+```bash
+./example
+```
+
+This will create a local database file that with a table for embeddings, insert some data (including embeddings), and query using the vector similarity search function.