Skip to main content

Crate sipx_testkit

Crate sipx_testkit 

Source
Expand description

Shared test machinery for the sipx workspace.

Provides an application-call harness with in-process SIP signalling, a seeded virtual-time transaction link, bounded RTP and realtime-peer fixtures, the RFC 4475 and RFC 5118 torture-message corpora and their harnesses, and a private certificate authority for TLS tests.

Published so downstream applications can use the same deterministic call surface as the workspace. The corpus and certificate modules are support utilities; call is the small, supported downstream call and RTP-echo harnesses.

§Stability

sipx is pre-1.0. Supported APIs are meant to be depended on and receive migration guidance for breaking changes; new enum variants and fields may still appear before 1.0. Experimental APIs may change shape without a migration note.

Supported: call, rtp_echo, link and time — the real application-call harness over socket-free SIP signalling, bounded RTP media peer, seeded fault link and nanosecond virtual clock. Experimental: realtime_peer, certificate, corpus, soak and transaction-sequence utilities; these primarily serve workspace verification and their shape follows those suites.

This is a test-product surface, not production application reachability. Its package metadata names the independently compiled rtp_echo example as the executable caller; the app-surface gate validates that target and import without admitting this crate’s dependencies into the production surface.

Modules§

call
Application-level and transaction-level call harnesses for downstream tests.
certs
A certificate authority the tests control.
link
A byte link between two stacks in one process, with faults you can turn on.
realtime_peer
A deterministic stand-in for the realtime agent endpoint.
rfc4475
The RFC 4475 SIP torture-test corpus.
rfc5118
The RFC 5118 IPv6 SIP torture-test corpus.
rtp_echo
A bounded RTP/PCMU echo peer for downstream media tests.
soak
Proving nothing grows without bound.
time
Virtual time for deterministic test drivers.
transaction_sequence
Structured event sequences for the transaction layer, and the invariants they are checked against.