Build & test

How contributors build the library and run user-mode protocol tests. Product integrators only need Build.

Build the library

pwsh -NoLogo -NoProfile -File .\tools\build-lib.ps1
pwsh -NoLogo -NoProfile -File .\tools\build-lib.ps1 -Configuration Debug -Platform x64
msbuild wknet.sln /m /restore /p:Configuration=Debug /p:Platform=x64

Use pwsh. Debug/Release treat warnings as errors.

Output: src/wknetlib/<Platform>/<Configuration>/wknetlib.lib.

User-mode protocol tests

Build and run each suite through tools/build-tests.ps1:

pwsh -NoLogo -NoProfile -File .\tools\build-tests.ps1 -Test http_parser_tests -Run
pwsh -NoLogo -NoProfile -File .\tools\build-tests.ps1 -Test http_chunked_decoder_tests -Run
pwsh -NoLogo -NoProfile -File .\tools\build-tests.ps1 -Test websocket_frame_tests -Run
pwsh -NoLogo -NoProfile -File .\tools\build-tests.ps1 -Test websocket_client_tests -Run
pwsh -NoLogo -NoProfile -File .\tools\build-tests.ps1 -Test sse_parser_tests -Run
pwsh -NoLogo -NoProfile -File .\tools\build-tests.ps1 -Test sse_client_tests -Run
pwsh -NoLogo -NoProfile -File .\tools\build-tests.ps1 -Test http2_frame_tests -Run
pwsh -NoLogo -NoProfile -File .\tools\build-tests.ps1 -Test hpack_tests -Run
pwsh -NoLogo -NoProfile -File .\tools\build-tests.ps1 -Test http2_client_tests -Run
pwsh -NoLogo -NoProfile -File .\tools\build-tests.ps1 -Test tls_crypto_tests -Run
pwsh -NoLogo -NoProfile -File .\tools\build-tests.ps1 -Test tls_handshake_tests -Run
pwsh -NoLogo -NoProfile -File .\tools\build-tests.ps1 -Test tls_record_tests -Run
pwsh -NoLogo -NoProfile -File .\tools\build-tests.ps1 -Test tls_interop_matrix_tests -Run
pwsh -NoLogo -NoProfile -File .\tools\build-tests.ps1 -Test http_api_tests -Run
pwsh -NoLogo -NoProfile -File .\tools\build-tests.ps1 -Test high_level_api_tests -Run

Regression group (includes SSE):

pwsh -NoLogo -NoProfile -File .\tools\run-http3-test-suite.ps1 -Group Regression

Built binaries also run from .\tests\out\bin\<name>.exe.

Local TLS interop

pwsh -NoLogo -NoProfile -File .\tests\integration\tls_matrix.ps1 -Configuration Debug -Platform x64

Uses only 127.0.0.1; SKIPs cleanly when OpenSSL/BoringSSL is missing.

Do not use tests/integration/https_smoke.ps1 as a regular path (it may hang in some environments).

Samples and API regression

Path	Purpose
src/wknettest/samples/HighLevelApiSamples.cpp	Product API scenarios (includes SSE fake-transport sample)
src/wknettest/samples/AdvancedScenarioSamples.cpp	Edge and error paths
tests/high_level_api_tests.cpp	User-mode API regression
tests/sse_parser_tests.cpp	SSE parser
tests/sse_client_tests.cpp	SSE client + reconnect

Test hooks: Internals. Trace check:

pwsh -NoLogo -NoProfile -File .\tools\check-trace-events.ps1