Plugins get a host-owned WebSocket resource (net.websocket-connect → websocket with id/send/drain/close; dropping it closes the transport). The connection is bound to the project it was opened for, needs the endpoint's net:<host> grant, uses WSS outside loopback with the shared rustls config, and is capped at eight per plugin. Request headers (secret placeholders expanded) go with the handshake, except the ones the handshake owns; an empty subprotocol requests none; the handshake is bounded by the call's I/O budget. Incoming frames queue in a bounded FIFO, signalled by the websocket-ready event. Checked-in components are rebuilt for API 1.6. Co-authored-by: SorPuti <56741582+SorPuti@users.noreply.github.com>
test-runner — API 1.4 example
Put this directory on PATH before installing/granting the plugin, so
process:openidea-example-tests resolves to the included executable. Copy
example.tests to a trusted project. Its presence enables the dynamic
run-configurations export. Open it as plain text and click a gutter run
button, or use Example: Run Tests / the Run selector for all tests.
The gutter command appends the test name as a filter to run.start. The fake
executable prints a deliberately tiny start NAME / pass NAME protocol;
test-results.parse retains split lines and emits stable test ids. Replace
that protocol/parser and executable to integrate a real framework. This is an
API example for integrating a test framework.
Build from the repository root:
plugins/build.sh official/test-runner
cargo test --manifest-path plugins/official/test-runner/Cargo.toml
cargo run -p ide-host --bin openidea-plugin -- check plugins/official/test-runner
Install the built package folder through Settings › Plugins › Install from Disk. See the plugin guide and official/community policy.
test-results.select-tests returns the selected names as the complete argv for
openidea-example-tests, enabling Rerun Failed Tests and Run from the test tree.
It returns None for unknown configurations or paths this example cannot filter.