blob: 2ab657faf5b34cb81ae09eba587caac8c311c855 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
|
/*---------------------------------------------------------------------------------------------
* Copyright (c) Microsoft Corporation. All rights reserved.
* Licensed under the MIT License. See License.txt in the project root for license information.
*--------------------------------------------------------------------------------------------*/
import { IAction } from 'vs/base/common/actions';
import { Event } from 'vs/base/common/event';
import { IDisposable } from 'vs/base/common/lifecycle';
import { URI } from 'vs/base/common/uri';
import { ExtensionIdentifier } from 'vs/platform/extensions/common/extensions';
import { createDecorator } from 'vs/platform/instantiation/common/instantiation';
export interface ISelectedNotebooksChangeEvent {
notebook: URI;
oldKernel: string | undefined;
newKernel: string | undefined;
}
export interface INotebookKernelMatchResult {
readonly selected: INotebookKernel | undefined;
readonly suggestions: INotebookKernel[];
readonly all: INotebookKernel[];
}
export interface INotebookKernelChangeEvent {
label?: true;
description?: true;
detail?: true;
kind?: true;
supportedLanguages?: true;
hasExecutionOrder?: true;
}
export interface INotebookKernel {
readonly id: string;
readonly viewType: string;
readonly onDidChange: Event<Readonly<INotebookKernelChangeEvent>>;
readonly extension: ExtensionIdentifier;
readonly localResourceRoot: URI;
readonly preloadUris: URI[];
readonly preloadProvides: string[];
label: string;
description?: string;
detail?: string;
kind?: string;
supportedLanguages: string[];
implementsInterrupt?: boolean;
implementsExecutionOrder?: boolean;
executeNotebookCellsRequest(uri: URI, cellHandles: number[]): Promise<void>;
cancelNotebookCellExecution(uri: URI, cellHandles: number[]): Promise<void>;
}
export const enum ProxyKernelState {
Disconnected = 1,
Connected = 2,
Initializing = 3
}
export interface INotebookProxyKernelChangeEvent extends INotebookKernelChangeEvent {
connectionState?: true;
}
export interface ISourceAction {
readonly action: IAction;
readonly onDidChangeState: Event<void>;
execution: Promise<void> | undefined;
runAction: () => Promise<void>;
}
export interface INotebookTextModelLike { uri: URI; viewType: string }
export const INotebookKernelService = createDecorator<INotebookKernelService>('INotebookKernelService');
export interface INotebookKernelService {
_serviceBrand: undefined;
readonly onDidAddKernel: Event<INotebookKernel>;
readonly onDidRemoveKernel: Event<INotebookKernel>;
readonly onDidChangeSelectedNotebooks: Event<ISelectedNotebooksChangeEvent>;
readonly onDidChangeNotebookAffinity: Event<void>;
registerKernel(kernel: INotebookKernel): IDisposable;
getMatchingKernel(notebook: INotebookTextModelLike): INotebookKernelMatchResult;
/**
* Returns the selected or only available kernel.
*/
getSelectedOrSuggestedKernel(notebook: INotebookTextModelLike): INotebookKernel | undefined;
/**
* Bind a notebook document to a kernel. A notebook is only bound to one kernel
* but a kernel can be bound to many notebooks (depending on its configuration)
*/
selectKernelForNotebook(kernel: INotebookKernel, notebook: INotebookTextModelLike): void;
/**
* Set the kernel that a notebook should use when it starts up
*/
preselectKernelForNotebook(kernel: INotebookKernel, notebook: INotebookTextModelLike): void;
/**
* Bind a notebook type to a kernel.
* @param viewType
* @param kernel
*/
selectKernelForNotebookType(kernel: INotebookKernel, viewType: string): void;
/**
* Set a perference of a kernel for a certain notebook. Higher values win, `undefined` removes the preference
*/
updateKernelNotebookAffinity(kernel: INotebookKernel, notebook: URI, preference: number | undefined): void;
//#region Kernel source actions
readonly onDidChangeSourceActions: Event<void>;
getSourceActions(): ISourceAction[];
getRunningSourceActions(): ISourceAction[];
//#endregion
}
|