fastmssql 0.3.6__cp314-cp314-macosx_11_0_arm64.whl → 0.3.8__cp314-cp314-macosx_11_0_arm64.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/RECORD,,
+fastmssql-0.3.8.dist-info/WHEEL,sha256=Dfn9zUatNC9j13ABUHNgyZmkyHCncipEw4RIexPnpdI,132
+fastmssql-0.3.8.dist-info/METADATA,sha256=z2NgSJP9XoTN2zif5cEck9yMHBSUNCJpLSPjz4ZQv0w,13364
+fastmssql-0.3.8.dist-info/licenses/LICENSE,sha256=OHj2nKice3tSk2Us200EWXDpwDKtAzeOu4NF4rwg5gk,33858
+fastmssql/fastmssql.cpython-314-darwin.so,sha256=7STP9O1LWCTV_W6WNLAU5cDB-gXWbgIS7FxpkjxKkNs,2069296
+fastmssql/__init__.py,sha256=H2sCgkVlgRo3oIbejLqnHUIsFCqcbJIc20TJ4CCPkQo,43543

fastmssql-0.3.6.dist-info/RECORD

@@ -1,6 +0,0 @@
-fastmssql/fastmssql.cpython-314-darwin.so,sha256=x0OcG8iWfQ8qA7rpAotGp-_cz0xTWJBy5dwBEcL8MF8,2052720
-fastmssql/__init__.py,sha256=H2sCgkVlgRo3oIbejLqnHUIsFCqcbJIc20TJ4CCPkQo,43543
-fastmssql-0.3.6.dist-info/RECORD,,
-fastmssql-0.3.6.dist-info/WHEEL,sha256=Dfn9zUatNC9j13ABUHNgyZmkyHCncipEw4RIexPnpdI,132
-fastmssql-0.3.6.dist-info/METADATA,sha256=JPpjwy3GKpu2Nu4aLbJWr4-udpB7QNB7uhYrQIFjtg4,12514
-fastmssql-0.3.6.dist-info/licenses/LICENSE,sha256=OHj2nKice3tSk2Us200EWXDpwDKtAzeOu4NF4rwg5gk,33858