**Какие уникальные фичи есть в django-modern-rest?**

Иногда, когда я добавляю какие-то фичи в мой [https://github.com/wemake-services/django-modern-rest](https://github.com/wemake-services/django-modern-rest) , то я думаю про себя: почему таких фичей больше нет нигде? 

Давайте сегодня посмотрим на них. А вы мне расскажите свое мнение в комментах.

**Семантическая схема **

Допустим, вы навесили на какой-то свой endpoint `auth`: 


class UserController(Controller[MsgspecSerializer]):
      @modify(auth=[JWTAsyncAuth()])
      async def get(self) -> User: ...


В OpenAPI [автоматически появятся](https://django-modern-rest.readthedocs.io/en/latest/pages/openapi/schema.html) все коды ошибок, которые могут случиться в `auth` (401).
Ничего не надо допом писать. И так происходит со всеми частями фреймворка: добавил `throttling=[SyncThrottle(1, Rate.minute)]`? Теперь у тебя в ответах автоматом 429. Если нужно, можно [отключить](https://django-modern-rest.readthedocs.io/en/latest/pages/openapi/schema.html#customizing-schema-generation) любые семантические статусы. 

Не должно ли такое быть дефолтом везде?

**Умные типы ошибок**

Не уходя далеко: как кастомизировать формат ошибки, например, в FastAPI? Через боль. Как поменять в спеке формат? Руками.

В DMR мы просто добавили везде `error_model` как параметр. Можно [заменять любые ошибки](https://django-modern-rest.readthedocs.io/en/latest/pages/error-handling.html#customizing-error-messages), все автоматом сконвертится и покажет правильную схему. Зачем? Хочешь [Problem Details](https://django-modern-rest.readthedocs.io/en/latest/pages/error-handling.html#problem-details) - используешь. Хочешь свой формат - реализуешь. Можно даже [content negotiation на ошибки](https://django-modern-rest.readthedocs.io/en/latest/pages/error-handling.html#conditionally-raising-problem-details) навесить.

Почему никто о таком не думает в других фреймворках?

**Нормальный throttling**

Фича, которая принесла мне больше всех боли. Я прочитал throttling реализации во всех фреймворках. В Litestar [даже](https://github.com/litestar-org/litestar/commit/577121ca48fd052204c9d37465d326d0d3cbe1f3) фиксы [присылал](https://github.com/litestar-org/litestar/commit/32c595ba13873c3992e35c33686d63f5ccc49f7d). 

1. Почти нигде из коробки нет поддержки разных [алгоритмов](https://django-modern-rest.readthedocs.io/en/latest/pages/throttling.html#algorithms), [бекендов](https://django-modern-rest.readthedocs.io/en/latest/pages/throttling.html#backends), иногда даже [cache-keys](https://django-modern-rest.readthedocs.io/en/latest/pages/throttling.html#cache-keys). Очень жаль, есть только обычный counter с бекендом в памяти
2. Нигде (пришлите в комменты контр-пример) нет [разделения](https://django-modern-rest.readthedocs.io/en/latest/pages/throttling.html#when-throttling-is-executed) на throttling до auth и после. Почему такое вообще важно? Чтобы не заддосить auth. И чтобы иметь возможность выдавать per-user правила. Нужны и важны оба варианта
3. [Кастомизация](https://django-modern-rest.readthedocs.io/en/latest/pages/throttling.html#headers) заголовков ответа? Ха&#33;

Что? Почему?

**Простое переиспользование кода**

Когда я смотрю на АПИ разных DRF проектов или FastAPI, мне становится больно. FastAPI строит все на view функциях, которые нельзя нормально кастомизировать. А DRF строит все на импортах строк внутри настроек. А как на счет классов и наследования?

У нас подобное сделано как [абстрактные generic классы](https://django-modern-rest.readthedocs.io/en/latest/pages/reusable-code.html). Например: получить JWT. Можно выбрать любой сериализатор, можно выбрать любые модели для запроса и ответа:


class RequestPayload(pydantic.BaseModel):
     username: str
     password: str

class ResponsePayload(pydantic.BaseModel):
     access: str
     refresh: str

class ObtainAccessAndRefreshSyncController(
    ObtainTokensSyncController[
        PydanticSerializer,
        RequestPayload,
        ResponsePayload,
    ],
): ...  # надо еще переопределить 2 метода


Все типизировано, документировано, очевидно. 
Как вы думаете, почему так больше никто не делает?

**Внешние вьюхи**

Интегрировать один фреймворк в другой - крайне сложно. Вот мы недавно даже [стрим проводили](https://t.me/opensource_findings/979), потому что не могли использовать `dj-rest-auth` из DRF. Так быть не должно.

Теперь в DMR можно использовать любые внешние Django View. Хоть DRF, хоть `django-ninja`, хоть ванильные вьюхи. И отображать любой внешний OpenAPI. Вот [настолько просто](https://django-modern-rest.readthedocs.io/en/latest/pages/external-views.html):


raw_schema = read_openapi_yaml('openapi.yml')
router = Router(
    urls=[
        external_path(
            'number/', number, name='number',
            openapi=load_schema(raw_schema['paths']['/api/number'], PathItem),
        ),
    ],
)


Почему другие фреймворки не стараются вписать существующие решения?

**Одной строкой**

- У нас есть еще куча других крутых фичей&#33; Заглядывайте в наш чатик по DMR [@django_modern_rest](https://t.me/django_modern_rest)
- [Релизнули](https://github.com/typeddjango/django-stubs/releases/tag/6.1.0) `django-stubs@6.1` с поддержкой `django@6.1`
- Сделали [папку с крутыми каналами](https://t.me/addlist/o2_hXmp5nSUyODNi) ребят из нашего Python сообщества. Смело можно закидывать коллегам как базовую папку "на кого подписаться в тг по питону". Внутри все мои друзья и коллеги, советую&#33;

Поддержать мою работу над опенсорсом и данным каналом можно на [бусти](https://boosty.to/sobolevn) и [github sponsors](https://github.com/sponsors/wemake-services).
Знание, что люди тебя поддерживают, мотивирует работать дальше&#33;