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

Generate conformance-test SAM templates from handler metadata

Offen
#553 0 Kommentare 0 Reaktionen 0 zugewiesene Personen Auf GitHub ansehen
Vorherrschende Sprache
Java
Sterne
28
Forks
11
Ø Merge
1 T. 8 Std.
Gemergte PRs (30 T.)
47

Beschreibung

## 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.

Beitragsleitfaden

Beitragsleitfaden öffnen

Rechercherichtung

Beginne mit PR #552 und den vorhandenen, von Hand gepflegten Conformance-Test-SAM-Templates und verfolge dann die Java-Handler sowie ihre TestingMetadata.TestDescription-Zuordnungen. Vergleiche den lokalen/CI-Conformance-Test-Workflow mit der SAM-Validierung/-Build sowie den Step- und Wait-Suites. Als abgeschlossen gilt die Aufgabe, wenn die Templates deterministisch sind, die Handler-Registrierung dokumentiert ist, die Suites erfolgreich ausgeführt werden und CI gegen veraltete generierte Ausgaben schützt.

Vom Indexierungsmodell aus dem Issue-Text verfasst.

Bewertung

Tech-Stack
aws, java
Bereich
build-system, ci-cd, testing
Issue-Typ
Feature
Schwierigkeit
5/5
Geschätzter Aufwand
Über eine Woche
Aktivitätsstatus
Ruhig
Klarheit
Größtenteils klar
Anfängerfreundlichkeit
38/100

Neue Issues direkt in Ihr Postfach

Eine kurze Übersicht über anfängerfreundliche GitHub-Issues.