doc: add missing docstring + add missing feature to README (#57)

src/fastapi_toolsets/pytest/__init__.py

@@ -1,3 +1,5 @@
+"""Pytest helpers for FastAPI testing: sessions, clients, and fixtures."""
+
 from .plugin import register_fixtures
 from .utils import (
     cleanup_tables,

src/fastapi_toolsets/pytest/utils.py

@@ -33,7 +33,6 @@ async def create_async_client(
         An AsyncClient configured for the app.
 
     Example:
-        ```python
         from fastapi import FastAPI
         from fastapi_toolsets.pytest import create_async_client
 
@@ -47,7 +46,6 @@ async def create_async_client(
         async def test_endpoint(client: AsyncClient):
             response = await client.get("/health")
             assert response.status_code == 200
-        ```
     """
     transport = ASGITransport(app=app)
     async with AsyncClient(transport=transport, base_url=base_url) as client:
@@ -79,7 +77,6 @@ async def create_db_session(
         An AsyncSession ready for database operations.
 
     Example:
-        ```python
         from fastapi_toolsets.pytest import create_db_session
         from app.models import Base
 
@@ -94,7 +91,6 @@ async def create_db_session(
             user = User(name="test")
             db_session.add(user)
             await db_session.commit()
-        ```
     """
     engine = create_async_engine(database_url, echo=echo)
 
@@ -151,7 +147,6 @@ def worker_database_url(database_url: str, default_test_db: str) -> str:
         A database URL with a worker- or default-specific database name.
 
     Example:
-        ```python
         # With PYTEST_XDIST_WORKER="gw0":
         url = worker_database_url(
             "postgresql+asyncpg://user:pass@localhost/test_db",
@@ -165,7 +160,6 @@ def worker_database_url(database_url: str, default_test_db: str) -> str:
             default_test_db="test",
         )
         # "postgresql+asyncpg://user:pass@localhost/test_db_test"
-        ```
     """
     worker = _get_xdist_worker(default_test_db=default_test_db)
 
@@ -198,7 +192,6 @@ async def create_worker_database(
         The worker-specific database URL.
 
     Example:
-        ```python
         from fastapi_toolsets.pytest import (
             create_worker_database, create_db_session, cleanup_tables
         )
@@ -215,7 +208,6 @@ async def create_worker_database(
             async with create_db_session(worker_db_url, Base) as session:
                 yield session
                 await cleanup_tables(session, Base)
-        ```
     """
     worker_url = worker_database_url(
         database_url=database_url, default_test_db=default_test_db
@@ -256,13 +248,11 @@ async def cleanup_tables(
         base: SQLAlchemy DeclarativeBase class containing model metadata.
 
     Example:
-        ```python
         @pytest.fixture
         async def db_session(worker_db_url):
             async with create_db_session(worker_db_url, Base) as session:
                 yield session
                 await cleanup_tables(session, Base)
-        ```
     """
     tables = base.metadata.sorted_tables
     if not tables: