v2.1.0

💰 Sponsors 💰

GitHub Sponsors: @benjamin-kirkbride @crisog
OpenCollective: Christian Y, GitHub Sponsors, Shubham Prajapati, Snyk

🎉 New Contributors 🎉

• @ddxv made their first contribution in #2194
• @juan-riveros made their first contribution in #2191
• @davidbrochart made their first contribution in #2247
• @sean-donoghue made their first contribution in #2259
• @sykloid made their first contribution in #2277
• @benjamin-kirkbride made their first contribution in #2276
• @wevonosky made their first contribution in #2268
• @geeshta made their first contribution in #2298
• @RobertRosca made their first contribution in #2329

What's Changed

➕ Features

• feat: make 302 the default status_code for redirect responses by @cofin
  in #2189
• feat(layered-include_in_schema): Add include_in_schema option for all layers by @Alc-Alc
  in #2295
• feat(deprecation): Adds deprecation warnings for app parameter when using to_asgi_response method of responses by @wevonosky
  in #2268

🔢 Features: Extras

• feat(contrib-jwt): Add parameters to set the JWT extras field by @dialvarezs
  in #2313
• feat(templates): add possibility to customize jinja environment by @euri10 in #2195
• feat(templates): add minjinja by @euri10 in #2250

📅 Features: SQLAlchemy

• feat(sqlalchemy): exclude implicit fields for sqlalchemy dto by @abdulhaq-e in #2170
• feat(sqlalchemy): allow repository functions to be filter by expressions by @cofin
  in #2265
• feat(sqlalchemy): use lambda_stmt in the repository by @cofin in #2179
• feat(sqlalchemy): swap to the advanced_alchemy implementations by @cofin
  in #2312

📚 Docs

• docs: updates htmx docs by @cofin in #2202
• docs(DTO): Replace PartialDataDTO with DTOData by @ddxv in #2194
• docs: update benchmarks by @provinzkraut in #2198
• docs: add app to events usage example by @juan-riveros in #2191
• docs(responses): fix cookie example reference by @aorith in #2215
• docs(security): incorrect argument to Litestar by @aorith in #2220
• docs: fix typo by @davidbrochart in #2247
• docs: Miscellaneous fixes by @sean-donoghue in #2259
• docs: Add litestar-fullstack to README and docs by @odiseo0 in #2284
• docs: Fix async sessions, Pydantic V2 by @geeshta in #2298
• docs(templates): Add missing sync_to_thread for examples by @provinzkraut
  in #2309
• docs(signature-namespace): Fix code block to render without removing the imports by @Alc-Alc
  in #2326
• docs: docs/update links by @RobertRosca in #2329

🔧 Fixes

• fix: remove usages of deprecated ExceptionHandlerMiddleware debug parameter by @provinzkraut
  in #2192
• fix: raise ValidationException when pydantic validation fails by @guacs
  in #2204
• fix: set the max width of the console to the standard terminal width of 80. This helps prevent line wrapping in
  certain cases. by @cofin in #2244
• fix(schema): handling of optional path parameters by @Goldziher in #2224
• fix: use os.replace instead of shutil.move for renaming file by @guacs
  in #2223
• fix: Exception detail attribute by @gsakkis in #2231
• fix(sqlalchemy-repo): #2221 - Filters not available in exists() by @nielsvanhooy
  in #2228
• fix: add pydantic types to sqlalchemy registry only if pydantic is installed by @guacs
  in #2252
• fix: don't add content type for responses that don't have a body by @guacs
  in #2263
• fix: SQLAlchemyPlugin refactored. by @cofin in #2269
• fix: Ensure app-dir is appended to path during autodiscovery. by @sykloid
  in #2277
• fix: set content length header by default by @guacs in #2271
• fix: #2196 - incorrect handling of mutable headers in ASGIResponse by @provinzkraut
  in #2308
• fix: adds missing ORM registry export by @cofin in #2316
• fix: bump version of advanced_alchemy by @cofin in #2317
• fix: discrepency in attrs, msgspec and pydantic for multi-part forms by @euri10
  in #2280
