snowflake-connector-python 5.0.0b1__tar.gz → 5.0.0b3__tar.gz

{snowflake_connector_python-5.0.0b1 → snowflake_connector_python-5.0.0b3}/Cargo.lock

@@ -905,6 +905,55 @@ dependencies = [
  "tracing",
 ]
 
+[[package]]
+name = "axum"
+version = "0.8.9"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "31b698c5f9a010f6573133b09e0de5408834d0c82f8d7475a89fc1867a71cd90"
+dependencies = [
+ "axum-core",
+ "bytes",
+ "form_urlencoded",
+ "futures-util",
+ "http 1.3.1",
+ "http-body 1.0.1",
+ "http-body-util",
+ "hyper 1.7.0",
+ "hyper-util",
+ "itoa",
+ "matchit",
+ "memchr",
+ "mime",
+ "percent-encoding",
+ "pin-project-lite",
+ "serde_core",
+ "serde_path_to_error",
+ "serde_urlencoded",
+ "sync_wrapper",
+ "tokio",
+ "tower",
+ "tower-layer",
+ "tower-service",
+]
+
+[[package]]
+name = "axum-core"
+version = "0.5.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "08c78f31d7b1291f7ee735c1c6780ccde7785daae9a9206026862dab7d8792d1"
+dependencies = [
+ "bytes",
+ "futures-core",
+ "http 1.3.1",
+ "http-body 1.0.1",
+ "http-body-util",
+ "mime",
+ "pin-project-lite",
+ "sync_wrapper",
+ "tower-layer",
+ "tower-service",
+]
+
 [[package]]
 name = "backtrace"
 version = "0.3.76"
@@ -1377,7 +1426,7 @@ dependencies = [
  "crc",
  "digest",
  "libc",
- "rand",
+ "rand 0.9.2",
  "regex",
 ]
 
