Python SDK is no longer experimental

penberg · penberg · commit bcc013b3779f · 2025-06-10T16:44:47.000+03:00
diff --git a/Cargo.toml b/Cargo.toml
@@ -4,7 +4,7 @@ version = "0.0.55"
 edition = "2021"
 
 [lib]
-name = "libsql_experimental"
+name = "libsql_python"
 crate-type = ["cdylib"]
 
 [dependencies]
diff --git a/README.md b/README.md
@@ -1,12 +1,10 @@
 <p align="center">
   <a href="https://docs.turso.tech/sdk/python/quickstart">
-    <img alt="Turso + Python" src="https://github.com/tursodatabase/libsql-experimental-python/assets/950181/3748f2b3-872e-4cdd-bbe3-78491fd81dfa" width="1000">
-    <h3 align="center">Turso + Python (experimental)</h3>
+    <img alt="Turso + Python" src="https://github.com/tursodatabase/libsql-python/assets/950181/3748f2b3-872e-4cdd-bbe3-78491fd81dfa" width="1000">
+    <h3 align="center">Turso + Python</h3>
   </a>
 </p>
 
-<i><b>This package is experimental, which means it is not consider to be production grade. Furthermore, the package currently only supports Linux and macOS.</b></i>
-
 <p align="center">
   SQLite for Production. Powered by <a href="https://turso.tech/libsql">libSQL</a>.
 </p>
@@ -21,8 +19,8 @@
 </p>
 
 <p align="center">
-  <a href="https://pypi.org/project/libsql-experimental">
-    <img src="https://badge.fury.io/py/libsql-experimental.svg" alt="PyPI" title="PyPI" />
+  <a href="https://pypi.org/project/libsql">
+    <img src="https://badge.fury.io/py/libsql.svg" alt="PyPI" title="PyPI" />
   </a>
   <a href="https://discord.com/invite/4B5D7hYwub">
     <img src="https://dcbadge.vercel.app/api/server/4B5D7hYwub?style=flat" alt="discord activity" title="join us on discord" />
diff --git a/example.py b/example.py
@@ -1,6 +1,6 @@
-import libsql_experimental
+import libsql
 