• fix: set proper default for exclude_http_methods in auth middleware by @guacs
  in #2325
• fix(tests): fix platform compat tests by @provinzkraut in #2310
• fix(tests): RedisStore test for time-machine 2.13.0 by @provinzkraut
  in #2342

🏛️ Misc / Infra / Tests / Other

• build: ignore all-contributorsrc from pre-commit prettier by @cofin
  in #2201
• refactor(structure): move the repository module from contrib to top-level by @Goldziher
  in #2238
• infra: Publish with PyPI's trusted publishers by @provinzkraut in #2306
• test: use stricter pytest config by @sobolevn in #2327
• test: use xfail_strict for pytest config by @sobolevn in #2328
• test: fix pydantic@v2 deprecation warning in tests by @sobolevn
  in #2340
• test: silence ResourceWarning in test_file_response by @sobolevn
  in #2331

Full Changelog: v2.0.0...v2.0.2x

v2.0.1

💰 Sponsors 💰

GitHub Sponsors: @benjamin-kirkbride @crisog
OpenCollective: Christian Y, GitHub Sponsors, Shubham Prajapati, Snyk

What's Changed

🔧 Fixes

• Fix warnings about deprecated debug parameter of ExceptionHandlerMiddleware by @provinzkraut in #2193

Full Changelog: v2.0.0...v2.0.1

v2.0.0

This marks the first release of the new 2.x release line. The 1.5x releases will be supported until the release of 3.0. Nevertheless, users are encouraged to upgrade to version 2.

What's Changed

Bugfixes

• Fix #2024 - media_type missing in error response by @Goldziher in #2131
• Fix #2147 - setting app debug does not propagate to exception handling middleware by @provinzkraut in #2153
• Fix static files not being served if a route handler with the same base path was registered by @Goldziher in #2154
• Fix missing default values for receive and send parameters of HTMXRequest by @tompin82 in #2145
• DTO: Fix #2125 - excluded attributes being accessed during transfer by @provinzkraut in #2127
• DTO: Fix DTOData.create_instance ignores renaming by @abdulhaq-e in #2144
• OpenAPI: Fix application/octet-stream set as contentEncoding instead of contentMediaType @Goldziher in #2130
• OpenAPI: Fix response not preferring aliased fields by @gsakkis in #2150
• OpenAPI: Fix examples not being generated deterministically by @Goldziher in #2161
• OpenAPI: Fix example generation for Pydantic models by @guacs in #2178
• SQLAlchemy repository: Handle dialects that don't support JSON by @thiagozf in #2139
• JWT: Fix OPTIONS and HEAD being authenticated by default by @Goldziher in #2160
• Fix OPTIONS and HEAD being authenticated by default for SessionAuthMiddleware by @Mattwmaster58 in #2182

New Contributors

• @thiagozf made their first contribution in #2139
• @Mattwmaster58 made their first contribution in #2143

Full Changelog: v2.0.0rc1...v2.0.0

v2.0.0rc1

What's Changed

🎉 New Contributors 🎉

• @mj0nez made their first contribution in #2036
• @therealzanfar made their first contribution in #2058

New features

• Server-sent events by @Goldziher in #2035
• SQLAlchemy repository: allow specifying id_attribute per method by @cofin in #2052
• SQLAlchemy repository: upsert_many by @cofin in #2056
• SQLAlchemy repository: New filters OnBeforeAfter, NotInCollectionFilter and NotInSearchFilter by @cofin in #2057
• SQLAlchemy repository: Configurable chunk sizing for delete_many by @cofin in #2061
• SQLAlchemy repository: Support InstrumentedAttribute for attribute columns by @provinzkraut in #2054
• OpenAPI: support callable operation_id on route handlers by @Goldziher in #2078
• Run event listeners concurrently by @provinzkraut in #2083
• Plugin registry by @provinzkraut in #2096
• CLI plugins by @provinzkraut in #2066

Bugfixes

• SQLAlchemy repository: health_check generates valid statement for oracle by @cofin in #2060
• Fix serialization of empty strings in multipart form by @Goldziher in #2044
• Fix #2033 - Server-side session middleware overrides CSRF cookies by @provinzkraut in #2069
• Fix base path escaping in channels on Windows by @provinzkraut in #2112
• DTO: Support renamed fields in DTOData and create_instance by @abdulhaq-e in #2065

