(MAJOR) Prepare for stable API (1.0) release

[scouten-adobe]

I believe that this crate is ready for API stabilization.

I'm seeking discussion regarding committing to the existing API as a stable interface over the next month. Barring unresolved feedback, this PR will be merged on 5 December 2022 and a 1.0 release issued at that time.

Between now and then, I welcome feedback on any issues or concerns that should block or delay a 1.0 release. Please review this crate and remaining APIs from the underlying C++ XMP Toolkit with an eye toward what might cause breaking API changes.

I believe the following are not in scope for 1.0 release:

• Porting remaining APIs from XMP_Meta, XMP_Files, and TXMPUtils. (There are relatively few left and these may be added in 1.x releases.)
• Porting UTF-16 or UTF-32 APIs.
• Porting other APIs (notably the I___ API surface).

Please either file issues here in GitHub or add comments to this PR while discussion is open.

[codecov]

Codecov Report

Merging #151 (29d0b11) into main (f48342f) will not change coverage.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main     #151   +/-   ##
=======================================
  Coverage   97.87%   97.87%           
=======================================
  Files           8        8           
  Lines        1504     1504           
=======================================
  Hits         1472     1472           
  Misses         32       32           

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