feat: Improve read_database typing

[wakabame]

Purpose

This pull request aims to improve type hints in the codebase.

• The query parameter in read_database currently accepts only str and Selectable types, but execute can handle str | TextClause | Selectable.
• In practice, read_database can execute successfully with a TextClause argument.
• However, mypy flags this as an error, causing issues during type-checking as in https://github.com/pola-rs/polars/actions/runs/11515095096/job/32055062473?pr=19444

Changes Made

• Added a test case that uses SQLAlchemy's text to validate that read_database executes properly with a TextClause: 4e87f01
• Updated the type hint for the query parameter in read_database to include TextClause: edd7e1d

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 79.97%. Comparing base (425e251) to head (edd7e1d).
Report is 18 commits behind head on main.

Additional details and impacted files

@@           Coverage Diff           @@
##             main   #19444   +/-   ##
=======================================
  Coverage   79.96%   79.97%           
=======================================
  Files        1534     1534           
  Lines      211030   211030           
  Branches     2444     2444           
=======================================
+ Hits       168750   168765   +15     
+ Misses      41725    41710   -15     
  Partials      555      555           

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[alexander-beedie]

Yup, looks good to me - nice contribution 👍
(FYI: the failing doctest was addressed by #19440).

[wakabame]

@alexander-beedie
Thank you for reviewing and approving my PR!
I appreciate your time and feedback. Looking forward to contributing more.

[alexander-beedie]

@alexander-beedie Thank you for reviewing and approving my PR! I appreciate your time and feedback. Looking forward to contributing more.

大歓迎です! ご貢献を楽しみにしています (^_^)