@@ -2652,7 +2701,7 @@ dependencies = [
 name = "jdbc_bridge"
 version = "0.1.0"
 dependencies = [
- "jni",
+ "jni 0.21.1",
  "proto_utils",
  "sf_core",
  "tokio",
@@ -2694,7 +2743,7 @@ dependencies = [
  "cfg-if",
  "combine",
  "java-locator",
- "jni-sys",
+ "jni-sys 0.3.0",
  "libloading 0.7.4",
  "log",
  "thiserror 1.0.69",
@@ -2702,12 +2751,61 @@ dependencies = [
  "windows-sys 0.45.0",
 ]
 
+[[package]]
+name = "jni"
+version = "0.22.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5efd9a482cf3a427f00d6b35f14332adc7902ce91efb778580e180ff90fa3498"
+dependencies = [
+ "cfg-if",
+ "combine",
+ "jni-macros",
+ "jni-sys 0.4.1",
+ "log",
+ "simd_cesu8",
+ "thiserror 2.0.16",
+ "walkdir",
+ "windows-link 0.2.0",
+]
+
+[[package]]
+name = "jni-macros"
+version = "0.22.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "a00109accc170f0bdb141fed3e393c565b6f5e072365c3bd58f5b062591560a3"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "rustc_version",
+ "simd_cesu8",
+ "syn 2.0.106",
+]
+
 [[package]]
 name = "jni-sys"
 version = "0.3.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "8eaf4bc02d17cbdd7ff4c7438cafcdf7fb9a4613313ad11b4f8fefe7d3fa0130"
 
+[[package]]
+name = "jni-sys"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "c6377a88cb3910bee9b0fa88d4f42e1d2da8e79915598f65fb0c7ee14c878af2"
+dependencies = [
+ "jni-sys-macros",
+]
+
+[[package]]
+name = "jni-sys-macros"
+version = "0.4.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "38c0b942f458fe50cdac086d2f946512305e5631e720728f2a61aabcd47a6264"
+dependencies = [
+ "quote",
+ "syn 2.0.106",
+]
+
 [[package]]
 name = "jobserver"
 version = "0.1.34"
@@ -2931,6 +3029,12 @@ dependencies = [
  "regex-automata",
 ]
 
+[[package]]
+name = "matchit"
+version = "0.8.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "47e1ffaa40ddd1f3ed91f717a33c8c0ee23fff369e3aa8772b9605cc1d22f4c3"
+
 [[package]]
 name = "md-5"
 version = "0.10.6"
@@ -3031,6 +3135,12 @@ dependencies = [
  "tempfile",
 ]
 
+[[package]]
+name = "ndk-context"
+version = "0.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "27b02d87554356db9e9a873add8782d4ea6e3e58ea071a9adb9a2e8ddb884a8b"
+
 [[package]]
 name = "nix"
 version = "0.26.4"
@@ -3173,6 +3283,26 @@ dependencies = [
  "libc",
 ]
 
+[[package]]
+name = "oauth2"
+version = "5.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "51e219e79014df21a225b1860a479e2dcd7cbd9130f4defd4bd0e191ea31d67d"
+dependencies = [
+ "base64 0.22.1",
+ "chrono",
+ "getrandom 0.2.16",
+ "http 1.3.1",
+ "rand 0.8.6",
+ "reqwest",
+ "serde",
+ "serde_json",
+ "serde_path_to_error",
+ "sha2",
+ "thiserror 1.0.69",
+ "url",
+]
+
 [[package]]
 name = "objc2"
 version = "0.6.4"
@@ -3348,6 +3478,7 @@ dependencies = [
  "arrow",
  "base64 0.22.1",
  "chrono",
+ "dirs",
  "embed-resource",
  "error_trace",
  "libc",
@@ -3355,9 +3486,13 @@ dependencies = [
  "parking_lot",
  "proto_utils",
  "rust-ini",
+ "rustc_version",
  "serde_json",
  "sf_core",
  "snafu 0.8.9",
+ "strum",
+ "strum_macros",
+ "temp-env",
  "test-case",
  "tokio",
  "tokio-util",
@@ -3377,8 +3512,10 @@ name = "odbc_trace_tool"
 version = "0.1.0"
 dependencies = [
  "clap",
+ "encoding_rs",
  "regex",
  "serde",
+ "serde_json",
  "serde_yaml",
  "snafu 0.8.9",
  "tempfile",
@@ -3540,7 +3677,7 @@ dependencies = [
  "futures-util",
  "opentelemetry",
  "percent-encoding",
- "rand",
+ "rand 0.9.2",
  "serde_json",
  "thiserror 2.0.16",
 ]
@@ -3985,7 +4122,7 @@ dependencies = [
  "bytes",
  "getrandom 0.3.3",
  "lru-slab",
- "rand",
+ "rand 0.9.2",
  "ring",
  "rustc-hash",
  "rustls 0.23.32",
@@ -4035,16 +4172,37 @@ dependencies = [
  "ptr_meta",
 ]
 
+[[package]]
+name = "rand"
+version = "0.8.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5ca0ecfa931c29007047d1bc58e623ab12e5590e8c7cc53200d5202b69266d8a"
+dependencies = [
+ "libc",
+ "rand_chacha 0.3.1",
+ "rand_core 0.6.4",
+]
+
 [[package]]
 name = "rand"
 version = "0.9.2"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "6db2770f06117d490610c7488547d543617b21bfa07796d7a12f6f1bd53850d1"
 dependencies = [
- "rand_chacha",
+ "rand_chacha 0.9.0",
  "rand_core 0.9.3",
 ]
 
+[[package]]
+name = "rand_chacha"
+version = "0.3.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e6c10a63a0fa32252be49d21e7709d4d4baf8d231c2dbce1eaa8141b9b127d88"
+dependencies = [
+ "ppv-lite86",
+ "rand_core 0.6.4",
+]
+
 [[package]]
 name = "rand_chacha"
 version = "0.9.0"
@@ -4231,6 +4389,7 @@ dependencies = [
  "url",
  "wasm-bindgen",
  "wasm-bindgen-futures",
+ "wasm-streams",
  "web-sys",
  "webpki-roots",
 ]
@@ -4609,6 +4768,17 @@ dependencies = [
  "serde_core",
 ]
 
+[[package]]
+name = "serde_path_to_error"
+version = "0.1.20"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "10a9ff822e371bb5403e391ecd83e182e0e77ba7f6fe0160b795797109d1b457"
+dependencies = [
+ "itoa",
+ "serde",
+ "serde_core",
+]
+
 [[package]]
 name = "serde_spanned"
 version = "0.6.9"
@@ -4664,8 +4834,10 @@ dependencies = [
  "aws-lc-rs",
  "aws-sdk-s3",
  "aws-sdk-sts",
+ "axum",
  "base64 0.22.1",
  "brotli",
+ "bytes",
  "bzip2",
  "chrono",
  "clap",
@@ -4681,6 +4853,7 @@ dependencies = [
  "glob",
  "hex",
  "html-escape",
+ "http 1.3.1",
  "infer",
  "jwt",
  "keyring",
@@ -4688,6 +4861,7 @@ dependencies = [
  "lru",
  "memchr",
  "num-traits",
+ "oauth2",
  "once_cell",
  "openssl",
  "opentelemetry",
@@ -4699,7 +4873,7 @@ dependencies = [
  "prost 0.14.1",
  "proto_generator",
  "proto_utils",
- "rand",
+ "rand 0.9.2",
  "rcgen",
  "reqwest",
  "rust-ini",
@@ -4727,12 +4901,14 @@ dependencies = [
  "toml 0.8.23",
  "tracing",
  "tracing-appender",
+ "tracing-core",
  "tracing-opentelemetry",
  "tracing-subscriber",
  "tracing-test",
  "url",
  "urlencoding",
  "uuid",
+ "webbrowser",
  "wiremock",
  "x509-cert",
  "x509-parser",
@@ -4816,6 +4992,16 @@ version = "2.2.0"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "77549399552de45a898a580c1b41d445bf730df867cc44e6c0233bbc4b8329de"
 
+[[package]]
+name = "simd_cesu8"
+version = "1.1.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "94f90157bb87cddf702797c5dadfa0be7d266cdf49e22da2fcaa32eff75b2c33"
+dependencies = [
+ "rustc_version",
+ "simdutf8",
+]
+
 [[package]]
 name = "simdutf8"
 version = "0.1.5"
@@ -4983,6 +5169,25 @@ version = "0.11.1"
 source = "registry+https://github.com/rust-lang/crates.io-index"
 checksum = "7da8b5736845d9f2fcb837ea5d9e2628564b3b043a70948a3f0b778838c5fb4f"
 
+[[package]]
+name = "strum"
+version = "0.26.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8fec0f0aef304996cf250b31b5a10dee7980c85da9d759361292b8bca5a18f06"
+
+[[package]]
+name = "strum_macros"
+version = "0.26.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "4c6bee85a5a24955dc440386795aa378cd9cf82acd5f764469152d2270e581be"
+dependencies = [
+ "heck 0.5.0",
+ "proc-macro2",
+ "quote",
+ "rustversion",
+ "syn 2.0.106",
+]
+
 [[package]]
 name = "subtle"
 version = "2.6.1"
@@ -5865,6 +6070,19 @@ dependencies = [
  "unicode-ident",
 ]
 
+[[package]]
+name = "wasm-streams"
+version = "0.4.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "15053d8d85c7eccdbefef60f06769760a563c7f0a9d6902a13d35c7800b0ad65"
+dependencies = [
+ "futures-util",
+ "js-sys",
+ "wasm-bindgen",
+ "wasm-bindgen-futures",
+ "web-sys",
+]
+
 [[package]]
 name = "web-sys"
 version = "0.3.81"
@@ -5885,6 +6103,22 @@ dependencies = [
  "wasm-bindgen",
 ]
 
+[[package]]
+name = "webbrowser"
+version = "1.2.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0fc95580916af1e68ff6a7be07446fc5db73ebf71cf092de939bbf5f7e189f72"
+dependencies = [
+ "core-foundation 0.10.1",
+ "jni 0.22.4",
+ "log",
+ "ndk-context",
+ "objc2",
+ "objc2-foundation",
+ "url",
+ "web-sys",
+]
+
 [[package]]
 name = "webpki-roots"
 version = "1.0.2"

{snowflake_connector_python-5.0.0b1 → snowflake_connector_python-5.0.0b3}/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: snowflake-connector-python
-Version: 5.0.0b1
-Summary: A PEP 249 Database API 2.0 implementation for Snowflake
+Version: 5.0.0b3
+Summary: Snowflake DB driver for Python (Private Preview)
 Project-URL: Homepage, https://github.com/snowflakedb/universal-driver
 Project-URL: Bug Reports, https://github.com/snowflakedb/universal-driver/issues
 Project-URL: Source, https://github.com/snowflakedb/universal-driver
 Project-URL: Documentation, https://github.com/snowflakedb/universal-driver/blob/main/README.md
 License: Apache-2.0
 Keywords: api,database,dbapi,pep249,python,snowflake
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3
@@ -19,7 +19,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Database
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Requires-Dist: cryptography>=44.0.1
 Requires-Dist: protobuf>=6.32.1
 Requires-Dist: pytz
@@ -56,14 +56,16 @@ Requires-Dist: tzdata; extra == 'test'
 Requires-Dist: zstandard; extra == 'test'
 Description-Content-Type: text/markdown
 
-# PEP 249 Database API 2.0 Implementation
+# ⚠️ PRIVATE PREVIEW DISCLAIMER ⚠️
 
-A Python library that implements [PEP 249 (Python Database API Specification 2.0)](https://peps.python.org/pep-0249/) with empty interface implementations. This library provides a complete skeleton implementation that follows the PEP 249 specification, making it an ideal starting point for creating new database drivers or for testing database API compliance.
+**This is a beta version of our Universal Driver intended for Snowflake customers who are subject to Snowflake's Preview Terms.**
+
+This driver is not ready for use with production data and may be unstable. Please only use it if you are actively participating in the Universal Driver Private Preview.
 
 ## Development
 
 ### Prerequisites
-- Python 3.9+
+- Python 3.10+
 - [uv](https://docs.astral.sh/uv/) package manager
 - [Hatch](https://hatch.pypa.io/) build tool
 - Rust toolchain (for building core library)
@@ -102,7 +104,7 @@ The `dev` environment is designed for **human developers** during active develop
 - Installs from sources (`skip-install = false`)
 - Editable mode enabled (`dev-mode = true`)
 - Changes to source code are immediately available
-- Supports Python matrix: 3.9, 3.10, 3.11, 3.12, 3.13
+- Supports Python matrix: 3.10, 3.11, 3.12, 3.13, 3.14
 
 **Usage:**
 ```bash
@@ -165,8 +167,10 @@ hatch run test.py3.12:all
 hatch run precommit:check        # Run all checks (format, lint, type)
 hatch run precommit:fix          # Auto-fix formatting and linting issues
 
-# Reference connector tests (for compatibility testing)
-PYTHON_REFERENCE_DRIVER_VERSION=3.17.2 hatch run reference:test
+# Reference connector tests (for compatibility testing, installs latest v4.x)
+hatch run reference:test
+# Pin a specific version if needed:
+PYTHON_REFERENCE_DRIVER_VERSION='==4.3.0' hatch run reference:test
 ```
 
 ## References

{snowflake_connector_python-5.0.0b1 → snowflake_connector_python-5.0.0b3}/README.md

@@ -1,11 +1,13 @@
-# PEP 249 Database API 2.0 Implementation
+# ⚠️ PRIVATE PREVIEW DISCLAIMER ⚠️
 
-A Python library that implements [PEP 249 (Python Database API Specification 2.0)](https://peps.python.org/pep-0249/) with empty interface implementations. This library provides a complete skeleton implementation that follows the PEP 249 specification, making it an ideal starting point for creating new database drivers or for testing database API compliance.
+**This is a beta version of our Universal Driver intended for Snowflake customers who are subject to Snowflake's Preview Terms.**
+
+This driver is not ready for use with production data and may be unstable. Please only use it if you are actively participating in the Universal Driver Private Preview.
 
 ## Development
 
 ### Prerequisites
-- Python 3.9+
+- Python 3.10+
 - [uv](https://docs.astral.sh/uv/) package manager
 - [Hatch](https://hatch.pypa.io/) build tool
 - Rust toolchain (for building core library)
@@ -44,7 +46,7 @@ The `dev` environment is designed for **human developers** during active develop
 - Installs from sources (`skip-install = false`)
 - Editable mode enabled (`dev-mode = true`)
 - Changes to source code are immediately available
-- Supports Python matrix: 3.9, 3.10, 3.11, 3.12, 3.13
+- Supports Python matrix: 3.10, 3.11, 3.12, 3.13, 3.14
 
 **Usage:**
 ```bash
@@ -107,8 +109,10 @@ hatch run test.py3.12:all
 hatch run precommit:check        # Run all checks (format, lint, type)
 hatch run precommit:fix          # Auto-fix formatting and linting issues
 
-# Reference connector tests (for compatibility testing)
-PYTHON_REFERENCE_DRIVER_VERSION=3.17.2 hatch run reference:test
+# Reference connector tests (for compatibility testing, installs latest v4.x)
+hatch run reference:test
+# Pin a specific version if needed:
+PYTHON_REFERENCE_DRIVER_VERSION='==4.3.0' hatch run reference:test
 ```
 
 ## References

{snowflake_connector_python-5.0.0b1 → snowflake_connector_python-5.0.0b3}/proto_generator/src/generators/python_generator.rs

@@ -113,11 +113,16 @@ impl PythonGenerator {
                 content += &self.generate_server_class(&service, &package);
             }
 
-            // Generate client classes
-            for service in file.service {
+            // Generate (synchronous) client classes
+            for service in file.service.clone() {
                 content += &self.generate_client_class(&service, &package);
             }
 
+            // Generate async client classes (separate code path from the sync clients)
+            for service in file.service {
+                content += &self.generate_async_client_class(&service, &package);
+            }
+
             result.add_file(
                 PathBuf::from(format!(r#"{package}_services.py"#)),
                 GeneratedFile::new(content),
@@ -311,6 +316,96 @@ class ProtoError(Exception):
 
         content
     }
+
+    /// Generate the asynchronous client for a service.
+    ///
+    /// This is a dedicated client for the async code path — separate from the
+    /// synchronous ``{service}Client``. Each method awaits
+    /// ``transport.handle_message_async``, which today offloads the blocking
+    /// FFI call to a worker thread via ``asyncio.to_thread``. A non-blocking,
+    /// callback-based FFI will replace that hop later without changing this
+    /// client's surface.
+    fn generate_async_client_class(
+        &self,
+        service: &crate::protobuf::ServiceDescriptorProto,
+        package: &str,
+    ) -> String {
+        let service_name = service.name.as_ref().unwrap_or(&String::new()).clone();
+        let service_error = service
+            .options
+            .as_ref()
+            .and_then(|o| o.service_error.as_ref());
+
+        let mut content = format!(
+            r#"class Async{service_name}Client:
+    """Asynchronous {service_name} client.
+
+    Each RPC awaits ``transport.handle_message_async``, which runs the
+    blocking FFI call on a worker thread so the event loop is not blocked.
+    This is a separate code path from the synchronous ``{service_name}Client``.
+    """
+
+    def __init__(self, transport, error_handler=None):
+        """
+        Args:
+            transport: Transport layer that handles message serialization.
+            error_handler: Optional callable that converts a proto-layer exception
+                into a public exception.  Must **return** the converted exception
+                (not raise it); ``_raise_error`` takes care of raising.
+        """
+        self._transport = transport
+        self._error_handler = error_handler
+
+    def _raise_error(self, exc):
+        if self._error_handler is not None:
+            raise self._error_handler(exc) from None
+        raise exc
+
+"#
+        );
+
+        for method in &service.method {
+            let name = camel_to_snake_case(method.name.as_ref().unwrap_or(&String::new()));
+            let input_type = to_rust_message_name(
+                &package.to_string(),
+                &method.input_type.as_ref().unwrap_or(&String::new()).clone(),
+            );
+            let output_type = to_rust_message_name(
+                &package.to_string(),
+                &method
+                    .output_type
+                    .as_ref()
+                    .unwrap_or(&String::new())
+                    .clone(),
+            );
+            let method_error = method
+                .options
+                .as_ref()
+                .and_then(|o| o.method_error.as_ref());
+            let empty_error = "EmptyError".to_string();
+            let error_type = method_error.or(service_error).unwrap_or(&empty_error);
+
+            content += &format!(
+                r#"    async def {name}(self, request: {input_type}) -> {output_type}:
+        (code, response_bytes) = await self._transport.handle_message_async('{service_name}', '{name}', request.SerializeToString())
+        if code == 0:
+            response = {output_type}()
+            response.ParseFromString(response_bytes)
+            return response
+        elif code == 1:
+            error = {error_type}()
+            error.ParseFromString(response_bytes)
+            self._raise_error(ProtoApplicationException(error))
+        elif code == 2:
+            self._raise_error(ProtoTransportException(str(response_bytes)))
+        else:
+            self._raise_error(ProtoTransportException(f"Unknown error code: %s", code))
+"#
+            );
+        }
+
+        content
+    }
 }
 
 impl Default for PythonGenerator {

{snowflake_connector_python-5.0.0b1 → snowflake_connector_python-5.0.0b3}/proto_generator/src/generators/rust_generator.rs

@@ -230,7 +230,7 @@ use prost::Message;
 					Ok(input) => input,
 					Err(e) => return Err(ProtoError::Transport(e.to_string())),
 				}};
-				let result = self.{name}(input).await;
+				let result = Box::pin(self.{name}(input)).await;
 				match result {{
 				Ok(output) => Ok(output.encode_to_vec()),
 				Err(e) => Err(ProtoError::Application(e.encode_to_vec())),