RELEASE: 0.7.0 (#121)

bewithgaurav · web-flow · commit ef7049389df5 · 2025-07-04T21:28:52.000+05:30
### ADO Work Item Reference  > [AB#37855](https://sqlclientdrivers.visualstudio.com/c6d89619-62de-46a0-8b46-70b92a84d85e/_workitems/edit/37855) ------------------------------------------------------------------- ### Summary  This pull request introduces significant updates to the `mssql-python` driver, including expanded platform support, enhanced authentication features, and pipeline adjustments. The most important changes focus on enabling Linux support, improving cross-platform connection pooling, updating authentication capabilities, and refining the build pipeline configurations. ### Platform Support Enhancements: * **Linux Support**: Added support for Linux OS (manylinux2014) including Ubuntu, Debian, and RHEL. This includes architecture-specific handling and ODBC driver path resolution. Support for additional Linux distributions will follow in future releases. (`PyPI_Description.md` - [[1]](diffhunk://#diff-5236254592b2fea0773f17424b16acf82e3aa351ad8bae33871de5c98eb76eedL11-R14) `README.md` - [[2]](diffhunk://#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5R23-R34) * **Connection Pooling for MacOS and Linux**: Implemented connection pooling features for MacOS and Linux, unifying code support for pooling across platforms. (`PyPI_Description.md` - [PyPI_Description.mdL11-R14](diffhunk://#diff-5236254592b2fea0773f17424b16acf82e3aa351ad8bae33871de5c98eb76eedL11-R14)) ### Authentication Updates: * **Expanded Entra ID Authentication**: Added a table summarizing authentication method support across Windows, MacOS, and Linux, clarifying limitations for specific methods like `ActiveDirectoryInteractive` and `ActiveDirectoryIntegrated`. (`README.md` - [README.mdR53-R69](diffhunk://#diff-b335630551682c19a781afebcf4d07bf978fb1f8ac04c6bf87428ed5106870f5R53-R69)) ### Version Update: * **Driver Version Increment**: Updated the version of the `mssql-python` driver from `0.6.0` to `0.7.0` in `setup.py`. (`setup.py` - [setup.pyL82-R82](diffhunk://#diff-60f61ab7a8d1910d86d9fda2261620314edcae5894d5aaa236b821c7256badd7L82-R82)) These changes collectively enhance the functionality, compatibility, and maintainability of the `mssql-python` driver across platforms.
diff --git a/PyPI_Description.md b/PyPI_Description.md
@@ -8,9 +8,10 @@ We are making progress - The Public Preview of our driver is now available! This
 
 ### What's Included:
 
-- Everything from alpha
-- macOS Support: The mssql-python driver now supports macOS on Intel as well as ARM-based systems, enabling seamless development on Apple Silicon (M-series) devices. This milestone strengthens our cross-platform capabilities—and we’re just getting started. Linux support is on the horizon!
-- Connection Pooling: We've introduced a robust and configurable connection pooling system designed to significantly enhance performance and optimize resource utilization. This feature ensures more efficient management of database connections, especially under high-load scenarios. This feature is only available on Windows as of now.
+- Everything from previous releases
+- **Linux Support**: The mssql-python driver now supports Linux OS (manylinux2014) - Ubuntu, Debian and RHEL, enabling seamless development on Linux based systems. Added Linux driver libraries and related logic for architecture-specific handling and ODBC driver path resolution. Support for other Linux based distros will come in subsequent releases.
+- **Connection Pooling Support for MacOS and Linux**: Implemented connection pooling features for MacOS and Linux, including tests and unified code support for pooling across platforms.
+Expanded Pipeline/Test Matrix: Added/expanded support for Python versions < 3.13 and enhanced database setup for testing, including LocalDB and Docker-based SQL Server.
 
 For more information, please visit the project link on Github: https://github.com/microsoft/mssql-python
 
diff --git a/README.md b/README.md
@@ -20,14 +20,18 @@ pip install mssql-python
 brew install openssl
 pip install mssql-python
 ```
+**Linux:** mssql-python can be installed with [pip](http://pypi.python.org/pypi/pip)
+```bash
+pip install mssql-python
+```
 
 ## Key Features
 ### Supported Platforms
  
-Windows and MacOS
- 
+Windows, MacOS and Linux (manylinux2014 - Debian, Ubuntu & RHEL)
+
 > **Note:**
-> Support for Linux is coming soon
+> Support for additional Linux OSs (Alpine, SUSE Linux) will come soon
 >
  
 ### DBAPI v2.0 Compliance
@@ -45,15 +49,24 @@ By adhering to the DB API 2.0 specification, the mssql-python module ensures com
 ### Support for Microsoft Entra ID Authentication
  
 The Microsoft mssql-python driver enables Python applications to connect to Microsoft SQL Server, Azure SQL Database, or Azure SQL Managed Instance using Microsoft Entra ID identities. It supports various authentication methods, including username and password, Microsoft Entra managed identity, and Integrated Windows Authentication in a federated, domain-joined environment. Additionally, the driver supports Microsoft Entra interactive authentication and Microsoft Entra managed identity authentication for both system-assigned and user-assigned managed identities.
- 
+
+EntraID authentication is now fully supported on MacOS and Linux but with certain limitations as mentioned in the table:
+
+| Authentication Method | Windows Support | macOS/Linux Support | Notes |
+|----------------------|----------------|---------------------|-------|
+| ActiveDirectoryPassword | ✅ Yes | ✅ Yes | Username/password-based authentication |
+| ActiveDirectoryInteractive | ✅ Yes | ❌ No | Only works on Windows |
+| ActiveDirectoryMSI (Managed Identity) | ✅ Yes | ✅ Yes | For Azure VMs/containers with managed identity |
+| ActiveDirectoryServicePrincipal | ✅ Yes | ✅ Yes | Use client ID and secret or certificate |
+| ActiveDirectoryIntegrated | ✅ Yes | ❌ No | Only works on Windows (requires Kerberos/SSPI) |
+
 ### Enhanced Pythonic Features
  
 The driver offers a suite of Pythonic enhancements that streamline database interactions, making it easier for developers to execute queries, manage connections, and handle data more efficiently.
  
 ### Connection Pooling
  
-The Microsoft mssql_python driver provides built-in support for connection pooling, which helps improve performance and scalability by reusing active database connections instead of creating a new connection for every request.
- 
+The Microsoft mssql_python driver provides built-in support for connection pooling, which helps improve performance and scalability by reusing active database connections instead of creating a new connection for every request. This feature is enabled by default. For more information, refer [Connection Pooling Wiki](https://github.com/microsoft/mssql-python/wiki/Connection#connection-pooling).
  
 ## Getting Started Examples
 Connect to SQL Server and execute a simple query:
diff --git a/ROADMAP.md b/ROADMAP.md
@@ -25,27 +25,15 @@ In future releases, we plan to add several DBAPI enhancements, including:
 - `Output` and `InputOutput` Parameters: Handling of output and input-output parameters in stored procedures.
 - Optional DBAPIs: Additional optional DBAPI features to provide more flexibility and functionality for developers.
 
-**3. Connection Pooling for MacOS and Linux Distributions**
+**3. Cross-Platform Support: Additional Linux Distributions** 
 
-Connection pooling will be made available soon for MacOS and Linux distributions, allowing for efficient reuse of database connections. The feature is already available for Windows OS. This feature will significantly improve performance by reducing the overhead associated with establishing new connections for each database operation .
-- Reduce Connection creation overhead
-- Improve scalability via efficient reuse of connections
-- Enhance multi-threaded operation performance
+We are committed to providing cross-platform support for our Python driver. In the next few weeks, we will release support for additional Linux distributions viz Alpine, SUSE Linux & Oracle Linux.
 
-**4. Cross-Platform Support: Linux Distributions** 
-
-We are committed to providing cross-platform support for our Python driver. In the next few weeks, we will release versions compatible with various Linux distributions. This will enable developers to use the driver on their preferred operating systems without any compatibility issues. 
-Soon, you will be able to:
-- Use the driver across multiple environments and OS
-- Deploy application on cloud-native platforms
-- Avoid compatibility issues with system-dependent code
-- Flexibility in choosing development environments
-
-**5. Bulk Copy (BCP)**
+**4. Bulk Copy (BCP)**
 
 Bulk Copy API (BCP) support is coming soon to the Python Driver for SQL Server. It enables high-speed data ingestion and offers fine-grained control over batch operations, making it ideal for large-scale ETL workflows.
 
-**6. Asynchronous Query Execution**
+**5. Asynchronous Query Execution**
 
 We are also working on adding support for asynchronous query execution. This feature will allow developers to execute queries without blocking the main thread, enabling more responsive and efficient applications. Asynchronous query execution will be particularly beneficial for applications that require high concurrency and low latency.
 - No blocking of the main thread
diff --git a/setup.py b/setup.py
@@ -79,7 +79,7 @@ def finalize_options(self):
 
 setup(
     name='mssql-python',
-    version='0.6.0',
+    version='0.7.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',
