davsclaus opened a new pull request, #29771: URL: https://github.com/apache/camel/pull/29771
Fixes [CAMEL-26609](https://issues.apache.org/jira/browse/CAMEL-26609) CAMEL-26438 (#28787) puts the fake worlds of the deterministic simulation tests in the catalog (`dstWorlds` in the component JSON). They showed on the camel-test-dst page, but not on the page of the component itself. ### What changes A new partial `docs/components/modules/ROOT/partials/dst-worlds.adoc`, included from `component-endpoint-headers.adoc` right after the Message Body section, the same way (CAMEL-24961): `jsonpathcount` on `nodes$.dstWorlds.*`, an `ifeval` so the section only shows when the component has a world, and a `jsonpathTable` with helpers in `examples/js/camel.js`. No component page is edited. Today it shows on aws2-sqs, azure-eventhubs, kafka-share, pulsar and slack. The section "Deterministic simulation tests" has a short intro linking to the camel-test-dst page, then one row per world: | World | What it checks | Issues | |---|---|---| | `SqsWorld`<br><br>Fake: FakeSqs: a standard SQS queue (ReceiveMessage, DeleteMessage, ChangeMessageVisibilityBatch) bound as amazonSQSClient<br><br>Tests: `SqsRedeliveryDstTest`, `SqsVisibilityDstTest` | **Covers:** the visibility timeout extender, ... (4 items)<br>**Faults:** ReceiveMessage fails, ... (6 items)<br>**Invariants:** no message is delivered again while the consumer holds it, ... (4 items) | CAMEL-25700<br>CAMEL-25737<br>CAMEL-25738<br>CAMEL-25911 (JIRA links) | followed by links to "Running the tests" and "Writing a fake world" on the camel-test-dst page. The world is shown by its simple name and not linked, as it is a test class in no JAR. Values are escaped for `{attribute}` references and the cell separator, as in the body-type helpers. ### Verified - The helpers run (node) on the five catalog JSONs with worlds, and the AsciiDoc they produce, put in the same table, renders with asciidoctor.js 3.0.4 without warnings: 5 tables, 15 lists (covers, faults and invariants per world), the 12 issue links. - The partial uses only what `body-types.adoc` already uses in production: `jsonpathcount`, `ifeval`, `jsonpathTable` with `path[2]` for the key, and the `camel=xref:ROOT:js/camel.js` helpers, with the page module's `example$json/{shortname}.json` as the headers table does. - `xref:others:test-dst.adoc` links within the same docs version, so it resolves although the page is new in 4.24; both anchors (`_running_the_tests`, `_writing_a_fake_world_a_guide_for_ai_agents_and_humans`) exist. - Not done: a local camel-website build (it needs a `yarn install` of the website). Worth a look at the aws2-sqs page in the preview build. _Claude Code on behalf of davsclaus_ 🤖 Generated with [Claude Code](https://claude.com/claude-code) -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
