Update cursor total items docs

Author: uriyyo

docs/tutorials/cursor-pagination.md

@@ -19,4 +19,14 @@ To use `cursor` you need to import `CursorPage` from `fastapi_pagination.cursor`
 
 ```py hl_lines="7"
 {! ../docs_src/tutorial/cursor_pagination.py !}
+```
+
+
+## Total items behavior 
+
+By default `CursorPage` doesn't include total count of items. If you want to include it, you should customize page
+using `UseIncludeTotal` customizer.
+
+```py hl_lines="58-63"
+{! ../docs_src/tutorial/cursor_pagination_with_total.py !}
 ```

docs_src/tutorial/cursor_pagination_with_total.py

@@ -0,0 +1,69 @@
+from typing import TypeVar
+
+from fastapi import FastAPI
+from pydantic import BaseModel
+from sqlalchemy import create_engine, select
+from sqlalchemy.orm import DeclarativeBase, Mapped, Session, mapped_column
+
+from fastapi_pagination import add_pagination
+from fastapi_pagination.cursor import CursorPage
+from fastapi_pagination.customization import CustomizedPage, UseIncludeTotal
+from fastapi_pagination.ext.sqlalchemy import paginate
+
+app = FastAPI()
+add_pagination(app)
+
+engine = create_engine("sqlite:///.db")
+
+
+class Base(DeclarativeBase):
+    pass
+
+
+class User(Base):
+    __tablename__ = "users"
+
+    id: Mapped[int] = mapped_column(primary_key=True)
+
+    name: Mapped[str] = mapped_column()
+    age: Mapped[int] = mapped_column()
+
+
+class UserOut(BaseModel):
+    id: int
+    name: str
+    age: int
+
+    class Config:
+        orm_mode = True
+
+
+@app.on_event("startup")
+def on_startup():
+    with engine.begin() as conn:
+        Base.metadata.drop_all(conn)
+        Base.metadata.create_all(conn)
+
+    with Session(engine) as session:
+        session.add_all(
+            [
+                User(name="John", age=25),
+                User(name="Jane", age=30),
+                User(name="Bob", age=20),
+            ],
+        )
+        session.commit()
+
+
+T = TypeVar("T")
+
+CursorWithTotalPage = CustomizedPage[
+    CursorPage[T],
+    UseIncludeTotal(True),
+]
+
+
+@app.get("/users")
+def get_users() -> CursorWithTotalPage[UserOut]:
+    with Session(engine) as session:
+        return paginate(session, select(User).order_by(User.id))