Added expicit array types, changed how they convert

Signed-off-by: chandr-andr (Kiselev Aleksandr) <[email protected]>

Author: chandr-andr

docs/.vuepress/sidebar.ts

@@ -38,6 +38,7 @@ export default sidebar({
           collapsible: true,
           children: [
             "supported_types",
+            "array_types",
             "extra_types",
             "advanced_type_usage",
           ]

docs/components/connection.md

@@ -184,9 +184,10 @@ async def main() -> None:
 - `isolation_level`: level of isolation. Default how it is in PostgreSQL.
 - `read_variant`: configure read variant of the transaction. Default how it is in PostgreSQL.
 - `deferrable`: configure deferrable of the transaction. Default how it is in PostgreSQL.
+- `synchronous_commit`: configure [synchronous_commit](https://postgresqlco.nf/doc/en/param/synchronous_commit/) option for transaction. Default how it is in PostgreSQL.
 
 ```python
-from psqlpy import IsolationLevel, ReadVariant
+from psqlpy import IsolationLevel, ReadVariant, SynchronousCommit
 
 async def main() -> None:
     ...
@@ -195,6 +196,7 @@ async def main() -> None:
         isolation_level=IsolationLevel.Serializable,
         read_variant=ReadVariant.ReadWrite,
         deferrable=True,
+        synchronous_commit=SynchronousCommit.On,
     )
 ```
 

docs/components/connection_pool.md

@@ -192,7 +192,7 @@ Parameters must be passed as list after querystring.
 ::: caution
 You must use `ConnectionPool.execute` method in high-load production code wisely!
 It pulls connection from the pool each time you execute query.
-Preferable way to execute statements with [Connection](./../../introduction/components/connection.md) or [Transaction](./../../introduction/components/transaction.md)
+Preferable way to execute statements with [Connection](./../components/connection.md) or [Transaction](./../components/transaction.md)
 :::
 
 ```python

docs/usage/types/array_types.md

@@ -0,0 +1,50 @@
+---
+title: Array Types
+---
+For type safety and better performance we have predefined array types.
+
+| PSQLPy Array Type | PostgreSQL Array Type |
+| :---: | :---: |
+| BoolArray | BOOLEAN ARRAY |
+| UUIDArray | UUID ARRAY |
+| VarCharArray | VarChar ARRAY |
+| TextArray | Text ARRAY |
+| Int16Array | INT2 ARRAY |
+| Int32Array | INT4 ARRAY |
+| Int64Array | INT8 ARRAY |
+| Float32Array | FLOAT4 ARRAY |
+| Float64Array | FLOAT8 ARRAY |
+| MoneyArray | MONEY ARRAY |
+| IpAddressArray | INET ARRAY |
+| JSONBArray | JSONB ARRAY |
+| JSONArray | JSON ARRAY |
+| DateArray | DATE ARRAY |
+| TimeArray | TIME ARRAY |
+| DateTimeArray | TIMESTAMP ARRAY |
+| DateTimeTZArray | TIMESTAMPTZ ARRAY |
+| MacAddr6Array | MACADDR ARRAY |
+| MacAddr8Array | MACADDR8 ARRAY |
+| NumericArray | NUMERIC ARRAY |
+| PointArray | POINT ARRAY |
+| BoxArray | BOX ARRAY |
+| PathArray | PATH ARRAY |
+| LineArray | LINE ARRAY |
+| LsegArray | LSEG ARRAY |
+| CircleArray | CIRCLE ARRAY |
+
+### Example:
+
+```python
+from psqlpy import ConnectionPool
+from psqlpy.extra_types import TextArray
+
+
+async def main() -> None:
+    pool = ConnectionPool()
+    result = await pool.execute(
+        querystring="SELECT * FROM users WHERE id = ANY($1)",
+        parameters=[
+            TextArray([1, 2, 3]),
+        ]
+    )
+```

docs/usage/types/supported_types.md

@@ -50,6 +50,7 @@ DECIMAL PostgreSQL type isn't supported, use NUMERIC instead.
 ## Array Type
 
 You can make arrays with any type of `Simple Type`s.
+For better performance and type safety we recommend to use predefined [Array Types](./array_types.md).
 
 #### Example:
 ```sql

python/psqlpy/_internal/extra_types.pyi

@@ -489,7 +489,7 @@ class JSONBArray:
         """
 
 class JSONArray:
-    """Represent JSONArray ARRAY in PostgreSQL."""
+    """Represent JSON ARRAY in PostgreSQL."""
 
     def __init__(
         self: Self,