from drfexts.fields import CharField, IntegerField, DecimalField

class Product(models.Model):
    name = CharField("商品名称", max_length=128)
    price = DecimalField("价格", max_digits=10, decimal_places=2)
    stock = IntegerField("库存")

from drfexts.models import BaseCreatorModel
from drfexts.fields import CharField, DecimalField

class Product(BaseCreatorModel):
    name = CharField("商品名称", max_length=128)
    price = DecimalField("价格", max_digits=10, decimal_places=2)

    class Meta:
        verbose_name = "商品"
        verbose_name_plural = verbose_name

Product.objects.editable()   # 排除已删除和已失效
Product.objects.active()     # 已生效 + 暂停中 + 待失效
Product.objects.valid()      # 仅已生效

from drfexts.models import serialize_model, serialize_queryset

qs = Product.objects.select_related("category").prefetch_related("tags")
data = serialize_queryset(qs)

from drfexts.serializers.serializers import WCCModelSerializer

class ProductSerializer(WCCModelSerializer):
    class Meta:
        model = Product
        fields = "__all__"

from drfexts.serializers.fields import ComplexPKRelatedField

class OrderSerializer(serializers.ModelSerializer):
    product = ComplexPKRelatedField(
        queryset=Product.objects.all(),
        display_field="name",
    )

{
    "product": {
        "id": 1,
        "label": "商品A"
    }
}

from drfexts.serializers.fields import DisplayChoiceField

status = DisplayChoiceField(choices=CommonStatus.choices)
# 序列化：50 → "已生效"
# 反序列化："已生效" → 50

serializer = ProductSerializer(instance, fields=["id", "name", "price"])

from drfexts.viewsets import ExtGenericViewSet
from rest_framework.mixins import ListModelMixin, RetrieveModelMixin

class ProductViewSet(ListModelMixin, RetrieveModelMixin, ExtGenericViewSet):
    queryset = Product.objects.all()
    serializer_class = {
        "default": ProductListSerializer,
        "retrieve": ProductDetailSerializer,
    }

class ProductSerializer(WCCModelSerializer):
    @classmethod
    def get_included_fields(cls, view, request):
        if request.query_params.get("simple"):
            return ["id", "name"]
        return None

class ProductSerializer(WCCModelSerializer):
    @classmethod
    def process_queryset(cls, request, queryset):
        return queryset.select_related("category")

class ProductViewSet(EagerLoadingMixin, ModelViewSet):
    ...

class ProductSerializer(ModelSerializer):
    @classmethod
    def setup_eager_loading(cls, queryset):
        return queryset.select_related("category").prefetch_related("tags")

from drfexts.filtersets.backends import AutoFilterBackend, OrderingFilterBackend

REST_FRAMEWORK = {
    "DEFAULT_FILTER_BACKENDS": [
        "drfexts.filtersets.backends.AutoFilterBackend",
        "drfexts.filtersets.backends.OrderingFilterBackend",
    ],
}

class ProductViewSet(ModelViewSet):
    filterset_fields_overwrite = {
        "name": {"lookup_expr": "icontains"},
        "custom_filter": SomeCustomFilter(field_name="..."),
    }

GET /api/products/?ordering=-price,name

class ProductSearchFilter(FullTextSearchFilter):
    search_vector = ["name", "description"]

REST_FRAMEWORK = {
    "DEFAULT_PAGINATION_CLASS": "drfexts.pagination.CustomPagination",
    "PAGE_SIZE": 20,
}

{
    "total": 100,
    "page_size": 20,
    "current_page": 1,
    "results": [...]
}

{
    "ret": 200,
    "msg": "success",
    "data": { ... }
}

{
    "ret": 400,
    "msg": "错误信息",
    "request_id": "..."
}

REST_FRAMEWORK = {
    "DEFAULT_RENDERER_CLASSES": [
        "drfexts.renderers.CustomJSONRenderer",
    ],
}

