Merge pull request #73 from giovannibenussi/examples

Add Usage Examples

Author: notrab

examples/batch/.gitignore

@@ -0,0 +1 @@
+local.db-journal

examples/batch/README.md

@@ -0,0 +1,19 @@
+# Local
+
+This example demonstrates how to use libSQL to execute a batch of SQL statements.
+
+## Install Dependencies
+
+```bash
+pip install libsql-experimental
+```
+
+## Running
+
+Execute the example:
+
+```bash
+python3 main.py
+```
+
+This will create a local database, execute a batch of SQL statements (creating tables, inserting data, etc.), and then query the results.

examples/batch/main.py

@@ -0,0 +1,16 @@
+import libsql_experimental as libsql
+
+conn = libsql.connect("local.db")
+cur = conn.cursor()
+
+cur.executescript(
+    """
+        DROP TABLE IF EXISTS users;
+        CREATE TABLE users (id INTEGER, name TEXT);
+        INSERT INTO users VALUES (1, '[email protected]');
+        INSERT INTO users VALUES (2, '[email protected]');
+        INSERT INTO users VALUES (3, '[email protected]');
+    """
+)
+
+print(conn.execute("select * from users").fetchall())

examples/encryption/.gitignore

@@ -0,0 +1 @@
+local.db-journal

examples/encryption/README.md

@@ -0,0 +1,19 @@
+# Local
+
+This example demonstrates how to create and use an encrypted SQLite database with libSQL.
+
+## Install Dependencies
+
+```bash
+pip install libsql-experimental
+```
+
+## Running
+
+Execute the example:
+
+```bash
+python3 main.py
+```
+
+This will setup an encrypted SQLite database, execute a batch of SQL statements, and then query the results.

examples/encryption/main.py

@@ -0,0 +1,16 @@
+import libsql_experimental as libsql
+
+# You should set the ENCRYPTION_KEY in a environment variable
+# For demo purposes, we're using a fixed key
+encryption_key= "my-safe-encryption-key";
+
+conn = libsql.connect("local.db", encryption_key=encryption_key)
+cur = conn.cursor()
+
+conn.execute("CREATE TABLE IF NOT EXISTS users (name TEXT);")
+conn.execute("INSERT INTO users VALUES ('[email protected]');")
+conn.execute("INSERT INTO users VALUES ('[email protected]');")
+conn.execute("INSERT INTO users VALUES ('[email protected]');")
+
+
+print(conn.execute("select * from users").fetchall())

examples/local/.gitignore

@@ -0,0 +1 @@
+local.db-journal

examples/local/README.md

@@ -0,0 +1,19 @@
+# Local
+
+This example demonstrates how to use libSQL with a local SQLite file.
+
+## Install Dependencies
+
+```bash
+pip install libsql-experimental
+```
+
+## Running
+
+Execute the example:
+
+```bash
+python3 main.py
+```
+
+This will connect to a local SQLite, insert some data, and query it.

examples/local/main.py

@@ -0,0 +1,12 @@
+import libsql_experimental as libsql
+
+conn = libsql.connect("local.db")
+cur = conn.cursor()
+
+conn.execute("CREATE TABLE IF NOT EXISTS users (name TEXT);")
+conn.execute("INSERT INTO users VALUES ('[email protected]');")
+conn.execute("INSERT INTO users VALUES ('[email protected]');")
+conn.execute("INSERT INTO users VALUES ('[email protected]');")
+
+
+print(conn.execute("select * from users").fetchall())

examples/memory/README.md

@@ -0,0 +1,19 @@
+# Local
+
+This example demonstrates how to use libSQL with an in-memory SQLite database.
+
+## Install Dependencies
+
+```bash
+pip install libsql-experimental
+```
+
+## Running
+
+Execute the example:
+
+```bash
+python3 main.py
+```
+
+This will create an in-memory SQLite database, insert some data, and then query the results.