feat(sqlalchemy): allow repository functions to be filter by expressions

[cofin]

Pull Request Checklist

• New code has 100% test coverage
• (If applicable) The prose documentation has been updated to reflect the changes introduced by this PR
• (If applicable) The reference documentation has been updated to reflect the changes introduced by this PR

Description

• This PR enhances the repository so that you can more easily pass in complex where expressions into the repository functions.

Without this, you have to override the statement parameter and it separates the where conditions from the filters and the kwargs.

Allows usage of this syntax:

locations, total_count = await model_service.list_and_count(ST_DWithin(UniqueLocation.location, geog, 1000), account_id=str(account_id))

instead of the previous method of overriding the statement:

locations, total_count = await model_service.list_and_count(statement=select(Model).where(ST_DWithin(UniqueLocation.location, geog, 1000)), account_id=str(account_id))

Close Issue(s)

[sonarcloud]

Kudos, SonarCloud Quality Gate passed!   

0 Bugs
0 Vulnerabilities
0 Security Hotspots
0 Code Smells

66.7% Coverage
0.0% Duplication

[github-actions]

Documentation preview will be available shortly at https://litestar-org.github.io/litestar-docs-preview/2265

[cofin]

@Alc-Alc nice work on this one!

[TheGreatAlgo]

works like a charm, thanks for the quick turnaround on this! Using this syntax locations, total_count = await model_service.list_and_count(ST_DWithin(UniqueLocation.location, geog, 1000), account_id=str(account_id)) it worked as expected on the new branch. And too double check with prior version, it failed as expected with Unexpected filter error

[TheGreatAlgo]

and no issues with my mypy setup for me. but im not getting any errors using the new syntax with the old branch so probably something on my side that i should resolve

[provinzkraut]

Great stuff!