Starlite

:warning: **Important** :warning:

This release contains a patch for a [vulnerability](https://github.com/litestar-org/litestar/security/advisories/GHSA-83pv-qr33-2vcf) that would allow path traversal in the static file serving functionality of Litestar. It is highly recommended to update your minor version to this patch release.

You can find more background information in the related discussion 3473 .

Sponsors 🌟
Thanks to these incredible business sponsors:

[Scalar](https://scalar.com/) (scalar), [Telemetry Sports](https://telemetrysports.com/) (via chris-telemetry), [Stok](https://www.stok.kr/) (stok-team)

A huge 'Thank you!' to all other sponsors across [Polar.sh](https://polar.sh/litestar-org), [OpenCollective](https://opencollective.com/litestar) and [GitHub Sponsors](https://github.com/sponsors/litestar-org/)!

What's changed

New contributors 🎉
* maintain0404 made their first contribution in https://github.com/litestar-org/litestar/pull/3405

Bugfixes 🐛
* Fix improper Limitation of a Pathname to a Restricted Directory by peterschutt in https://github.com/litestar-org/litestar/security/advisories/GHSA-83pv-qr33-2vcf
* Remove use of asserts for control flow in Pydantic Plugin by peterschutt in https://github.com/litestar-org/litestar/pull/3359
* Fix OpenAPI schema for generic wrapped return types with DTO by peterschutt in https://github.com/litestar-org/litestar/pull/3371
* Fix ambiguous default warning for no signature default by peterschutt in https://github.com/litestar-org/litestar/pull/3378
* Fix path param consumed by dependency treated as unconsumed by peterschutt in https://github.com/litestar-org/litestar/pull/3380
* Fix remove `name` and `in` properties included in OpenAPI headers by peterschutt in https://github.com/litestar-org/litestar/pull/3417
* Fix unconditional minijinja import in flash-messages plugin by peterschutt in https://github.com/litestar-org/litestar/pull/3418
* Fix routing issues with regular handler under mounted app by peterschutt in https://github.com/litestar-org/litestar/pull/3430
* Fix file logging with structlog by peterschutt in https://github.com/litestar-org/litestar/pull/3425
* Fix clearing large session cookies by peterschutt in https://github.com/litestar-org/litestar/pull/3446
* Fix flash messages were not displayed on redirects by euri10 in https://github.com/litestar-org/litestar/pull/3420
* Fix alidation of optional sequence in multipart data with one value by provinzkraut in https://github.com/litestar-org/litestar/pull/3408

Documentation
* Update ``usage/static_files`` by JacobCoffee in https://github.com/litestar-org/litestar/pull/3358
* Fix broken url; swagger ui by wer153 in https://github.com/litestar-org/litestar/pull/3368
* Correct a word by wer153 in https://github.com/litestar-org/litestar/pull/3412
* Fix WebSockets documentation grammar by marcuslimdw in https://github.com/litestar-org/litestar/pull/3413
* Fix intersphinx mapping for advanced-alchemy by provinzkraut in https://github.com/litestar-org/litestar/pull/3438
* Update ``usage/caching`` by JacobCoffee in https://github.com/litestar-org/litestar/pull/3345
* Update ``docs/usage/security/*`` by JacobCoffee in https://github.com/litestar-org/litestar/pull/3344
* Improve sse by euri10 in https://github.com/litestar-org/litestar/pull/3454


**Full Changelog**
https://github.com/litestar-org/litestar/compare/v2.8.2...v2.8.3

Sponsors 🌟

Thanks to these incredible business sponsors:
- [Scalar](https://scalar.com/) (scalar), [Telemetry Sports](https://telemetrysports.com/) (via chris-telemetry), [Stok](https://www.stok.kr/) (stok-team)

- A huge 'Thank you!' to all sponsors, subscribers, and contributors across [Polar.sh](https://polar.sh/litestar-org), [OpenCollective](https://opencollective.com/litestar) and [GitHub Sponsors](https://github.com/sponsors/litestar-org/)!

What's changed

Bugfixes 🐛
* fix: pydantic import differentiation for pydantic v1.10.15 by peterschutt in https://github.com/litestar-org/litestar/pull/3347

**Full Changelog**
https://github.com/litestar-org/litestar/compare/v2.8.1...v2.8.2

Sponsors 🌟

Thanks to these incredible business sponsors:
- [Scalar](https://scalar.com/) (scalar), [Telemetry Sports](https://telemetrysports.com/) (via chris-telemetry), [Stok](https://www.stok.kr/) (stok-team)

- A huge 'Thank you!' to all sponsors, subscribers, and contributors across [Polar.sh](https://polar.sh/litestar-org), [OpenCollective](https://opencollective.com/litestar) and [GitHub Sponsors](https://github.com/sponsors/litestar-org/)!

What's changed

Bugfixes 🐛
* fix: asgi lifespan msg after lifespan context exception by peterschutt in https://github.com/litestar-org/litestar/pull/3315
* fix: bug when pydantic==1.10 is installed by peterschutt in https://github.com/litestar-org/litestar/pull/3335
* fix: OpenAPI router and controller on same app. by peterschutt in https://github.com/litestar-org/litestar/pull/3338

<!-- Review these: Not all of them should go into the release notes -->
Other changes
* docs: add citation by JacobCoffee in https://github.com/litestar-org/litestar/pull/3329
* refactor(routing): Move kwargs model creation to handler by provinzkraut in https://github.com/litestar-org/litestar/pull/3331

**Full Changelog**
https://github.com/litestar-org/litestar/compare/v2.8.0...v2.8.1

Sponsors 🌟
Thanks to these incredible business sponsors:
- [Scalar](https://scalar.com/) (scalar), [Telemetry Sports](https://telemetrysports.com/) (via chris-telemetry), [Stok](https://www.stok.kr/) (stok-team)

Thanks to these incredible personal sponsors:
- [Polar.sh](https://polar.sh/litestar-org/subscriptions): thomastu, skewty, iRod3s
- [GitHub Sponsors](https://github.com/sponsors/litestar-org/): (stok-team), benjamin-kirkbride, crisog, geeshta, cbscsm, ruslan-korneev,
- [OpenCollective](https://opencollective.com/litestar): Christian Y, Anonymous

- A huge 'Thank you!' to all sponsors, subscribers, and contributors across [Polar.sh](https://polar.sh/litestar-org), [OpenCollective](https://opencollective.com/litestar) and [GitHub Sponsors](https://github.com/sponsors/litestar-org/)!
What's changed

New contributors 🎉
* carlsmedstad made their first contribution in https://github.com/litestar-org/litestar/pull/3291
* haryle made their first contribution in https://github.com/litestar-org/litestar/pull/3242
* winbornejw made their first contribution in https://github.com/litestar-org/litestar/pull/3136

Bugfixes 🐛
* fix(cli): remove duplicate rich-click config options by JacobCoffee in https://github.com/litestar-org/litestar/pull/3274
* fix: pydantic `json_schema_extra` examples. by peterschutt in https://github.com/litestar-org/litestar/pull/3281
* fix(openapi): set default on schema from `FieldDefinition` by guacs in https://github.com/litestar-org/litestar/pull/3280
* fix: Custom types cause serialisation error in exception response with non-JSON media-type by provinzkraut in https://github.com/litestar-org/litestar/pull/3284
* fix(OpenAPI): Ensure default values are always represented in schema for dataclasses and `msgspec.Struct`s by provinzkraut in https://github.com/litestar-org/litestar/pull/3285
* fix(DTO): Pydantic v2 error handling/serialization when for non-pydantic exceptions by provinzkraut in https://github.com/litestar-org/litestar/pull/3286
* fix(OpenAPI): Fix OpenAPI schema generation for paths with path parameters of different types on the same path by provinzkraut in https://github.com/litestar-org/litestar/pull/3293
* fix(OpenAPI): Document unconsumed path parameters by provinzkraut in https://github.com/litestar-org/litestar/pull/3295
* fix: Unique schema names for nested models (3134) by winbornejw in https://github.com/litestar-org/litestar/pull/3136

New features 🚀
* feat: add [Scalar.com](https://scalar.com/) as an OpenAPI docs generator option
* feat: allow for console output to be silenced by cofin in https://github.com/litestar-org/litestar/pull/3180
* feat: add flash plugin by euri10 in https://github.com/litestar-org/litestar/pull/3145
* feat: Use memoized `request_class` and `response_class` values by kedod in https://github.com/litestar-org/litestar/pull/3205
* feat(DTO): Enable codegen backend by default by provinzkraut in https://github.com/litestar-org/litestar/pull/3215
* feat: Added precedence of CLI parameters over envs by kedod in https://github.com/litestar-org/litestar/pull/3190
* feat: only print when terminal is `TTY` enabled by cofin in https://github.com/litestar-org/litestar/pull/3219
* feat: Support `schema_extra` in `Parameter` and `Body` by tuukkamustonen in https://github.com/litestar-org/litestar/pull/3204
* feat: add typevar expansion by haryle in https://github.com/litestar-org/litestar/pull/3242
* feat: Add LITESTAR_ prefix before WEB_CONCURRENCY env option by kedod in https://github.com/litestar-org/litestar/pull/3227
* feat: Warn about ambiguous default values in parameter specifications by provinzkraut in https://github.com/litestar-org/litestar/pull/3283
* feat: support declaring `DTOField` via `Annotated` by peterschutt in https://github.com/litestar-org/litestar/pull/3289
* feat: Add `TRACE` to HttpMethod enum by provinzkraut in https://github.com/litestar-org/litestar/pull/3294
* feat: Pydantic dto non instantiable types by peterschutt in https://github.com/litestar-org/litestar/pull/3296
* feat: Add `path` parameter to Litestar application class by kedod in https://github.com/litestar-org/litestar/pull/3314

Other changes
* docs(channels): Fix subscriber examples by provinzkraut in https://github.com/litestar-org/litestar/pull/3287
* docs: Expand the acronym for Data Transfer Object in `What's New in v2` by cclauss in https://github.com/litestar-org/litestar/pull/3288
* docs: Add examples for auth `exclude` configuration by aranvir in https://github.com/litestar-org/litestar/pull/3246
* refactor: Reduce module import time by provinzkraut in https://github.com/litestar-org/litestar/pull/3282
* refactor: remove CacheControlHeader dependency on AbstractDTO by peterschutt in https://github.com/litestar-org/litestar/pull/3307

**Full Changelog**
https://github.com/litestar-org/litestar/compare/v2.7.1...v2.8.0

:warning: **Important** :warning:

This release contains a patch for a [vulnerability](https://github.com/litestar-org/litestar/security/advisories/GHSA-83pv-qr33-2vcf) that would allow path traversal in the static file serving functionality of Litestar. It is highly recommended to update your minor version to this patch release.

You can find more background information in the related discussion 3473 .

Sponsors 🌟
Thanks to these incredible business sponsors:

[Scalar](https://scalar.com/) (scalar), [Telemetry Sports](https://telemetrysports.com/) (via chris-telemetry), [Stok](https://www.stok.kr/) (stok-team)

A huge 'Thank you!' to all other sponsors across [Polar.sh](https://polar.sh/litestar-org), [OpenCollective](https://opencollective.com/litestar) and [GitHub Sponsors](https://github.com/sponsors/litestar-org/)!

What's changed

* Fix improper Limitation of a Pathname to a Restricted Directory by peterschutt in https://github.com/litestar-org/litestar/security/advisories/GHSA-83pv-qr33-2vcf

Sponsors 🌟
- Thanks to these incredible business sponsors: [Scalar](https://scalar.com/) (scalar), [Telemetry Sports](https://telemetrysports.com/) (via chris-telemetry), [Stok](https://www.stok.kr/) (stok-team)
- A huge 'Thank you!' to all sponsors across [Polar.sh](https://polar.sh/litestar-org), [OpenCollective](https://opencollective.com/litestar) and [GitHub Sponsors](https://github.com/sponsors/litestar-org/)!

New contributors 🎉
* jderrien made their first contribution in https://github.com/litestar-org/litestar/pull/3185
* sherbang made their first contribution in https://github.com/litestar-org/litestar/pull/3258

What's changed

Bugfixes 🐛
* fix: replace TestClient.__enter__ return type with Self by cbscsm in https://github.com/litestar-org/litestar/pull/3194
* fix: use the full path for fetching openapi.json by guacs in https://github.com/litestar-org/litestar/pull/3196
* fix: JSON schema `examples` were OpenAPI formatted by tuukkamustonen in https://github.com/litestar-org/litestar/pull/3224
* fix(logging): queue_listener handler for Python >= 3.12 by jderrien in https://github.com/litestar-org/litestar/pull/3185
* fix: extend openapi meta collected from domain models by peterschutt in https://github.com/litestar-org/litestar/pull/3237
* fix: kwarg ambiguity exc msg for path params by peterschutt in https://github.com/litestar-org/litestar/pull/3261

Other changes
* docs: fix included line range from example by hugovk in https://github.com/litestar-org/litestar/pull/3208
* docs: fix included line range from example by hugovk in https://github.com/litestar-org/litestar/pull/3209
* docs: add missing api docs for plugins by JacobCoffee in https://github.com/litestar-org/litestar/pull/3169
* docs: add missing `alembic` class references by cofin in https://github.com/litestar-org/litestar/pull/3220
* docs: Removed double `parsing` from the codegen backend docs by kedod in https://github.com/litestar-org/litestar/pull/3216
* docs: document guards behavior when placed at controller and app level by guacs in https://github.com/litestar-org/litestar/pull/3230
* docs: Add missing layered parameters by kedod in https://github.com/litestar-org/litestar/pull/3245
* docs: Update test_client fixture documentation by sherbang in https://github.com/litestar-org/litestar/pull/3258
* docs(csrf): Add usage example by Alc-Alc in https://github.com/litestar-org/litestar/pull/3256
* docs: build develop and v3 branch docs by JacobCoffee in https://github.com/litestar-org/litestar/pull/3264

**Full Changelog**
https://github.com/litestar-org/litestar/compare/v2.7.0...v2.7.1