[python] verify_core_versions() during import tiledbsoma

[ryan-williams]

Issue and/or context: #1837

Changes:

• Add verify_core_versions helper which asserts that TileDB-Py's and libtiledbsoma's core versions match
• Add verify_core_versions() to tiledbsoma.__init__.py
• Add TILEDB_CORE_MISMATCHED_VERSIONS_ERROR_LEVEL=err "escape hatch"; if the check above catches any users, and they really want to just keep running and fix it later, this allows it (but prints a relevant error message).
• Minor reformatting of show_package_versions output:

  < tiledbsoma.__version__        1.5.0rc0.post272.dev2332272127
  < TileDB-Py tiledb.version()    (0, 27, 1)
  < TileDB core version           2.21.1
  < libtiledbsoma version()       libtiledb=2.21.1
  < python version                3.11.8.final.0
  < OS version                    Darwin 23.2.0
  ---
  > tiledbsoma.__version__              1.5.0rc0.post272.dev2332272127
  > TileDB-Py version                   0.27.1
  > TileDB core version (tiledb)        2.21.1
  > TileDB core version (libtiledbsoma) 2.21.1
  > python version                      3.11.8.final.0
  > OS version                          Darwin 23.2.0

Notes for Reviewer:

• We could probably put together a test for this in a Docker image where we intentionally install mismatched versions… not sure it's worth it.
• I am fetching libtiledbsoma's "core" version via pytiledbsoma.version, which calls tiledbsoma::version::as_string(), which calls tiledb_version.
  • The naming feels a bit off, the former two seem like they'd return a version of libtiledbsoma, not libtiledb.
  • Don't need to change it here, just want to make sure I'm understanding.

[eddelbuettel]

I like the 'hatch' -- thumps up. I considered adding such an override in the R package's R/Init.R but haven't yet. May reconsider.

[codecov]

Codecov Report

Merging #2437 (fbe7a03) into main (7c76c4a) will decrease coverage by 0.19%.
Report is 2 commits behind head on main.
The diff coverage is 78.57%.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #2437      +/-   ##
==========================================
- Coverage   90.61%   90.43%   -0.19%     
==========================================
  Files          37       37              
  Lines        3900     3940      +40     
==========================================
+ Hits         3534     3563      +29     
- Misses        366      377      +11     

Flag	Coverage Δ
python	90.43% <78.57%> (-0.19%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

Components	Coverage Δ
python_api	90.43% <78.57%> (-0.19%)	⬇️
libtiledbsoma	∅ <ø> (∅)

[johnkerl]

Sorry, I wasn't clear -- let's keep this tiledbsoma._general_utilities.verify_core_versions but just don't auto-export it in the package-level __init__.py

[johnkerl]

@ryan-williams so sorry!! I misread this as you populating __all__ -- but you very much are not

Let's just call it verify_core_versions and this will be fine

[johnkerl]

🚢
Sorry again about the misdirect! 😓