[python] Append mode with resizing

[johnkerl]

Issue and/or context: As tracked on issue #2407 / [sc-51048].

Note that the intended Python and R API changes are all agreed on and finalized as described in #2407.

Changes:

Support experipment-level upgrade_shape and resize.

Notes for Reviewer:

[codecov]

Codecov Report

Attention: Patch coverage is 86.95652% with 3 lines in your changes missing coverage. Please review.

Project coverage is 83.29%. Comparing base (22aa800) to head (251542b).
Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #3148      +/-   ##
==========================================
+ Coverage   83.18%   83.29%   +0.10%     
==========================================
  Files          51       51              
  Lines        5483     5495      +12     
==========================================
+ Hits         4561     4577      +16     
+ Misses        922      918       -4     

Flag	Coverage Δ
python	83.29% <86.95%> (+0.10%)	⬆️

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

Components	Coverage Δ
python_api	83.29% <86.95%> (+0.10%)	⬆️
libtiledbsoma	∅ <ø> (∅)

[jp-dark]

I think this looks good, but I'm not super familiar with the ingestor code so you may want to want to wait for @nguyenv to review as well.

One question: Is that resize code required before ingesting with the new shape feature? If so, what error does the user get if they fail to resize first?

[johnkerl]

One question: Is that resize code required before ingesting with the new shape feature? If so, what error does the user get if they fail to resize first?

@jp-dark they get a message like this:

tiledbsoma._exception.SOMAError: TileDB internal: ['UnorderedWriter::dowork]  (FragmentMetadata: Cells are written outside of the defined current domain.)

which we can perhaps catch and rethrow with a friendlier error message ...