FEAT: Build Wheels for MacOS (#85)

### Summary  
This pull request introduces significant updates to the
`eng/pipelines/build-whl-pipeline.yml` file to expand the build pipeline
by adding support for macOS alongside existing Windows builds. Key
changes include the addition of a macOS-specific job for building Python
wheels, enhancements to the build strategy for cross-platform
compatibility, and new steps for dependency installation and artifact
management.

### macOS Build Pipeline Addition:
* Added a new `BuildMacOSWheels` job to the pipeline, which uses a macOS
image (`macos-latest`) to build Python wheels for Python versions 3.10
through 3.13 on the x86_64 architecture. This includes a matrix strategy
to handle multiple Python versions.
* Introduced steps to install macOS-specific dependencies such as
`CMake` and `pybind11`, build `.so` files using a `build.sh` script, and
package them into wheel files.

### Dependency Management and Artifact Handling:
* Added steps to install required Python dependencies and tools (e.g.,
`pip`, `setuptools`, `wheel`) and to copy and publish the built `.so`
and `.whl` files as build artifacts for macOS.
* Enhanced the pipeline to include tasks for publishing test results and
code coverage reports for macOS builds.

### General Pipeline Adjustments:
* Updated the pipeline structure to include the new `BuildMacOSWheels`
job alongside the existing `BuildWindowsWheels` job, ensuring
cross-platform compatibility.

### Issue Reference  
Fixes
[AB#37752](https://sqlclientdrivers.visualstudio.com/c6d89619-62de-46a0-8b46-70b92a84d85e/_workitems/edit/37752)

### Checklist  
- [x] **Tests Passed** (if applicable)  
- [x] **Code is formatted**   
- [x] **Docs Updated** (if necessary) 

### Testing Performed  
<!-- How was this fix tested? -->
- [x] Unit Tests`   

### Additional Notes  
<!-- Any extra details or related links -->

Author: bewithgaurav

eng/pipelines/build-whl-pipeline.yml

@@ -13,13 +13,12 @@ pr:
     include:
       - main  
 
-# Use Microsoft-hosted Windows VM
-pool:
-  vmImage: 'windows-latest'
-
 jobs:
-- job: BuildPYDs
-  displayName: 'Build -'
+- job: BuildWindowsWheels
+  # Use the latest Windows image for building
+  pool:
+    vmImage: 'windows-latest'
+  displayName: 'Build Windows -'
   # Strategy matrix to build all combinations
   strategy:
     matrix:
@@ -123,7 +122,7 @@ jobs:
       inputs:
         SourceFolder: '$(Build.SourcesDirectory)\mssql_python\pybind\build\$(targetArch)\py$(shortPyVer)\Release'
         Contents: 'ddbc_bindings.cp$(shortPyVer)-*.pyd'
-        TargetFolder: '$(Build.ArtifactStagingDirectory)\all-pyds'
+        TargetFolder: '$(Build.ArtifactStagingDirectory)\ddbc-bindings'
       displayName: 'Place PYD file into artifacts directory'
 
     # Copy the built .pdb files to staging folder for artifacts
@@ -154,12 +153,15 @@ jobs:
     - task: PublishBuildArtifacts@1
       condition: succeededOrFailed()
       inputs:
-        PathtoPublish: '$(Build.ArtifactStagingDirectory)\all-pyds'
-        ArtifactName: 'mssql-python-pyds'
+        PathtoPublish: '$(Build.ArtifactStagingDirectory)\ddbc-bindings'
+        ArtifactName: 'mssql-python-ddbc-bindings'
         publishLocation: 'Container'
       displayName: 'Publish all PYDs as artifacts'
 
     # Publish the python arm64 libraries as build artifacts for next builds if ARM64
+    # We publish them only for ARM64 builds since we cannot install arm64 Python on x64 host
+    # This allows us to reuse the libraries in future ARM64 builds
+    # Publishing will retain the libraries in the build artifacts
     - task: PublishBuildArtifacts@1
       condition: eq(variables['targetArch'], 'arm64')
       inputs:
@@ -176,3 +178,90 @@ jobs:
         ArtifactName: 'mssql-python-wheels-dist'
         publishLocation: 'Container'
       displayName: 'Publish all wheels as artifacts'
+
+- job: BuildMacOSWheels
+  # Use the latest macOS image for building
+  pool:
+    vmImage: 'macos-latest'
+  # Display name for the job in Azure DevOps UI
+  displayName: 'Build macOS - '
+  strategy:
+    matrix:
+      # Python 3.13 (only x86_64 for builds)
+      py313_x86_64:
+        pythonVersion: '3.13'
+        shortPyVer: '313'
+        # targetArch is not used anywhere since build.sh does auto-detection, kept for cross-compilation of ARM64 Builds
+        targetArch: 'x86_64'
+  steps:
+    # Use correct Python version and architecture for the current job
+    - task: UsePythonVersion@0
+      inputs:
+        versionSpec: '$(pythonVersion)'
+        addToPath: true
+      displayName: 'Use Python $(pythonVersion) (x86_64)'
+
+    # Install CMake on macOS
+    - script: |
+        brew update
+        brew install cmake
+      displayName: 'Install CMake'
+
+    # Install required packages: pip, CMake, pybind11
+    - script: |
+        python -m pip install --upgrade pip
+        pip install -r requirements.txt
+        pip install cmake pybind11
+      displayName: 'Install dependencies'
+
+    # Build the .so file by calling build.sh
+    - script: |
+        echo "Python Version: $(pythonVersion)"
+        echo "Short Tag: $(shortPyVer)"
+        echo "Architecture: Target=$(targetArch)"
+        cd "$(Build.SourcesDirectory)/mssql_python/pybind"
+        # Call build.sh to build the .so file
+        ./build.sh
+      displayName: 'Build .so file'
+
+    # Copy the built .so file to staging folder for artifacts
+    - task: CopyFiles@2
+      inputs:
+        SourceFolder: '$(Build.SourcesDirectory)/mssql_python'
+        Contents: '*.so'
+        TargetFolder: '$(Build.ArtifactStagingDirectory)/ddbc-bindings'
+      displayName: 'Place .so file into artifacts directory'
+    
+    # Build wheel package for the current architecture
+    - script: |
+        python -m pip install --upgrade pip
+        pip install wheel setuptools
+        set ARCHITECTURE=$(targetArch)
+        python setup.py bdist_wheel
+      displayName: 'Build wheel package for Python $(pythonVersion) ($(targetArch))'
+    
+    # Copy the wheel file to the artifacts
+    - task: CopyFiles@2
+      inputs:
+        SourceFolder: '$(Build.SourcesDirectory)/dist'
+        Contents: '*.whl'
+        TargetFolder: '$(Build.ArtifactStagingDirectory)/dist'
+      displayName: 'Collect wheel package'
+    
+    # Publish the collected .so file(s) as build artifacts
+    - task: PublishBuildArtifacts@1
+      condition: succeededOrFailed()
+      inputs:
+        PathtoPublish: '$(Build.ArtifactStagingDirectory)/ddbc-bindings'
+        ArtifactName: 'mssql-python-ddbc-bindings'
+        publishLocation: 'Container'
+      displayName: 'Publish all .so files as artifacts'
+    
+    # Publish the collected wheel file(s) as build artifacts
+    - task: PublishBuildArtifacts@1
+      condition: succeededOrFailed()
+      inputs:
+        PathtoPublish: '$(Build.ArtifactStagingDirectory)/dist'
+        ArtifactName: 'mssql-python-wheels-dist'
+        publishLocation: 'Container'
+      displayName: 'Publish all wheels as artifacts'

setup.py

@@ -81,8 +81,11 @@ def finalize_options(self):
         if platform.machine() == 'arm64':
             arch = 'arm64'
             platform_tag = 'macosx_15_0_arm64'
+        elif platform.machine() == 'x86_64':
+            arch = 'x86_64'
+            platform_tag = 'macosx_15_0_x86_64'
         else:
-            raise Exception("Unsupported architecture for macOS. Please set the ARCHITECTURE environment variable to 'arm64'.")
+            raise Exception("Unsupported architecture for macOS.")
 
     # Add architecture-specific packages for macOS
     packages.extend([