Updates to StacIO

[duckontheweb]

Related Issue(s):

• Closes StacIO._json_dumps requires unused argument #467
• Closes Update I/O documentation #432
• Setting object_pairs_hook for json.loads #313

Description:

• Makes "private" StacIO._json_dumps method into a "public" StacIO.json_dumps and updates the signature to accept arbitrary keyword arguments instead of specifically accepting a source argument (see StacIO._json_dumps requires unused argument #467).
• Refactors error reporting logic for DuplicateKeyReportingMixin.read_json and DuplicateKeyReportingMixin.json_loads so that we do not need to pass the source into json_loads. Also adds test coverage for this class.
• Adds all exception classes to API docs
• Moves DuplicateObjectKeyError into pystac.errors
• Updates the API docs for the stac_io classes as well as the "Using STAC_IO" section in the "Concepts" docs

PR Checklist:

• Code is formatted (run pre-commit run --all-files)
• Tests pass (run scripts/test)
• Documentation has been updated to reflect changes, if applicable
• This PR maintains or improves overall codebase code coverage.
• Changes are added to the CHANGELOG. See the docs for information about adding to the changelog.

[codecov-commenter]

Codecov Report

Merging #471 (2519e03) into main (13a9fad) will increase coverage by 0.17%.
The diff coverage is 96.55%.

@@            Coverage Diff             @@
##             main     #471      +/-   ##
==========================================
+ Coverage   91.48%   91.66%   +0.17%     
==========================================
  Files          40       40              
  Lines        5240     5245       +5     
==========================================
+ Hits         4794     4808      +14     
+ Misses        446      437       -9     

Impacted Files	Coverage Δ
pystac/__init__.py	100.00% <ø> (ø)
pystac/stac_io.py	82.75% <96.29%> (+5.56%)	⬆️
pystac/errors.py	90.00% <100.00%> (+1.11%)	⬆️

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 13a9fad...2519e03. Read the comment docs.