Descarteslabs

Catalog

- Fixed a problem with unpickling Catalog objects pickled with an earlier version. Please be aware that we do not support the pickling of any Catalog objects, so if in doubt, don't do it!

Authentication

- The links for interacting with login and token generation have been updated to refer to `https://app.descarteslabs.com`.

Catalog

- All `CatalogObject` classes which support the `owners`, `writers`, and `readers` fields have been refactored to derive this support from the new `AuthCatalogObject`. This change does not affect the behavior of any of these classes. The methods `AuthCatalogObject.user_is_owner()`, `AuthCatalogObject.user_can_write()`, and `AuthCatalogObject.user_can_read()` have been added to allow testing of permissions prior to attempting an operation such as updating or deleting the object.
- `EventSchedule` now has a read-only `expires` attribute which indicates when the schedule will be expired and deleted.
- `EventSubscription` now has a read-only `owner_role_arn` field which contains the AWS Role which will be used by certain `EventRule` targets that reside in an external AWS account.
- `EventRule` has been enhanced to support SQS Queue targets.
- Several new helper classes for use with `EventSubscription` are now supported: `EventSubscriptionSqsTarget`, `NewImageEventSubscription`, `NewStorageEventSubscription`, `NewVectorEventSubscription`, and `ComputeFunctionCompletedEventSubscription`. The latter supports events generated by the Compute service as described below.

Compute

- The Compute service now generates a `compute-function-completed` event every time the number of outstanding (pending or running) jobs transitions to 0, akin to the `Function.wait_for_completion()` method. These can be used with the Catalog service events support to trigger other operations.

General

- Support for Python 3.8 has been removed
- Support for Python 3.12 has been added
- Some dependencies have been updated due to security flaws
- The dependency on `pytz` has been removed in favor of the standard `zoneinfo` package
- Minor changes and additions to the client exception hierarchy so that ClientErrors and ServerErrors are not conflated in the retry support.

Catalog

- The Catalog now provides support for Events, essentially notifications of new or updated assets in the Catalog, including images and storage blobs. Additionally, scheduled calendar-based events can be defined. You can subscribe to these events to trigger running a Compute function of your choice. This makes it possible to set up automated processing of new imagery. See the [https://docs.descarteslabs.com/guides/catalog.html](Catalog Guide) and API documentation for more information.

General

- Due to declining support for Python 3.8 across the ecosystem, we have discontinued our support for Python 3.8. It is expected that the client will continue to function until Python 3.8 is End of Life (October 2024), but we can no longer test new releases against this version.

Catalog

- The Catalog Storage Blob deletion methods have been enhanced to support waiting for completion of the operation. When a blob is deleted, it is removed immediately from the catalog and a background asynchronous task is launched to clean up the contents of the blob from the backing storage. If a blob is deleted and then a new blob with the identical id is immediately created and uploaded before this background task completes, it is possible for the background task to end up deleting the new blob contents. As of this release the `Blob` instance and class delete methods return a `BlobDeletionTaskStatus` object which provides a `wait_for_completion` method which can be used to wait until the background task completes and it is safe to create a new blob with the same id. For the `Blob.delete_many` method, the `wait_for_completion=True` parameter can be used to wait for all the supplied blobs to be completely deleted. Note that in the case of the `Blob.delete` class method, this is a very slight breaking change, as it used to return True or False, and now instead returns a `BlobDeletionTaskStatus` or `None`, which have the same truthiness and hence are very likely to behave identically in practical use.

Bugfix only

General

- The `descarteslabs` client CLI script generated by the installation process was broken. Now it works!

A very minor release with some obscure bug fixes.

General

- The `descarteslabs` client CLI has had an overhaul. Gone is the obsolete support for the Raster client, and added is support for querying Catalog Products, Bands, and Blobs and managing sharing for the same.
- Minor fixes to the authorization flow on login.

Catalog

- Add testing of Blobs.

Compute

- Corrected regular expressions used to parse the `memory` argument to the `Function` constructor.
- Improved documentation of the the `cpus` and `memory` arguments to the `Function` constructor.