Merge branch 'main' into patch-2

Author: chirizxc

.github/workflows/release_docs.yaml

@@ -15,7 +15,7 @@ jobs:
       - name: Setup Node.js
         uses: actions/setup-node@v3
         with:
-          node-version: 18
+          node-version: 20
           cache: pnpm
       - name: Install deps
         run: pnpm install

docs/contribute.md

@@ -22,7 +22,7 @@ One of the best ways is follow [maturin offical documentation](https://www.matur
 ```bash
 > python3 -m venv .venv
 > source .venv/bin/activate
-> pip install -U pip maturin
+> pip install -U pip maturin pre-commit pytest pytest-anyio pydantic pgpq
 ```
 
 Then you need to build `PSQLPy` project.

docs/usage/types/advanced_type_usage.md

@@ -6,7 +6,7 @@ Due to an unavailability to support all possible types in PostgreSQL, we have a
 This section has `Advanced` in the name because you'll need to work with raw bytes which can be difficult for some developers.
 
 ## Pass unsupported type into PostgreSQL
-If you are using some type that we don't support and want to insert it into PostgreSQL from PSQLPy, you must use `PyCustomType` class.
+If you are using some type that we don't support and want to insert it into PostgreSQL from PSQLPy, you must use `CustomType` class.
 
 Let's assume we have table `for_test` in the database and `PSQLPy` doesn't support (only for demonstration) `VARCHAR` type:
 |  database type | database column name |
@@ -16,24 +16,24 @@ Let's assume we have table `for_test` in the database and `PSQLPy` doesn't suppo
 from typing import Final
 
 from psqlpy import ConnectionPool
-from psqlpy.extra_types import PyCustomType
+from psqlpy.extra_types import CustomType
 
 
 async def main() -> None:
     # It uses default connection parameters
     db_pool: Final = ConnectionPool()
 
-    await db_pool.execute(
-        "INSERT INTO for_test (nickname) VALUES ($1)",
-        [PyCustomType(b"SomeDataInBytes")],
-    )
-    db_pool.close()
+    async with db_pool.acquire() as connection:
+        await connection.execute(
+            "INSERT INTO for_test (nickname) VALUES ($1)",
+            [CustomType(b"SomeDataInBytes")],
+        )
 ```
 
-Here we pass `PyCustomType` into the parameters. It accepts only bytes.
+Here we pass `CustomType` into the parameters. It accepts only bytes.
 
 ::: important
-You must make bytes passed into `PyCustomType` readable for `PostgreSQL`.
+You must make bytes passed into `CustomType` readable for `PostgreSQL`.
 If bytes will be wrong, you will get an exception.
 :::
 
@@ -49,7 +49,7 @@ Let's assume we have table `for_test` in the database and `PSQLPy` doesn't suppo
 from typing import Final, Any
 
 from psqlpy import ConnectionPool, QueryResult
-from psqlpy.extra_types import PyCustomType
+from psqlpy.extra_types import CustomType
 
 
 def nickname_decoder(bytes_from_psql: bytes | None) -> str:
@@ -60,17 +60,17 @@ async def main() -> None:
     # It uses default connection parameters
     db_pool: Final = ConnectionPool()
 
-    result: QueryResult = await db_pool.execute(
-        "SELECT * FROM for_test",
-        [PyCustomType(b"SomeDataInBytes")],
-    )
+    async with db_pool.acquire() as connection:
+        result: QueryResult = await connection.execute(
+            "SELECT * FROM for_test",
+            [CustomType(b"SomeDataInBytes")],
+        )
 
     parsed_result: list[dict[str, Any]] = result.result(
         custom_decoders={
             "nickname": nickname_decoder,
         },
     )
-    db_pool.close()
 ```
 
 ::: important

docs/usage/types/array_types.md

@@ -49,10 +49,11 @@ from psqlpy.extra_types import TextArray
 
 async def main() -> None:
     pool = ConnectionPool()
-    result = await pool.execute(
-        querystring="SELECT * FROM users WHERE name = ANY($1)",
-        parameters=[
-            TextArray(["Alex", "Dev", "Who"]),
-        ]
-    )
+    async with db_pool.acquire() as connection:
+        result = await connection.execute(
+            querystring="SELECT * FROM users WHERE name = ANY($1)",
+            parameters=[
+                TextArray(["Alex", "Dev", "Who"]),
+            ]
+        )
 ```

docs/usage/types/extra_types.md

@@ -62,12 +62,11 @@ from psqlpy.extra_types import SmallInt, Integer, BigInt, Float32, Float64
 async def main() -> None:
     # It uses default connection parameters
     db_pool: Final = ConnectionPool()
-
-    await db_pool.execute(
-        "INSERT INTO numbers (index, elf_life, elon_musk_money) VALUES ($1, $2, $3, $4, $5)",
-        [SmallInt(101), Integer(10500), BigInt(300000000000), Float32(123.11), Float64(222.12)],
-    )
-    db_pool.close()
+    async with db_pool.acquire() as connection:
+        await connection.execute(
+            "INSERT INTO numbers (index, elf_life, elon_musk_money) VALUES ($1, $2, $3, $4, $5)",
+            [SmallInt(101), Integer(10500), BigInt(300000000000), Float32(123.11), Float64(222.12)],
+        )
 ```
 
 ::: important
@@ -96,16 +95,16 @@ async def main() -> None:
     # It uses default connection parameters
     db_pool: Final = ConnectionPool()
 
-    await db_pool.execute(
-        "INSERT INTO banners (title, description) VALUES ($1, $2)",
-        ["SomeTitle", PyText("Very long description")],
-    )
-    # Alternatively, you can do this:
-    await db_pool.execute(
-        "INSERT INTO banners (title, description) VALUES ($1, $2)",
-        [PyVarChar("SomeTitle"), PyText("Very long description")],
-    )
-    db_pool.close()
+    async with db_pool.acquire() as connection:
+        await connection.execute(
+            "INSERT INTO banners (title, description) VALUES ($1, $2)",
+            ["SomeTitle", PyText("Very long description")],
+        )
+        # Alternatively, you can do this:
+        await connection.execute(
+            "INSERT INTO banners (title, description) VALUES ($1, $2)",
+            [PyVarChar("SomeTitle"), PyText("Very long description")],
+        )
 ```
 
 ## PyJSON & PyJSONB
@@ -140,6 +139,7 @@ from psqlpy.extra_types import PyJSON
 async def main() -> None:
     # It uses default connection parameters
     db_pool: Final = ConnectionPool()
+
     list_for_jsonb_field = [
         {"some": "dict"},
         [
@@ -154,16 +154,15 @@ async def main() -> None:
         ]
     }
 
-    await db_pool.execute(
-        "INSERT INTO users (additional_user_info) VALUES ($1)",
-        [PyJSONB(list_for_jsonb_field)],
-    )
-    await db_pool.execute(
-        "INSERT INTO users (additional_user_info) VALUES ($1)",
-        [dict_for_jsonb_field,],
-    )
-
-    db_pool.close()
+    async with db_pool.acquire() as connection:
+        await connection.execute(
+            "INSERT INTO users (additional_user_info) VALUES ($1)",
+            [PyJSONB(list_for_jsonb_field)],
+        )
+        await connection.execute(
+            "INSERT INTO users (additional_user_info) VALUES ($1)",
+            [dict_for_jsonb_field,],
+        )
 ```
 
 ## PyMacAddr6 & PyMacAddr8
@@ -186,15 +185,14 @@ async def main() -> None:
     # It uses default connection parameters
     db_pool: Final = ConnectionPool()
 
-    await db_pool.execute(
-        "INSERT INTO devices (device_macaddr6, device_macaddr8) VALUES ($1, $2)",
-        [
-            PyMacAddr6("08:00:2b:01:02:03"),
-            PyMacAddr8("08:00:2b:01:02:03:04:05"),
-        ],
-    )
-
-    db_pool.close()
+    async with db_pool.acquire() as connection:
+        await connection.execute(
+            "INSERT INTO devices (device_macaddr6, device_macaddr8) VALUES ($1, $2)",
+            [
+                PyMacAddr6("08:00:2b:01:02:03"),
+                PyMacAddr8("08:00:2b:01:02:03:04:05"),
+            ],
+        )
 ```
 
 ## Geo Types
@@ -222,17 +220,16 @@ async def main() -> None:
     # It uses default connection parameters
     db_pool: Final = ConnectionPool()
 
-    await db_pool.execute(
-        "INSERT INTO geo_info VALUES ($1, $2, $3, $4, $5, $6)",
-        [
-            Point([1.5, 2]),
-            Box([(1.7, 2.8), (9, 9)]),
-            Path([(3.5, 3), (9, 9), (8, 8)]),
-            Line([1, -2, 3]),
-            LineSegment([(5.6, 3.1), (4, 5)]),
-            Circle([5, 1.8, 10]),
-        ],
-    )
-
-    db_pool.close()
+    async with db_pool.acquire() as connection:
+        await connection.execute(
+            "INSERT INTO geo_info VALUES ($1, $2, $3, $4, $5, $6)",
+            [
+                Point([1.5, 2]),
+                Box([(1.7, 2.8), (9, 9)]),
+                Path([(3.5, 3), (9, 9), (8, 8)]),
+                Line([1, -2, 3]),
+                LineSegment([(5.6, 3.1), (4, 5)]),
+                Circle([5, 1.8, 10]),
+            ],
+        )
 ```

docs/usage/types/supported_types.md

@@ -87,10 +87,11 @@ async def main() -> None:
     # It uses default connection parameters
     db_pool: Final = ConnectionPool()
 
-    result = await db_pool.execute(
-        "SELECT user_info FROM custom_table",
-    )
-    print(result.result()[0])
+    async with db_pool.acquire() as connection:
+        result = await connection.execute(
+            "SELECT user_info FROM custom_table",
+        )
+        print(result.result()[0])
 ```
 It will return:
 ```json
@@ -132,22 +133,22 @@ class Weather(str, Enum):
 async def main() -> None:
     # It uses default connection parameters
     db_pool: Final = ConnectionPool()
-
-    # Insert new data
-    await db_pool.execute(
-        querystring="INSERT INTO weather_plus VALUES($1)",
-        parameters=[Weather.SUN],
-    )
-
-    # Or you can pass string directly
-    await db_pool.execute(
-        querystring="INSERT INTO weather_plus VALUES($1)",
-        parameters=["sun"],
-    )
-
-    result = await db_pool.execute(
-        querystring="SELECT * FROM weather_plus",
-    )
+    async with db_pool.acquire() as connection:
+        # Insert new data
+        await connection.execute(
+            querystring="INSERT INTO weather_plus VALUES($1)",
+            parameters=[Weather.SUN],
+        )
+
+        # Or you can pass string directly
+        await connection.execute(
+            querystring="INSERT INTO weather_plus VALUES($1)",
+            parameters=["sun"],
+        )
+
+        result = await connection.execute(
+            querystring="SELECT * FROM weather_plus",
+        )
     print(result.result()[0])
 ```
 You will receive:

package.json

@@ -11,22 +11,22 @@
     "docs:clean-dev": "vuepress-vite dev docs --clean-cache",
     "docs:update-package": "pnpm dlx vp-update"
   },
-  "packageManager": "pnpm@7.22.0",
+  "packageManager": "pnpm@10.18.1",
   "devDependencies": {
-    "@vuepress/bundler-vite": "2.0.0-rc.23",
-    "@vuepress/plugin-markdown-tab": "2.0.0-rc.47",
-    "@vuepress/plugin-slimsearch": "2.0.0-rc.106",
-    "mermaid": "^11.6.0",
-    "sass": "^1.89.0",
-    "sass-embedded": "^1.88.0",
+    "@vuepress/bundler-vite": "2.0.0-rc.24",
+    "@vuepress/plugin-markdown-tab": "2.0.0-rc.112",
+    "@vuepress/plugin-slimsearch": "2.0.0-rc.112",
+    "mermaid": "^11.12.0",
+    "sass": "^1.93.2",
+    "sass-embedded": "^1.93.2",
     "sass-loader": "^16.0.5",
-    "vue": "^3.5.13",
-    "vuepress": "2.0.0-rc.23",
-    "vuepress-plugin-md-enhance": "2.0.0-rc.88",
-    "vuepress-theme-hope": "2.0.0-rc.88"
+    "vue": "^3.5.22",
+    "vuepress": "2.0.0-rc.24",
+    "vuepress-plugin-md-enhance": "2.0.0-rc.94",
+    "vuepress-theme-hope": "2.0.0-rc.94"
   },
   "dependencies": {
-    "chart.js": "^4.4.9"
+    "chart.js": "^4.5.0"
   },
   "pnpm": {
     "onlyBuiltDependencies": [