aws / aws/aws-durable-execution-sdk-java
Generate conformance-test SAM templates from handler metadata
- Ngôn ngữ chính
- Java
- Star
- 28
- Fork
- 11
- Merge trung bình
- 1 ngày 10 giờ
- Pull request đã merge (30 ngày)
- 45
Mô tả
## Summary
PR #552 adds hand-maintained SAM templates for the Java conformance test suites. Each handler requires a largely repetitive Lambda resource plus a `TestingMetadata.TestDescription` mapping to conformance requirement IDs. As the number of handlers and suites grows, maintaining these mappings in both Java code and SAM YAML will be error-prone.
Add a script or build step that generates the conformance-test SAM templates from handler metadata.
Review context: https://github.com/aws/aws-durable-execution-sdk-java/pull/552#discussion_r3617917672
## Requirements
- Define one source of truth for the mapping between each Java handler and its conformance requirement IDs. This could be a Java annotation, a small manifest, or another explicit convention.
- Generate `template_.yaml` files deterministically for all conformance suites.
- Preserve the shared SAM configuration and each function's `TestingMetadata.TestDescription` values.
- Integrate generation into the local/CI conformance-test workflow so templates cannot silently drift from handlers or metadata.
- Document how to add a handler and its requirement mapping to an existing or new suite.
## Acceptance criteria
- Adding or removing a conformance handler requires no manual duplication of its Lambda resource in a SAM template.
- Generated templates pass SAM validation/build and run the existing step and wait conformance suites successfully.
- Generation is stable: running it twice without source changes produces no diff.
- CI fails when checked-in generated templates are stale, or generates templates before they are consumed if they are not checked in.
Hướng dẫn đóng góp
Hướng nghiên cứu
Bắt đầu với PR #552 và các template SAM của bài kiểm thử tuân thủ hiện có, được duy trì thủ công, sau đó lần theo các Java handler và các ánh xạ TestingMetadata.TestDescription của chúng. So sánh quy trình local/CI của bài kiểm thử tuân thủ với việc validation/build SAM và các suite step và wait. Được xem là hoàn tất khi các template có tính xác định, việc đăng ký handler được ghi chép, các suite chạy thành công và CI bảo vệ khỏi đầu ra được tạo đã lỗi thời.
Do mô hình lập chỉ mục viết ra từ nội dung của issue.
Đánh giá
- Công nghệ
- aws, java
- Lĩnh vực
- build-system, ci-cd, testing
- Loại issue
- Tính năng
- Độ khó
- 5/5
- Thời gian dự kiến
- Hơn một tuần
- Mức độ hoạt động
- Ít trao đổi
- Độ rõ ràng
- Khá rõ ràng
- Mức phù hợp với người mới
- 38/100