Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Added ItemSearch.item_collection #277

Merged
merged 1 commit into from
Jul 28, 2022

Conversation

TomAugspurger
Copy link
Collaborator

Description:

Adds an ItemSearch.item_collection method as a replacement for
the deprecated get_all_items().

A few other notes:

  1. I haven't implemented any of the max_items changes being worked
    out in Replacement functionality for get_all_items #237. That
    can be done before / after this PR once things are ironed out
  2. I changed the get_all_items method to use Sphinx's builtin
    deprecated directive.
  3. I updated the tests (a bit)

I'd like to enable pytest's -W error flag to fail on warnings. But
it looks like the cli is using the (deprecated) get_all_items_as_dict
method. I haven't touched that in this PR, but I don't think the CLI
should be using a deprecated function.

PR Checklist:

  • Code is formatted
  • Tests pass
  • Changes are added to the CHANGELOG

Adds an ItemSearch.item_collection method as a replacement for
the deprecated `get_all_items()`.

A few other notes:

1. I haven't implemented any of the `max_items` changes being worked
   out in stac-utils#237. That
   can be done before / after this PR once things are ironed out
2. I changed the `get_all_items` method to use Sphinx's builtin
   `deprecated` directive.
3. I updated the tests (a bit)

I'd like to enable pytest's `-W error` flag to fail on warnings. But
it looks like the `cli` is using the (deprecated) `get_all_items_as_dict`
method. I haven't touched that in this PR, but I don't think the CLI
should be using a deprecated function.
@TomAugspurger
Copy link
Collaborator Author

cc @philvarner, @gadomski

@gadomski gadomski self-requested a review July 27, 2022 15:55
@philvarner philvarner merged commit caf8dd2 into stac-utils:main Jul 28, 2022
@TomAugspurger TomAugspurger deleted the fix/item-collection branch July 28, 2022 01:37
@TomAugspurger
Copy link
Collaborator Author

Hmm, I just noticed that there was already an ItemSearch.item_collections method. So now we have .item_collection() and .item_collections().

What are people's thoughts on method names that differ by only the trailing s? I'm generally wary of them... (cc @gadomski, @duckontheweb)

TomAugspurger pushed a commit to TomAugspurger/pystac-client that referenced this pull request Jul 28, 2022
Followup to stac-utils#277 and
closes stac-utils#279

the `cli.search` and `get_all_items()` / `item_collection()` were using
this deprecated method. Users using non-deprecated APIs shouldn't be
getting deprecation warnings.

Clearly it's useful, so let's either un-deprecate it or move the
implementaiton to a private method and call that directly. I've chosen
to un-deprecate it.

I've also configured pytest to fail on warnings, to catch this type of
issue in CI.
gadomski added a commit that referenced this pull request Aug 8, 2022
* Un-deprecate get_all_items_as_dict

Followup to #277 and
closes #279

the `cli.search` and `get_all_items()` / `item_collection()` were using
this deprecated method. Users using non-deprecated APIs shouldn't be
getting deprecation warnings.

Clearly it's useful, so let's either un-deprecate it or move the
implementaiton to a private method and call that directly. I've chosen
to un-deprecate it.

I've also configured pytest to fail on warnings, to catch this type of
issue in CI.

* Implement the new result methods

* docstring

* cleanup

* Fixup

* typo

* table

* Added a table

* updated for signing

* Updated recording

* Apply suggestions from code review

Co-authored-by: Pete Gadomski <pete.gadomski@gmail.com>

Co-authored-by: Pete Gadomski <pete.gadomski@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants