Expand get_items - deprecate get_all_items and Catalog.get_item

[jsignell]

Related Issue(s):

• Catalog.get_item(id) with non-unique IDs #585

Description:

Instead of using get_all_items people should use get_items(recursive=True) and instead of Catalog.get_item(id) people should use next(Catalog.get_items(id), None)

TO DO:

• make tests fail on deprecation warnings
• refactor code to not use deprecated methods
• add new tests
• explicitly expect warnings in specific tests
• refactor examples to not use deprecated methods

PR Checklist:

• pre-commit hooks pass locally
• 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

Attention: Patch coverage is 94.11765% with 1 line in your changes missing coverage. Please review.

Project coverage is 90.25%. Comparing base (25f2050) to head (a4e971f).
Report is 236 commits behind head on main.

Files	Patch %	Lines
pystac/summaries.py	0.00%	1 Missing ⚠️

Additional details and impacted files

@@           Coverage Diff           @@
##             main    #1075   +/-   ##
=======================================
  Coverage   90.25%   90.25%           
=======================================
  Files          47       47           
  Lines        6227     6230    +3     
  Branches      935      934    -1     
=======================================
+ Hits         5620     5623    +3     
  Misses        427      427           
  Partials      180      180           

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

[gadomski]

Just two minor notebook fixups, otherwise looks good to me. I'm going to ask for another set of eyes on this one, just because it's a non-insignificant API change we're committing too, and I want to make sure it makes sense to someone else.

Oh, needs a CHANGELOG as well.

[TomAugspurger]

Makes sense to me.