IaC: add custom error messages based on service availability status by k-a-il · Pull Request #13597 · localstack/localstack

k-a-il · 2026-01-08T13:00:54Z

Motivation

Integrates the license catalog with LocalStack exceptions to return customized errors based on the AWS service catalog status.
If a NotImplemented exception includes a message from service level, the defined message is returned without accessing the catalog, otherwise, the exception message is obtained from the catalog.

Changes

Integrates the catalog into the NotImplementedError handling logic by adding it to the ServiceExceptionSerializer and the service Skeleton class
pydantic library dependency was moved to the base runtime dependencies because it is required for AWS Catalog validation
Removed the logic that created and tested the previouisly used error message

Tests

Updated ServiceExceptionSerializer and the service Skeleton class tests

Notes

Merge after pydantic version is updated by automatic dependency updates

Test Results - Preflight, Unit

23 045 tests - 1 21 200 ✅ - 1 6m 11s ⏱️ ±0s
1 suites ±0 1 845 💤 ±0
1 files ±0 0 ❌ ±0

Results for commit 332ad14. ± Comparison against base commit 40c916d.

This pull request removes 6 and adds 5 tests. Note that renamed tests count towards both.

tests.unit.aws.handlers.test_service.TestServiceExceptionSerializer ‑ test_not_implemented_error[-not available in your current license plan or has not yet been emulated]
tests.unit.aws.handlers.test_service.TestServiceExceptionSerializer ‑ test_not_implemented_error[Ups!-Ups!]
tests.unit.aws.test_skeleton ‑ test_skeleton_e2e_sqs_send_message_not_implemented[api_class0-The API action 'SendMessage' for service 'sqs' is either not available in your current license plan or has not yet been emulated by LocalStack. Please refer to https://docs.localstack.cloud/references/coverage/coverage_sqs for more information.]
tests.unit.aws.test_skeleton ‑ test_skeleton_e2e_sqs_send_message_not_implemented[api_class1-We will implement it soon, that's a promise!]
tests.unit.utils.test_coverage_docs ‑ test_coverage_link_for_existing_service
tests.unit.utils.test_coverage_docs ‑ test_coverage_link_for_non_existing_service

tests.unit.aws.handlers.test_service.TestServiceExceptionSerializer ‑ test_not_implemented_error_uses_catalog_when_message_is_empty[AVAILABLE_WITH_LICENSE_UPGRADE-is not supported with your LocalStack license]
tests.unit.aws.handlers.test_service.TestServiceExceptionSerializer ‑ test_not_implemented_error_uses_catalog_when_message_is_empty[None-The API for service opensearch is either not included in your current license plan or has not yet been emulated by LocalStack.]
tests.unit.aws.handlers.test_service.TestServiceExceptionSerializer ‑ test_not_implemented_error_with_custom_message
tests.unit.aws.test_skeleton ‑ test_skeleton_e2e_sqs_send_message_not_implemented[api_class0-NOT_IMPLEMENTED-Sorry, the SendMessage operation on the sqs service is not currently supported by LocalStack.]
tests.unit.aws.test_skeleton ‑ test_skeleton_e2e_sqs_send_message_not_implemented[api_class1-NOT_IMPLEMENTED-We will implement it soon, that's a promise!]