Other changes

• Switch test clients to debug=True by default by @Goldziher in #2049
• BREAKING: remove deprecated module partial.py by @provinzkraut in #2113
• BREAKING: remove deprecated modules dto/factory and contrib/msgspec by @provinzkraut in #2114

Changes to DTOs

BREAKING

This release introduces significant changes to the DTOs. This was necessary to address some bugs that came about because of some issues with the previous internal design. Unfortunately, these changes could not be made backwards compatible, but they are mostly superficial changes to the interfaces; Functionally DTOs still work the same.

The following breaking changes were introduced:

• DTOInterface has been removed
• ForType has been removed
• AbstractDTOFactory has been renamed to AbstractDTO

Full Changelog: v2.0.0beta4...v2.0.0rc1

v1.51.14

What's Changed

• fix(v1.51): #1948 passing wrapper class to struct logging config causes pydantic exception by @JacobCoffee in #2105

Full Changelog: v1.51.13...v1.51.14

v2.0.0beta4

What's Changed

Bugfix release containing a workaround for a bug in poetry that caused development / extra dependencies to be installed alongside the package.

This was fixed by @Goldziher in #2029.

Full Changelog: v2.0.0beta3...v2.0.0beta4

v2.0.0beta3

Highlights

As of this release, Pydantic is an optional dependency.

What does that mean?
For you as an end user, not much; It is still supported in the same capacity as before, it's just not required anymore.
We have migrated all of our internals that previously relied on Pydantic (mainly for parsing and validation) to the amazing msgspec library, with Pydantic now being handled by an internal plugin.

The important thing is: Everything that has worked before with Pydantic will continue to work, and if you're not using Pydantic, but instead want to use attrs or pure msgspec, you won't have a required Pydantic dependency anymore.

Pydantic 2 support

Another change related to Pydantic is that this release adds support for Pydantic 2, which offers lots of improvements, new features and performance gains. Pydantic 1 is still fully supported and will be for the foreseeable future.

What's Changed

New features

• DTO: Support piccolo ORM with PiccoloDTO by @Goldziher in #1896
• DTO: Add include option to DTOConfig by @Goldziher in #1950
• SQLAlchemyDTO: column/relationship type inference by @peterschutt in #1879
• SQLAlchemy repository: New auto_commit, auto_refresh and auto_expunge options by @cofin in #1900
• Allow customization of OpenAPIController.path from OpenAPIConfig by @jaykv in #1886
• Include path name in ImproperlyConfiguredException message for missing param type by @euri10 in #1935

Bugfixes

• Breaking SQLAlchemy repository: Fix spanner support by renaming the _sentinel column to sa_orm_sentinel by @cofin in #1933
• SQLAlchemy repository: Fix audit columns created_at and updated_at defaulting to app startup time by @MatthewNewland in #1894
• SQLAlchemyDTO: Fix handling of Sequence with defaults by @peterschutt in #1883
• DTO / OpenAPI: Fix detection of required fields for Pydantic and msgspec by @abdulhaq-e in #1946
• Allow JSON as redirect response by @cofin in #1908

Other changes

• Breaking Pin Redis to >=4.4.4+ version by @Goldziher in #1903
• Breaking Replace Header, CacheControlHeader and ETag Pydantic models with dataclasses by @Tsdevendra1 in #1917
• Breaking dto.factory.abc.AbstractDTOFactory moved to dto.factory.base.AbstractDTOFactory by @Goldziher in #1950
• Breaking Make Pydantic an optional extra by @Goldziher in #1963
• Pydantic 2 support by @Goldziher in #1956
• Deprecation of partial module by @Goldziher in #2002

New Contributors

• @jaykv made their first contribution in #1886
• @Tsdevendra1 made their first contribution in #1917
• @euri10 made their first contribution in #1935
• @su-shubham made their first contribution in #1930
• @erik-hasse made their first contribution in #1938
• @sobolevn made their first contribution in #1954

