mirror of
https://github.com/l0ng-ai/openidea.git
synced 2026-11-18 16:08:55 +00:00
views.open-diff takes exactly two texts, so a plugin could not tell the IDE that a file does not exist on one side, and the diff drew an empty pane next to it. API 1.10 adds views.open-file-diff with a file-diff record whose left / right are option<string> (none: the file does not exist there; both none is invalid); the SDK adds host::open_file_diff with a mock, and web views may send null for a missing side. A missing side maps to the same absent text side the VCS diffs use, so the existing side shows alone. open-diff and content-diff are unchanged. The WIT package, ENGINE_VERSION and API_VERSION move to 1.10.0, with the checked-in components rebuilt. Closes #3780 Co-authored-by: bertyhell <1710840+bertyhell@users.noreply.github.com>
94 lines
4.3 KiB
Plaintext
94 lines
4.3 KiB
Plaintext
package openidea:plugin@1.10.0;
|
|
|
|
/// Launches this plugin's configurations in the invoking window's Run tool window.
|
|
interface run {
|
|
use types.{error};
|
|
/// Starts an owned configuration, appending args. Debug requires a debugger.
|
|
/// Only from a window command/event. The returned id receives run-exited.
|
|
start: func(config: string, args: list<string>, debug: bool) -> result<string, error>;
|
|
}
|
|
|
|
/// Optional dynamic configurations, refreshed alongside run detectors.
|
|
interface run-configurations {
|
|
/// A configuration running an approved process in the project sandbox.
|
|
record run-configuration {
|
|
id: string,
|
|
name: string,
|
|
program: string,
|
|
args: list<string>,
|
|
cwd: option<string>,
|
|
test: bool,
|
|
framework: option<string>,
|
|
}
|
|
/// Returns the complete set for this project root.
|
|
configurations: func(project-root: string) -> list<run-configuration>;
|
|
}
|
|
|
|
/// Optional dynamic configurations with an environment and a debugger (API 1.9).
|
|
/// When a plugin exports both, the IDE uses this one instead of `run-configurations`.
|
|
interface launch-configurations {
|
|
use types.{extension};
|
|
/// A process the run starts, to attach the debugger to.
|
|
record attach-child {
|
|
/// Its debugger, as in Attach to Process: `dotnet`, `node`, `python`, `go` or `native`.
|
|
kind: string,
|
|
/// Only a process whose command line contains this text.
|
|
command-contains: option<string>,
|
|
}
|
|
/// How Debug starts the configuration.
|
|
variant debugger {
|
|
/// Starts `program` under the debugger of this language id (its `[debugger]`), e.g. `python`.
|
|
launch(string),
|
|
/// Runs the configuration as Run does, then attaches to the first matching process the
|
|
/// run starts (it waits for one up to 60 seconds).
|
|
attach-child(attach-child),
|
|
/// Later kinds; this IDE treats the configuration as having no debugger.
|
|
other(extension),
|
|
}
|
|
/// `run-configuration` with an environment and a debugger.
|
|
record launch-configuration {
|
|
id: string,
|
|
name: string,
|
|
program: string,
|
|
args: list<string>,
|
|
cwd: option<string>,
|
|
test: bool,
|
|
framework: option<string>,
|
|
/// Variables added to the run's environment (at most 64). A name the IDE's own
|
|
/// environment already has, such as `PATH`, is refused like in `process`.
|
|
env: list<tuple<string, string>>,
|
|
/// None: Debug infers the debugger from a source file in `args`, as before.
|
|
debugger: option<debugger>,
|
|
}
|
|
/// Returns the complete set for this project root.
|
|
configurations: func(project-root: string) -> list<launch-configuration>;
|
|
}
|
|
|
|
/// Optional parser for test configurations whose framework is plugin.
|
|
interface test-results {
|
|
use types.{location, extension};
|
|
/// A suite or test; parents must precede children and ids remain stable for a run.
|
|
record test-start { id: string, parent: option<string>, name: string, location: option<location> }
|
|
/// A successful test and optional elapsed milliseconds.
|
|
record test-passed { id: string, duration-ms: option<u32> }
|
|
/// A failed test, comparison and optional declaration location.
|
|
record test-failed {
|
|
id: string, duration-ms: option<u32>, message: string,
|
|
expected: option<string>, actual: option<string>, location: option<location>,
|
|
}
|
|
/// A skipped test and its explanation.
|
|
record test-skipped { id: string, reason: option<string> }
|
|
/// Output attached to a test or suite.
|
|
record test-output { id: string, text: string }
|
|
/// Incremental updates to the IDE's test tree. Unknown extensions are ignored.
|
|
variant test-event {
|
|
suite-started(test-start), test-started(test-start), passed(test-passed),
|
|
failed(test-failed), skipped(test-skipped), output(test-output), other(extension),
|
|
}
|
|
/// Parses one bounded output batch; failures fall back to built-in parsers.
|
|
parse: func(config: string, chunk: string) -> list<test-event>;
|
|
/// Selects test-tree name paths (parents then test), using the same config id as parse.
|
|
/// Returns the full replacement argument list, or none when filtering is unsupported.
|
|
select-tests: func(config: string, tests: list<list<string>>) -> option<list<string>>;
|
|
}
|