django-gc 1.0.1__tar.gz

django_gc-1.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 RDD Lab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

django_gc-1.0.1/PKG-INFO

@@ -0,0 +1,136 @@
+Metadata-Version: 2.4
+Name: django-gc
+Version: 1.0.1
+Summary: Typed Django runtime configuration stored in the database and served from cache
+Author-email: Raman Marozau <r.morozov@rdd-lab.com>
+License: MIT
+Project-URL: Homepage, https://django-gc.rdd-lab.com/
+Project-URL: Documentation, https://django-gc.rdd-lab.com/
+Project-URL: Issues, https://github.com/RDDLab/Django-GC/issues
+Project-URL: Repository, https://github.com/RDDLab/Django-GC
+Project-URL: Changelog, https://github.com/RDDLab/Django-GC/blob/main/CHANGELOG.md
+Keywords: django,config,settings,cache,admin
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 6.0
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: django>=6.0
+Requires-Dist: cryptography>=44.0.0
+Provides-Extra: celery
+Requires-Dist: celery>=5.3; extra == "celery"
+Dynamic: license-file
+
+![Logo](https://github.com/RDDLab/Django-GC/raw/main/docs/static/img/logo.svg)
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json&style=for-the-badge)](https://docs.astral.sh/ruff)
+[![pyrefly](https://img.shields.io/endpoint?url=https://pyrefly.org/badge.json&style=for-the-badge)](https://pyrefly.org)
+[![PyPI](https://img.shields.io/pypi/v/django-gc?style=for-the-badge)](https://pypi.org/project/django-gc/)
+[![PyPI pyversions](https://img.shields.io/pypi/pyversions/django-gc.svg?style=for-the-badge)](https://pypi.python.org/pypi/django-gc/)
+[![PyPI djversions](https://img.shields.io/pypi/djversions/django-gc.svg?style=for-the-badge)](https://pypi.org/project/django-gc/)
+[![PyPI status](https://img.shields.io/pypi/status/django-gc.svg?style=for-the-badge)](https://pypi.python.org/pypi/django-gc)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/django-gc?style=for-the-badge)](https://pypistats.org/packages/django-gc)
+[![PyPI - Types](https://img.shields.io/pypi/types/django-gc.svg?style=for-the-badge)](https://pypi.python.org/pypi/django-gc)
+
+---
+
+[![Tests](https://img.shields.io/github/actions/workflow/status/RDDLab/Django-GC/testing.yml?branch=main&label=Tests)](https://github.com/RDDLab/Django-GC/actions/workflows/testing.yml)
+[![Codecov](https://img.shields.io/codecov/c/github/RDDLab/Django-GC/main?logo=codecov)](https://codecov.io/gh/RDDLab/Django-GC)
+[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/RDDLab/Django-GC/main.svg)](https://results.pre-commit.ci/latest/github/RDDLab/Django-GC/main)
+
+---
+
+**Documentation**: <a href="https://django-gc.rdd-lab.com/" target="_blank">https://django-gc.rdd-lab.com/</a>
+
+**Source Code**: <a href="https://github.com/RDDLab/Django-GC" target="_blank">https://github.com/RDDLab/Django-GC</a>
+
+---
+
+# Django-GC
+
+Django-GC stores typed runtime settings in the database and serves them from Django's cache. Application code never reads a value through the ORM. The project owns the keys; this package is the mechanism.
+
+## Features
+
+- **Code-declared keys** — categories and definitions live in Django settings and are synchronized after migrate.
+- **Typed values** — strings, numbers, dates, arrays, choices, JSON, UUID, and optional secure secrets.
+- **Full cache snapshot** — `get_value()` never falls back to a single-row ORM read.
+- **Stock Django Admin** — edit values with standard `ModelAdmin` and Django's built-in change history.
+- **Optional Celery** — periodic full snapshot refresh.
+- **Fully typed** — ships `py.typed`; compatible with pyrefly and standard type checkers.
+
+## Installation
+
+```bash
+pip install django-gc
+```
+
+```python
+INSTALLED_APPS = [
+    'django_gc',
+    'django.contrib.admin',
+    # ...
+]
+```
+
+Periodic refresh is optional:
+
+```bash
+pip install 'django-gc[celery]'
+```
+
+## Quick start
+
+In Django `settings`, set categories, keys, and the encryption key. Then migrate and read values through the service:
+
+```python
+from enum import StrEnum
+
+from django_gc import (
+    CategoryDefinition,
+    SettingDefinition,
+    SettingType,
+    get_value,
+    set_value,
+)
+
+
+class SettingKey(StrEnum):
+    MAINTENANCE_ENABLED = 'maintenance-enabled'
+
+
+GLOBAL_CONFIG_CATEGORIES = [
+    CategoryDefinition(id=1, code='platform', name='Platform'),
+]
+GLOBAL_CONFIG_DEFINITIONS = [
+    SettingDefinition(
+        key=SettingKey.MAINTENANCE_ENABLED,
+        description='Maintenance mode',
+        default_value=False,
+        value_type=SettingType.BOOLEAN,
+        category_id=1,
+    ),
+]
+GLOBAL_CONFIG_ENCRYPTION_KEY = 'replace-with-a-long-random-secret'
+
+enabled = get_value(SettingKey.MAINTENANCE_ENABLED)
+set_value(SettingKey.MAINTENANCE_ENABLED, True)
+```
+
+## Documentation
+
+**https://django-gc.rdd-lab.com/**

django_gc-1.0.1/README.md

@@ -0,0 +1,100 @@
+![Logo](https://github.com/RDDLab/Django-GC/raw/main/docs/static/img/logo.svg)
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)
+[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json&style=for-the-badge)](https://docs.astral.sh/ruff)
+[![pyrefly](https://img.shields.io/endpoint?url=https://pyrefly.org/badge.json&style=for-the-badge)](https://pyrefly.org)
+[![PyPI](https://img.shields.io/pypi/v/django-gc?style=for-the-badge)](https://pypi.org/project/django-gc/)
+[![PyPI pyversions](https://img.shields.io/pypi/pyversions/django-gc.svg?style=for-the-badge)](https://pypi.python.org/pypi/django-gc/)
+[![PyPI djversions](https://img.shields.io/pypi/djversions/django-gc.svg?style=for-the-badge)](https://pypi.org/project/django-gc/)
+[![PyPI status](https://img.shields.io/pypi/status/django-gc.svg?style=for-the-badge)](https://pypi.python.org/pypi/django-gc)
+[![PyPI - Downloads](https://img.shields.io/pypi/dm/django-gc?style=for-the-badge)](https://pypistats.org/packages/django-gc)
+[![PyPI - Types](https://img.shields.io/pypi/types/django-gc.svg?style=for-the-badge)](https://pypi.python.org/pypi/django-gc)
+
+---
+
+[![Tests](https://img.shields.io/github/actions/workflow/status/RDDLab/Django-GC/testing.yml?branch=main&label=Tests)](https://github.com/RDDLab/Django-GC/actions/workflows/testing.yml)
+[![Codecov](https://img.shields.io/codecov/c/github/RDDLab/Django-GC/main?logo=codecov)](https://codecov.io/gh/RDDLab/Django-GC)
+[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/RDDLab/Django-GC/main.svg)](https://results.pre-commit.ci/latest/github/RDDLab/Django-GC/main)
+
+---
+
+**Documentation**: <a href="https://django-gc.rdd-lab.com/" target="_blank">https://django-gc.rdd-lab.com/</a>
+
+**Source Code**: <a href="https://github.com/RDDLab/Django-GC" target="_blank">https://github.com/RDDLab/Django-GC</a>
+
+---
+
+# Django-GC
+
+Django-GC stores typed runtime settings in the database and serves them from Django's cache. Application code never reads a value through the ORM. The project owns the keys; this package is the mechanism.
+
+## Features
+
+- **Code-declared keys** — categories and definitions live in Django settings and are synchronized after migrate.
+- **Typed values** — strings, numbers, dates, arrays, choices, JSON, UUID, and optional secure secrets.
+- **Full cache snapshot** — `get_value()` never falls back to a single-row ORM read.
+- **Stock Django Admin** — edit values with standard `ModelAdmin` and Django's built-in change history.
+- **Optional Celery** — periodic full snapshot refresh.
+- **Fully typed** — ships `py.typed`; compatible with pyrefly and standard type checkers.
+
+## Installation
+
+```bash
+pip install django-gc
+```
+
+```python
+INSTALLED_APPS = [
+    'django_gc',
+    'django.contrib.admin',
+    # ...
+]
+```
+
+Periodic refresh is optional:
+
+```bash
+pip install 'django-gc[celery]'
+```
+
+## Quick start
+
+In Django `settings`, set categories, keys, and the encryption key. Then migrate and read values through the service:
+
+```python
+from enum import StrEnum
+
+from django_gc import (
+    CategoryDefinition,
+    SettingDefinition,
+    SettingType,
+    get_value,
+    set_value,
+)
+
+
+class SettingKey(StrEnum):
+    MAINTENANCE_ENABLED = 'maintenance-enabled'
+
+
+GLOBAL_CONFIG_CATEGORIES = [
+    CategoryDefinition(id=1, code='platform', name='Platform'),
+]
+GLOBAL_CONFIG_DEFINITIONS = [
+    SettingDefinition(
+        key=SettingKey.MAINTENANCE_ENABLED,
+        description='Maintenance mode',
+        default_value=False,
+        value_type=SettingType.BOOLEAN,
+        category_id=1,
+    ),
+]
+GLOBAL_CONFIG_ENCRYPTION_KEY = 'replace-with-a-long-random-secret'
+
+enabled = get_value(SettingKey.MAINTENANCE_ENABLED)
+set_value(SettingKey.MAINTENANCE_ENABLED, True)
+```
+
+## Documentation
+
+**https://django-gc.rdd-lab.com/**

django_gc-1.0.1/django_gc/__init__.py

@@ -0,0 +1,45 @@
+from typing import Any
+
+from django_gc.dto import CategoryDefinition, SettingDefinition
+from django_gc.enums import SettingType
+from django_gc.exceptions import (
+    GlobalConfigCreationForbiddenError,
+    GlobalConfigDeletionForbiddenError,
+    GlobalConfigError,
+    GlobalConfigLockNotOwnedError,
+    GlobalConfigNotFoundError,
+    GlobalConfigParseError,
+    GlobalConfigRefreshLockTimeoutError,
+    GlobalConfigSnapshotIncompleteError,
+    GlobalConfigValueError,
+)
+
+__all__ = [
+    'CategoryDefinition',
+    'GlobalConfigCreationForbiddenError',
+    'GlobalConfigDeletionForbiddenError',
+    'GlobalConfigError',
+    'GlobalConfigLockNotOwnedError',
+    'GlobalConfigNotFoundError',
+    'GlobalConfigParseError',
+    'GlobalConfigRefreshLockTimeoutError',
+    'GlobalConfigSnapshotIncompleteError',
+    'GlobalConfigValueError',
+    'SettingDefinition',
+    'SettingType',
+    'get_value',
+    'is_cache_ready',
+    'refresh_cache',
+    'set_value',
+]
+
+
+def __getattr__(name: str) -> Any:
+    """
+    Лениво отдать runtime API после загрузки Django apps.
+    """
+    if name in {'get_value', 'is_cache_ready', 'refresh_cache', 'set_value'}:
+        from django_gc import services
+
+        return getattr(services, name)
+    raise AttributeError(f'module {__name__!r} has no attribute {name!r}')

django_gc-1.0.1/django_gc/admins/__init__.py

@@ -0,0 +1,4 @@
+from django_gc.admins.global_config import GlobalConfigAdmin
+from django_gc.admins.global_config_category import GlobalConfigCategoryAdmin
+
+__all__ = ['GlobalConfigAdmin', 'GlobalConfigCategoryAdmin']

django_gc-1.0.1/django_gc/admins/global_config.py

@@ -0,0 +1,48 @@
+from typing import TYPE_CHECKING, override
+
+from django.contrib import admin
+from django.http import HttpRequest
+from django.utils.translation import gettext_lazy as _
+
+from django_gc.forms import GlobalConfigForm
+from django_gc.models import GlobalConfig
+
+if TYPE_CHECKING:
+    _GlobalConfigAdmin = admin.ModelAdmin[GlobalConfig]
+else:
+    _GlobalConfigAdmin = admin.ModelAdmin
+
+
+@admin.register(GlobalConfig)
+class GlobalConfigAdmin(_GlobalConfigAdmin):
+    """
+    Управлять значениями GlobalConfig без изменения состава системных ключей.
+    """
+
+    form = GlobalConfigForm
+    list_display = ['key', 'description', 'category']
+    list_select_related = ['category']
+    list_filter = ['category', 'value_type', 'is_read_only']
+    search_fields = ['key', 'description']
+    ordering = ['category', 'description']
+    readonly_fields = ['key', 'description', 'is_read_only', 'category', 'created_at', 'updated_at']
+    fieldsets = [
+        (_('Общая информация'), {'classes': ['wide'], 'fields': ['key', 'category', 'value_type', 'description']}),
+        (_('Параметры'), {'classes': ['wide'], 'fields': ['is_read_only']}),
+        (_('Значение'), {'classes': ['wide'], 'fields': ['value']}),
+        (_('Даты'), {'classes': ['wide'], 'fields': ['created_at', 'updated_at']}),
+    ]
+
+    @override
+    def has_add_permission(self, request: HttpRequest) -> bool:
+        """
+        Разрешить создание ключей только через definitions.
+        """
+        return False
+
+    @override
+    def has_delete_permission(self, request: HttpRequest, obj: GlobalConfig | None = None) -> bool:
+        """
+        Запретить удаление системных ключей.
+        """
+        return False

django_gc-1.0.1/django_gc/admins/global_config_category.py

@@ -0,0 +1,45 @@
+from typing import TYPE_CHECKING, override
+
+from django.contrib import admin
+from django.http import HttpRequest
+from django.utils.translation import gettext_lazy as _
+
+from django_gc.forms import GlobalConfigCategoryForm
+from django_gc.models import GlobalConfigCategory
+
+if TYPE_CHECKING:
+    _GlobalConfigCategoryAdmin = admin.ModelAdmin[GlobalConfigCategory]
+else:
+    _GlobalConfigCategoryAdmin = admin.ModelAdmin
+
+
+@admin.register(GlobalConfigCategory)
+class GlobalConfigCategoryAdmin(_GlobalConfigCategoryAdmin):
+    """
+    Разрешить переименование системных категорий без изменения их состава.
+    """
+
+    form = GlobalConfigCategoryForm
+    list_display = ['id', 'code', 'name']
+    search_fields = ['code', 'name']
+    ordering = ['id']
+    readonly_fields = ['id', 'code', 'created_at', 'updated_at']
+    fieldsets = [
+        (_('Идентификаторы'), {'classes': ['wide'], 'fields': ['id', 'code']}),
+        (_('Категория'), {'classes': ['wide'], 'fields': ['name']}),
+        (_('Даты'), {'classes': ['wide'], 'fields': ['created_at', 'updated_at']}),
+    ]
+
+    @override
+    def has_add_permission(self, request: HttpRequest) -> bool:
+        """
+        Разрешить создание категорий только через definitions.
+        """
+        return False
+
+    @override
+    def has_delete_permission(self, request: HttpRequest, obj: GlobalConfigCategory | None = None) -> bool:
+        """
+        Запретить удаление системных категорий.
+        """
+        return False

django_gc-1.0.1/django_gc/apps.py

@@ -0,0 +1,21 @@
+from typing import override
+
+from django.apps import AppConfig
+from django.utils.translation import gettext_lazy as _
+
+
+class Config(AppConfig):
+    """
+    Приложение типизированных runtime-настроек.
+    """
+
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'django_gc'
+    verbose_name = _('Управление настройками')
+
+    @override
+    def ready(self) -> None:
+        """
+        Подключить сигналы и регистрацию Admin.
+        """
+        from django_gc import admins, signals

django_gc-1.0.1/django_gc/conf.py

@@ -0,0 +1,101 @@
+import base64
+import hashlib
+from collections.abc import Sequence
+from contextlib import contextmanager
+from contextvars import ContextVar, Token
+from typing import Any
+
+from cryptography.fernet import Fernet, InvalidToken
+from django.conf import settings
+
+from django_gc.dto import CategoryDefinition, SettingDefinition
+
+_REFRESH_SUPPRESSED: ContextVar[bool] = ContextVar('global_config_refresh_suppressed', default=False)
+
+
+def get_cache_alias() -> str:
+    """
+    Вернуть алиас Django cache для снимка GlobalConfig.
+    """
+    return str(getattr(settings, 'GLOBAL_CONFIG_CACHE_ALIAS', 'default'))
+
+
+def get_category_definitions() -> Sequence[CategoryDefinition]:
+    """
+    Прочитать объявленные проектом категории.
+    """
+    return tuple(getattr(settings, 'GLOBAL_CONFIG_CATEGORIES', ()))
+
+
+def get_setting_definitions() -> Sequence[SettingDefinition]:
+    """
+    Прочитать объявленные проектом ключи.
+    """
+    return tuple(getattr(settings, 'GLOBAL_CONFIG_DEFINITIONS', ()))
+
+
+def get_required_setting_keys() -> set[str]:
+    """
+    Получить системный состав обязательного полного снимка.
+    """
+    return {str(item.key) for item in get_setting_definitions()}
+
+
+def get_encryption_key() -> str | None:
+    """
+    Прочитать ключ шифрования SECURE-значений.
+    """
+    key = getattr(settings, 'GLOBAL_CONFIG_ENCRYPTION_KEY', None)
+    if key is None or key == '':
+        return None
+    return str(key)
+
+
+def _build_fernet(*, key: str) -> Fernet:
+    """
+    Построить Fernet из произвольной секретной строки.
+    """
+    digest = hashlib.sha256(key.encode('utf-8')).digest()
+    return Fernet(key=base64.urlsafe_b64encode(digest))
+
+
+def encrypt_value(*, text: str) -> str:
+    """
+    Зашифровать SECURE-значение, если задан GLOBAL_CONFIG_ENCRYPTION_KEY.
+    """
+    key = get_encryption_key()
+    if key is None:
+        return text
+    return _build_fernet(key=key).encrypt(data=text.encode('utf-8')).decode('ascii')
+
+
+def decrypt_value(*, text: str) -> str | None:
+    """
+    Расшифровать SECURE-значение, если задан GLOBAL_CONFIG_ENCRYPTION_KEY.
+    """
+    key = get_encryption_key()
+    if key is None:
+        return text
+    try:
+        return _build_fernet(key=key).decrypt(token=text.encode('ascii')).decode('utf-8')
+    except (InvalidToken, ValueError):
+        return None
+
+
+def is_refresh_suppressed() -> bool:
+    """
+    Проверить, нужно ли пропустить post_save refresh.
+    """
+    return _REFRESH_SUPPRESSED.get()
+
+
+@contextmanager
+def suppress_cache_refresh() -> Any:
+    """
+    Подавить per-row refresh на время синхронизации definitions.
+    """
+    token: Token[bool] = _REFRESH_SUPPRESSED.set(True)
+    try:
+        yield
+    finally:
+        _REFRESH_SUPPRESSED.reset(token)

django_gc-1.0.1/django_gc/dto/__init__.py

@@ -0,0 +1,4 @@
+from django_gc.dto.definitions import CategoryDefinition, SettingDefinition
+from django_gc.dto.global_config_cache_value import GlobalConfigCacheValueDTO
+
+__all__ = ['CategoryDefinition', 'GlobalConfigCacheValueDTO', 'SettingDefinition']

django_gc-1.0.1/django_gc/dto/definitions.py

@@ -0,0 +1,33 @@
+from dataclasses import dataclass
+from enum import StrEnum
+from typing import Any
+
+from django_gc.enums import SettingType
+
+
+@dataclass(frozen=True)
+class CategoryDefinition:
+    """
+    Описать системную категорию GlobalConfig для инициализации.
+    """
+
+    id: int
+    code: str
+    name: str
+
+
+@dataclass(frozen=True)
+class SettingDefinition:
+    """
+    Описать управляемый кодом ключ GlobalConfig для инициализации.
+    """
+
+    key: str | StrEnum
+    description: str
+    default_value: Any
+    value_type: SettingType
+    category_id: int
+    nullable: bool = False
+    is_read_only: bool = False
+    variables: dict[str, Any] | None = None
+    is_always_update: bool = False

django_gc-1.0.1/django_gc/dto/global_config_cache_value.py

@@ -0,0 +1,16 @@
+from dataclasses import dataclass
+from typing import Any
+
+from django_gc.enums import SettingType
+
+
+@dataclass(frozen=True)
+class GlobalConfigCacheValueDTO:
+    """
+    Типизированное значение снимка GlobalConfig.
+
+    Для SettingType.SECURE поле value содержит только зашифрованное значение.
+    """
+
+    value: Any
+    value_type: SettingType

django_gc-1.0.1/django_gc/enums/__init__.py

@@ -0,0 +1,4 @@
+from django_gc.enums.choices_enum import ChoicesEnumMixin
+from django_gc.enums.setting_types import SettingType
+
+__all__ = ['ChoicesEnumMixin', 'SettingType']

django_gc-1.0.1/django_gc/enums/choices_enum.py

@@ -0,0 +1,36 @@
+from enum import Enum
+
+from django.utils.functional import Promise
+
+
+class ChoicesEnumMixin(Enum):
+    """
+    Дать Django choices из членов enum с методом ``label()``.
+    """
+
+    def label(self) -> Promise:
+        """
+        Вернуть человекочитаемую подпись члена enum.
+        """
+        raise NotImplementedError
+
+    @classmethod
+    def values(cls) -> set[object]:
+        """
+        Вернуть множество значений членов.
+        """
+        return {item.value for item in cls}
+
+    @classmethod
+    def labels(cls) -> set[str]:
+        """
+        Вернуть множество строковых подписей членов.
+        """
+        return {str(item.label()) for item in cls}
+
+    @classmethod
+    def choices(cls) -> list[tuple[object, Promise]]:
+        """
+        Вернуть пары value/label для поля Django.
+        """
+        return [(member.value, member.label()) for member in cls]