Citrus

What Citrus is

Citrus is a free test framework for automated integration testing of messaging applications and microservices. A test can act as both client and server across multiple messaging interfaces, send messages, and validate their content. Supported endpoints include HTTP, Kafka, JMS, Apache Camel, mail, FTP/SFTP, OpenAPI, SOAP, Docker, Kubernetes, Knative, SQL, and SSH. Citrus checks JSON and XML payloads and elements, supports XML schema and DTD validation, and can validate database data. Test cases can sequence messages and include loops, delays, retries, parallel sections, and timeouts. Tests can be written in Java, XML, YAML, or as Cucumber BDD features. Citrus integrates with JUnit 5, Cucumber, JBang, Quarkus, Spring Boot, TestNG, and JUnit 4. Setup guidance covers test-scoped Maven dependencies and Gradle. The framework runs on Linux and requires Java 17 or newer since version 4.0. It is available for no cost under the Apache License 2.0, including for testing commercial applications. The project invites contributions, feature requests, and issue reports through its community repository.