aws / aws/aws-durable-execution-sdk-java

Generate conformance-test SAM templates from handler metadata

Đang mở
#553 0 bình luận 0 reaction 0 người được giao Xem trên GitHub
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

Mở 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

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.