REST_FRAMEWORK = {
    "DEFAULT_PARSER_CLASSES": [
        "drfexts.parsers.CustomJSONParser",
        "rest_framework.parsers.FormParser",
        "rest_framework.parsers.MultiPartParser",
    ],
}

from drfexts.viewsets import ExportMixin
from rest_framework.viewsets import ModelViewSet

class ProductViewSet(ExportMixin, ModelViewSet):
    queryset = Product.objects.all()
    serializer_class = ProductSerializer
    default_base_filename = "products"

# 导出 CSV
GET /api/products/?format=csv

# 导出 XLSX
GET /api/products/?format=xlsx

# 指定导出文件名
GET /api/products/?format=xlsx&filename=商品列表.xlsx

# 指定导出字段及列名映射
GET /api/products/?format=csv&fields=name,price&fields_map={"name":"商品名","price":"价格"}

REST_FRAMEWORK = {
    "DEFAULT_AUTHENTICATION_CLASSES": [
        "drfexts.authentication.CsrfExemptSessionAuthentication",
    ],
}

REST_FRAMEWORK = {
    "EXCEPTION_HANDLER": "drfexts.exceptions.custom_exception_handler",
}

from drfexts.routers import OptionalSlashRouter

router = OptionalSlashRouter()
router.register("products", ProductViewSet)

# settings.py
DEFAULT_FILE_STORAGE = "drfexts.storages.AliOSSMediaStorage"
STATICFILES_STORAGE = "drfexts.storages.AliOSSStaticStorage"

REST_FRAMEWORK = {
    "DEFAULT_RENDERER_CLASSES": [
        "drfexts.renderers.CustomJSONRenderer",
    ],
    "DEFAULT_PARSER_CLASSES": [
        "drfexts.parsers.CustomJSONParser",
        "rest_framework.parsers.FormParser",
        "rest_framework.parsers.MultiPartParser",
    ],
    "DEFAULT_PAGINATION_CLASS": "drfexts.pagination.CustomPagination",
    "PAGE_SIZE": 20,
    "DEFAULT_FILTER_BACKENDS": [
        "drfexts.filtersets.backends.AutoFilterBackend",
        "drfexts.filtersets.backends.OrderingFilterBackend",
    ],
    "DEFAULT_AUTHENTICATION_CLASSES": [
        "drfexts.authentication.CsrfExemptSessionAuthentication",
    ],
    "EXCEPTION_HANDLER": "drfexts.exceptions.custom_exception_handler",
}

# models.py
from drfexts.models import BaseCreatorModel
from drfexts.fields import CharField, DecimalField, VirtualForeignKey

class Category(BaseCreatorModel):
    name = CharField("分类名称", max_length=64)

    class Meta:
        verbose_name = "分类"

class Product(BaseCreatorModel):
    name = CharField("商品名称", max_length=128)
    price = DecimalField("价格", max_digits=10, decimal_places=2)
    category = VirtualForeignKey(Category, verbose_name="分类")

    class Meta:
        verbose_name = "商品"


# serializers.py
from drfexts.serializers.serializers import WCCModelSerializer

class ProductSerializer(WCCModelSerializer):
    class Meta:
        model = Product
        fields = "__all__"

    @classmethod
    def process_queryset(cls, request, queryset):
        return queryset.select_related("category")


# views.py
from drfexts.viewsets import ExtGenericViewSet, ExportMixin
from rest_framework.mixins import ListModelMixin, RetrieveModelMixin, CreateModelMixin, UpdateModelMixin

class ProductViewSet(ExportMixin, ListModelMixin, RetrieveModelMixin, CreateModelMixin, UpdateModelMixin, ExtGenericViewSet):
    queryset = Product.objects.all()
    serializer_class = ProductSerializer


# urls.py
from drfexts.routers import OptionalSlashRouter

router = OptionalSlashRouter()
router.register("products", ProductViewSet)
urlpatterns = router.urls