feat: add transformations to from_xml

[tlambert03]

This PR addresses, and I'm going to say closes #129

It adds a new transformations argument to from_xml

AnyElementTree = xml.etree.ElementTree.ElementTree | lxml.etree._ElementTree
TransformationCallable = Callable[[AnyElementTree], AnyElementTree]

def from_xml(
    ...,
    transformations: Iterable[TransformationCallable] = (),
):

which lets the user add any number of "fixers" before converting xml. There is a new module ome_types.etree_fixes with some standard fixes, and PRs can be opened to add more. So, to use them all:

from ome_types import etree_fixes, from_xml

from_xml("some_bad.ome.xml", transformations=etree_fixes.ALL_FIXES)

HOWEVER:
With v0.4.0, many of the fixes that are included in the aicsimageio clean_ome_xml_for_known_issues function referenced in #129 (i.e., ID and references fixes, namespace capitalization, ordering of elements) are no longer necessary as they are handled fine by default. Some will emit warnings, and the transformations could be used to avoid those warnings. But in general, I think this is a flexible enough approach that anyone can extend if needed

[codecov]

Codecov Report

Merging #208 (a6f8427) into main (46bae0c) will increase coverage by 0.21%.
The diff coverage is 97.29%.

@@            Coverage Diff             @@
##             main     #208      +/-   ##
==========================================
+ Coverage   86.26%   86.48%   +0.21%     
==========================================
  Files          25       26       +1     
  Lines        1223     1250      +27     
==========================================
+ Hits         1055     1081      +26     
- Misses        168      169       +1     

Impacted Files	Coverage Δ
src/ome_types/_conversion.py	95.89% <93.33%> (-0.42%)	⬇️
src/ome_types/etree_fixes.py	100.00% <100.00%> (ø)

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[codspeed-hq]

CodSpeed Performance Report

Merging #208 will not alter performance

_{Comparing fix-common-errors (a6f8427) with main (46bae0c)}

Summary

✅ 9 untouched benchmarks