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.