Full Changelog: v2.0.0beta2...v2.0.0beta3

v1.51.13

What's Changed

• Restrict Pydantic to <2 by @provinzkraut in #1985

Full Changelog: v1.51.12...v1.51.13

v2.0.0beta2

Beta 2 is out now!

What does that mean?

As stated in the Beta 1 release, it means that all of the major changes are done, and you can start evaluating the 2.0 release. Upcoming beta releases will mostly include bugfixes, and you can expect a generally stable interface.

This release however is not feature complete, and we'll still be adding new features until the first rc (release candidate) release preceding the 2.0 release.

What's Changed

🎉 New Contributors 🎉

• @floxay made their first contribution in #1834
• @sfermigier made their first contribution in #1858
• @rseeley made their first contribution in #1774
• @r4gesingh47 made their first contribution in #1872

Enhancements

• 🚀 NEW FEATURE 🚀 : Integration of Prometheus exporter. (#1806) by @r4gesingh47 and @Goldziher in #1872
• Add support for annotated-types by @Goldziher in #1847
• Increase verbosity of validation error response keys by @rseeley in #1774
• Simplify SQLAlchemy repo imports by @provinzkraut in #1841
• SQLA DTO: Explicit error message for cases where a column has no type annotation by @provinzkraut in #1852
• Add missing marker to SQLA oracle JSON tests by @provinzkraut in #1855

Fixes

• Fix controller inheritance issues by @Goldziher in #1867
• Fix Internal Server Error detail by @peterschutt in #1857
• Fix path parameter resolution by @Goldziher in #1833
• Fix Pydantic v1 regex validation by @Goldziher in #1865

Docs

• Add missing newline to properly format bullet points. by @sfermigier in #1858
• Fix Cookie.expires field docstring by @floxay in #1834

Other Changes

• Add TestClient default timeout by @provinzkraut in #1840

Internal

• Add poetry pre-commit hooks by @JacobCoffee in #1832
• Add fake Redis to publish pipeline by @cofin in #1875
• Refactor 🔧: OpenAPI create_schema by @gsakkis in #1842
• Refactor 🔧: OpenAPI create schema v2 by @gsakkis in #1846
• Refactor 🔧: OpenAPI handler media types by @peterschutt in #1838
• Refactor 🔧: remove set-cookie ops on genric asgi responses. by @peterschutt in #1839
• Use get_type_hints by @Goldziher in #1861
• Cleanup types by @Goldziher in #1866
• Replace msgspec.from_builtins with msgspec.convert by @provinzkraut in #1843
• Refactor tests by @provinzkraut in #1850
• Update Polyfactory to not use the 2.3.0 version by @provinzkraut in #1844

Full Changelog: v2.0.0beta1...v2.0.0beta2

v2.0.0beta1

This is the first beta release of Litestar 2.0!

What does that mean?

In practical terms, it means that all of the major changes are done, and you can start evaluating the 2.0 release. Upcoming beta releases will mostly include bugfixes, and you can expect a generally stable interface.

This release however is not feature complete, and we'll still be adding new features until the first rc (release candidate) release preceding the 2.0 release.

What's Changed

New features

General

• Expose ParsedType as public API by @peterschutt in #1677
• Add --pdb flag and LITESTAR_PDB environment variable by @provinzkraut in #1742
• Improve schema generation for constrained fields (msgspec and pydantic) by @Goldziher in #1751
• Add operation_class argument to HTTP route handlers to override OpenAPI Operation class by @smithk86 in #1732
• Handle nested Literal annotations for OpenApi schema generation by @gsakkis in #1829
• Add --reload-dir option to CLI run command by @peterschutt in #1689
• Optional rich-click integration by @cofin in #1745
• Allow extra attributes on JWTs by @cofin in #1695
• Add default modes for WebSocket iter_ methods by @provinzkraut in #1733

SQLAlchemy repository

• Add synchronous SQLAlchemy repository pattern by @cofin in #1683
• Add oracledb support by @cofin in #1694
• Add duckdb and Google spanner support by @cofin in #1744
• Add JSON check constraint for Oracle dialect by @cofin in #1780
• Add timezone aware datetime by @cofin in #1816
• Exclude unloaded columns on to_dict by @cofin in #1802
• Enforce UTC timestamps are stored and returned by @cofin in #1816

DTO

• Support nested keyword arguments in DTOData.create_instance() by @peterschutt in #1741
• Support hybrid properties and association proxies in SQLAlchemyDTO by @peterschutt in #1754 and #1776
• Support transfer to generic collection types by @peterschutt in #1764
• Support data transfer for non-generic builtin collection annotations by @peterschutt in #1799
• Exclude leading underscore fields by default by @peterschutt in #1777
• Msgspec and Pydantic DTO factory implementations by @peterschutt in #1712
• Factory: Support for arbitrary generic wrappers by @peterschutt in #1801

Bugfixes

• Fix #1674: Store and reuse state deep_copy directive when copying state by @peterschutt in #1678
• Fix #1652: ParsedType.is_subclass_of(X) true for union if all union types are subtypes of X by @peterschutt in #1690
• Fix #1699: Inconsistent template autoescape behavior by @peterschutt in #1718
• Fix #1691: Missing ChannelsPlugin in signature namespace population by @peterschutt in #1719
• Fix #1681: Gzip not sending small streaming responses by @peterschutt in #1723
• Fix #1726: Premature transfer to nested models with DTOData by @peterschutt in #1731
• Fix #1711: Incorrect sync_to_thread warnings for generator dependencies by @peterschutt in #1716 and @provinzkraut in #1740
• Fix #1762: Dependency injection not available for custom dependencies in WebSocketListener by @JacobCoffee in #1807
• Fix #1795: OpenAPI schema for Dict[K, V] ignores generic by @gsakkis in #1828
• Fix JSON comparisons in SQLAlchemy repositories by @cofin in #1794
• Fix simple_asdict() with attribute value having dataclass type by @peterschutt in #1729
• Fix WebSocketTestSession not timing out without when connection is not accepted by @smithk86 in #1696
• Fix attrs converter unstructuring behavior for attrs models by @Goldziher in #1682
• Prevent msgspec.field from being called with too many arguments by @MatthewNewland in #1686
• Fix alembic migrations generated for models using GUID by @cofin in #1676

Other changes

• Update cryptography to >= 41.0 by @peterschutt in #1772
• Change ExceptionHandlersMap to MutableMapping by @peterschutt in #1791
• Upgrade Swagger UI to 5.0.0 with OpenAPI 3.1 support by @cofin in #1826

Breaking

• Remove state parameter from AfterExceptionHookHandler and BeforeMessageSendHookHandler by @provinzkraut in #1739
• Remove unused dto/exceptions.py by @peterschutt in #1773
• Remove generic base from BaseRouteHandler by @peterschutt in #1819
• Deprecate Litestar parameter preferred_validation_backend private by @provinzkraut in #1810
• Move Response.get_serializer() to serialization.get_serializer(). by @peterschutt in #1820
• Remove ResponseContainer and introduce ASGIResponse by @peterschutt in #1790

Documentation

• Add DTO factory tutorial by @peterschutt in #1654
• Add #1565 plugin docs by @peterschutt in #1568
• Add debugging guide by @provinzkraut in #1742
• Add SQLAlchemy repository tutorial by @cofin in #1778
• Add v2 migration guide and release documents by @provinzkraut in #1701
• DTO usage docs: Excluding from nested fields. by @peterschutt in #1797
• Consistent usage of Oxford commas by @patrickarmengol in #1766
• Fix a typo in openapi.rst by @eldano1995 in #1722
• Fix outdated module imports in Flask migration guide by @01EK98 in #1746
• Fix imports in authentication middleware docs by @ctrl-Felix in #1811
• Fix Request and WebSocket generic args in examples by @ctrl-Felix in #1815

New Contributors

• @MatthewNewland made their first contribution in #1686
• @eldano1995 made their first contribution in #1722
• @01EK98 made their first contribution in #1746
• @sarbor made their first contribution in #1755
• @ctrl-Felix made their first contribution in #1811

Full Changelog: v2.0.0alpha7...v2.0.0beta1