test/README.test

   1 Wireshark Tests
   2
   3 The recommended steps to prepare for and to run tests:
   4
   5 * Install two Python packages, pytest: `pip install pytest pytest-xdist`
   6 * Build programs (“wireshark”, “tshark”, etc.): `ninja`
   7 * Build additional programs for the “unittests” suite: `ninja test-programs`
   8 * Run tests in the build directory: `pytest`
   9
  10 Replace `ninja test-programs` by `make test-programs` as needed.
  11
  12 See the “Wireshark Tests” chapter of the Developer's Guide for details:
  13 https://www.wireshark.org/docs/wsdg_html_chunked/ChapterTests.html
  14
  15 If you need to update the baseline files use the following commands (on a Linux or macOS system)
  16 TZ=UTC WIRESHARK_RUN_FROM_BUILD_DIRECTORY=1 build/run/tshark --global-profile -T ek -r test/captures/dhcp.pcap > test/baseline/dhcp.ek
  17 TZ=UTC WIRESHARK_RUN_FROM_BUILD_DIRECTORY=1 build/run/tshark --global-profile -T json -r test/captures/dhcp.pcap > test/baseline/dhcp.json
  18 TZ=UTC WIRESHARK_RUN_FROM_BUILD_DIRECTORY=1 build/run/tshark --global-profile -T json -o protocols.display_abs_time_ascii:ALWAYS -r test/captures/dhcp.pcap > test/baseline/dhcp-asctime.json
  19 TZ=UTC WIRESHARK_RUN_FROM_BUILD_DIRECTORY=1 build/run/tshark --global-profile -T jsonraw -r test/captures/dhcp.pcap > test/baseline/dhcp.jsonraw
  20 TZ=UTC WIRESHARK_RUN_FROM_BUILD_DIRECTORY=1 build/run/tshark --global-profile -T ek -r test/captures/dhcp.pcap -x > test/baseline/dhcp-raw.ek