Wilma is a combined HTTP/HTTPS Service Stub and Transparent Proxy, written in Java. Its main purpose is to test applications/services/components those functionality relies/depends on another - usually 3rd party - service or services. The selected architecture approach makes it capable to use it in environment that contains microservices. The solution consists of two standalone applications:
- Wilma application
- Wilma Message Search application
Wilma application is the highly configurable Service Stub and Transparent Proxy. It logs the messages, and meanwhile acts as a proxy between the components, makes it possible to stub responses based on configuration defined in XML file(s). It is designed for use in test environments where test automation is in use (unit, integration, functional or end-to-end). Also can be used for manual tests. It is expandable easily via plugins.
Wilma Message Search application provides high performance searching of the request-response pairs that were logged by Wilma application.
#Quick intro for end users ##Wilma application ####Requirements
- JRE 7
- The latest release of Wilma application downloaded and extracted into a folder.
####Running
java -jar wilma-x.y.z.jar wilma.conf.properties
##Wilma Message Search application ####Requirements
- JDK 7
- The latest release of Wilma Message Search application downloaded and extracted into a folder.
####Running
java -jar wilma-message-search-x.y.z.jar message.search.conf.properties
####Notes
- Running Wilma Message Search application is optional, Wilma itself does not require it.
- To run Wilma Message Search application, java JDK must be used. With JRE, it will not work properly.
- Wilma Message Search application must be started before any Wilma instance that provides messages for the search
#Quick intro for developers/contributors
####Requirements
- Java JDK 7 or 8
####Advised working environment
- IntelliJ / Eclipse
- Gradle, Checkstyle, Git Integration for the IDE
####Building with Gradle The project can be built by following the instructions described here. This way of build is recommended for contributors only, End-Users, please use the pre-built downloadable releases from here.
##Detailed information
- Check the Wiki and Issues link on GitHub
- Check further documentation at http://epam.github.io/Wilma/
In order to get the latest news, follow this project on GitHub.
Feel free to contribute (send pull request), or seek for assistance/advise, or discuss usage scenarios by joining to wilma-users mailing list.
Copyright 2013-2015 EPAM Systems
Wilma is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
Wilma is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with Wilma. If not, see http://www.gnu.org/licenses/.
##Contribution
There are three ways you can help us: