📣 Note: This repository contains all projects supported in Rust by the @aws/aws-crypto-tools team.
This repository uses semantic versioning and uses conventional commits to determine project versions.
The error types are part of the public API: their variants, their accessors, and is_retryable().
Error handling that decides from those keeps working across minor and patch releases.
A minor or patch release can change:
- Message text. Any message, and anything an error prints. Decide from the variant and its accessors, never from the message.
- Failures without a specific variant. An ESDK operation returns only
aws_esdk::Error, and an MPL operation onlyaws_crypto_mpl::Error. A failure that reaches you without a specific variant is a bug: a panic, anInternalerror, or a failure you can recognize only by a type in its source chain. A minor or patch release can turn it into a specific variant. In C++, the same applies to an exception that is not anAwsEncryptionSdkException, and toInternalException. - The shape of the source chain. Levels can be added or removed.
Reach a source with
find_source. - Which variant a collection of failures gets. The priority between variants, and whose retry kind is kept.
To act on each failure, use
failures(). - New variants and enum values. Every
matchneeds a catch-all arm, and every C++switchadefaultcase.
If you discover a potential security issue in this project we ask that you notify AWS/Amazon Security via our vulnerability reporting page. Please do not create a public GitHub issue.
This project is licensed under the Apache-2.0 License.