fastmssql 0.3.6__cp312-cp312-win_amd64.whl → 0.3.8__cp312-cp312-win_amd64.whl

{fastmssql-0.3.6.dist-info → fastmssql-0.3.8.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastmssql
-Version: 0.3.6
+Version: 0.3.8
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
@@ -92,7 +92,7 @@ pip install fastmssql
 
 ### Prerequisites
 
-- Python 3.8 to 3.14
+- Python 3.9 to 3.14
 - Microsoft SQL Server (any recent version)
 
 ### From source (development)
@@ -127,7 +127,35 @@ async def main():
 asyncio.run(main())
 ```
 
+## Explicit Connection Management
 
+When not utilizing Python's context manager (async with), **FastMssql** uses *lazy connection initialization*:  
+if you call `query()` or `execute()` on a new `Connection`, the underlying pool is created if not already present. 
+
+For more control, you can explicitly connect and disconnect:
+
+```python
+import asyncio
+from fastmssql import Connection
+
+async def main():
+    conn_str = "Server=localhost;Database=master;User Id=myuser;Password=mypass"
+    conn = Connection(conn_str)
+
+    # Explicitly connect
+    await conn.connect()
+    assert await conn.is_connected()
+
+    # Run queries
+    result = await conn.query("SELECT 42 as answer")
+    print(result.rows()[0]["answer"])  # -> 42
+
+    # Explicitly disconnect
+    await conn.disconnect()
+    assert not await conn.is_connected()
+    
+asyncio.run(main())
+```
 ## Usage
 
 ### Connection options

fastmssql-0.3.8.dist-info/RECORD

@@ -0,0 +1,6 @@
+fastmssql-0.3.8.dist-info/METADATA,sha256=Jp2-W6PGv8gpXMZBIZ6uHbkuUBKfN1XqECDOGJZIM5Y,13744
+fastmssql-0.3.8.dist-info/WHEEL,sha256=4hYCffp0RsSVQAuv2PMtXQ9QS7YSHeZi4PrSg-wi2q0,96
+fastmssql-0.3.8.dist-info/licenses/LICENSE,sha256=oCvGJWOz1z4-4sMRHL32UnC0BnRFXmJZYQ0QAsv0Cok,34533
+fastmssql/__init__.py,sha256=xTvVL92qRiQd3BSe3k7sZ7ud9J9pmNxonpixx48G2Q0,44500
+fastmssql/fastmssql.cp312-win_amd64.pyd,sha256=6idV0OehTzfZTNTgmPwpEiyiYk0FEvG9OW3xCppWpNA,2237952
+fastmssql-0.3.8.dist-info/RECORD,,

fastmssql-0.3.6.dist-info/RECORD

@@ -1,6 +0,0 @@
-fastmssql-0.3.6.dist-info/METADATA,sha256=5XyNxAUnsqTojQjM_B77pKBrZD55Y9RhbC2F2EHKwm8,12866
-fastmssql-0.3.6.dist-info/WHEEL,sha256=4hYCffp0RsSVQAuv2PMtXQ9QS7YSHeZi4PrSg-wi2q0,96
-fastmssql-0.3.6.dist-info/licenses/LICENSE,sha256=oCvGJWOz1z4-4sMRHL32UnC0BnRFXmJZYQ0QAsv0Cok,34533
-fastmssql/__init__.py,sha256=xTvVL92qRiQd3BSe3k7sZ7ud9J9pmNxonpixx48G2Q0,44500
-fastmssql/fastmssql.cp312-win_amd64.pyd,sha256=jAW4aQOJqtZcs1I4Ci8PJ_2bmn66Y_amVAVc8YDX2wM,2219008
-fastmssql-0.3.6.dist-info/RECORD,,