Starlite

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 https://github.com/litestar-org/litestar/pull/1834
* sfermigier made their first contribution in https://github.com/litestar-org/litestar/pull/1858
* rseeley made their first contribution in https://github.com/litestar-org/litestar/pull/1774
* r4gesingh47 made their first contribution in https://github.com/litestar-org/litestar/pull/1872

Enhancements

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

Fixes
* Fix controller inheritance issues by Goldziher in https://github.com/litestar-org/litestar/pull/1867
* Fix Internal Server Error detail by peterschutt in https://github.com/litestar-org/litestar/pull/1857
* Fix path parameter resolution by Goldziher in https://github.com/litestar-org/litestar/pull/1833
* Fix [Pydantic](https://docs.pydantic.dev/1.10/) v1 regex validation by Goldziher in https://github.com/litestar-org/litestar/pull/1865

Docs
* Add missing newline to properly format bullet points. by sfermigier in https://github.com/litestar-org/litestar/pull/1858
* Fix Cookie.expires field docstring by floxay in https://github.com/litestar-org/litestar/pull/1834

Other Changes

* Add `TestClient` default timeout by provinzkraut in https://github.com/litestar-org/litestar/pull/1840

Internal
* Add poetry pre-commit hooks by JacobCoffee in https://github.com/litestar-org/litestar/pull/1832
* Add fake Redis to publish pipeline by cofin in https://github.com/litestar-org/litestar/pull/1875
* **Refactor** 🔧: OpenAPI create_schema by gsakkis in https://github.com/litestar-org/litestar/pull/1842
* **Refactor** 🔧: OpenAPI create schema v2 by gsakkis in https://github.com/litestar-org/litestar/pull/1846
* **Refactor** 🔧: OpenAPI handler media types by peterschutt in https://github.com/litestar-org/litestar/pull/1838
* **Refactor** 🔧: remove set-cookie ops on genric asgi responses. by peterschutt in https://github.com/litestar-org/litestar/pull/1839
* Use `get_type_hints` by Goldziher in https://github.com/litestar-org/litestar/pull/1861
* Cleanup types by Goldziher in https://github.com/litestar-org/litestar/pull/1866
* Replace `msgspec.from_builtins` with `msgspec.convert` by provinzkraut in https://github.com/litestar-org/litestar/pull/1843
* Refactor tests by provinzkraut in https://github.com/litestar-org/litestar/pull/1850
* Update [Polyfactory](about:blank) to not use the 2.3.0 version by provinzkraut in https://github.com/litestar-org/litestar/pull/1844


**Full Changelog**: https://github.com/litestar-org/litestar/compare/v2.0.0beta1...v2.0.0beta2

**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 https://github.com/litestar-org/litestar/pull/1677
* Add `--pdb` flag and `LITESTAR_PDB` environment variable by provinzkraut in https://github.com/litestar-org/litestar/pull/1742
* Improve schema generation for constrained fields (msgspec and pydantic) by Goldziher in https://github.com/litestar-org/litestar/pull/1751
* Add `operation_class` argument to HTTP route handlers to override OpenAPI `Operation` class by smithk86 in https://github.com/litestar-org/litestar/pull/1732
* Handle nested Literal annotations for OpenApi schema generation by gsakkis in https://github.com/litestar-org/litestar/pull/1829
* Add `--reload-dir` option to CLI `run` command by peterschutt in https://github.com/litestar-org/litestar/pull/1689
* Optional `rich-click` integration by cofin in https://github.com/litestar-org/litestar/pull/1745
* Allow extra attributes on JWTs by cofin in https://github.com/litestar-org/litestar/pull/1695
* Add default modes for `WebSocket` `iter_` methods by provinzkraut in https://github.com/litestar-org/litestar/pull/1733

SQLAlchemy repository

* Add synchronous SQLAlchemy repository pattern by cofin in https://github.com/litestar-org/litestar/pull/1683
* Add oracledb support by cofin in https://github.com/litestar-org/litestar/pull/1694
* Add duckdb and Google spanner support by cofin in https://github.com/litestar-org/litestar/pull/1744
* Add JSON check constraint for Oracle dialect by cofin in https://github.com/litestar-org/litestar/pull/1780
* Add timezone aware datetime by cofin in https://github.com/litestar-org/litestar/pull/1816
* Exclude unloaded columns on `to_dict` by cofin in https://github.com/litestar-org/litestar/pull/1802
* Enforce UTC timestamps are stored and returned by cofin in https://github.com/litestar-org/litestar/pull/1816

DTO

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

Bugfixes

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

Other changes

* Update cryptography to >= 41.0 by peterschutt in https://github.com/litestar-org/litestar/pull/1772
* Change `ExceptionHandlersMap` to `MutableMapping` by peterschutt in https://github.com/litestar-org/litestar/pull/1791
* Upgrade Swagger UI to `5.0.0` with OpenAPI `3.1` support by cofin in https://github.com/litestar-org/litestar/pull/1826

Breaking

* Remove `state` parameter from `AfterExceptionHookHandler` and `BeforeMessageSendHookHandler` by provinzkraut in https://github.com/litestar-org/litestar/pull/1739
* Remove unused `dto/exceptions.py` by peterschutt in https://github.com/litestar-org/litestar/pull/1773
* Remove generic base from `BaseRouteHandler` by peterschutt in https://github.com/litestar-org/litestar/pull/1819
* Deprecate `Litestar` parameter `preferred_validation_backend` private by provinzkraut in https://github.com/litestar-org/litestar/pull/1810
* Move `Response.get_serializer()` to `serialization.get_serializer()`. by peterschutt in https://github.com/litestar-org/litestar/pull/1820
* Remove `ResponseContainer` and introduce `ASGIResponse` by peterschutt in https://github.com/litestar-org/litestar/pull/1790

Documentation

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


New Contributors
* MatthewNewland made their first contribution in https://github.com/litestar-org/litestar/pull/1686
* eldano1995 made their first contribution in https://github.com/litestar-org/litestar/pull/1722
* 01EK98 made their first contribution in https://github.com/litestar-org/litestar/pull/1746
* sarbor made their first contribution in https://github.com/litestar-org/litestar/pull/1755
* ctrl-Felix made their first contribution in https://github.com/litestar-org/litestar/pull/1811

**Full Changelog**: https://github.com/litestar-org/litestar/compare/v2.0.0alpha7...v2.0.0beta1

What's Changed

New features

* Warn about sync dependencies without an explicit `sync_to_thread` value by provinzkraut in https://github.com/litestar-org/litestar/pull/1648
* Warn about sync handler functions without an explicit `sync_to_thread` value by provinzkraut in https://github.com/litestar-org/litestar/pull/1655
* Warn about `sync_to_thread` with async callables by provinzkraut in https://github.com/litestar-org/litestar/pull/1664
* Support dependencies in WS listener hooks by provinzkraut in https://github.com/litestar-org/litestar/pull/1647
* Declaring dependencies without Provide by provinzkraut in https://github.com/litestar-org/litestar/pull/1638
* `DTOData` datastructure by peterschutt in https://github.com/litestar-org/litestar/pull/1650
* Partial DTOs by peterschutt in https://github.com/litestar-org/litestar/pull/1651
* SQLA repository: `psycopg` asyncio support by cofin in https://github.com/litestar-org/litestar/pull/1657
* SQLA repository: `BigInteger` PK option PKs by cofin in https://github.com/litestar-org/litestar/pull/1657
* SQLA repository: Binary `GUID` PKs by cofin in https://github.com/litestar-org/litestar/pull/1657
* Application lifespan context managers by provinzkraut in https://github.com/litestar-org/litestar/pull/1635
* Trio compatible event-emitters by provinzkraut in https://github.com/litestar-org/litestar/pull/1666
* OpenAPI schema for `msgspec.Meta` annotated types by Goldziher in https://github.com/litestar-org/litestar/pull/1669
* OpenAPI schema for Pydantic `FieldInfo` by Goldziher in https://github.com/litestar-org/litestar/pull/1670


Bugfixes
* Fix 1640 - StorageObject doesn't return < 0 when using expiry by SanderWegter in https://github.com/litestar-org/litestar/pull/1641
* Fix filter `forward-ref` issues by cofin in https://github.com/litestar-org/litestar/pull/1659
* Fix channels repeated unsubscribe bug by provinzkraut in https://github.com/litestar-org/litestar/pull/1656
* Fix 1643 - Fully qualified model name + Unique ShortID generation for DTO Model to avoid collision issues by v3ss0n in https://github.com/litestar-org/litestar/pull/1649
* Fix 1660 - Discrepancy between attrs and Pydantic validation output by Goldziher in https://github.com/litestar-org/litestar/pull/1668
* Fix 1446 - Add validation to unknown media types by Goldziher in https://github.com/litestar-org/litestar/pull/1671


Other changes
* **[Breaking]** Unify lifespan hooks by provinzkraut in https://github.com/litestar-org/litestar/pull/1663


New Contributors
* v3ss0n made their first contribution in https://github.com/litestar-org/litestar/pull/1649

**Full Changelog**: https://github.com/litestar-org/litestar/compare/v2.0.0alpha6...v2.0.0alpha7

What's Changed

Bugfixes
* Fix the typing for `url_for` kwargs unpack by whiskeyriver in https://github.com/litestar-org/litestar/pull/1610
* Fix 1615: Using `websocket_listener` in controller causes `TypeError: .handler_fn() got multiple values for argument 'socket'` by provinzkraut in https://github.com/litestar-org/litestar/pull/1627

New features
* Add `connection_accept_handler` to `websocket_listener` by peterschutt in https://github.com/litestar-org/litestar/pull/1572
* Add `block` and `timeout` parameters to `WebSocketTestSession` receive methods by provinzkraut in https://github.com/litestar-org/litestar/pull/1593
* Add `--app-dir` option to CLI by cofin in https://github.com/litestar-org/litestar/pull/1506
* Add repository signature namespace by sonpro1296 in https://github.com/litestar-org/litestar/pull/1618
* MessagePack support and generator methods to `WebSocket` by provinzkraut in https://github.com/litestar-org/litestar/pull/1626
* Sentinel column support for SQLAlchemy repository by cofin in https://github.com/litestar-org/litestar/pull/1603
* Alias generator for DTO field names by abdulhaq-e in https://github.com/litestar-org/litestar/pull/1590
* Support nested field exclusion in DTO Factory by peterschutt in https://github.com/litestar-org/litestar/pull/1596
* Support managing a WebSocket's lifespan using a context manager in WebSocket listeners by provinzkraut in https://github.com/litestar-org/litestar/pull/1625
* WebSocket broadcast / channels by provinzkraut in https://github.com/litestar-org/litestar/pull/1587


Other changes
* Add ModelProtocol to `contrib.sqlalchemy.base.__all__` by provinzkraut in https://github.com/litestar-org/litestar/pull/1582
* Make `dto.factory.backends` private by peterschutt in https://github.com/litestar-org/litestar/pull/1589

**Internal**
* Move model parsing into `AbstractDTOBackend`. by peterschutt in https://github.com/litestar-org/litestar/pull/1597
* DTO: Refactor transfer model production by peterschutt in https://github.com/litestar-org/litestar/pull/1632


Documentation
* Fix typo / formatting in basic application tutorial by provinzkraut in https://github.com/litestar-org/litestar/pull/1583
* DTO docs by peterschutt in https://github.com/litestar-org/litestar/pull/1569
* Add Jacob Coffee as a maintainer by provinzkraut in https://github.com/litestar-org/litestar/pull/1594
* Fix wrong CLI argument name by provinzkraut in https://github.com/litestar-org/litestar/pull/1633
* Fix a function name typo by erhuabushuo in https://github.com/litestar-org/litestar/pull/1598


New Contributors
* erhuabushuo made their first contribution in https://github.com/litestar-org/litestar/pull/1598
* whiskeyriver made their first contribution in https://github.com/litestar-org/litestar/pull/1610

**Full Changelog**: https://github.com/litestar-org/litestar/compare/v2.0.0alpha5...v2.0.0alpha6

What's Changed

Bugfixes
* Fix inconsistent parsing of unix timestamp between pydantic and cattrs. by peterschutt in https://github.com/litestar-org/litestar/pull/1492
* Fix retrieve type hints from class with no `__init__` method. by peterschutt in https://github.com/litestar-org/litestar/pull/1505
* Fix import bug when all required attrs extra are not installed by smithk86 in https://github.com/litestar-org/litestar/pull/1543
* Fix 1547: Remove bool coercion in URL parsing by provinzkraut in https://github.com/litestar-org/litestar/pull/1550


New features
* Pass context to HTMX Template response by tompin82 in https://github.com/litestar-org/litestar/pull/1488
* Support schema generation for attrs and msgspec classes by Goldziher in https://github.com/litestar-org/litestar/pull/1487
* Add SQLAlchemy repository model protocol by LonelyVikingMichael in https://github.com/litestar-org/litestar/pull/1503
* Add support for MySQL to SQLAlchemy repository by cofin in https://github.com/litestar-org/litestar/pull/1345
* SQLAlchemy repository enhancements by cofin in https://github.com/litestar-org/litestar/pull/1345
* DTO Factory implementation of DTOInterface by peterschutt in https://github.com/litestar-org/litestar/pull/1461
* Support DTOs in `websocket_listener` by peterschutt in https://github.com/litestar-org/litestar/pull/1518
* DTO based serialization plugin by peterschutt in https://github.com/litestar-org/litestar/pull/1501
* Set compressed static file headers by LonelyVikingMichael in https://github.com/litestar-org/litestar/pull/1577

Other changes
* Update `standard` and `full` extra by provinzkraut in https://github.com/litestar-org/litestar/pull/1494
* Refactor `DTOInterface`. by peterschutt in https://github.com/litestar-org/litestar/pull/1500
* Test client helper default sig backend consistent with `Litestar`. by peterschutt in https://github.com/litestar-org/litestar/pull/1508
* Remove support for declaring DTOs as handler types. by peterschutt in https://github.com/litestar-org/litestar/pull/1534
* Make `MissingDependencyException` a subclass of `ImportError` by provinzkraut in https://github.com/litestar-org/litestar/pull/1557
* Simplify DTO config options. by peterschutt in https://github.com/litestar-org/litestar/pull/1580


**Internal**
* Move httpx log suppression into a fixture by provinzkraut in https://github.com/litestar-org/litestar/pull/1512
* Speed up some tests by provinzkraut in https://github.com/litestar-org/litestar/pull/1513
* Update to polyfactory 2.0.0 by provinzkraut in https://github.com/litestar-org/litestar/pull/1540
* Infra: Fix docs workflow not building on main by provinzkraut in https://github.com/litestar-org/litestar/pull/1553


Documentation
* Add basic application tutorial by provinzkraut in https://github.com/litestar-org/litestar/pull/1515
* Update installation extras by patrickarmengol in https://github.com/litestar-org/litestar/pull/1554
* Correct several `litestar.config.` imports in migration guide
* Add documentation for `contrib.repository` and SQLAlchemy repository by cofin in https://github.com/litestar-org/litestar/pull/1345


New Contributors
* tompin82 made their first contribution in https://github.com/litestar-org/litestar/pull/1488
* patrickarmengol made their first contribution in https://github.com/litestar-org/litestar/pull/1554
* SanderWegter made their first contribution in https://github.com/litestar-org/litestar/pull/1574

**Full Changelog**: https://github.com/litestar-org/litestar/compare/v2.0.0alpha4...v2.0.0alpha5

What's Changed

New Features

* Add support for `attrs` and `msgspec` to `Partial` by Goldziher in https://github.com/litestar-org/litestar/pull/1462

Bugfixes

* Support `text/html` Media-Type in `Redirect` response by sonpro1296 in https://github.com/litestar-org/litestar/pull/1474
* Fix global namespace for type resolution by Goldziher in https://github.com/litestar-org/litestar/pull/1477
* Fix 1478: Add uvicorn to `cli` extra by provinzkraut in https://github.com/litestar-org/litestar/pull/1480
* Fix 1476: Update `Litestar.logger` levels when setting `Litestar.debug` by provinzkraut in https://github.com/litestar-org/litestar/pull/1482

Documentation

* Update URL of Pydantic repo by khiemdoan in https://github.com/litestar-org/litestar/pull/1467
* Fix Github issue link in routing documentation by kedod in https://github.com/litestar-org/litestar/pull/1470


New Contributors
* khiemdoan made their first contribution in https://github.com/litestar-org/litestar/pull/1467
* kedod made their first contribution in https://github.com/litestar-org/litestar/pull/1470
* sonpro1296 made their first contribution in https://github.com/litestar-org/litestar/pull/1474

**Full Changelog**: https://github.com/litestar-org/litestar/compare/v2.0.0alpha3...v2.0.0alpha4