Testing Waton

Testing Waton#

Unit tests#

Run complete unit suite:

python -m pytest tests/unit -q

Run a focused area:

python -m pytest tests/unit/test_messages.py -q
python -m pytest tests/unit/test_client.py -q
python -m pytest tests/unit/test_dashboard.py -q
python -m pytest tests/unit/test_app.py -q

Live reliability check#

Run the integrated reliability probe:

python scripts/live_check.py --auth-db waton_live.db --test-jid 628123456789@s.whatsapp.net --test-text "hello from waton"

This validates:

  1. connect + auth,

  2. ping/iq response,

  3. optional send + ack,

  4. close + reconnect.

Release preflight#

python scripts/preflight_check.py

Faster local gate:

python scripts/preflight_check.py --skip-lint --skip-typecheck

Docs verification#

Run strict docs build (fails on warnings):

python -m pip install .[docs]
python -m sphinx -W --keep-going -b html docs/source docs/build/html

Windows editable install lock issue#

If editable install fails with:

  • failed to copy ... waton\_crypto.pyd

  • os error 32 (file being used by another process)

close running Waton Python sessions first:

Get-CimInstance Win32_Process -Filter "name='python.exe'" `
  | Where-Object { $_.CommandLine -match 'examples/cli_chat.py|examples/live_connect.py' } `
  | ForEach-Object { Stop-Process -Id $_.ProcessId -Force }

Then rerun:

python -m pip install -e .[dashboard]
Contents