All notable changes to this project will be documented in this file.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
0.44.0 - 2025-09-18
tilebox-workflows: Addedprogress_indicatorsto the query response ofJobClient.findto provide programmatic access to a job's progress indicators.tilebox-workflows: Added anipywidgetsbased interactive display for Job objects for interactive environments like Jupyter notebooks.
0.43.0 - 2025-09-12
tilebox-workflows: Added progress tracking support to theTaskRunner.
0.42.0 - 2025-08-22
tilebox-storage: AddedUSGSLandsatStorageClientto download landsat data from the USGS Landsat S3 bucket.tilebox-storage: Storage client now support concurrent downloads of multiple objects, controlled by themax_concurrent_downloadsparameter.tilebox-storage: Addedquicklookanddownload_quicklookmethods to theCopernicusStorageClientto download and display preview images for Sentinel data.
tilebox-workflows: Registering duplicate task identifiers with a task runner now raises aValueErrorinstead of overwriting the existing task.tilebox-workflows: Fixed a bug where thedeserialize_taskfunction would fail to deserialize nested dataclasses or protobuf messages that are wrapped in anOptionalorAnnotatedtype hint.tilebox-workflows: Callingconfigure_otel_tracingandconfigure_otel_loggingmultiple times correctly configures multiple exporters instead of overwriting the existing ones.
0.41.0 - 2025-08-01
tilebox-workflows: Task runners now support receiving a suggested idling duration from the workflows API
tilebox-workflows: Change task lease extension logging message toDEBUGlevel
0.40.0 - 2025-07-29
- Added
NetworkErrorandNetworkTimeoutErrorexceptions classes to indicate network related errors in grpc calls.
- Dropped support for
protobuf v5and below, minimum supported version is nowprotobuf>=6.
tilebox-workflows: Fix opentelemetry logging and tracing initialization on Windows, which was relying onos.uname, a stdlib function that does not exist on Windows python SDKs.
0.39.0 - 2025-07-16
tilebox-workflows: Addedcancel_jobsargument toAutomationClient.deleteto optionally cancel all currently queued or running jobs of the automation.
tilebox-datasets: ChangedTimeIntervalandTimeIntervalLikeimports fromtilebox.datasets.datatotilebox.datasets.query.
0.38.0 - 2025-06-24
tilebox-datasets: Addeddelete_collectionmethod toDatasetClientto delete a collection.tilebox-workflows: Added support for nested dataclasses and protobuf messages inside alist,dictortupleas task arguments.
0.37.1 - 2025-06-10
tilebox-datasets: Fixed a bug inTimeseriesDatasetChunk.from_messagerelying on incorrect bool assumptions about missing protobuf fields.tilebox-grpc: More robust parsing of GRPC channel URLs.tilebox-workflows: Fixed a bug in the timeseries interceptor that resulted in an error when accessing a collection.
0.37.0 - 2025-06-06
- Dropped support for legacy Tilebox datasets, no longer necessary since all datasets have been migrated on the server.
0.36.1 - 2025-06-04
- Changed the
runnermethod of theClientto take an optionalclusterargument. If not provided, the default cluster will be used. - Changed the
create_cron_automationandcreate_storage_event_automationmethods of theAutomationClientto take an optionalclusterargument. If not provided, the default cluster will be used. - Changed the
submitmethod of theJobClientto take an optionalclusterargument. If not provided, the default cluster will be used.
0.36.0 - 2025-05-27
- Added
querymethod toJobClientto query jobs in a given temporal extent and filter by automation id
0.35.0 - 2025-04-29
- Support for ingestion of enum values into datasets
- Pagination support for ingestion / deletion of large numbers of datapoints
- Renamed
TimeseriesDatasettoDatasetClient - Renamed
TimeseriesCollectiontoCollectionClient
0.34.0 - 2025-04-15
- Added spatial-query support via new
querymethod inTimeseriesDatasetCollection - Added
submit_subtasksmethod toTaskRunner - Added deprecation warning for
submit_batchmethod toTaskRunner
0.33.1 - 2025-04-01
- Replaced Job field
completedbystate
0.33.0 - 2025-03-21
- Support for custom datasets
collection.ingestmethod to ingest data into a collection- ingest takes data in the form of either a
xarray.Dataset, apandas.DataFrameor a dictionary of Iterables (which will be converted to apandas.DataFrameusing its constructor)
- ingest takes data in the form of either a
collection.deletemethod to delete datapoints from a collection
0.32.1 - 2025-03-11
- Update protobuf due to server side refactoring
0.32.0 - 2025-03-11
- Add
get_or_create_collectionandcreate_collectionmethod to timeseries dataset - Added deprecation warning for
availabilityandcountfor collection info - Add dataset_type protobuf files
0.31.0 - 2025-02-12
- Added
list_objectsmethod to storage clients to list available objects for a given datapoint. - Added
download_objectsmethod to storage clients to download a subset of the available objects for a given datapoint.
0.30.2 - 2025-01-27
- Renamed recurrent tasks to automations.
0.30.1 - 2025-01-10
- Added
_load_pagemethod toTimeseriesCollectionto easily allow individual pages, allowing to not do auto-pagination for use cases where it is not needed. - Added docstrings to the dataset client constructors.
0.30.0 - 2024-11-29
- Removed
asyncAPI fortilebox-workflows. - Changed argument order of create recurrent task methods to be consistent with the job client.
0.29.0 - 2024-11-14
- Added support for Python
3.12and3.13
tilebox-grpc: Fixed a dependency version error resulting in an outdated version of the package being installed bypipby default.tilebox-workflows: Fixed a bug wheregrpcerrors were not wrapped in Tilebox Python exceptions.
0.28.0 - 2024-10-12
- Added
SubscriptionLimitExceededErrorerror to indicate subscription rate limiting related errors.
client.datasetmethod of the datasets client now takes a dataset slug instead of an id as input argument- Changed default value of
countfor thecollection.infomethod toTrue, since it's no longer an expensive operation
0.27.2 - 2024-10-05
- Added
formatmethod toTimeIntervalto format the interval as a string with custom precision and with or without the endpoint chars.
tilebox-workflows: Fixed a bug where the root logger was not set to DEBUG level, which would cause all DEBUG messages to be discarded.
0.27.1 - 2024-10-04
- Properly offload datapoint parsing to a background thread during
loadin the async client. - Progress callbacks during
loadare now always done from the main thread in the sync client. This resolves an issue when using it instreamlitto update a progress bar, since interacting with streamlit widgets from a background thread is not allowed without setting some streamlit context in the background thread. - Accept any return type for show_progress callbacks in
load
0.27.0 - 2024-10-02
- Refactored timeseries dataset to a proper sync / async client containing correct types.
0.26.0 - 2024-09-30
- Create collection RPC stub and service method
- Ingest and delete datapoints RPC stubs and service methods
- Configure a default console logger if
get_logger()is called without any configured loggers. - Callback function for reporting progress percentage for timeseries datasets
.load()method.
- Updated TimeInterval and TimeChunk tasks to use protobuf messages from datasets package.
0.25.1 - 2024-09-12
- Added descriptions for the pypi.org pages of the packages.
0.25.0 - 2024-08-12
- Initial version of the tilebox python library
- Released under the MIT license.
- Released packages:
tilebox-datasets,tilebox-workflows,tilebox-storage,tilebox-grpc