TESTING.rst

Testing Setup

virtualenv venv
pip install -e .[dev]

# Make the virtualenv Python a real file rather than a symlink
[ -L "venv/bin/python" ] && cp --remove-destination "$(readlink "venv/bin/python")" "venv/bin/python"

# Give the virtualenv Python CAP_NET_RAW
sudo setcap CAP_NET_RAW+ep venv/bin/python

# Configure the dummy0 interface
sudo ip link add dummy0 type dummy # Skip on WSL2, it has a pre-created dummy0
sudo ip link set dummy0 up
sudo ip addr add 172.27.224.1 dev dummy0

Run pytest with --interface=<iface>, e.g. --interface=dummy0

Coverage

1. Uncomment define_macros=[("CYTHON_TRACE_NOGIL", 1)], & compiler_directives={'linetrace': True}, in setup.py.
2. Rebuild. (May have to manually delete cypcap.c)

VS Code

.vscode/setting.json:

{
    "python.testing.pytestArgs": [
        "--interface=dummy0"
    ],
    "python.testing.unittestEnabled": false,
    "python.testing.pytestEnabled": true,
}

(You can of course add any other pytest flag you want)