e6data-python-connector 2.3.12rc12__tar.gz → 2.3.12rc31__tar.gz

{e6data_python_connector-2.3.12rc12/e6data_python_connector.egg-info → e6data_python_connector-2.3.12rc31}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: e6data-python-connector
-Version: 2.3.12rc12
+Version: 2.3.12rc31
 Summary: Client for the e6data distributed SQL Engine.
 Home-page: https://github.com/e6x-labs/e6data-python-connector
 Author: e6data, Inc.
@@ -39,7 +39,7 @@ Dynamic: summary
 
 # e6data Python Connector
 
-![version](https://img.shields.io/badge/version-2.3.12rc12-blue.svg)
+![version](https://img.shields.io/badge/version-2.3.12rc31-blue.svg)
 
 ## Introduction
 
@@ -125,7 +125,7 @@ The `Connection` class supports the following parameters:
 | `auto_resume` | bool | No | True | Automatically resume cluster if suspended |
 | `grpc_options` | dict | No | None | Additional gRPC configuration options |
 | `debug` | bool | No | False | Enable debug logging for troubleshooting |
-| `ssl_cert` | str/bytes | No | None | Path to CA certificate (PEM) or certificate bytes for HTTPS connections |
+| `require_fastbinary` | bool | No | True | Require fastbinary module for Thrift deserialization. Set to False to use pure Python implementation if system dependencies cannot be installed |
 
 #### Secure Connection Example
 
@@ -143,14 +143,11 @@ conn = Connection(
 )
 ```
 
-#### HTTPS Connection with HAProxy
+#### Cluster-Specific Connection
 
-When connecting through HAProxy with HTTPS/TLS and custom CA certificates:
+When working with multiple clusters, specify the cluster name:
 
 ```python
-from e6data_python_connector import Connection
-
-# Option 1: Using CA certificate file path
 conn = Connection(
     host=host,
     port=port,
@@ -158,40 +155,30 @@ conn = Connection(
     password=password,
     database=database,
     cluster_name='analytics-cluster-01',  # Specify cluster name
-    secure=True,
-    ssl_cert='/path/to/ca-cert.pem'  # Path to CA certificate
+    secure=True
 )
+```
 
-# Option 2: Reading certificate content as bytes
-with open('/path/to/ca-cert.pem', 'rb') as f:
-    ca_cert = f.read()
+#### Handling Missing System Dependencies
 
-conn = Connection(
-    host=host,
-    port=port,
-    username=username,
-    password=password,
-    database=database,
-    secure=True,
-    ssl_cert=ca_cert  # Certificate as bytes
-)
+The e6data connector uses the `fastbinary` module (from Apache Thrift) for optimal performance when deserializing data. This module requires system-level dependencies (`python3-devel` and `gcc-c++`) to be installed.
+
+**Default Behavior (Recommended):**
+By default, the connector requires `fastbinary` to be available. If it's not found, the connection will fail immediately with a clear error message:
 
-# Option 3: System CA bundle (for publicly signed certificates)
+```python
 conn = Connection(
     host=host,
     port=port,
     username=username,
     password=password,
-    database=database,
-    secure=True  # Uses system CA bundle
+    database=database
 )
+# Raises exception if fastbinary is not available
 ```
 
-**Note:** Certificate verification is always enabled for security. For self-signed certificates, provide the CA certificate via the `ssl_cert` parameter.
-
-#### Cluster-Specific Connection
-
-When working with multiple clusters, specify the cluster name:
+**Fallback to Pure Python:**
+If you cannot install system dependencies (e.g., in restricted environments, serverless platforms, or containers without build tools), you can disable the `fastbinary` requirement. The connector will fall back to a pure Python implementation with a performance penalty:
 
 ```python
 conn = Connection(
@@ -200,11 +187,23 @@ conn = Connection(
     username=username,
     password=password,
     database=database,
-    cluster_name='analytics-cluster-01',  # Specify cluster name
-    secure=True
+    require_fastbinary=False  # Allow operation without fastbinary
 )
+# Logs warning but continues with pure Python implementation
 ```
 
+**When to use `require_fastbinary=False`:**
+- Running in AWS Lambda or other serverless environments
+- Docker containers built without compilation tools
+- Restricted environments where system packages cannot be installed
+- Development/testing environments where performance is not critical
+
+**Performance Impact:**
+- With `fastbinary`: Optimal performance for data deserialization
+- Without `fastbinary` (pure Python): ~2-3x slower deserialization, but otherwise fully functional
+
+**Note:** It's strongly recommended to install system dependencies when possible for best performance. The `require_fastbinary=False` option should only be used when system dependencies cannot be installed.
+
 ### Perform a Queries & Get Results
 
 ```python
@@ -551,35 +550,6 @@ pool.return_connection(conn)
 pool.close_all()
 ```
 
-##### Connection Pool with HTTPS (HAProxy)
-
-```python
-from e6data_python_connector import ConnectionPool
-
-# Connection pool with HTTPS and custom CA certificate
-pool = ConnectionPool(
-   min_size=2,
-    max_size=10,
-    host=host,
-    port=port,
-    username=username,
-    password=password,
-    database=database,
-    secure=True,
-    ssl_cert='/path/to/ca-cert.pem'  # CA certificate for HTTPS
-)
-
-# Use the pool with context manager for automatic cleanup
-with pool.get_connection_context() as conn:
-    cursor = conn.cursor()
-    cursor.execute("SELECT * FROM table")
-    results = cursor.fetchall()
-    print(f"Retrieved {len(results)} rows")
-
-# Clean up pool when done
-pool.close_all()
-```
-
 ##### Using Context Manager (Recommended)
 
 The context manager pattern ensures connections are automatically returned to the pool:
@@ -767,5 +737,6 @@ python your_script.py
 | 456 Strategy Error | Automatic blue-green failover will handle this |
 | Memory issues with large results | Use `fetchall_buffer()` instead of `fetchall()` |
 | gRPC message size errors | Configure `grpc_options` with appropriate message size limits |
+| fastbinary import error | Install system dependencies (`python3-devel`, `gcc-c++`) or set `require_fastbinary=False` |
 
 See [TECH_DOC.md](TECH_DOC.md) for detailed technical documentation.

{e6data_python_connector-2.3.12rc12 → e6data_python_connector-2.3.12rc31}/README.md

@@ -1,6 +1,6 @@
 # e6data Python Connector
 
-![version](https://img.shields.io/badge/version-2.3.12rc12-blue.svg)
+![version](https://img.shields.io/badge/version-2.3.12rc31-blue.svg)
 
 ## Introduction
 
@@ -86,7 +86,7 @@ The `Connection` class supports the following parameters:
 | `auto_resume` | bool | No | True | Automatically resume cluster if suspended |
 | `grpc_options` | dict | No | None | Additional gRPC configuration options |
 | `debug` | bool | No | False | Enable debug logging for troubleshooting |
-| `ssl_cert` | str/bytes | No | None | Path to CA certificate (PEM) or certificate bytes for HTTPS connections |
+| `require_fastbinary` | bool | No | True | Require fastbinary module for Thrift deserialization. Set to False to use pure Python implementation if system dependencies cannot be installed |
 
 #### Secure Connection Example
 
@@ -104,14 +104,11 @@ conn = Connection(
 )
 ```
 
-#### HTTPS Connection with HAProxy
+#### Cluster-Specific Connection
 
-When connecting through HAProxy with HTTPS/TLS and custom CA certificates:
+When working with multiple clusters, specify the cluster name:
 
 ```python
-from e6data_python_connector import Connection
-
-# Option 1: Using CA certificate file path
 conn = Connection(
     host=host,
     port=port,
@@ -119,40 +116,30 @@ conn = Connection(
     password=password,
     database=database,
     cluster_name='analytics-cluster-01',  # Specify cluster name
-    secure=True,
-    ssl_cert='/path/to/ca-cert.pem'  # Path to CA certificate
+    secure=True
 )
+```
 
-# Option 2: Reading certificate content as bytes
-with open('/path/to/ca-cert.pem', 'rb') as f:
-    ca_cert = f.read()
+#### Handling Missing System Dependencies
 
-conn = Connection(
-    host=host,
-    port=port,
-    username=username,
-    password=password,
-    database=database,
-    secure=True,
-    ssl_cert=ca_cert  # Certificate as bytes
-)
+The e6data connector uses the `fastbinary` module (from Apache Thrift) for optimal performance when deserializing data. This module requires system-level dependencies (`python3-devel` and `gcc-c++`) to be installed.
+
+**Default Behavior (Recommended):**
+By default, the connector requires `fastbinary` to be available. If it's not found, the connection will fail immediately with a clear error message:
 
-# Option 3: System CA bundle (for publicly signed certificates)
+```python
 conn = Connection(
     host=host,
     port=port,
     username=username,
     password=password,
-    database=database,
-    secure=True  # Uses system CA bundle
+    database=database
 )
+# Raises exception if fastbinary is not available
 ```
 
-**Note:** Certificate verification is always enabled for security. For self-signed certificates, provide the CA certificate via the `ssl_cert` parameter.
-
-#### Cluster-Specific Connection
-
-When working with multiple clusters, specify the cluster name:
+**Fallback to Pure Python:**
+If you cannot install system dependencies (e.g., in restricted environments, serverless platforms, or containers without build tools), you can disable the `fastbinary` requirement. The connector will fall back to a pure Python implementation with a performance penalty:
 
 ```python
 conn = Connection(
@@ -161,11 +148,23 @@ conn = Connection(
     username=username,
     password=password,
     database=database,
-    cluster_name='analytics-cluster-01',  # Specify cluster name
-    secure=True
+    require_fastbinary=False  # Allow operation without fastbinary
 )
+# Logs warning but continues with pure Python implementation
 ```
 
+**When to use `require_fastbinary=False`:**
+- Running in AWS Lambda or other serverless environments
+- Docker containers built without compilation tools
+- Restricted environments where system packages cannot be installed
+- Development/testing environments where performance is not critical
+
+**Performance Impact:**
+- With `fastbinary`: Optimal performance for data deserialization
+- Without `fastbinary` (pure Python): ~2-3x slower deserialization, but otherwise fully functional
+
+**Note:** It's strongly recommended to install system dependencies when possible for best performance. The `require_fastbinary=False` option should only be used when system dependencies cannot be installed.
+
 ### Perform a Queries & Get Results
 
 ```python
@@ -512,35 +511,6 @@ pool.return_connection(conn)
 pool.close_all()
 ```
 
-##### Connection Pool with HTTPS (HAProxy)
-
-```python
-from e6data_python_connector import ConnectionPool
-
-# Connection pool with HTTPS and custom CA certificate
-pool = ConnectionPool(
-   min_size=2,
-    max_size=10,
-    host=host,
-    port=port,
-    username=username,
-    password=password,
-    database=database,
-    secure=True,
-    ssl_cert='/path/to/ca-cert.pem'  # CA certificate for HTTPS
-)
-
-# Use the pool with context manager for automatic cleanup
-with pool.get_connection_context() as conn:
-    cursor = conn.cursor()
-    cursor.execute("SELECT * FROM table")
-    results = cursor.fetchall()
-    print(f"Retrieved {len(results)} rows")
-
-# Clean up pool when done
-pool.close_all()
-```
-
 ##### Using Context Manager (Recommended)
 
 The context manager pattern ensures connections are automatically returned to the pool:
@@ -728,5 +698,6 @@ python your_script.py
 | 456 Strategy Error | Automatic blue-green failover will handle this |
 | Memory issues with large results | Use `fetchall_buffer()` instead of `fetchall()` |
 | gRPC message size errors | Configure `grpc_options` with appropriate message size limits |
+| fastbinary import error | Install system dependencies (`python3-devel`, `gcc-c++`) or set `require_fastbinary=False` |
 
 See [TECH_DOC.md](TECH_DOC.md) for detailed technical documentation.

{e6data_python_connector-2.3.12rc12 → e6data_python_connector-2.3.12rc31}/e6data_python_connector/cluster_manager.py

@@ -1,7 +1,6 @@
 import logging
 import threading
 import time
-from typing import Optional, Union
 import e6data_python_connector.cluster_server.cluster_pb2 as cluster_pb2
 import e6data_python_connector.cluster_server.cluster_pb2_grpc as cluster_pb2_grpc
 import grpc
@@ -141,7 +140,7 @@ class ClusterManager:
     """
 
     def __init__(self, host: str, port: int, user: str, password: str, secure_channel: bool = False, timeout=60 * 5,
-                 cluster_uuid=None, grpc_options=None, debug=False, ssl_cert: Optional[Union[str, bytes]] = None):
+                 cluster_uuid=None, grpc_options=None, debug=False):
         """
         Initializes a new instance of the ClusterManager class.
 
@@ -156,12 +155,7 @@ class ClusterManager:
                 defaults to 5 minutes.
             cluster_uuid (str, optional): The unique identifier for the target cluster;
                 defaults to None.
-            grpc_options (dict, optional): Additional gRPC configuration options;
-                defaults to None.
             debug (bool, optional): Enable debug logging; defaults to False.
-            ssl_cert (str or bytes, optional): Path to CA certificate file (PEM format)
-                or certificate content as bytes. Used when secure_channel=True.
-                If not provided and secure_channel=True, system default CA bundle will be used.
         """
 
         self._host = host
@@ -170,67 +164,12 @@ class ClusterManager:
         self._password = password
         self._timeout = time.time() + timeout
         self._secure_channel = secure_channel
-        self._ssl_cert = ssl_cert
         self.cluster_uuid = cluster_uuid
         self._grpc_options = grpc_options
         if grpc_options is None:
             self._grpc_options = dict()
         self._debug = debug
 
-    def _get_ssl_credentials(self):
-        """
-        Creates SSL/TLS credentials for secure gRPC connections.
-
-        This method handles loading CA certificates from various sources:
-        - File path (str): Reads the certificate from the specified file
-        - Bytes: Uses the certificate content directly
-        - None: Uses system default CA bundle
-
-        Returns:
-            grpc.ChannelCredentials: SSL credentials for secure channel creation
-
-        Raises:
-            FileNotFoundError: If ssl_cert is a file path and the file doesn't exist
-            ValueError: If ssl_cert format is invalid or file cannot be read
-        """
-        root_certificates = None
-
-        if self._ssl_cert:
-            # Custom CA certificate provided
-            if isinstance(self._ssl_cert, str):
-                # It's a file path - read the certificate
-                try:
-                    with open(self._ssl_cert, 'rb') as f:
-                        root_certificates = f.read()
-                    if self._debug:
-                        logger.info(f"ClusterManager: Loaded CA certificate from file: {self._ssl_cert}")
-                except FileNotFoundError:
-                    raise FileNotFoundError(
-                        f"CA certificate file not found: {self._ssl_cert}. "
-                        f"Please ensure the file exists and the path is correct."
-                    )
-                except Exception as e:
-                    raise ValueError(
-                        f"Failed to read CA certificate from {self._ssl_cert}: {str(e)}"
-                    )
-            elif isinstance(self._ssl_cert, bytes):
-                # Certificate content provided as bytes
-                root_certificates = self._ssl_cert
-                if self._debug:
-                    logger.info("ClusterManager: Using CA certificate provided as bytes")
-            else:
-                raise ValueError(
-                    f"ssl_cert must be either a file path (str) or certificate content (bytes), "
-                    f"got {type(self._ssl_cert)}"
-                )
-        else:
-            # No custom CA certificate - use system default CA bundle
-            if self._debug:
-                logger.info("ClusterManager: Using system default CA bundle for SSL/TLS")
-
-        # Create and return SSL credentials with certificate verification enabled
-        return grpc.ssl_channel_credentials(root_certificates=root_certificates)
-
     @property
     def _get_connection(self):
         """
@@ -242,29 +181,16 @@ class ClusterManager:
         """
 
         if self._secure_channel:
-            # Get SSL credentials (handles CA cert loading and validation)
-            credentials = self._get_ssl_credentials()
-
             self._channel = grpc.secure_channel(
                 target='{}:{}'.format(self._host, self._port),
                 options=self._grpc_options,
-                credentials=credentials
+                credentials=grpc.ssl_channel_credentials()
             )
-
-            if self._debug:
-                logger.info(
-                    f"ClusterManager: Created secure gRPC channel to {self._host}:{self._port} "
-                    f"with SSL/TLS certificate verification enabled"
-                )
         else:
             self._channel = grpc.insecure_channel(
                 target='{}:{}'.format(self._host, self._port),
                 options=self._grpc_options
             )
-
-            if self._debug:
-                logger.info(f"ClusterManager: Created insecure gRPC channel to {self._host}:{self._port}")
-
         return cluster_pb2_grpc.ClusterServiceStub(self._channel)
 
     def _try_cluster_request(self, request_type, payload=None):

{e6data_python_connector-2.3.12rc12 → e6data_python_connector-2.3.12rc31}/e6data_python_connector/datainputstream.py

@@ -12,20 +12,27 @@ from e6data_python_connector.e6x_vector.ttypes import Chunk, Vector, VectorType
 from e6data_python_connector.constants import ZONE
 from e6data_python_connector.date_time_utils import floor_div, floor_mod, timezone_from_offset
 
+# Try to import fastbinary - it's optional but provides better performance
+_fastbinary_available = False
 try:
     from thrift.protocol import fastbinary
+    _fastbinary_available = True
 except ImportError:
-    raise Exception(
-        """
-        Failed to import fastbinary. 
-        Did you install system dependencies?
-        Please verify https://github.com/e6x-labs/e6data-python-connector#dependencies
-        """
-    )
+    pass  # Will check require_fastbinary flag at connection creation time
 
 _logger = logging.getLogger(__name__)
 
 
+def is_fastbinary_available():
+    """
+    Check if fastbinary module is available.
+
+    Returns:
+        bool: True if fastbinary is available, False otherwise
+    """
+    return _fastbinary_available
+
+
 def _binary_to_decimal128(binary_data, scale=None):
     """
     Convert binary data to Decimal128.
@@ -504,6 +511,16 @@ def read_values_from_array(query_columns_description: list, dis: DataInputStream
 
 
 def read_rows_from_chunk(query_columns_description: list, buffer):
+    """
+    Read rows from a Thrift-encoded chunk buffer.
+
+    Args:
+        query_columns_description: List of column descriptions
+        buffer: Thrift-encoded binary buffer
+
+    Returns:
+        List of rows
+    """
     # Create a transport and protocol instance for deserialization
     transport = TTransport.TMemoryBuffer(buffer)
     protocol = TBinaryProtocol.TBinaryProtocolAccelerated(transport)

{e6data_python_connector-2.3.12rc12 → e6data_python_connector-2.3.12rc31}/e6data_python_connector/e6data_grpc.py

@@ -16,7 +16,6 @@ import time
 from decimal import Decimal
 from io import BytesIO
 from ssl import CERT_NONE, CERT_OPTIONAL, CERT_REQUIRED
-from typing import Union, Optional
 import threading
 import multiprocessing
 
@@ -27,7 +26,7 @@ from e6data_python_connector.cluster_manager import ClusterManager
 from e6data_python_connector.strategy import _get_grpc_header as _get_strategy_header
 from e6data_python_connector.common import DBAPITypeObject, ParamEscaper, DBAPICursor
 from e6data_python_connector.constants import *
-from e6data_python_connector.datainputstream import get_query_columns_info, read_rows_from_chunk
+from e6data_python_connector.datainputstream import get_query_columns_info, read_rows_from_chunk, is_fastbinary_available
 from e6data_python_connector.server import e6x_engine_pb2_grpc, e6x_engine_pb2
 from e6data_python_connector.typeId import *
 
@@ -336,7 +335,7 @@ class Connection(object):
             scheme: str = 'e6data',
             grpc_options: dict = None,
             debug: bool = False,
-            ssl_cert: Optional[Union[str, bytes]] = None,
+            require_fastbinary: bool = True,
     ):
         """
         Parameters
@@ -370,14 +369,10 @@ class Connection(object):
                 - keepalive_time_ms: This parameter defines the time, in milliseconds, Default to 30 seconds
             debug: bool, Optional
                 Flag to enable debug logging for blue-green deployment strategy changes
-            ssl_cert: str or bytes, Optional
-                Path to CA certificate file (PEM format) or certificate content as bytes.
-                Used when connecting via HTTPS .
-                If not provided and secure=True, system default CA bundle will be used.
-                For self-signed certificates, provide the CA certificate via this parameter.
-                Examples:
-                    - File path: ssl_cert='/path/to/ca-cert.pem'
-                    - Bytes: ssl_cert=open('/path/to/ca-cert.pem', 'rb').read()
+            require_fastbinary: bool, Optional
+                Flag to require fastbinary module for Thrift deserialization. If True (default),
+                raises an exception if fastbinary is not available. If False, logs a warning
+                and continues with pure Python implementation (with reduced performance).
         """
         if not username or not password:
             raise ValueError("username or password cannot be empty.")
@@ -392,12 +387,34 @@ class Connection(object):
         self._port = port
 
         self._secure_channel = secure
-        self._ssl_cert = ssl_cert
 
         self.catalog_name = catalog
 
         self._auto_resume = auto_resume
 
+        # Store require_fastbinary flag
+        self._require_fastbinary = require_fastbinary
+
+        # Check fastbinary availability at connection creation time
+        if not is_fastbinary_available():
+            if require_fastbinary:
+                raise Exception(
+                    """
+                    Failed to import fastbinary.
+                    Did you install system dependencies?
+                    Please verify https://github.com/e6x-labs/e6data-python-connector#dependencies
+
+                    To continue without fastbinary (with reduced performance), set require_fastbinary=False
+                    in the connection parameters.
+                    """
+                )
+            else:
+                logger.warning(
+                    "fastbinary module is not available. Using pure Python implementation. "
+                    "Performance may be degraded. To enable fastbinary, install system dependencies: "
+                    "https://github.com/e6x-labs/e6data-python-connector#dependencies"
+                )
+
         self._grpc_options = grpc_options
         if self._grpc_options is None:
             self._grpc_options = dict()
@@ -494,60 +511,6 @@ class Connection(object):
 
         return self._cached_grpc_options
 
-    def _get_ssl_credentials(self):
-        """
-        Creates SSL/TLS credentials for secure gRPC connections.
-
-        This method handles loading CA certificates from various sources:
-        - File path (str): Reads the certificate from the specified file
-        - Bytes: Uses the certificate content directly
-        - None: Uses system default CA bundle
-
-        Returns:
-            grpc.ChannelCredentials: SSL credentials for secure channel creation
-
-        Raises:
-            FileNotFoundError: If ssl_cert is a file path and the file doesn't exist
-            ValueError: If ssl_cert format is invalid or file cannot be read
-        """
-        root_certificates = None
-
-        if self._ssl_cert:
-            # Custom CA certificate provided
-            if isinstance(self._ssl_cert, str):
-                # It's a file path - read the certificate
-                try:
-                    with open(self._ssl_cert, 'rb') as f:
-                        root_certificates = f.read()
-                    if self._debug:
-                        logger.info(f"Loaded CA certificate from file: {self._ssl_cert}")
-                except FileNotFoundError:
-                    raise FileNotFoundError(
-                        f"CA certificate file not found: {self._ssl_cert}. "
-                        f"Please ensure the file exists and the path is correct."
-                    )
-                except Exception as e:
-                    raise ValueError(
-                        f"Failed to read CA certificate from {self._ssl_cert}: {str(e)}"
-                    )
-            elif isinstance(self._ssl_cert, bytes):
-                # Certificate content provided as bytes
-                root_certificates = self._ssl_cert
-                if self._debug:
-                    logger.info("Using CA certificate provided as bytes")
-            else:
-                raise ValueError(
-                    f"ssl_cert must be either a file path (str) or certificate content (bytes), "
-                    f"got {type(self._ssl_cert)}"
-                )
-        else:
-            # No custom CA certificate - use system default CA bundle
-            if self._debug:
-                logger.info("Using system default CA bundle for SSL/TLS")
-
-        # Create and return SSL credentials with certificate verification enabled
-        return grpc.ssl_channel_credentials(root_certificates=root_certificates)
-
     def _create_client(self):
         """
         Creates a gRPC client for the connection.
@@ -562,19 +525,13 @@ class Connection(object):
 
         Raises:
             grpc.RpcError: If there is an error in creating the gRPC channel or client stub.
-            FileNotFoundError: If ssl_cert is a file path and the file doesn't exist.
-            ValueError: If ssl_cert format is invalid.
         """
 
         if self._secure_channel:
-            # Get SSL credentials (handles CA cert loading and validation)
-            credentials = self._get_ssl_credentials()
-
-            # Create secure channel
             self._channel = grpc.secure_channel(
                 target='{}:{}'.format(self._host, self._port),
                 options=self._get_grpc_options,
-                credentials=credentials
+                credentials=grpc.ssl_channel_credentials()
             )
         else:
             self._channel = grpc.insecure_channel(
@@ -756,8 +713,7 @@ class Connection(object):
                     secure_channel=self._secure_channel,
                     cluster_uuid=self.cluster_name,
                     timeout=self.grpc_auto_resume_timeout_seconds,
-                    debug=self._debug,
-                    ssl_cert=self._ssl_cert
+                    debug=self._debug
                 ).resume()
                 return status  # Return boolean status directly
             else:
@@ -1536,7 +1492,10 @@ class Cursor(DBAPICursor):
         if not buffer or len(buffer) == 0:
             return None
         # one batch retrieves the predefined set of rows
-        return read_rows_from_chunk(self._query_columns_description, buffer)
+        return read_rows_from_chunk(
+            self._query_columns_description,
+            buffer
+        )
 
     def fetchall(self):
         """

{e6data_python_connector-2.3.12rc12 → e6data_python_connector-2.3.12rc31/e6data_python_connector.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: e6data-python-connector
-Version: 2.3.12rc12
+Version: 2.3.12rc31
 Summary: Client for the e6data distributed SQL Engine.
 Home-page: https://github.com/e6x-labs/e6data-python-connector
 Author: e6data, Inc.
@@ -39,7 +39,7 @@ Dynamic: summary
 
 # e6data Python Connector
 
-![version](https://img.shields.io/badge/version-2.3.12rc12-blue.svg)
+![version](https://img.shields.io/badge/version-2.3.12rc31-blue.svg)
 
 ## Introduction
 
@@ -125,7 +125,7 @@ The `Connection` class supports the following parameters:
 | `auto_resume` | bool | No | True | Automatically resume cluster if suspended |
 | `grpc_options` | dict | No | None | Additional gRPC configuration options |
 | `debug` | bool | No | False | Enable debug logging for troubleshooting |
-| `ssl_cert` | str/bytes | No | None | Path to CA certificate (PEM) or certificate bytes for HTTPS connections |
+| `require_fastbinary` | bool | No | True | Require fastbinary module for Thrift deserialization. Set to False to use pure Python implementation if system dependencies cannot be installed |
 
 #### Secure Connection Example
 
@@ -143,14 +143,11 @@ conn = Connection(
 )
 ```
 
-#### HTTPS Connection with HAProxy
+#### Cluster-Specific Connection
 
-When connecting through HAProxy with HTTPS/TLS and custom CA certificates:
+When working with multiple clusters, specify the cluster name:
 
 ```python
-from e6data_python_connector import Connection
-
-# Option 1: Using CA certificate file path
 conn = Connection(
     host=host,
     port=port,
@@ -158,40 +155,30 @@ conn = Connection(
     password=password,
     database=database,
     cluster_name='analytics-cluster-01',  # Specify cluster name
-    secure=True,
-    ssl_cert='/path/to/ca-cert.pem'  # Path to CA certificate
+    secure=True
 )
+```
 
-# Option 2: Reading certificate content as bytes
-with open('/path/to/ca-cert.pem', 'rb') as f:
-    ca_cert = f.read()
+#### Handling Missing System Dependencies
 
-conn = Connection(
-    host=host,
-    port=port,
-    username=username,
-    password=password,
-    database=database,
-    secure=True,
-    ssl_cert=ca_cert  # Certificate as bytes
-)
+The e6data connector uses the `fastbinary` module (from Apache Thrift) for optimal performance when deserializing data. This module requires system-level dependencies (`python3-devel` and `gcc-c++`) to be installed.
+
+**Default Behavior (Recommended):**
+By default, the connector requires `fastbinary` to be available. If it's not found, the connection will fail immediately with a clear error message:
 
-# Option 3: System CA bundle (for publicly signed certificates)
+```python
 conn = Connection(
     host=host,
     port=port,
     username=username,
     password=password,
-    database=database,
-    secure=True  # Uses system CA bundle
+    database=database
 )
+# Raises exception if fastbinary is not available
 ```
 
-**Note:** Certificate verification is always enabled for security. For self-signed certificates, provide the CA certificate via the `ssl_cert` parameter.
-
-#### Cluster-Specific Connection
-
-When working with multiple clusters, specify the cluster name:
+**Fallback to Pure Python:**
+If you cannot install system dependencies (e.g., in restricted environments, serverless platforms, or containers without build tools), you can disable the `fastbinary` requirement. The connector will fall back to a pure Python implementation with a performance penalty:
 
 ```python
 conn = Connection(
@@ -200,11 +187,23 @@ conn = Connection(
     username=username,
     password=password,
     database=database,
-    cluster_name='analytics-cluster-01',  # Specify cluster name
-    secure=True
+    require_fastbinary=False  # Allow operation without fastbinary
 )
+# Logs warning but continues with pure Python implementation
 ```
 
+**When to use `require_fastbinary=False`:**
+- Running in AWS Lambda or other serverless environments
+- Docker containers built without compilation tools
+- Restricted environments where system packages cannot be installed
+- Development/testing environments where performance is not critical
+
+**Performance Impact:**
+- With `fastbinary`: Optimal performance for data deserialization
+- Without `fastbinary` (pure Python): ~2-3x slower deserialization, but otherwise fully functional
+
+**Note:** It's strongly recommended to install system dependencies when possible for best performance. The `require_fastbinary=False` option should only be used when system dependencies cannot be installed.
+
 ### Perform a Queries & Get Results
 
 ```python
@@ -551,35 +550,6 @@ pool.return_connection(conn)
 pool.close_all()
 ```
 
-##### Connection Pool with HTTPS (HAProxy)
-
-```python
-from e6data_python_connector import ConnectionPool
-
-# Connection pool with HTTPS and custom CA certificate
-pool = ConnectionPool(
-   min_size=2,
-    max_size=10,
-    host=host,
-    port=port,
-    username=username,
-    password=password,
-    database=database,
-    secure=True,
-    ssl_cert='/path/to/ca-cert.pem'  # CA certificate for HTTPS
-)
-
-# Use the pool with context manager for automatic cleanup
-with pool.get_connection_context() as conn:
-    cursor = conn.cursor()
-    cursor.execute("SELECT * FROM table")
-    results = cursor.fetchall()
-    print(f"Retrieved {len(results)} rows")
-
-# Clean up pool when done
-pool.close_all()
-```
-
 ##### Using Context Manager (Recommended)
 
 The context manager pattern ensures connections are automatically returned to the pool:
@@ -767,5 +737,6 @@ python your_script.py
 | 456 Strategy Error | Automatic blue-green failover will handle this |
 | Memory issues with large results | Use `fetchall_buffer()` instead of `fetchall()` |
 | gRPC message size errors | Configure `grpc_options` with appropriate message size limits |
+| fastbinary import error | Install system dependencies (`python3-devel`, `gcc-c++`) or set `require_fastbinary=False` |
 
 See [TECH_DOC.md](TECH_DOC.md) for detailed technical documentation.

{e6data_python_connector-2.3.12rc12 → e6data_python_connector-2.3.12rc31}/setup.py

@@ -12,7 +12,7 @@
 
 import setuptools
 
-VERSION = (2, 3, 12, 'rc12',)
+VERSION = (2, 3, 12, 'rc31',)
 
 
 def get_long_desc():