Merge pull request #147 from psqlpy-python/result-as-tuple

Added new as_tuple parameter to QueryResult and some performance optimizations by @bymoye

Author: chandr-andr

docs/components/results.md

@@ -14,7 +14,9 @@ Currently there are two results:
 ### Result
 
 #### Parameters
+
 - `custom_decoders`: custom decoders for unsupported types. [Read more](/usage/types/advanced_type_usage.md)
+- `as_tuple`: Headless tuple output
 
 Get the result as a list of dicts
 
@@ -27,12 +29,19 @@ async def main() -> None:
         [],
     )
 
-    result: List[Dict[str, Any]] = query_result.result()
+    # Result as dict
+    list_dict_result: List[Dict[str, Any]] = query_result.result()
+
+    # Result as tuple
+    list_tuple_result: List[Tuple[t.Any, ...]] = query_result.result(
+        as_tuple=True,
+    )
 ```
 
 ### As class
 
 #### Parameters
+
 - `as_class`: Custom class from Python.
 - `custom_decoders`: custom decoders for unsupported types. [Read more](/usage/types/advanced_type_usage.md)
 
@@ -61,6 +70,7 @@ async def main() -> None:
 ### Row Factory
 
 #### Parameters
+
 - `row_factory`: custom callable object.
 - `custom_decoders`: custom decoders for unsupported types. [Read more](/usage/types/advanced_type_usage.md)
 
@@ -71,7 +81,9 @@ async def main() -> None:
 ### Result
 
 #### Parameters
+
 - `custom_decoders`: custom decoders for unsupported types. [Read more](/usage/types/advanced_type_usage.md)
+- `as_tuple`: Headless tuple output
 
 Get the result as a dict
 
@@ -84,12 +96,19 @@ async def main() -> None:
         [100],
     )
 
-    result: Dict[str, Any] = query_result.result()
+    # Result as dict
+    dict_result: Dict[str, Any] = query_result.result()
+
+    # Result as tuple
+    tuple_result: Tuple[typing.Any, ...] = query_result.result(
+        as_tuple=True,
+    )
 ```
 
 ### As class
 
 #### Parameters
+
 - `as_class`: Custom class from Python.
 - `custom_decoders`: custom decoders for unsupported types. [Read more](/usage/types/advanced_type_usage.md)
 
@@ -117,6 +136,7 @@ async def main() -> None:
 ### Row Factory
 
 #### Parameters
+
 - `row_factory`: custom callable object.
 - `custom_decoders`: custom decoders for unsupported types. [Read more](/usage/types/advanced_type_usage.md)