Update docs

Author: wu-clan

docs/advanced/primary_key.md

@@ -2,20 +2,28 @@
 
     由于在 python 内部 `id` 为关键字，因此，我们设定默认主键入参为 `pk`。这仅用于函数入参，并不要求模型主键必须定义为 `pk`
 
-```py title="e.g." hl_lines="2"
-async def delete(self, db: AsyncSession, primary_key: int) -> int:
-    return self.delete_model(db, pk=primary_key)
-```
-
-## 主键定义
-
 !!! tip 自动主键
 
     我们在 SQLAlchemy CRUD Plus 内部通过 [inspect()](https://docs.sqlalchemy.org/en/20/core/inspection.html) 自动搜索表主键，
     而非强制绑定主键列必须命名为 `id`
 
-```py title="e.g." hl_lines="4"
+## 单个主键
+
+```py title="e.g."
 class ModelIns(Base):
     # define primary_key
     primary_key: Mapped[int] = mapped_column(primary_key=True, index=True, autoincrement=True)
+
+
+class ModelIns2(Base):
+    # define primary_key
+    primary_key: Mapped[str] = mapped_column(primary_key=True, index=True)
+```
+
+## 复合主键
+
+```python title="e.g."
+class ModelIns(Base):
+    primary_key: Mapped[int] = mapped_column(primary_key=True, index=True, autoincrement=True)
+    primary_key2: Mapped[str] = mapped_column(primary_key=True, index=True)
 ```

docs/usage/delete_model.md

@@ -24,20 +24,20 @@ class CRUDIns(CRUDPlus[ModelIns]):
 async def delete_model(
     self,
     session: AsyncSession,
-    pk: int,
+    pk: Any | Sequence[Any],
     flush: bool = False,
     commit: bool = False,
 ) -> int:
 ```
 
 **Parameters:**
 
-| Name    | Type         | Description                      | Default |
-|---------|--------------|----------------------------------|---------|
-| session | AsyncSession | 数据库会话                            | 必填      |
-| pk      | int          | [主键](../advanced/primary_key.md) | 必填      |
-| flush   | bool         | [冲洗](../advanced/flush.md)       | `False` |
-| commit  | bool         | [提交](../advanced/commit.md)      | `False` |
+| Name    | Type                     | Description                      | Default |
+|---------|--------------------------|----------------------------------|---------|
+| session | AsyncSession             | 数据库会话                            | 必填      |
+| pk      | `Any `\| `Sequence[Any]` | [主键](../advanced/primary_key.md) | 必填      |
+| flush   | bool                     | [冲洗](../advanced/flush.md)       | `False` |
+| commit  | bool                     | [提交](../advanced/commit.md)      | `False` |
 
 **Returns:**
 

docs/usage/select_model.md

@@ -24,17 +24,17 @@ class CRUDIns(CRUDPlus[ModelIns]):
 async def select_model(
     self,
     session: AsyncSession,
-    pk: int,
+    pk: Any | Sequence[Any],
     *whereclause: ColumnExpressionArgument[bool],
 ) -> Model | None:
 ```
 
 **Parameters:**
 
-| Name         | Type                             | Description                                                                                          | Default |
-|--------------|----------------------------------|------------------------------------------------------------------------------------------------------|---------|
-| session      | AsyncSession                     | 数据库会话                                                                                                | 必填      |
-| pk           | int                              | [主键](../advanced/primary_key.md)                                                                     | 必填      |
+| Name         | Type                             | Description                                                                                         | Default |
+|--------------|----------------------------------|-----------------------------------------------------------------------------------------------------|---------|
+| session      | AsyncSession                     | 数据库会话                                                                                               | 必填      |
+| pk           | `Any `\| `Sequence[Any]`         | [主键](../advanced/primary_key.md)                                                                     | 必填      |
 | *whereclause | `ColumnExpressionArgument[bool]` | 等同于 [SQLAlchemy where](https://docs.sqlalchemy.org/en/20/tutorial/data_select.html#the-where-clause) |         |
 
 **Returns:**

docs/usage/update_model.md

@@ -31,7 +31,7 @@ class CRUDIns(CRUDPlus[ModelIns]):
 async def update_model(
     self,
     session: AsyncSession,
-    pk: int,
+    pk: Any | Sequence[Any],
     obj: UpdateSchema | dict[str, Any],
     flush: bool = False,
     commit: bool = False,
@@ -44,7 +44,7 @@ async def update_model(
 | Name    | Type                          | Description                      | Default |
 |---------|-------------------------------|----------------------------------|---------|
 | session | AsyncSession                  | 数据库会话                            | 必填      |
-| pk      | int                           | [主键](../advanced/primary_key.md) | 必填      |
+| pk      | `Any `\| `Sequence[Any]`      | [主键](../advanced/primary_key.md) | 必填      |
 | obj     | `TypeVar `\|` dict[str, Any]` | 更新数据参数                           | 必填      |
 | flush   | bool                          | [冲洗](../advanced/flush.md)       | `False` |
 | commit  | bool                          | [提交](../advanced/commit.md)      | `False` |

sqlalchemy_crud_plus/crud.py

@@ -41,7 +41,7 @@ def _get_pk_filter(self, pk: Any | Sequence[Any]) -> list[bool]:
         """
         Get the primary key filter(s).
 
-        :param pk:
+        :param pk: Single value for simple primary key, or tuple for composite primary key.
         :return:
         """
         if isinstance(self.primary_key, list):

tests/test_update.py

@@ -1,7 +1,5 @@
 #!/usr/bin/env python3
 # -*- coding: utf-8 -*-
-from random import choice
-
 import pytest
 
 from sqlalchemy_crud_plus import CRUDPlus