FEAT: Adding Ouput Converter APIs

[jahnvi480]

Work Item / Issue Reference

AB#34913
AB#34914
AB#34915
AB#34916

---

Summary

This pull request adds a flexible output converter system to the database connection, allowing custom Python functions to be registered for converting SQL data types when fetching results. It introduces new methods for managing these converters and updates the row handling logic to apply them automatically. Comprehensive tests are added to verify correct registration, retrieval, removal, and integration of output converters, including edge cases and chaining behavior.

Core output converter system:

• Added methods to Connection (add_output_converter, get_output_converter, remove_output_converter, clear_output_converters) for registering and managing output converter functions for specific SQL types. These converters are called when values of the registered SQL type are read from the database. (mssql_python/connection.py)
• Updated the Row class to apply registered output converters automatically to values fetched from the database, with fallback logic for string types and robust error handling. (mssql_python/row.py)

Testing and validation:

• Added extensive tests for output converter management, including adding, retrieving, removing, clearing, chaining, temporary replacement, and integration during data fetching. Tests also cover edge cases such as handling NULL values and using multiple converters at once. (tests/test_003_connection.py)
• Introduced helper converter functions for specific SQL types (e.g., DATETIMEOFFSET and custom string handling) to support and validate the new converter system in tests. (tests/test_003_connection.py)

Test and utility enhancements:

• Imported additional modules (struct, datetime, timezone, and constants) to support new test cases and converter logic. (tests/test_003_connection.py)

[sumitmsft]

Left a few comments.

The base branch was changed.

[Copilot]

Pull Request Overview

This pull request adds a flexible output converter system to the mssql-python database connection, allowing custom Python functions to be registered for converting SQL data types when fetching results. The implementation includes comprehensive thread-safe methods for managing converters and robust integration with the row handling logic.

• Adds connection-level output converter management methods (add, get, remove, clear) with thread safety
• Updates Row class to automatically apply registered output converters during data fetching with error handling
• Includes extensive testing for converter registration, retrieval, integration, and edge cases

Reviewed Changes

Copilot reviewed 5 out of 6 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
mssql_python/connection.py	Adds output converter management methods and convenience execute() method with thread-safe implementation
mssql_python/row.py	Updates Row class to apply output converters automatically with fallback logic and error handling
tests/test_003_connection.py	Adds comprehensive tests for output converter functionality including helper functions and edge cases
tests/test_004_cursor.py	Reorganizes test functions by moving them to different locations within the file
tests/test_001_globals.py	Adds duplicate test for decimal separator functionality

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}