feat(python): Improve read_database when reading from Kùzu graph database

[alexander-beedie]

Can directly use get_as_pl() now; requires a new version of kuzu, but this seems reasonable. Added an optional "minimum_version" module/driver check to gracefully handle this - raises a ModuleUpgradeRequired exception if an insufficiently recent version is found.

Note that the next release of kuzu will also include an improvement¹ in Arrow chunking inside get_as_pl(), meaning we'll no longer need to rechunk (will always get a single chunk from now on).

Footnotes

1. https://github.com/kuzudb/kuzu/pull/3110 ↩

[stinodego]

Nice! Just some very minor remarks.

[codecov]

Codecov Report

Attention: Patch coverage is 80.95238% with 4 lines in your changes are missing coverage. Please review.

Project coverage is 81.26%. Comparing base (2a3b363) to head (a1c656a).
Report is 6 commits behind head on main.

❗ Current head a1c656a differs from pull request most recent head 81a59a7. Consider uploading reports for the commit 81a59a7 to get more accurate results

Files	Patch %	Lines
py-polars/polars/io/database/_executor.py	78.94%	2 Missing and 2 partials ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #15218      +/-   ##
==========================================
+ Coverage   81.25%   81.26%   +0.01%     
==========================================
  Files        1354     1355       +1     
  Lines      175631   175657      +26     
  Branches     2518     2522       +4     
==========================================
+ Hits       142702   142743      +41     
+ Misses      32448    32431      -17     
- Partials      481      483       +2     

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

[stinodego]

Looks good! Nice to have the minimum version too.