sobolevn

docs: refactor exception usage

2

I made quite a lot of changes: 1. I replaced `:doc:` with `:ref:` since it is more reliable 2. I replaced things like ```rst :class:`HTTPException ` ``` to be just...

### Summary Django has a middleware that should always be used: https://docs.djangoproject.com/en/3.0/ref/middleware/#module-django.middleware.security I think that Litestar should also have it out of the box. What it does? It provide security-related...

### Summary https://docs.litestar.dev/latest/usage/logging.html features a lot of useful examples, but it does not have one with logging JSON data. I think that it is the de-facto standard these days and...

### Description Link: https://github.com/litestar-org/litestar/actions/runs/11371187529/job/31632686132 ``` ================================== FAILURES =================================== ____________________________ test_default_no_warns ____________________________ [gw1] win32 -- Python 3.12.7 D:\a\litestar\litestar\.venv\Scripts\python.exe def test_default_no_warns() -> None: with catch_warnings(record=True) as warnings: simplefilter("always") import litestar.handlers.http_handlers.decorators reload(litestar.handlers.http_handlers.decorators) >...

### Summary I've noticed several type errors in examples. For example: https://github.com/litestar-org/litestar/blob/236cfa31064da5b4e02dd1a447d6abb737e208e3/docs/examples/data_transfer_objects/factory/patch_requests.py#L33 It is a type error, because `data.update_instance` expects `T=Person`) and we give it `T=Person | None` from `.get`...

### Summary Right now [`create_instance`](https://docs.litestar.dev/latest/reference/dto/data_structures.html#litestar.dto.data_structures.DTOData.create_instance) can take any `**kwargs`. But, mypy has no way of actually checking that `id=1, address__id=2` are valid keywords for this call. It can be caught...

Docs: let's improve "DTO: basic use" page

2

### Summary Right now https://docs.litestar.dev/latest/usage/dto/0-basic-use.html starts with: and I was like: wait a second! > Here we demonstrate how to declare DTO types to your route handlers. > For demonstration...

### Summary Example: - Docs: https://docs.litestar.dev/latest/usage/dto/1-abstract-dto.html#excluding-fields - Code: ```python config = DTOConfig( exclude={ "id", "address.id", "address.street", "pets.0.id", "pets.0.user_id", } ) ``` Later is specifies: > and "pets.0.id" and "pets.0.user_id" represent...

### Description When running `pdm install` on `litestar` repo you get: ``` Run pdm install -G:all WARNING: Lockfile is generated on an older version of PDM WARNING: Lockfile hash doesn't...

Narrow `is` with final types correctly

4

Now we can narrow `@final` types with `is` and `is not`. Closes #15553