NO-SNOW: passing interface of connect async ig

Author: sfc-gh-fpawlowski

src/snowflake/connector/aio/_connection.py

@@ -117,6 +117,21 @@ def __init__(
         connections_file_path: pathlib.Path | None = None,
         **kwargs,
     ) -> None:
+        """Create a new SnowflakeConnection.
+
+        Connections can be loaded from the TOML file located at
+        snowflake.connector.constants.CONNECTIONS_FILE.
+
+        When connection_name is supplied we will first load that connection
+        and then override any other values supplied.
+
+        When no arguments are given (other than connection_file_path) the
+        default connection will be loaded first. Note that no overwriting is
+        supported in this case.
+
+        If overwriting values from the default connection is desirable, supply
+        the name explicitly.
+        """
         # note we don't call super here because asyncio can not/is not recommended
         # to perform async operation in the __init__ while in the sync connection we
         # perform connect

test/integ/aio_it/test_connection_async.py

@@ -1812,12 +1812,19 @@ async def test_connect_metadata_preservation():
     except Exception as e:
         pytest.fail(f"inspect.signature(connect) failed: {e}")
 
-    # Test 7: Check __doc__ is preserved on the instance
-    # Note: inspect.getdoc() doesn't work reliably on instances, so we check __doc__ directly
-    assert hasattr(connect, "__doc__"), "connect instance should have __doc__ attribute"
-    assert (
-        connect.__doc__ == SnowflakeConnection.__init__.__doc__
-    ), "connect.__doc__ should match SnowflakeConnection.__init__.__doc__ on the instance"
+    # Test 7: Check inspect.getdoc works correctly  
+    connect_doc = inspect.getdoc(connect)
+    source_doc = inspect.getdoc(SnowflakeConnection.__init__)
+    assert connect_doc == source_doc, (
+        "inspect.getdoc(connect) should match inspect.getdoc(SnowflakeConnection.__init__)"
+    )
 
     # Test 8: Check that connect is callable and returns expected type
     assert callable(connect), "connect should be callable"
+
+    # Test 9: Verify the instance has proper introspection capabilities
+    # IDEs and type checkers should be able to resolve parameters
+    sig = inspect.signature(connect)
+    params = list(sig.parameters.keys())
+    assert len(params) > 0, "connect should have parameters from SnowflakeConnection.__init__"
+