RELEASE: 0.13.0 (#269)

bewithgaurav · web-flow · commit 49a04c34759d · 2025-10-03T16:28:11.000+05:30
### Work Item / Issue Reference   > [AB#39062](https://sqlclientdrivers.visualstudio.com/c6d89619-62de-46a0-8b46-70b92a84d85e/_workitems/edit/39062) ------------------------------------------------------------------- ### Summary  This pull request updates the package to version 0.13.0 and revises the release notes to highlight new features and critical stability improvements. The most important changes are grouped below: Version update: * Updated the package version from `0.12.0` to `0.13.0` in `setup.py` to reflect the latest release. Release notes and feature enhancements (in `PyPI_Description.md`): * Added support for streaming large values (NVARCHAR/VARCHAR/VARBINARY(MAX)) in `executemany()` with automatic Data-At-Execution detection and fallback, enabling efficient handling of massive datasets. * Improved batch operations with complete support for UNIQUEIDENTIFIER and DATETIMEOFFSET in `executemany()`, including automatic type inference for bulk inserts of UUIDs and timezone-aware datetimes. * Enhanced cursor reliability by improving `cursor.rowcount` accuracy for all fetch operations, including proper handling of empty result sets and consistent behavior for SELECT, INSERT, and UPDATE. * Addressed critical stability issues by resolving memory leaks, fixing resource cleanup to prevent segmentation faults during Python shutdown, and correcting type inference bugs in batch operations.
diff --git a/PyPI_Description.md b/PyPI_Description.md
@@ -39,12 +39,12 @@ PyBind11 provides:
 
 We are currently in **Public Preview**.
 
-## What's new in v0.12.0
+## What's new in v0.13.0
 
-- **Complex Data Type Support:** Added native support for DATETIMEOFFSET and UNIQUEIDENTIFIER data types with full round-trip handling, enabling seamless integration with Python's timezone-aware `datetime` objects and `uuid.UUID` types.
-- **Support for monetary or currency values data types:** Extended MONEY and SMALLMONEY support to `executemany` operations with proper NULL handling and decimal conversion for improved bulk financial data processing.
-- **Improved Database Metadata API:** Added `getinfo()` method with enhanced ODBC metadata retrieval, allowing users to query driver/data source information using ODBC info types.
-- **Data Processing Optimizations:** Removed aggressive datetime parsing to prevent incorrect type conversions and improve data integrity across diverse datetime formats and string data.
+- **Enhanced Batch Operations:** Complete support for UNIQUEIDENTIFIER and DATETIMEOFFSET in `executemany()` operations with automatic type inference, enabling efficient bulk inserts of complex data types including UUIDs and timezone-aware datetimes.
+- **Streaming Large Values:** Robust handling of large objects (NVARCHAR/VARCHAR/VARBINARY(MAX)) in `executemany()` with automatic Data-At-Execution detection and fallback, supporting streaming inserts and fetches for massive datasets.
+- **Improved Cursor Reliability:** Enhanced `cursor.rowcount` accuracy across all fetch operations, including proper handling of empty result sets and consistent behavior for SELECT, INSERT, and UPDATE operations.
+- **Critical Stability Fixes:** Resolved memory leaks with secure token buffer handling, fixed resource cleanup to prevent segmentation faults during Python shutdown, and corrected type inference bugs in batch operations.
 
 For more information, please visit the project link on Github: https://github.com/microsoft/mssql-python
 
diff --git a/mssql_python/pybind/ddbc_bindings.cpp b/mssql_python/pybind/ddbc_bindings.cpp
@@ -2069,8 +2069,10 @@ SQLRETURN BindParameterArray(SQLHANDLE hStmt,
                     SQLGUID* guidArray = AllocateParamBufferArray<SQLGUID>(tempBuffers, paramSetSize);
                     strLenOrIndArray = AllocateParamBufferArray<SQLLEN>(tempBuffers, paramSetSize);
 
-                    static py::module_ uuid_mod = py::module_::import("uuid");
-                    static py::object uuid_class = uuid_mod.attr("UUID");
+                    // Get cached UUID class from module-level helper
+                    // This avoids static object destruction issues during Python finalization
+                    py::object uuid_class = py::module_::import("mssql_python.ddbc_bindings").attr("_get_uuid_class")();
+                    
                     for (size_t i = 0; i < paramSetSize; ++i) {
                         const py::handle& element = columnValues[i];
                         std::array<unsigned char, 16> uuid_bytes;
@@ -3903,6 +3905,14 @@ PYBIND11_MODULE(ddbc_bindings, m) {
     });
 
 
+    // Module-level UUID class cache
+    // This caches the uuid.UUID class at module initialization time and keeps it alive
+    // for the entire module lifetime, avoiding static destructor issues during Python finalization
+    m.def("_get_uuid_class", []() -> py::object {
+        static py::object uuid_class = py::module_::import("uuid").attr("UUID");
+        return uuid_class;
+    }, "Internal helper to get cached UUID class");
+
     // Add a version attribute
     m.attr("__version__") = "1.0.0";
     
diff --git a/setup.py b/setup.py
@@ -83,7 +83,7 @@ def finalize_options(self):
 
 setup(
     name='mssql-python',
-    version='0.12.0',
+    version='0.13.0',
     description='A Python library for interacting with Microsoft SQL Server',
     long_description=open('PyPI_Description.md', encoding='utf-8').read(),
     long_description_content_type='text/markdown',