-con = libsql_experimental.connect("hello.db", sync_url="http://localhost:8080",
+con = libsql.connect("hello.db", sync_url="http://localhost:8080",
                                   auth_token="")
 
 con.sync()
diff --git a/examples/batch/README.md b/examples/batch/README.md
@@ -5,7 +5,7 @@ This example demonstrates how to use libSQL to execute a batch of SQL statements
 ## Install Dependencies
 
 ```bash
-pip install libsql-experimental
+pip install libsql
 ```
 
 ## Running
diff --git a/examples/batch/main.py b/examples/batch/main.py
@@ -1,4 +1,4 @@
-import libsql_experimental as libsql
+import libsql
 
 conn = libsql.connect("local.db")
 cur = conn.cursor()
diff --git a/examples/encryption/README.md b/examples/encryption/README.md
@@ -5,7 +5,7 @@ This example demonstrates how to create and use an encrypted SQLite database wit
 ## Install Dependencies
 
 ```bash
-pip install libsql-experimental
+pip install libsql
 ```
 
 ## Running
diff --git a/examples/encryption/main.py b/examples/encryption/main.py
@@ -1,4 +1,4 @@
-import libsql_experimental as libsql
+import libsql
 
 # You should set the ENCRYPTION_KEY in a environment variable
 # For demo purposes, we're using a fixed key
diff --git a/examples/execute_script.py b/examples/execute_script.py
@@ -3,7 +3,7 @@
 """
 import os
 
-import libsql_experimental as libsql
+import libsql
 
 def execute_script(conn, file_path: os.PathLike):
     with open(file_path, 'r') as file:
diff --git a/examples/local/README.md b/examples/local/README.md
@@ -5,7 +5,7 @@ This example demonstrates how to use libSQL with a local SQLite file.
 ## Install Dependencies
 
 ```bash
-pip install libsql-experimental
+pip install libsql
 ```
 
 ## Running
diff --git a/examples/local/main.py b/examples/local/main.py
@@ -1,4 +1,4 @@
-import libsql_experimental as libsql
+import libsql
 
 conn = libsql.connect("local.db")
 cur = conn.cursor()
diff --git a/examples/memory/README.md b/examples/memory/README.md
@@ -5,7 +5,7 @@ This example demonstrates how to use libSQL with an in-memory SQLite database.
 ## Install Dependencies
 
 ```bash
-pip install libsql-experimental
+pip install libsql
 ```
 
 ## Running
diff --git a/examples/memory/main.py b/examples/memory/main.py
@@ -1,4 +1,4 @@
-import libsql_experimental as libsql
+import libsql
 
 conn = libsql.connect(":memory:")
 cur = conn.cursor()
diff --git a/examples/remote/README.md b/examples/remote/README.md
@@ -5,7 +5,7 @@ This example demonstrates how to use libSQL with a remote database.
 ## Install Dependencies
 
 ```bash
-pip install libsql-experimental
+pip install libsql
 ```
 
 ## Running
diff --git a/examples/remote/main.py b/examples/remote/main.py
@@ -1,4 +1,4 @@
-import libsql_experimental as libsql
+import libsql
 import os
 
 url = os.getenv("TURSO_DATABASE_URL")
diff --git a/examples/remote_connect.py b/examples/remote_connect.py
@@ -5,7 +5,7 @@
 """
 import os
 
-import libsql_experimental as libsql
+import libsql
 
 print(F"connecting to {os.getenv('LIBSQL_URL')}")
 conn = libsql.connect(database=os.getenv('LIBSQL_URL'),
diff --git a/examples/sqlalchemy/dialect.py b/examples/sqlalchemy/dialect.py
@@ -53,12 +53,12 @@ class SQLiteDialect_libsql(SQLiteDialect_pysqlite):
 
     @classmethod
     def import_dbapi(cls):
-        import libsql_experimental as libsql
+        import libsql
 
         return libsql
 
     def on_connect(self):
-        import libsql_experimental as libsql
+        import libsql
 
         sqlite3_connect = super().on_connect()
 
diff --git a/examples/sync/README.md b/examples/sync/README.md
@@ -5,7 +5,7 @@ This example demonstrates how to use libSQL with a synced database (local file s
 ## Install Dependencies
 
 ```bash
-pip install libsql-experimental
+pip install libsql
 ```
 
 ## Running
diff --git a/examples/sync/main.py b/examples/sync/main.py
@@ -1,4 +1,4 @@
-import libsql_experimental as libsql
+import libsql
 import os
 
 url = os.getenv("TURSO_DATABASE_URL")
diff --git a/examples/sync_write.py b/examples/sync_write.py
@@ -5,7 +5,7 @@
 """
 import os
 
-import libsql_experimental as libsql
+import libsql
 
 print(F"syncing with {os.getenv('LIBSQL_URL')}")
 conn = libsql.connect("hello.db", sync_url=os.getenv("LIBSQL_URL"),
diff --git a/examples/transaction/README.md b/examples/transaction/README.md
@@ -5,7 +5,7 @@ This example demonstrates how to create and use an encrypted SQLite database wit
 ## Install Dependencies
 
 ```bash
-pip install libsql-experimental
+pip install libsql
 ```
 
 ## Running
diff --git a/examples/transaction/main.py b/examples/transaction/main.py
@@ -1,4 +1,4 @@
-import libsql_experimental as libsql
+import libsql
 
 conn = libsql.connect("local.db")
 cur = conn.cursor()
diff --git a/examples/vector.py b/examples/vector.py
@@ -1,4 +1,4 @@
-import libsql_experimental as libsql
+import libsql
 
 conn = libsql.connect("vector.db")
 
diff --git a/examples/vector/README.md b/examples/vector/README.md
@@ -5,7 +5,7 @@ This example demonstrates how to use libSQL vector search with a local database.
 ## Install Dependencies
 
 ```bash
-pip install libsql-experimental
+pip install libsql
 ```
 
 ## Running
diff --git a/examples/vector/main.py b/examples/vector/main.py
@@ -1,4 +1,4 @@
-import libsql_experimental as libsql
+import libsql
 
 conn = libsql.connect("local.db")
 
diff --git a/perf-libsql.py b/perf-libsql.py
@@ -1,9 +1,9 @@
 #!/usr/bin/env python3
-import libsql_experimental
+import libsql
 import pyperf
 import time
 
-con = libsql_experimental.connect(":memory:")
+con = libsql.connect(":memory:")
 cur = con.cursor()
 
 def func():
diff --git a/pyproject.toml b/pyproject.toml
@@ -3,7 +3,7 @@ requires = ["maturin>=1.1,<2.0"]
 build-backend = "maturin"
 
 [project]
-name = "libsql-experimental"
+name = "libsql"
 version = "0.0.55"
 requires-python = ">=3.7"
 classifiers = [
diff --git a/src/lib.rs b/src/lib.rs
@@ -25,7 +25,7 @@ fn rt() -> Handle {
 
 fn to_py_err(error: libsql_core::errors::Error) -> PyErr {
     let msg = match error {
-        libsql::Error::SqliteFailure(_, err) => err,
+        libsql_core::Error::SqliteFailure(_, err) => err,
         _ => error.to_string(),
     };
     PyValueError::new_err(msg)
@@ -117,21 +117,21 @@ fn _connect_core(
     let rt = rt();
     let encryption_config = match encryption_key {
         Some(key) => {
-            let cipher = libsql::Cipher::default();
-            let encryption_config = libsql::EncryptionConfig::new(cipher, key.into());
+            let cipher = libsql_core::Cipher::default();
+            let encryption_config = libsql_core::EncryptionConfig::new(cipher, key.into());
             Some(encryption_config)
         }
         None => None,
     };
     let db = if is_remote_path(&database) {
-        let result = libsql::Database::open_remote_internal(database.clone(), auth_token, ver);
+        let result = libsql_core::Database::open_remote_internal(database.clone(), auth_token, ver);
         result.map_err(to_py_err)?
     } else {
         match sync_url {
             Some(sync_url) => {
                 let sync_interval = sync_interval.map(|i| std::time::Duration::from_secs_f64(i));
                 let mut builder =
-                    libsql::Builder::new_remote_replica(database, sync_url, auth_token.to_string());
+                    libsql_core::Builder::new_remote_replica(database, sync_url, auth_token.to_string());
                 if let Some(encryption_config) = encryption_config {
                     builder = builder.encryption_config(encryption_config);
                 }
@@ -144,7 +144,7 @@ fn _connect_core(
                 result.map_err(to_py_err)?
             }
             None => {
-                let mut builder = libsql::Builder::new_local(database);
+                let mut builder = libsql_core::Builder::new_local(database);
                 if let Some(config) = encryption_config {
                     builder = builder.encryption_config(config);
                 }
@@ -640,10 +640,10 @@ fn convert_row(py: Python, row: libsql_core::Row, column_count: i32) -> PyResult
     Ok(PyTuple::new(py, elements))
 }
 
-create_exception!(libsql_experimental, Error, pyo3::exceptions::PyException);
+create_exception!(libsql, Error, pyo3::exceptions::PyException);
 
 #[pymodule]
-fn libsql_experimental(py: Python, m: &PyModule) -> PyResult<()> {
+fn libsql(py: Python, m: &PyModule) -> PyResult<()> {
     let _ = tracing_subscriber::fmt::try_init();
     m.add("LEGACY_TRANSACTION_CONTROL", LEGACY_TRANSACTION_CONTROL)?;
     m.add("paramstyle", "qmark")?;
diff --git a/tests/test_suite.py b/tests/test_suite.py
@@ -2,7 +2,7 @@
 
 import sqlite3
 import sys
-import libsql_experimental
+import libsql
 import pytest
 
 
@@ -326,18 +326,18 @@ def connect(provider, database, isolation_level="DEFERRED", autocommit=-1):
             raise Exception("libsql-remote server is not running")
         if res.getcode() != 200:
             raise Exception("libsql-remote server is not running")
-        return libsql_experimental.connect(
+        return libsql.connect(
             database, sync_url="http://localhost:8080", auth_token=""
         )
     if provider == "libsql":
         if sys.version_info < (3, 12):
-            return libsql_experimental.connect(
+            return libsql.connect(
                 database, isolation_level=isolation_level
             )
         else:
             if autocommit == -1:
-                autocommit = libsql_experimental.LEGACY_TRANSACTION_CONTROL
-            return libsql_experimental.connect(
+                autocommit = libsql.LEGACY_TRANSACTION_CONTROL
+            return libsql.connect(
                 database, isolation_level=isolation_level, autocommit=autocommit
             )
     if provider == "sqlite":

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-import libsql_experimental as libsql`
	`1`	`+import libsql`
`2`	`2`
`3`	`3`	`conn = libsql.connect("local.db")`
`4`	`4`	`cur = conn.cursor()`