Fixed code example of type usage docs

Author: Daniil Babin

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 |
@@ -15,25 +15,26 @@ Let's assume we have table `for_test` in the database and `PSQLPy` doesn't suppo
 ```python
 from typing import Final
 
-from psqlpy import ConnectionPool
-from psqlpy.extra_types import PyCustomType
+from psqlpy import Connection, ConnectionPool
+from psqlpy.extra_types import CustomType
 
 
 async def main() -> None:
     # It uses default connection parameters
     db_pool: Final = ConnectionPool()
+    connection: Connection = await db_pool.connection()
 
-    await db_pool.execute(
+    await connection.execute(
         "INSERT INTO for_test (nickname) VALUES ($1)",
-        [PyCustomType(b"SomeDataInBytes")],
+        [CustomType(b"SomeDataInBytes")],
     )
-    db_pool.close()
+    connection.close()
 ```
 
-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.
 :::
 
@@ -48,8 +49,8 @@ Let's assume we have table `for_test` in the database and `PSQLPy` doesn't suppo
 ```python
 from typing import Final, Any
 
-from psqlpy import ConnectionPool, QueryResult
-from psqlpy.extra_types import PyCustomType
+from psqlpy import Connection, ConnectionPool, QueryResult
+from psqlpy.extra_types import CustomType
 
 
 def nickname_decoder(bytes_from_psql: bytes | None) -> str:
@@ -59,18 +60,19 @@ def nickname_decoder(bytes_from_psql: bytes | None) -> str:
 async def main() -> None:
     # It uses default connection parameters
     db_pool: Final = ConnectionPool()
+    connection: Connection = await db_pool.connection()
 
-    result: QueryResult = await db_pool.execute(
+    result: QueryResult = await connection.execute(
         "SELECT * FROM for_test",
-        [PyCustomType(b"SomeDataInBytes")],
+        [CustomType(b"SomeDataInBytes")],
     )
 
     parsed_result: list[dict[str, Any]] = result.result(
         custom_decoders={
             "nickname": nickname_decoder,
         },
     )
-    db_pool.close()
+    connection.close()
 ```
 
 ::: important

docs/usage/types/array_types.md

@@ -36,13 +36,14 @@ For type safety and better performance we have predefined array types.
 ### Example:
 
 ```python
-from psqlpy import ConnectionPool
+from psqlpy import Connection, ConnectionPool
 from psqlpy.extra_types import TextArray
 
 
 async def main() -> None:
     pool = ConnectionPool()
-    result = await pool.execute(
+    connection: Connection = await pool.connection()
+    result = await connection.execute(
         querystring="SELECT * FROM users WHERE name = ANY($1)",
         parameters=[
             TextArray(["Alex", "Dev", "Who"]),

docs/usage/types/extra_types.md

@@ -48,19 +48,20 @@ And we want to INSERT new data to this table:
 ```python
 from typing import Final
 
-from psqlpy import ConnectionPool, QueryResult
+from psqlpy import Connection, ConnectionPool, QueryResult
 from psqlpy.extra_types import SmallInt, Integer, BigInt, Float32, Float64
 
 
 async def main() -> None:
     # It uses default connection parameters
     db_pool: Final = ConnectionPool()
+    connection: Connection = await db_pool.connection()
 
-    await db_pool.execute(
+    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)],
     )
-    db_pool.close()
+    connection.close()
 ```
 
 ::: important
@@ -81,24 +82,25 @@ Let's assume we have table `banners` in the database:
 ```python
 from typing import Final
 
-from psqlpy import ConnectionPool, QueryResult
+from psqlpy import Connection, ConnectionPool, QueryResult
 from psqlpy.extra_types import PyText
 
 
 async def main() -> None:
     # It uses default connection parameters
     db_pool: Final = ConnectionPool()
+    connection: Connection = await db_pool.connection()
 
