ecotone-testing

Bootstrap Ecotone in-process tests with EcotoneLite flow testing utilities.

2|Updated Feb 12, 2026
One-click install
npx skills add https://github.com/ecotoneframework/skills --skill ecotone-testing
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ecotone-testing
Source: https://github.com/ecotoneframework/skills/tree/main/skills/ecotone-testing
Command: npx skills add https://github.com/ecotoneframework/skills --skill ecotone-testing

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Ecotone testing often requires a reliable bootstrap, controlled environments, and repeatable patterns to validate handlers, aggregates, projections, and event-sourced flows. This Skill provides structured guidance and ready-to-run examples for in-process testing with EcotoneLite::bootstrapFlowTesting and bootstrapFlowTestingWithEventStore, including asynchronous processing and projection workflows.

Core Features & Use Cases

  • In-process test bootstrapping using EcotoneLite::bootstrapFlowTesting and EcotoneLite::bootstrapFlowTestingWithEventStore.
  • Async-tested-synchronously patterns with SimpleMessageChannelBuilder and ExecutionPollingMetadata.
  • Projection testing, recorded messages inspection, and end-to-end validation for event-sourced and state-stored components.
  • Debugging guidance for common test failures and ModulePackageList configuration to tailor test packages.

Quick Start

Bootstrap Ecotone test environment by calling EcotoneLite::bootstrapFlowTesting with your handler class and a test container.

Frequently Asked Questions about ecotone-testing

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test Ecotone handlers and aggregates in-process?▼

To test Ecotone handlers in-process, bootstrap a test environment using EcotoneLite::bootstrapFlowTesting with your handler class and a test container. This provides controlled, repeatable validation for standard handlers and aggregates without external messaging infrastructure.

What is the best way to test event-sourced workflows in Ecotone?▼

Testing event-sourced workflows in Ecotone uses EcotoneLite::bootstrapFlowTestingWithEventStore. This approach supports end-to-end validation for event-sourced components, allowing you to verify state changes and recorded messages within a controlled testing environment.

Can I test asynchronous Ecotone messages synchronously?▼

Yes, you can test asynchronous Ecotone messages synchronously using SimpleMessageChannelBuilder and ExecutionPollingMetadata. These patterns allow controlled execution and validation of async processing workflows during in-process testing.

How do I test projections in an Ecotone application?▼

Projection testing in Ecotone is handled through in-process bootstrap utilities. It allows you to inspect recorded messages and validate end-to-end behavior for both event-sourced and state-stored components within your testing environment.

Why is my Ecotone test failing to recognize my modules?▼

Ecotone test failures often relate to module configuration. Use ModulePackageList during EcotoneLite bootstrap to explicitly tailor test packages, ensuring the testing environment correctly recognizes and loads required Ecotone modules.