psqlpy 0.11.1__cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl → 0.11.3__cp310-cp310-manylinux_2_17_i686.manylinux2014_i686.whl

psqlpy/_internal/__init__.pyi

@@ -1,4 +1,5 @@
 import types
+import typing
 from enum import Enum
 from io import BytesIO
 from ipaddress import IPv4Address, IPv6Address
@@ -18,15 +19,38 @@ ParamsT: TypeAlias = Sequence[Any] | Mapping[str, Any] | None
 class QueryResult:
     """Result."""
 
+    @typing.overload
     def result(
         self: Self,
+        as_tuple: typing.Literal[None] = None,
         custom_decoders: dict[str, Callable[[bytes], Any]] | None = None,
-    ) -> list[dict[Any, Any]]:
-        """Return result from database as a list of dicts.
+    ) -> list[dict[str, Any]]: ...
+    @typing.overload
+    def result(
+        self: Self,
+        as_tuple: typing.Literal[False],
+        custom_decoders: dict[str, Callable[[bytes], Any]] | None = None,
+    ) -> list[dict[str, Any]]: ...
+    @typing.overload
+    def result(
+        self: Self,
+        as_tuple: typing.Literal[True],
+        custom_decoders: dict[str, Callable[[bytes], Any]] | None = None,
+    ) -> list[tuple[typing.Any, ...]]: ...
+    @typing.overload
+    def result(
+        self: Self,
+        custom_decoders: dict[str, Callable[[bytes], Any]] | None = None,
+        as_tuple: bool | None = None,
+    ) -> list[dict[str, Any]]:
+        """Return result from database.
+
+        By default it returns result as a list of dicts.
 
         `custom_decoders` must be used when you use
         PostgreSQL Type which isn't supported, read more in our docs.
         """
+
     def as_class(
         self: Self,
         as_class: Callable[..., _CustomClass],
@@ -60,6 +84,7 @@ class QueryResult:
             )
         ```
         """
