Для чего используется IntegerChoices в Django?

IntegerChoices в Django используется для определения набора именованных целочисленных констант. Он предоставляет удобный и читаемый способ представления фиксированного набора числовых значений, например, статусов или типов, которые могут быть связаны с полями модели.

Основные преимущества использования IntegerChoices:

• Читаемость кода: Названия констант делают намерение кода более понятным, чем использование "магических" чисел.
• Улучшенная поддержка в формах и интерфейсе администратора: Django по умолчанию генерирует виджеты выбора (select widgets) с удобочитаемыми метками на основе названий констант.
• Предотвращение ошибок: Использование констант вместо прямых числовых значений уменьшает вероятность опечаток.
• Централизованное управление: Все возможные значения собраны в одном месте.

Пример использования:

# choices.py или models.py
from django.db import models

class OrderStatus(models.IntegerChoices):
    PENDING = 0, 'В обработке'
    PROCESSING = 1, 'В работе'
    SHIPPED = 2, 'Отправлен'
    DELIVERED = 3, 'Доставлен'
    CANCELLED = 4, 'Отменен'

# models.py
from django.db import models
from .choices import OrderStatus # Если OrderStatus определен в другом файле

class Order(models.Model):
    status = models.IntegerField(
        choices=OrderStatus.choices,
        default=OrderStatus.PENDING,
    )
    created_at = models.DateTimeField(auto_now_add=True)

# В коде
order = Order.objects.create(status=OrderStatus.PROCESSING)
if order.status == OrderStatus.DELIVERED:
    print("Заказ доставлен")