Add detailed connection testing to connectors documentation and implementation

- Introduced a new method `test_connection_detailed` in `ConnectorsResource` to return detailed connection test results, including elapsed time.
- Updated documentation to include examples for both basic and detailed connection testing.

Author: RubenAMtz

docs/guides/connectors.md

@@ -37,6 +37,12 @@ Test connection (basic):
 ok = client.connectors.test_connection(conn.id)
 ```
 
+Test connection (detailed):
+```python
+details = client.connectors.test_connection_detailed(conn.id)
+# {'ok': True, 'elapsed_ms': 123}
+```
+
 Filter by type:
 ```python
 pg = client.connectors.list_by_type("postgres")
@@ -64,4 +70,5 @@ snowflake_conn = client.connectors.create(
 
 # Optional: test the connection
 ok = client.connectors.test_connection(snowflake_conn.id)
+details = client.connectors.test_connection_detailed(snowflake_conn.id)
 ```

documentation/docs/guides/connectors.md

@@ -37,6 +37,12 @@ Test connection (basic):
 ok = client.connectors.test_connection(conn.id)
 ```
 
+Test connection (detailed):
+```python
+details = client.connectors.test_connection_detailed(conn.id)
+# {'ok': True, 'elapsed_ms': 123}
+```
+
 Filter by type:
 ```python
 pg = client.connectors.list_by_type("postgres")
@@ -64,6 +70,7 @@ snowflake_conn = client.connectors.create(
 
 # Optional: test the connection
 ok = client.connectors.test_connection(snowflake_conn.id)
+details = client.connectors.test_connection_detailed(snowflake_conn.id)
 ```
 
 

resources/connectors.py

@@ -267,12 +267,21 @@ def test_connection(self, connector_id: str) -> bool:
             ```
         """
         try:
-            # This would typically be a separate endpoint, but for now we'll use get
-            # In a real implementation, there might be a POST /connectors/{id}/test endpoint
-            connector = self.get(connector_id)
-            return True
+            resp = self._client.post(f"/connectors/{connector_id}/test")
+            return bool(resp.get("ok", False))
         except Exception as e:
             raise ValidationError(f"Connection test failed: {str(e)}")
+
+    def test_connection_detailed(self, connector_id: str) -> dict:
+        """Test a connector and return detailed response (e.g., elapsed_ms).
+        
+        Args:
+            connector_id: The connector ID to test
+            
+        Returns:
+            Dict with fields like { ok: bool, elapsed_ms: int }
+        """
+        return self._client.post(f"/connectors/{connector_id}/test")
 
     def list_by_type(self, db_type: str) -> List[Connector]:
         """List connectors by database type.