Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

Wilma

Wilma is a Service Virtualization tool, that combines the capabilities of a Service Stub and a HTTP/HTTPS Transparent Proxy. Its main purpose is to support development and testing applications/services/components those functionality relies/depends on another application/services/components that can be owned by you or can be owned by 3rd party as well. The selected architecture approach makes it capable to use it in unit, integration, functional, end-to-end, performance test environments and environments those contains microservices. It can be used for manual tests too. It is expandable easily via plugins and configurable on-the-fly. It is written in Java, and the solution consists of two standalone applications:

  • Wilma application is the highly configurable Service Virtualization tool
  • Wilma Message Search application (optional component) provides high performance searching capability of the request-response pairs that were logged by Wilma application.

WARNING!

Wilma is under mayor update (preparing V2.0) which means if you get the source and compile yourself, not all the functions might work! If you don't want to deal with broken features, always use the Released versions!

You must also should know that V1.6 release works reliable with HTTP only, since the supported HTTPS protocols (SSLv3, TLS1) become obsolete since the last release.

Quick intro for end users

Wilma application

Requirements

  • JRE 8 (pls use earlier Wilma releases than V1.6.x when you need to use Java 7 version)
  • The latest release of Wilma application downloaded and extracted into a folder.

Configuring Components/Services to use Wilma

The most simple way to do this is by configuring the Component/Service to use Wilma as HTTP(S) proxy. In case of Java components/services, this can be done by adding a few VM arguments to the run configuration:

JAVA_PROXY_FLAGS=-Dhttp.proxyHost=[wilma-url] -Dhttp.proxyPort=[wilma-proxy-port] -Dhttps.proxyHost=[wilma-url] -Dhttps.proxyPort=[wilma-proxy-port]
java ${JAVA_PROXY_FLAGS} ...

Configure and run Wilma

To run Wilma with simplest configuration, just download the release, extract it and run: java -jar wilma-x.y.z.jar wilma.conf.properties

See this page for more detailed information on how to configure Wilma, and Component/Service that uses Wilma.

Docker Image of Wilma

  • Docker image of Wilma is available on DockerHub, see details here

Contact, questions and answers

In order to get the latest news, follow this project on GitHub. The latest documentation can be found at http://epam.github.io/Wilma/. Feel free to seek for assistance/advise, or discuss usage scenarios by submitting new Issue on GitHub or by joining to wilma-users mailing list.

Wilma Message Search application

  • Running Wilma Message Search application is optional, Wilma itself does not require it.
  • This optional component just makes your life easier in case you would like to run quick searches on the messages logged by Wilma.
  • To run Wilma Message Search application, java JDK must be used. With JRE, it will not work properly.
  • Docker image of combined Wilma and Wilma Message Search application is available on DockerHub, see details here

Requirements

  • JDK 8 (pls use earlier Wilma releases than V1.6.x when you need to use Java 7 version)
  • 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

Quick intro for developers/contributors

There are several ways you can help us:

  • Raise an issue. Have you found something that does not work as expected? Let us know about it.
  • Suggest a feature by submitting an issue or by sending an e-mail to us. It's even better if you come up with a new feature and write us about it.
  • Write some code. We would love to see pull requests to this tool. Feel free to contribute (send pull request) on GitHub.

Advised working environment

  • Java JDK 8
  • 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, or use the docker image.

Build Status Quality Gate Status

Detailed information

License - GPLv3.0

Copyright since 2013 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/.

You can’t perform that action at this time.