Merge branch 'main' into enhancement/improve-update-when-not-found

docs/quick-start.md

@@ -8,10 +8,11 @@ Assuming you have your SQLAlchemy model, Pydantic schemas and database connectio
 
 Define your SQLAlchemy model
 
-```python title="setup.py" hl_lines="11-19"
-from sqlalchemy import Column, Integer, String
+```python title="setup.py" hl_lines="12-20"
+import datetime
+from sqlalchemy import Column, DateTime, Integer, Numeric, String, func
 from sqlalchemy.orm import DeclarativeBase, sessionmaker
-from sqlalchemy.ext.asyncio import AsyncSession
+from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine
 from pydantic import BaseModel
 
 
@@ -30,10 +31,11 @@ async_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False
 
 Then your Pydantic schemas
 
-```python title="setup.py" hl_lines="22-27"
-from sqlalchemy import Column, Integer, String
+```python title="setup.py" hl_lines="23-28"
+import datetime
+from sqlalchemy import Column, DateTime, Integer, Numeric, String, func
 from sqlalchemy.orm import DeclarativeBase, sessionmaker
-from sqlalchemy.ext.asyncio import AsyncSession
+from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine
 from pydantic import BaseModel
 
 
@@ -52,10 +54,11 @@ async_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False
 
 And, finally, your database connection
 
-```python title="setup.py" hl_lines="30-32"
-from sqlalchemy import Column, Integer, String
+```python title="setup.py" hl_lines="31-33"
+import datetime
+from sqlalchemy import Column, DateTime, Integer, Numeric, String, func
 from sqlalchemy.orm import DeclarativeBase, sessionmaker
-from sqlalchemy.ext.asyncio import AsyncSession
+from sqlalchemy.ext.asyncio import AsyncSession, create_async_engine
 from pydantic import BaseModel
 
 
@@ -76,28 +79,34 @@ async_session = sessionmaker(engine, class_=AsyncSession, expire_on_commit=False
 
 Use `crud_router` and include it in your `FastAPI` application
 
-```python title="main.py" hl_lines="17-24 26"
+```python title="main.py" hl_lines="23-30 32"
+from typing import AsyncGenerator
+
+from fastapi import FastAPI
+from sqlalchemy.ext.asyncio import AsyncSession
+
 from fastcrud import crud_router
+import setup
 
 # Database session dependency
 async def get_session() -> AsyncGenerator[AsyncSession, None]:
-    async with async_session() as session:
+    async with setup.async_session() as session:
         yield session
 
 # Create tables before the app start
 async def lifespan(app: FastAPI):
-    async with engine.begin() as conn:
-        await conn.run_sync(Base.metadata.create_all)
+    async with setup.engine.begin() as conn:
+        await conn.run_sync(setup.Base.metadata.create_all)
     yield
 
 # FastAPI app
 app = FastAPI(lifespan=lifespan)
 
 item_router = crud_router(
-    session=session,
-    model=Item,
-    create_schema=ItemSchema,
-    update_schema=ItemSchema,
+    session=get_session,
+    model=setup.Item,
+    create_schema=setup.ItemSchema,
+    update_schema=setup.ItemSchema,
     path="/items",
     tags=["Items"]
 )