IMSpector is a Python CLI for IMS/SIP smartphone conformance and differential testing.
It helps you:
- validate test suites defined in YAML
- run expected-response checks against one or more devices
- compare behavior between devices to catch interoperability differences
- switch transport backends without changing test logic
- Interface-first architecture: transport and message I/O are cleanly separated from test execution.
- YAML-driven workflows: test suites and runtime settings stay versioned and reproducible.
- Real + stub backends: use
stubfor offline deterministic runs orsip-proxy-httpfor live traffic. - Device discovery support: discover devices from SIP REGISTER flows when using
sip-proxy-http.
-
Create and activate a Python 3.10+ virtual environment.
-
Install dependencies:
pip install -r requirements.txt
-
Validate a test suite:
python main.py validate --test-config examples/test_suite_register.yaml
-
List available devices:
python main.py list-devices --runtime-config examples/runtime_stub.yaml
-
Run standard checks:
python main.py run-standard --test-config examples/test_suite_register.yaml --runtime-config examples/runtime_stub.yaml --device pixel_8
-
Run differential comparison:
python main.py compare --test-config examples/test_suite_register.yaml --runtime-config examples/runtime_stub.yaml --device pixel_8 --device galaxy_s24
validate: validate test suite YAML.list-devices: show configured and discovered devices.run-standard: run expected-response checks for selected devices.compare: run cross-device differential checks.live-edit-list: list activeims_proxylive-edit rules.live-edit-clear: clear activeims_proxylive-edit rules.
0: success2: configuration validation error10: standard run finished with at least one failed case11: differential run found differences
/docs/user-manual.md— end-to-end usage guide/docs/test-config.md— test suite schema/docs/runtime-config.md— runtime schema and transport config/docs/discovery-methods.md— device discovery methods/docs/http-sip-proxy.md— SIP proxy integration details/docs/test-program-architecture.md— architecture overview
/ims_tester/cli.py— command definitions and execution flow/ims_tester/engine.py— standard and differential test runners/ims_tester/adapters.py— pluggable transports and discovery adapters/ims_tester/config.py— YAML loading + validation/ims_tester/models.py— domain and report models/examples/— runnable sample configurations