update docs

Author: krylosov-aa

examples/README.md

@@ -0,0 +1,4 @@
+# Examples
+
+This module contains examples of how to integrate and use the
+library in various frameworks and applications.

examples/__init__.py

@@ -0,0 +1,4 @@
+"""
+This module contains examples of how to integrate and use the
+    library in various frameworks and applications.
+"""

examples/fastapi_example/README.md

@@ -0,0 +1,3 @@
+# FastAPI example
+
+An example of how to use the library with FastAPI

examples/fastapi_example/__init__.py

@@ -0,0 +1,3 @@
+"""
+An example of how to use the library with FastAPI
+"""

examples/fastapi_example/database.py

@@ -1,5 +1,5 @@
 """
-The module where the database connection parameters are defined
+The module that defines the database connection parameters
 """
 
 from sqlalchemy.ext.asyncio import (
@@ -14,7 +14,7 @@
 
 def create_engine(host: str) -> AsyncEngine:
     """
-    database connection parameters.
+    database connection parameters
     """
 
     # In production code, you will probably take these parameters from env

examples/fastapi_example/routes/README.md

@@ -0,0 +1,6 @@
+# Handlers example
+
+A module that contains all the application handlers.
+
+The examples are fictional, but they’re designed to demonstrate the
+various capabilities of the library.

examples/fastapi_example/routes/multiple_session_usage.py

@@ -26,7 +26,8 @@ async def handler_multiple_sessions() -> None:
         _insert(),  # context session
         run_in_new_ctx(_insert),  # new context and session with autocommit
         run_in_new_ctx(  # new context and session with manual commit
-            _insert_manual, "example_multiple_sessions",
+            _insert_manual,
+            "example_multiple_sessions",
         ),
         _insert_non_ctx(),  # new non context session
         _insert_non_ctx_manual(),  # new non context session