wiresham

Simple TCP service mocking tool for replaying Wireshark captured service traffic

License	The Apache License, Version 2.0
Categories	Wire Data Data Structures
GroupId	us.abstracta
ArtifactId	wiresham
Last Version	0.6
Release Date	Mar 1, 2021
Type	jar
Description	wiresham Simple TCP service mocking tool for replaying Wireshark captured service traffic
Project URL	https://github.com/abstracta/wiresham
Source Code Management	https://github.com/abstracta/wiresham/tree/master

Download wiresham

Filename	Size
wiresham-0.6.pom
wiresham-0.6.jar	21 KB
wiresham-0.6-standalone.jar	5 MB
wiresham-0.6-sources.jar	12 KB
wiresham-0.6-javadoc.jar	63 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/us.abstracta/wiresham/ -->
<dependency>
    <groupId>us.abstracta</groupId>
    <artifactId>wiresham</artifactId>
    <version>0.6</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/us.abstracta/wiresham/
implementation 'us.abstracta:wiresham:0.6'

Gradle Kotlin

// https://jarcasting.com/artifacts/us.abstracta/wiresham/
implementation ("us.abstracta:wiresham:0.6")

Apache Buildr

'us.abstracta:wiresham:jar:0.6'

Apache Ivy

<dependency org="us.abstracta" name="wiresham" rev="0.6">
  <artifact name="wiresham" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='us.abstracta', module='wiresham', version='0.6')
)

Scala SBT

libraryDependencies += "us.abstracta" % "wiresham" % "0.6"

Leiningen

[us.abstracta/wiresham "0.6"]

Dependencies

compile (8)

Group / Artifact	Type	Version
org.slf4j : slf4j-api	jar	1.7.30
ch.qos.logback : logback-classic	jar	1.2.3
com.google.guava : guava	jar	29.0-jre
org.yaml : snakeyaml	jar	1.26
com.fasterxml.jackson.core : jackson-databind	jar	2.11.2
args4j : args4j	jar	2.33
org.pcap4j : pcap4j-core	jar	1.8.2
org.pcap4j : pcap4j-packetfactory-static	jar	1.8.2

test (1)

Group / Artifact	Type	Version
org.junit.jupiter : junit-jupiter-engine	jar	5.6.2

Project Modules

There are no modules declared in this project.

Simple TCP mocking tool for replaying tcpdump or Wireshark captured service or client traffic.

If you like this project, please give it a star ⭐ ! This helps the project be more visible, gain relevance and encourages us to invest more effort in new features.

Description

This project is inspired in other tools like WireMock, mountebank and MockTCPServer, but provides following features that are partially supported by listed tools:

• TCP mocking support, with async messages sent (i.e: allows sending welcome messages which are not supported by mountebank).
• Load mocking specification from tcpdump .pcap or Wireshark .json dump files and provides a reduced .yaml format for easy versioning.
• Allows to easily run the mock embedded in Java projects for easy testing
• Allows both mocking servers and clients.

Take into consideration that this tool is very simple, and only replays TCP traffic that has previously been recorded, so if user (or server) interacts with the tool in unexpected ways, then the mock will not answer until next expected packet is received. For more complex scenarios consider using one of previously mentioned tools.

Usage

This tool (as previously listed ones) is particularly useful to implement integration tests without the hassle of flaky connections, or complex environment setup or restrictions (VPN, quotas, etc).

Note: If you use .pcap, since Wiresham uses pcap4j for .pcap files support, you need to install libpcap or winpcap as detailed in pcap4j website.

The general use case for the tool takes following steps:

1. User captures traffic with tcpdump (with something like tcpdump port 23 -w ~/traffic.pcap) or Wireshark between a client application and a service.

2. If traffic has been captured with Wireshark then store the captured traffic, filtering with proper condition for service port, in a .json file (File -> Export Packet Dissections -> As JSON...)

3. At this point user might follow three potential courses:

   1. Start Wiresham in standalone mode with stored .pcap or .json and connect to it with the client application to reproduce previously stored traffic.

      E.g.: java -jar wiresham-standalone.jar -p 2324 -a 0.0.0.0 wireshark-dump.json

      Latest version of wiresham-standalone.jar can be downloaded from maven central.

      A similar example for a tcpdump traffic:

      E.g.: java -jar wiresham-standalone.jar -p 2324 -a 0.0.0.0 traffic.pcap

      Run java -jar wiresham-standalone.jar -h to get usage instructions and help.

   2. Same as previous one but start Wiresham in standalong mode to emulate a client application (instead of a service application):

   E.g.: java -jar wiresham-standalone.jar -t 0.0.0.0:23 -a 0.0.0.0 wireshark-dump.json

   Note that the only difference with previous example is the use of -t to specify target server address instead of the -p option to specify the local port.

   1. Convert the tcpdump or Wireshark dump to a reduced .yaml file (an example file can be found in simple.yaml), optionally manually tune it (response times or binary packets), add it to the project repository and implement tests using VirtualTcpService class or VirtualTcpClient class.

      To convert a script run something like java -jar wiresham-standalone.jar -d reduced-dump.yml -a 0.0.0.0 wireshark-dump.json.

      To add Wiresham as dependency in maven project include in pom.xml the dependency:

      <dependency>
       <groupId>us.abstracta</groupId>
       <artifactId>wiresham</artifactId>
       <version>0.1</version>
      </dependency>

      Check what is the latest version in releases

      Check VirtualTcpServiceTest and VirtualTcpClientTest for simple and raw examples on how to use the classes.

Build

In case you want to build this project from scratch, it is required JDK8+ and maven 3.3+.

Then just run mvn clean install and the library (and standalone version) will be built and installed in the local maven repository.

Release

To release the project, define the version to be released by checking included changes since last release and following semantic versioning. Then, create a release (including v as prefix of the version, e.g. v0.1), this will trigger a Travis build which will publish the jars to maven central repository (and make it general available to be used as maven dependency projects) in around 10 mins and can be found in maven central search after up to 2 hours.

Abstracta

Versions

Version
0.6 Mar 1, 2021
0.5 Feb 5, 2021
0.4.3 Jun 7, 2019
0.4.2 Nov 21, 2018
0.4.1 Nov 21, 2018
0.4 Sep 12, 2018
0.3 Aug 24, 2018
0.2.2 Aug 3, 2018
0.2.1 Jun 7, 2018
0.2 Jun 7, 2018
0.1 Jun 6, 2018