-    await db_pool.execute(
+    await connection.execute(
         "INSERT INTO banners (title, description) VALUES ($1, $2)",
         ["SomeTitle", PyText("Very long description")],
     )
     # Alternatively, you can do this:
-    await db_pool.execute(
+    await connection.execute(
         "INSERT INTO banners (title, description) VALUES ($1, $2)",
         [PyVarChar("SomeTitle"), PyText("Very long description")],
     )
-    db_pool.close()
+    connection.close()
 ```
 
 ## PyJSON & PyJSONB
@@ -126,13 +128,15 @@ Let's assume we have table `users` in the database, and field `additional_user_i
 ```python
 from typing import Final
 
-from psqlpy import ConnectionPool, QueryResult
+from psqlpy import Connection, ConnectionPool, QueryResult
 from psqlpy.extra_types import PyJSON
 
 
 async def main() -> None:
     # It uses default connection parameters
     db_pool: Final = ConnectionPool()
+    connection: Connection = await db_pool.connection()
+    
     list_for_jsonb_field = [
         {"some": "dict"},
         [
@@ -147,16 +151,16 @@ async def main() -> None:
         ]
     }
 
-    await db_pool.execute(
+    await connection.execute(
         "INSERT INTO users (additional_user_info) VALUES ($1)",
         [PyJSONB(list_for_jsonb_field)],
     )
-    await db_pool.execute(
+    await connection.execute(
         "INSERT INTO users (additional_user_info) VALUES ($1)",
         [dict_for_jsonb_field,],
     )
 
-    db_pool.close()
+    connection.close()
 ```
 
 ## PyMacAddr6 & PyMacAddr8
@@ -171,23 +175,24 @@ Let's assume we have table `devices` in the database:
 ```python
 from typing import Final
 
-from psqlpy import ConnectionPool, QueryResult
+from psqlpy import Connection, ConnectionPool, QueryResult
 from psqlpy.extra_types import PyMacAddr6, PyMacAddr8
 
 
 async def main() -> None:
     # It uses default connection parameters
     db_pool: Final = ConnectionPool()
+    connection: Connection = await db_pool.connection()
 
-    await db_pool.execute(
+    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"),
         ],
     )
 
-    db_pool.close()
+    connection.close()
 ```
 
 ## Geo Types
@@ -207,15 +212,16 @@ Let's assume we have table `geo_info` with all PostgreSQL geo types in the datab
 ```python
 from typing import Final
 
-from psqlpy import ConnectionPool, QueryResult
+from psqlpy import Connection, ConnectionPool, QueryResult
 from psqlpy.extra_types import Point, Box, Path, Line, LineSegment, Circle
 
 
 async def main() -> None:
     # It uses default connection parameters
     db_pool: Final = ConnectionPool()
+    connection: Connection = await db_pool.connection()
 
-    await db_pool.execute(
+    await connection.execute(
         "INSERT INTO geo_info VALUES ($1, $2, $3, $4, $5, $6)",
         [
             Point([1.5, 2]),
@@ -227,5 +233,5 @@ async def main() -> None:
         ],
     )
 
-    db_pool.close()
+    connection.close()
 ```

docs/usage/types/supported_types.md

@@ -79,15 +79,16 @@ Now we can see what result will be returned.
 ```python
 from typing import Final
 
-from psqlpy import ConnectionPool, QueryResult
+from psqlpy import Connection, ConnectionPool, QueryResult
 from psqlpy.extra_types import SmallInt, Integer, BigInt
 
 
 async def main() -> None:
     # It uses default connection parameters
     db_pool: Final = ConnectionPool()
+    connection: Connection = await db_pool.connection()
 
-    result = await db_pool.execute(
+    result = await connection.execute(
         "SELECT user_info FROM custom_table",
     )
     print(result.result()[0])
@@ -121,7 +122,7 @@ Let's see how we can INSERT and SELECT such data.
 from enum import Enum
 from typing import Final
 
-from psqlpy import ConnectionPool, QueryResult
+from psqlpy import Connection, ConnectionPool, QueryResult
 
 
 class Weather(str, Enum):
@@ -132,20 +133,21 @@ class Weather(str, Enum):
 async def main() -> None:
     # It uses default connection parameters
     db_pool: Final = ConnectionPool()
+    connection: Connection = await db_pool.connection()
 
     # Insert new data
-    await db_pool.execute(
+    await connection.execute(
         querystring="INSERT INTO weather_plus VALUES($1)",
         parameters=[Weather.SUN],
     )
 
     # Or you can pass string directly
-    await db_pool.execute(
+    await connection.execute(
         querystring="INSERT INTO weather_plus VALUES($1)",
         parameters=["sun"],
     )
 
-    result = await db_pool.execute(
+    result = await connection.execute(
         querystring="SELECT * FROM weather_plus",
     )
     print(result.result()[0])