Rebuilding connection, make available create single connection

python/psqlpy/__init__.py

@@ -9,6 +9,7 @@
     SingleQueryResult,
     Transaction,
     connect,
+    create_pool,
 )
 
 __all__ = [
@@ -21,5 +22,6 @@
     "ConnRecyclingMethod",
     "IsolationLevel",
     "ReadVariant",
+    "create_pool",
     "connect",
 ]

python/psqlpy/_internal/__init__.pyi

@@ -940,7 +940,7 @@ class ConnectionPool:
     def close(self: Self) -> None:
         """Close the connection pool."""
 
-def connect(
+def create_pool(
     dsn: Optional[str] = None,
     username: Optional[str] = None,
     password: Optional[str] = None,
@@ -963,3 +963,23 @@ def connect(
     - `max_db_pool_size`: maximum size of the connection pool
     - `conn_recycling_method`: how a connection is recycled.
     """
+
+async def connect(
+    dsn: Optional[str] = None,
+    username: Optional[str] = None,
+    password: Optional[str] = None,
+    host: Optional[str] = None,
+    port: Optional[int] = None,
+    db_name: Optional[str] = None,
+) -> Connection:
+    """Create new single connection.
+
+    ### Parameters:
+    - `dsn`: full dsn connection string.
+        `postgres://postgres:postgres@localhost:5432/postgres?target_session_attrs=read-write`
+    - `username`: username of the user in the PostgreSQL
+    - `password`: password of the user in PostgreSQL
+    - `host`: host of the PostgreSQL
+    - `port`: port of the PostgreSQL
+    - `db_name`: name of the database in PostgreSQL
+    """

python/tests/test_connection.py

@@ -5,7 +5,7 @@
 import pytest
 from tests.helpers import count_rows_in_test_table
 
-from psqlpy import ConnectionPool, QueryResult, Transaction
+from psqlpy import ConnectionPool, QueryResult, Transaction, connect
 from psqlpy.exceptions import RustPSQLDriverPyBaseError, TransactionError
 
 pytestmark = pytest.mark.anyio
@@ -113,3 +113,12 @@ async def test_connection_fetch_val_more_than_one_row(
             f"SELECT * FROM  {table_name}",
             [],
         )
+
+
+async def test_connect_method() -> None:
+    connection = await connect(
+        dsn="postgres://postgres:postgres@localhost:5432/psqlpy_test",
+    )
+
+    res = await connection.execute("SELECT 1")
+    assert res.result()

python/tests/test_connection_pool.py

@@ -1,14 +1,20 @@
 import pytest
 
-from psqlpy import Connection, ConnectionPool, ConnRecyclingMethod, QueryResult, connect
+from psqlpy import (
+    Connection,
+    ConnectionPool,
+    ConnRecyclingMethod,
+    QueryResult,
+    create_pool,
+)
 from psqlpy.exceptions import RustPSQLDriverPyBaseError
 
 pytestmark = pytest.mark.anyio
 
 
 async def test_connect_func() -> None:
     """Test that connect function makes new connection pool."""
-    pg_pool = connect(
+    pg_pool = create_pool(
         dsn="postgres://postgres:postgres@localhost:5432/psqlpy_test",
     )