EarthDaily Python Client Release - 1.8.0#223
Merged
imanshafiei540 merged 1 commit intomainfrom Jan 16, 2026
Merged
Conversation
* Release version 1.8.0 with new STAC item search functionality - Introduced `platform.search()` method for searching STAC items with optional concurrent execution. - Added `batch_days` parameter to allow splitting datetime ranges for concurrent searches. - Implemented `max_workers` parameter to control the size of the concurrent thread pool (default is 10, capped at 10). - Updated CHANGELOG to reflect these new features and incremented version in `pyproject.toml` and `uv.lock` to 1.8.0. - Added unit tests to ensure the new search functionality works as intended. * Enhance `platform.search()` with `max_items_per_chunk` parameter for concurrent searches - Added `max_items_per_chunk` parameter to limit the number of items fetched per chunk during concurrent searches, improving performance and control. - Updated the `search` method to raise a `ValueError` if `max_items` is used alongside `batch_days`, guiding users to use `max_items_per_chunk` instead. - Enhanced documentation and examples to reflect the new parameter and its usage. - Updated CHANGELOG to include these changes for version 1.8.0. * Refactor `PlatformService` to enhance datetime handling and error management - Updated `_split_datetime` method to raise `ValueError` for zero or negative `batch_days` and for open-ended datetime intervals. - Improved the creation of STAC client to fetch a fresh authorization token for each call. - Refactored the handling of date ranges to ensure non-overlapping chunks during concurrent searches. - Added unit tests to validate new error conditions and ensure correct behavior of datetime splitting and STAC client creation. * Implement validation for `max_workers` in `PlatformService` and add corresponding unit tests - Added a check in the `search` method to raise a `ValueError` if `max_workers` is zero or negative, ensuring proper input validation. - Introduced unit tests to verify that appropriate errors are raised when `max_workers` is set to zero or a negative value, enhancing robustness of the concurrent search functionality. * Refactor `platform.search()` method to rename `batch_days` parameter to `days_per_chunk` - Updated the `platform.search()` method and related functionality to replace the `batch_days` parameter with `days_per_chunk`, enhancing clarity and consistency in the API. - Adjusted documentation and examples to reflect the new parameter name. - Updated unit tests to ensure proper functionality with the renamed parameter. - Modified CHANGELOG to document this change for versioning. * Enhance `build_datacube` documentation with `fail_on_error` parameter - Added a new optional parameter `fail_on_error` to the `build_datacube` function documentation, specifying its behavior for asset loading failures. If set to True (default), an error is raised for failed assets; if False, the function skips them, improving usability for users dealing with potentially missing or corrupted assets. GitOrigin-RevId: 70cca02c6e7b9c3c402945c03012ab7adacde6cb
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Automated Sync from Internal Repository
Changes in this sync:
[1.8.0]
Added
platform.search()method for STAC item search with optional concurrent executiondays_per_chunkparameter to split datetime ranges and execute searches concurrentlymax_workersparameter to control concurrent thread pool size (default 10, capped at 10)max_items_per_chunkparameter to limit items fetched per time chunk in concurrent search[1.7.0]
Added
deduplicate_byparameter fordatacube.create()to deduplicate STAC items before datacube creationdeduplicate_keepparameter to control which item to keep when duplicates found ("first"or"last")poolparameter passthrough to odc.stac.load for parallel COG metadata fetching[1.6.1]
Added
groupbyparameter fordatacube.temporal_aggregate()to aggregate by available dates (e.g.,groupby="time.date")[1.6.0]
Added
Sentinel1CollectionHelper,Sentinel2CollectionHelper)create_dual_pol,create_rgb,create_vegetation, etc.)STGeometryclass for spatiotemporal geometry handlingsentinel1_helper_example.py,sentinel2_helper_example.py)Breaking Changes:
Automated sync from internal repository. Please review and update the changelog above before merging.