+
     def row_factory(
         self,
         row_factory: Callable[[dict[str, Any]], _RowFactoryRV],
@@ -84,15 +109,38 @@ class QueryResult:
 class SingleQueryResult:
     """Single result."""
 
+    @typing.overload
+    def result(
+        self: Self,
+        as_tuple: typing.Literal[None] = None,
+        custom_decoders: dict[str, Callable[[bytes], Any]] | None = None,
+    ) -> dict[str, Any]: ...
+    @typing.overload
     def result(
         self: Self,
+        as_tuple: typing.Literal[False],
         custom_decoders: dict[str, Callable[[bytes], Any]] | None = None,
+    ) -> dict[str, Any]: ...
+    @typing.overload
+    def result(
+        self: Self,
+        as_tuple: typing.Literal[True],
+        custom_decoders: dict[str, Callable[[bytes], Any]] | None = None,
+    ) -> tuple[typing.Any, ...]: ...
+    @typing.overload
+    def result(
+        self: Self,
+        custom_decoders: dict[str, Callable[[bytes], Any]] | None = None,
+        as_tuple: bool | None = None,
     ) -> dict[Any, Any]:
-        """Return result from database as a dict.
+        """Return result from database.
+
+        By default it returns result as a dict.
 
         `custom_decoders` must be used when you use
         PostgreSQL Type which isn't supported, read more in our docs.
         """
+
     def as_class(
         self: Self,
         as_class: Callable[..., _CustomClass],
@@ -129,6 +177,7 @@ class SingleQueryResult:
             )
         ```
         """
+
     def row_factory(
         self,
         row_factory: Callable[[dict[str, Any]], _RowFactoryRV],
@@ -283,11 +332,13 @@ class Cursor:
 
         Execute DECLARE command for the cursor.
         """
+
     def close(self: Self) -> None:
         """Close the cursor.
 
         Execute CLOSE command for the cursor.
         """
+
     async def execute(
         self: Self,
         querystring: str,
@@ -298,10 +349,13 @@ class Cursor:
         Method should be used instead of context manager
         and `start` method.
         """
+
     async def fetchone(self: Self) -> QueryResult:
         """Return next one row from the cursor."""
+
     async def fetchmany(self: Self, size: int | None = None) -> QueryResult:
         """Return <size> rows from the cursor."""
+
     async def fetchall(self: Self, size: int | None = None) -> QueryResult:
         """Return all remaining rows from the cursor."""
 
@@ -334,6 +388,7 @@ class Transaction:
 
         `begin()` can be called only once per transaction.
         """
+
     async def commit(self: Self) -> None:
         """Commit the transaction.
 
@@ -341,6 +396,7 @@ class Transaction:
 
         `commit()` can be called only once per transaction.
         """
+
     async def rollback(self: Self) -> None:
         """Rollback all queries in the transaction.
 
@@ -361,6 +417,7 @@ class Transaction:
             await transaction.rollback()
         ```
         """
+
     async def execute(
         self: Self,
         querystring: str,
@@ -398,6 +455,7 @@ class Transaction:
             await transaction.commit()
         ```
         """
+
     async def execute_batch(
         self: Self,
         querystring: str,
@@ -413,6 +471,7 @@ class Transaction:
         ### Parameters:
         - `querystring`: querystrings separated by semicolons.
         """
+
     async def execute_many(
         self: Self,
         querystring: str,
@@ -471,6 +530,7 @@ class Transaction:
         - `prepared`: should the querystring be prepared before the request.
             By default any querystring will be prepared.
         """
+
     async def fetch_row(
         self: Self,
         querystring: str,
@@ -510,6 +570,7 @@ class Transaction:
             await transaction.commit()
         ```
         """
+
     async def fetch_val(
         self: Self,
         querystring: str,
@@ -550,6 +611,7 @@ class Transaction:
             )
         ```
         """
+
     async def pipeline(
         self,
         queries: list[tuple[str, list[Any] | None]],
@@ -614,6 +676,7 @@ class Transaction:
             )
         ```
         """
+
     async def create_savepoint(self: Self, savepoint_name: str) -> None:
         """Create new savepoint.
 
@@ -642,6 +705,7 @@ class Transaction:
             await transaction.rollback_savepoint("my_savepoint")
         ```
         """
+
     async def rollback_savepoint(self: Self, savepoint_name: str) -> None:
         """ROLLBACK to the specified `savepoint_name`.
 
@@ -667,6 +731,7 @@ class Transaction:
             await transaction.rollback_savepoint("my_savepoint")
         ```
         """
+
     async def release_savepoint(self: Self, savepoint_name: str) -> None:
         """Execute ROLLBACK TO SAVEPOINT.
 
@@ -691,6 +756,7 @@ class Transaction:
             await transaction.release_savepoint
         ```
         """
+
     def cursor(
         self: Self,
         querystring: str,
@@ -734,6 +800,7 @@ class Transaction:
             await cursor.close()
         ```
         """
+
     async def binary_copy_to_table(
         self: Self,
         source: bytes | bytearray | Buffer | BytesIO,
@@ -815,16 +882,7 @@ class Connection:
 
         Return representation of prepared statement.
         """
-    async def commit(self: Self) -> None:
-        """Commit the transaction.
-
-        Do nothing if there is no active transaction.
-        """
-    async def rollback(self: Self) -> None:
-        """Rollback the transaction.
 
-        Do nothing if there is no active transaction.
-        """
     async def execute(
         self: Self,
         querystring: str,
@@ -861,6 +919,7 @@ class Connection:
             dict_result: List[Dict[Any, Any]] = query_result.result()
         ```
         """
+
     async def execute_batch(
         self: Self,
         querystring: str,
@@ -876,6 +935,7 @@ class Connection:
         ### Parameters:
         - `querystring`: querystrings separated by semicolons.
         """
+
     async def execute_many(
         self: Self,
         querystring: str,
@@ -929,6 +989,7 @@ class Connection:
         - `prepared`: should the querystring be prepared before the request.
             By default any querystring will be prepared.
         """
+
     async def fetch_row(
         self: Self,
         querystring: str,
@@ -965,6 +1026,7 @@ class Connection:
             dict_result: Dict[Any, Any] = query_result.result()
         ```
         """
+
     async def fetch_val(
         self: Self,
         querystring: str,
@@ -1004,6 +1066,7 @@ class Connection:
             )
         ```
         """
+
     def transaction(
         self,
         isolation_level: IsolationLevel | None = None,
@@ -1017,6 +1080,7 @@ class Connection:
         - `read_variant`: configure read variant of the transaction.
         - `deferrable`: configure deferrable of the transaction.
         """
+
     def cursor(
         self: Self,
         querystring: str,
@@ -1055,6 +1119,7 @@ class Connection:
                         ...  # do something with this result.
         ```
         """
+
     def close(self: Self) -> None:
         """Return connection back to the pool.
 
@@ -1199,6 +1264,7 @@ class ConnectionPool:
         - `ca_file`: Loads trusted root certificates from a file.
             The file should contain a sequence of PEM-formatted CA certificates.
         """
+
     def __iter__(self: Self) -> Self: ...
     def __enter__(self: Self) -> Self: ...
     def __exit__(
@@ -1213,6 +1279,7 @@ class ConnectionPool:
         ### Returns
         `ConnectionPoolStatus`
         """
+
     def resize(self: Self, new_max_size: int) -> None:
         """Resize the connection pool.
 
@@ -1222,11 +1289,13 @@ class ConnectionPool:
         ### Parameters:
         - `new_max_size`: new size for the connection pool.
         """
+
     async def connection(self: Self) -> Connection:
         """Create new connection.
 
         It acquires new connection from the database pool.
         """
+
     def acquire(self: Self) -> Connection:
         """Create new connection for async context manager.
 
@@ -1244,6 +1313,7 @@ class ConnectionPool:
                 res = await connection.execute(...)
         ```
         """
+
     def listener(self: Self) -> Listener:
         """Create new listener."""
 
@@ -1355,6 +1425,7 @@ class ConnectionPoolBuilder:
 
     def __init__(self: Self) -> None:
         """Initialize new instance of `ConnectionPoolBuilder`."""
+
     def build(self: Self) -> ConnectionPool:
         """
         Build `ConnectionPool`.
@@ -1362,6 +1433,7 @@ class ConnectionPoolBuilder:
         ### Returns:
         `ConnectionPool`
         """
+
     def max_pool_size(self: Self, pool_size: int) -> Self:
         """
         Set maximum connection pool size.
@@ -1372,6 +1444,7 @@ class ConnectionPoolBuilder:
         ### Returns:
         `ConnectionPoolBuilder`
         """
+
     def conn_recycling_method(
         self: Self,
         conn_recycling_method: ConnRecyclingMethod,
@@ -1387,6 +1460,7 @@ class ConnectionPoolBuilder:
         ### Returns:
         `ConnectionPoolBuilder`
         """
+
     def user(self: Self, user: str) -> Self:
         """
         Set username to `PostgreSQL`.
@@ -1397,6 +1471,7 @@ class ConnectionPoolBuilder:
         ### Returns:
         `ConnectionPoolBuilder`
         """
+
     def password(self: Self, password: str) -> Self:
         """
         Set password for `PostgreSQL`.
@@ -1407,6 +1482,7 @@ class ConnectionPoolBuilder:
         ### Returns:
         `ConnectionPoolBuilder`
         """
+
     def dbname(self: Self, dbname: str) -> Self:
         """
         Set database name for the `PostgreSQL`.
@@ -1417,6 +1493,7 @@ class ConnectionPoolBuilder:
         ### Returns:
         `ConnectionPoolBuilder`
         """
+
     def options(self: Self, options: str) -> Self:
         """
         Set command line options used to configure the server.
@@ -1427,6 +1504,7 @@ class ConnectionPoolBuilder:
         ### Returns:
         `ConnectionPoolBuilder`
         """
+
     def application_name(self: Self, application_name: str) -> Self:
         """
         Set the value of the `application_name` runtime parameter.
@@ -1437,6 +1515,7 @@ class ConnectionPoolBuilder:
         ### Returns:
         `ConnectionPoolBuilder`
         """
+
     def ssl_mode(self: Self, ssl_mode: SslMode) -> Self:
         """
         Set the SSL configuration.
@@ -1447,6 +1526,7 @@ class ConnectionPoolBuilder:
         ### Returns:
         `ConnectionPoolBuilder`
         """
+
     def ca_file(self: Self, ca_file: str) -> Self:
         """
         Set ca_file for SSL.
@@ -1457,6 +1537,7 @@ class ConnectionPoolBuilder:
         ### Returns:
         `ConnectionPoolBuilder`
         """
+
     def host(self: Self, host: str) -> Self:
         """
         Add a host to the configuration.
@@ -1474,6 +1555,7 @@ class ConnectionPoolBuilder:
         ### Returns:
         `ConnectionPoolBuilder`
         """
+
     def hostaddr(self: Self, hostaddr: IPv4Address | IPv6Address) -> Self:
         """
         Add a hostaddr to the configuration.
@@ -1489,6 +1571,7 @@ class ConnectionPoolBuilder:
         ### Returns:
         `ConnectionPoolBuilder`
         """
+
     def port(self: Self, port: int) -> Self:
         """
         Add a port to the configuration.
@@ -1505,6 +1588,7 @@ class ConnectionPoolBuilder:
         ### Returns:
         `ConnectionPoolBuilder`
         """
+
     def connect_timeout(self: Self, connect_timeout: int) -> Self:
         """
         Set the timeout applied to socket-level connection attempts.
@@ -1519,6 +1603,7 @@ class ConnectionPoolBuilder:
         ### Returns:
         `ConnectionPoolBuilder`
         """
+
     def tcp_user_timeout(self: Self, tcp_user_timeout: int) -> Self:
         """
         Set the TCP user timeout.
@@ -1534,6 +1619,7 @@ class ConnectionPoolBuilder:
         ### Returns:
         `ConnectionPoolBuilder`
         """
+
     def target_session_attrs(
         self: Self,
         target_session_attrs: TargetSessionAttrs,
@@ -1551,6 +1637,7 @@ class ConnectionPoolBuilder:
         ### Returns:
         `ConnectionPoolBuilder`
         """
+
     def load_balance_hosts(
         self: Self,
         load_balance_hosts: LoadBalanceHosts,
@@ -1566,6 +1653,7 @@ class ConnectionPoolBuilder:
         ### Returns:
         `ConnectionPoolBuilder`
         """
+
     def keepalives(
         self: Self,
         keepalives: bool,
@@ -1583,6 +1671,7 @@ class ConnectionPoolBuilder:
         ### Returns:
         `ConnectionPoolBuilder`
         """
+
     def keepalives_idle(
         self: Self,
         keepalives_idle: int,
@@ -1601,6 +1690,7 @@ class ConnectionPoolBuilder:
         ### Returns:
         `ConnectionPoolBuilder`
         """
+
     def keepalives_interval(
         self: Self,
         keepalives_interval: int,
@@ -1620,6 +1710,7 @@ class ConnectionPoolBuilder:
         ### Returns:
         `ConnectionPoolBuilder`
         """
+
     def keepalives_retries(
         self: Self,
         keepalives_retries: int,
@@ -1712,11 +1803,13 @@ class Listener:
 
         Each listener MUST be started up.
         """
+
     async def shutdown(self: Self) -> None:
         """Shutdown the listener.
 
         Abort listen and release underlying connection.
         """
+
     async def add_callback(
         self: Self,
         channel: str,
@@ -1779,7 +1872,9 @@ class Column:
 class PreparedStatement:
     async def execute(self: Self) -> QueryResult:
         """Execute prepared statement."""
+
     def cursor(self: Self) -> Cursor:
         """Create new server-side cursor based on prepared statement."""
+
     def columns(self: Self) -> list[Column]:
         """Return information about statement columns."""

{psqlpy-0.11.1.dist-info → psqlpy-0.11.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: psqlpy
-Version: 0.11.1
+Version: 0.11.3
 Classifier: Typing :: Typed
 Classifier: Topic :: Database
 Classifier: Development Status :: 4 - Beta

{psqlpy-0.11.1.dist-info → psqlpy-0.11.3.dist-info}/RECORD

@@ -1,10 +1,10 @@
-psqlpy-0.11.1.dist-info/METADATA,sha256=2TTToTN0ntPpPNYGXxrAHiLiBgs285VYcjUZInQQkAY,3522
-psqlpy-0.11.1.dist-info/WHEEL,sha256=sS2xDIjcXlzogWS9cE3M06ZhUwJB3NYytHpfX_8qyI8,125
-psqlpy-0.11.1.dist-info/entry_points.txt,sha256=kNGHhl8cqbZ25PuaS-Ez-7jl3_b_4rIajMSmdJzmKNo,74
-psqlpy-0.11.1.dist-info/licenses/LICENSE,sha256=UkxvzBjZdhB37ez6jaooRIOe3GON6A2MJ7RVsiOxlUc,1078
+psqlpy-0.11.3.dist-info/METADATA,sha256=ZIE0FymLfdH_eGEn35_GNKqbp5bqw0yf0ZzPYzu64EM,3522
+psqlpy-0.11.3.dist-info/WHEEL,sha256=RSWnOenQPXPsJ6DAYcyOIEhXG6NY0t0kf38jLUfCcyo,125
+psqlpy-0.11.3.dist-info/entry_points.txt,sha256=kNGHhl8cqbZ25PuaS-Ez-7jl3_b_4rIajMSmdJzmKNo,74
+psqlpy-0.11.3.dist-info/licenses/LICENSE,sha256=UkxvzBjZdhB37ez6jaooRIOe3GON6A2MJ7RVsiOxlUc,1078
 psqlpy/__init__.py,sha256=w0a1HvjkEGAmg5dax_hkrur8y3WZT0caFmFVfMmyvxs,838
-psqlpy/_internal.cpython-310-i386-linux-gnu.so,sha256=nKIrwuGKMWOHlCbWqRrUkZgkKCqk3akEg6wjVxzOl98,13355376
-psqlpy/_internal/__init__.pyi,sha256=X7zqvCcXhF4PD51aZ9RVqORwNuQhGGPKhGjIpgdTpbc,58307
+psqlpy/_internal.cpython-310-i386-linux-gnu.so,sha256=lavXDwpPaHC9hjlS6QV3sJQ1bUyzEJtq96OhVPKtKfw,13382812
+psqlpy/_internal/__init__.pyi,sha256=m2N4d8gV4MK-Vn-XaT0xa2ZSu11-uL6HUqcfXBPIExg,59535
 psqlpy/_internal/exceptions.pyi,sha256=6GQls4kgEjd9JXl8B8i9ycf_ktYcXFeLAKp_qiwsdHk,4970
 psqlpy/_internal/extra_types.pyi,sha256=47STvXQt2VQrPMCu3fmYR8-FmHD7fDh3NOerNjSCe6g,16999
 psqlpy/_internal/row_factories.pyi,sha256=Viim3tpp1_7KrzZAAIJ6U9gaI_wKVWI4Y2UAO_OAlUA,1449
@@ -12,4 +12,4 @@ psqlpy/exceptions.py,sha256=A2TTXu7b4w8_j64ZIUfSJB-ywmWn9rJclANapflv6So,1973
 psqlpy/extra_types.py,sha256=q51BPqYfsYic6j1RMfN8mAFg_FWiMF-5hfG2fhy8kIU,1613
 psqlpy/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 psqlpy/row_factories.py,sha256=QtTUEF1oNSANT6HMyk7tAS-LluCfLC7w2mYoJ5c8X-0,107
-psqlpy-0.11.1.dist-info/RECORD,,
+psqlpy-0.11.3.dist-info/RECORD,,

{psqlpy-0.11.1.dist-info → psqlpy-0.11.3.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: maturin (1.8.6)
+Generator: maturin (1.9.1)
 Root-Is-Purelib: false
 Tag: cp310-cp310-manylinux_2_17_i686.manylinux2014_i686