fix docs

Author: krylosov-aa

context_async_sqlalchemy/test_utils.py

@@ -33,11 +33,11 @@ async def set_test_context(auto_close: bool = False) -> AsyncGenerator[None]:
     Opens a context similar to middleware.
 
     Use auto_close=False if you’re using a test session and transaction
-        that you close manually elsewhere in your code.
+        that you close elsewhere in your code.
 
-    Use auto_close=True if, for example, you want to call a
-        function in a test that uses a context bypassing the
-        middleware, and you want all sessions to be closed automatically.
+    Use auto_close=True if you want to call a function
+        in a test that uses a context while the middleware is not
+        active, and you want all sessions to be closed automatically.
     """
     token = init_db_session_ctx()
     try:

docs/api/index.html

@@ -394,10 +394,10 @@ <h3 id="set_test_context">set_test_context</h3>
 It’s intended for use in tests where the test and the application share
 a single transaction.</p>
 <p>Use <code>auto_close=False</code> if you’re using a test session and transaction
-that you close manually elsewhere in your code.</p>
-<p>Use <code>auto_close=True</code> if, for example, you want to call a
-function in a test that uses a context bypassing the
-middleware, and you want all sessions to be closed automatically.</p>
+that you close elsewhere in your code.</p>
+<p>Use <code>auto_close=True</code> if you want to call a function
+in a test that uses a context while the middleware is not
+active, and you want all sessions to be closed automatically.</p>
 <hr />
 <h3 id="put_savepoint_session_in_ctx">put_savepoint_session_in_ctx</h3>
 <pre><code class="language-python">async def put_savepoint_session_in_ctx(

docs_sources/docs/api.md

@@ -325,11 +325,11 @@ It’s intended for use in tests where the test and the application share
 a single transaction.
 
 Use `auto_close=False` if you’re using a test session and transaction
-that you close manually elsewhere in your code.
+that you close elsewhere in your code.
 
-Use `auto_close=True` if, for example, you want to call a
-function in a test that uses a context bypassing the
-middleware, and you want all sessions to be closed automatically.
+Use `auto_close=True` if you want to call a function
+in a test that uses a context while the middleware is not
+active, and you want all sessions to be closed automatically.
 
 ---