wemake-services/django-modern-rest 0.13.0

Version 0.13.0

on GitHub

You are migrating a Python project from `django-modern-rest` 0.12.0 to 0.13.0.
Load the latest documentation from https://django-modern-rest.readthedocs.io/llms-full.txt
before making any changes.

Apply **all** of the following breaking changes to the codebase.
For each change, search the entire project (including tests, fixtures, and
any helper modules) before editing.

---

### 1. `Schema.then` → `Schema.schema_then`

Find every attribute access or contructor param`then` on a `Schema` class
or instance and rename it to `schema_then`.

Before:
    Schema(then=...)
    schema.then

After:
    Schema(schema_then=...)
    schema.schema_then

---

### 2. `dmr.openapi.objects.openapi.convert` → `dmr.openapi.mappers.schema_normalization.dump_schema`

Find all imports and call-sites of `convert` from
`dmr.openapi.objects.openapi` and replace them:

Before:
    from dmr.openapi.objects.openapi import convert
    convert(...)

After:
    from dmr.openapi.mappers.schema_normalization import dump_schema
    dump_schema(...)

---

### 3. Remove `normalize_key` and `normalize_value`

Find all imports and usages of `normalize_key` and `normalize_value`
from `dmr.openapi.objects.openapi` and remove them entirely.
These functions have been deleted with no replacement.
If they are called inline, investigate whether the call site can be
removed or rewritten without them (consult the updated docs).
Use `dump_schema` directly instead.

Before:
    from dmr.openapi.objects.openapi import normalize_key, normalize_value

After:
    # remove the import and all call sites

---

### 4. `dmr.openapi.objects.openapi.ConvertedSchema` → `dmr.openapi.mappers.schema_normalization.DumpedSchema`

Before:
    from dmr.openapi.objects.openapi import ConvertedSchema

After:
    from dmr.openapi.mappers.schema_normalization import DumpedSchema

Replace all type annotations, isinstance checks, and other usages
of `ConvertedSchema` with `DumpedSchema`.

---

### 5. Remove `dmr.openapi.views.base.DumpedSchema`

Find all imports of `DumpedSchema` from `dmr.openapi.views.base` and remove
them. It was a plain `str` type alias; replace any annotation that used it
with the built-in `str`.

Before:
    from dmr.openapi.views.base import DumpedSchema
    def foo() -> DumpedSchema: ...

After:
    def foo() -> str: ...

---

### 6. `dmr.openapi.objects.OpenAPI` → `dmr.openapi.openapi.OpenAPI`

Before:
    from dmr.openapi.objects import OpenAPI

After:
    from dmr.openapi.openapi import OpenAPI

---

### 7. `rebuild_namespace` → `extra_namespace` in `PydanticSerializer.from_python`

Find every call to `PydanticSerializer.from_python(...)` that passes a
`rebuild_namespace` keyword argument and rename the parameter.

Before:
    PydanticSerializer.from_python(..., rebuild_namespace=ns)

After:
    PydanticSerializer.from_python(..., extra_namespace=ns)

---

### 8. `skip_validation` must be keyword-only on `OpenAPIView.as_view()` and subclasses

Find all call sites of `.as_view()` on `OpenAPIView` or any of its
subclasses where `skip_validation` is passed as a positional argument and
make it explicit.

Before:
    MyOpenAPIView.as_view(schema, True)          # skip_validation passed positionally

After:
    MyOpenAPIView.as_view(schema, skip_validation=True)

Also update any subclass overrides of `as_view` so that `skip_validation`
appears after a bare `*` in the signature:

Before:
    @classmethod
    def as_view(cls, skip_validation=False, **kwargs): ...

After:
    @classmethod
    def as_view(cls, *, skip_validation=False, **kwargs): ...

---

### 9. `Controller.get_path_item` → `Controller.get_schema`

Find every definition and call site of `get_path_item` on any
`Controller` subclass and rename it to `get_schema`.

Before:
    class MyController(Controller):
        def get_path_item(self, router): ...

    controller.get_path_item(router)

After:
    class MyController(Controller):
        def get_schema(self, router): ...

    controller.get_schema(router)

---

### 10. Remove `dmr_assert_throttling` and `dmr_assert_async_throttling` pytest fixtures

These are no longer fixtures. Find every use of them as pytest fixtures
(i.e. as function parameters in test functions) and replace them with
direct function calls instead.

Before:
    def test_my_endpoint(dmr_assert_throttling):
        dmr_assert_throttling(client, url)

After:
    from dmr.test.throttling import assert_throttling   # adjust import as needed

    def test_my_endpoint():
        assert_throttling(client, url)

Do the same for `dmr_assert_async_throttling`.

---

### 11. Remove `dmr.test.types` module

Find all imports from `dmr.test.types` and replace them with the new
location:

Before:
    from dmr.test.types import ThrottlingWhen

After:
    from dmr.test.throttling import ThrottlingWhen

Any other symbols that were imported from `dmr.test.types` should be
investigated; if they no longer exist, remove them.