Description
Citrus is a test framework written in Java that is able to create
fully automated end-to-end use case tests for enterprise SOA
applications. Citrus simulates surrounding interface partners
supporting a huge set of different transports and protocols like
Http, JMS, TCP/IP, FTP, SOAP, XML and JSON.
Visit our official website at 'http://www.citrusframework.org'
for more information and a detailed documentation.
Citrus alternatives and similar libraries
Based on the "Testing" category.
Alternatively, view Citrus alternatives based on common mentions on social networks and blogs.
-
Karate
Karate is the only open-source tool to combine API test-automation, mocks, performance-testing and even UI automation into a single, unified framework. -
TestContainers
Provides throwaway instances of common databases, Selenium web browsers, or anything else that can run in a Docker container. -
PowerMock
Enables mocking of static methods, constructors, final classes and methods, private methods and removal of static initializers. -
PIT
Fast mutation-testing framework for evaluating fault-detection abilities of existing JUnit or TestNG test-suites. -
GreenMail
In-memory email server for integration testing. Supports SMTP, POP3 and IMAP including SSL. -
Arquillian
Integration and functional testing platform for Java EE containers. -
Scott Test Reporter
Detailed failure reports and hassle free assertions for Java tests - Power Asserts for Java -
J8Spec
J8Spec is a library that allows tests written in Java to follow the BDD style introduced by RSpec and Jasmine.
Get performance insights in less than 4 minutes
* Code Quality Rankings and insights are calculated and provided by Lumnify.
They vary from L1 to L5 with "L5" being the highest. Visit our partner's website for more details.
Do you think we are missing an alternative of Citrus or a related project?
README
Citrus Integration Testing 
Welcome to Citrus
Citrus is a test framework written in Java that is able to create fully automated end-to-end use case tests for enterprise SOA applications. Citrus simulates surrounding interface partners supporting a huge set of different transports and protocols like Http, JMS, TCP/IP, FTP, SOAP, XML and JSON.
Visit our official website at 'https://citrusframework.org' for more information and a detailed documentation.
Preconditions
You need following software on your machine in order to use the Citrus framework:
Java 8 or higher Installed JDK plus JAVA_HOME environment variable set up and pointing to your Java installation directory
Java IDE (optional) A Java IDE will help you to manage your Citrus project (e.g. creating and executing test cases). You can use the Java IDE that you like best like Eclipse or IntelliJ IDEA.
Maven 3.0.x or higher (optional) Citrus projects will fit best with Maven (https://maven.apache.org). However it is not required to use Maven. You can also run tests using ANT (https://ant.apache.org/) for instance.
Installation
Download the latest Citrus release archive
Extract the archive into an appropriate location on your local storage
Use the ANT tutorial in our tutorials section to find out how to run tests using ANT.
Read the Maven tutorial to find out how to integrate the Citrus tests into the Maven build lifecycle
Release Notes
Each release comes with a complete reference documentation. At the beginning of the reference you will find a section about the changes and notes for this release. For detailed description of changed packages and classes do also consult the provided javadoc.
Resources
Citrus's source repository is hosted on github.com. You can clone the repository with git://github.com/citrusframework/citrus.git as URL
Find our blog and more interesting articles around Citrus on https://labs.consol.de and checkout the various post categories for selecting a specific topic.
https://citrusframework.org offers tutorials and more information about Citrus framework.
Samples
Our sample section is still growing. Nevertheless you can find a sample project called 'FlightBookingService' in our distribution. To build and run the sample applications go to the 'samples' directory and run 'build.xml' script with ANT (ant -p).
Licensing
Copyright 2006-2018 ConSol Software GmbH.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Consulting
Just in case you need professional support for Citrus have a look at 'https://citrusframework.org/docs/consulting/'. Contact [email protected] directly for any request or questions (or use the contact form at 'https://www.consol.com/contact/')
Bugs
Please report any bugs and/or feature requests directly to https://github.com/citrusframework/citrus/issues
Information
For more information on Citrus see citrusframework.org, including a complete reference manual.
*Note that all licence references and agreements mentioned in the Citrus README section above
are relevant to that project's source code only.