Skip to content

docs: replace misleading TODO comments on disabled tests with clear explanations#79

Open
nightness wants to merge 2 commits intowebrtc-rs:masterfrom
Brainwires:docs/disabled-test-explanations
Open

docs: replace misleading TODO comments on disabled tests with clear explanations#79
nightness wants to merge 2 commits intowebrtc-rs:masterfrom
Brainwires:docs/disabled-test-explanations

Conversation

@nightness
Copy link
Copy Markdown

Summary

Several #[ignore] tests had misleading TODO comments suggesting they just needed more work, when in reality they require live infrastructure (STUN/TURN servers, real network) that isn't available in CI. This replaces those with clear comments explaining exactly why each test is disabled and what would be needed to re-enable it.

  • candidate_relay_test and candidate_server_reflexive_test: document that a live TURN/STUN server is required
  • Various peer-connection integration tests: replace // TODO with // Disabled: requires live network / STUN server

Test plan

  • No functional changes — docs/comments only
  • cargo test still passes (tests remain ignored)

nightness and others added 2 commits April 1, 2026 11:39
…lexive_test are disabled

Both test files exist but reference turn::auth / turn::server / turn::relay APIs from a
different TURN library than rtc-turn. Enabling them requires porting to the rtc-turn API.
Replace the misleading //TODO comments with a clear explanation.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…xplanations

Five test locations had //TODO or /* TODO: */ markers implying they just needed
uncommenting. Investigation shows none can be trivially enabled:

- sdp/mod.rs: sdp_test.rs imports crate::api::APIBuilder which belongs to the
  old async API and does not exist in this sans-IO crate.
- configuration/mod.rs: test_configuration_json is Go source code, never ported.
- configuration/media_engine.rs: media_engine_test.rs does not exist.
- rtc-ice/src/candidate/mod.rs: relay/srflx tests use turn::auth/turn::server APIs
  from a different TURN library than rtc-turn (done in previous commit).

Replace all with accurate comments so future contributors know what work is needed.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant