Upgrade jsonschema

[SpacemanPaul]

Reason for this pull request

A jsonschema deprecation warning was raised in #1474.

This turned out to be due to the new "referencing" library released in jsonschema 4.18.0 replacing the old RefResolver API, which was deprecated from 4.18.0.

I pinned jsonschema<4.18 in #1476 as an immediate fix. This PR is a longer term fix - pinning to jsonschema>=4.18 switching to the new API.

4.18.0 was released barely 2 weeks ago at the time of writing and there have been 4 minor releases since, hence merging of this was postponed until the rest of the ecosystem calmed down.

Proposed changes

• Migrate the validate_document decorator to use the new referencing API.

• Pin jsonschema>=4.18

• Tests added / passed

• Fully documented, including docs/about/whats_new.rst for all changes

---

📚 Documentation preview 📚: https://datacube-core--1477.org.readthedocs.build/en/1477/

[codecov]

Codecov Report

Attention: 1 lines in your changes are missing coverage. Please review.

Comparison is base (0cfe300) 91.75% compared to head (79ff588) 91.75%.

Additional details and impacted files

@@             Coverage Diff             @@
##           develop    #1477      +/-   ##
===========================================
- Coverage    91.75%   91.75%   -0.01%     
===========================================
  Files          132      132              
  Lines        14549    14552       +3     
===========================================
+ Hits         13350    13352       +2     
- Misses        1199     1200       +1     

Files	Coverage Δ
datacube/utils/documents.py	98.04% <83.33%> (-0.31%)	⬇️

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

[emmaai]

This will cause trouble in all stac related functionalities. I did raise an issue in pystac repo, but ideally they'd be very happy if I could raise a pr fixing it. ref stac-utils/pystac#1214

[SpacemanPaul]

I'm beginning to think we should keep both implementations for the time being - dynamically try the new API first and fallback to the old API if the new one isn't available - that way we can support everything while the rest of the ecosystem dukes it out.

[emmaai]

the jsonschema issue with pystac was resolved. maybe it's time for us to merge the change.

[emmaai]

@SpacemanPaul any plan to merge this soon?

[SpacemanPaul]

@SpacemanPaul any plan to merge this soon?

Yep, it's on my todo list - will definitely be in the next release. (although not sure when that will be.)

[emmaai]

Thanks!