Skip to content

Commit

Permalink
Start enforcing the tunnels API (#163187)
Browse files Browse the repository at this point in the history
* Start enforcing the tunnels API

* Fix API test
  • Loading branch information
alexr00 committed Oct 10, 2022
1 parent 96ee913 commit 23e6c03
Show file tree
Hide file tree
Showing 6 changed files with 19 additions and 31 deletions.
1 change: 1 addition & 0 deletions extensions/vscode-api-tests/package.json
Expand Up @@ -34,6 +34,7 @@
"taskPresentationGroup",
"terminalDataWriteEvent",
"terminalDimensions",
"tunnels",
"envShellEvent",
"testCoverage",
"testObserver",
Expand Down
3 changes: 2 additions & 1 deletion extensions/vscode-test-resolver/package.json
Expand Up @@ -6,7 +6,8 @@
"license": "MIT",
"enableProposedApi": true,
"enabledApiProposals": [
"resolvers"
"resolvers",
"tunnels"
],
"private": true,
"engines": {
Expand Down
1 change: 1 addition & 0 deletions extensions/vscode-test-resolver/tsconfig.json
Expand Up @@ -9,6 +9,7 @@
"include": [
"src/**/*",
"../../src/vscode-dts/vscode.d.ts",
"../../src/vscode-dts/vscode.proposed.tunnels.d.ts",
"../../src/vscode-dts/vscode.proposed.resolvers.d.ts"
]
}
6 changes: 3 additions & 3 deletions src/vs/workbench/api/common/extHost.api.impl.ts
Expand Up @@ -1010,7 +1010,7 @@ export function createApiFactoryAndRegisterActors(accessor: ServicesAccessor): I
return extHostFileSystemEvent.getOnWillRenameFileEvent(extension)(listener, thisArg, disposables);
},
openTunnel: (forward: vscode.TunnelOptions) => {
checkProposedApiEnabled(extension, 'resolvers');
checkProposedApiEnabled(extension, 'tunnels');
return extHostTunnelService.openTunnel(extension, forward).then(value => {
if (!value) {
throw new Error('cannot open tunnel');
Expand All @@ -1019,11 +1019,11 @@ export function createApiFactoryAndRegisterActors(accessor: ServicesAccessor): I
});
},
get tunnels() {
checkProposedApiEnabled(extension, 'resolvers');
checkProposedApiEnabled(extension, 'tunnels');
return extHostTunnelService.getTunnels();
},
onDidChangeTunnels: (listener, thisArg?, disposables?) => {
checkProposedApiEnabled(extension, 'resolvers');
checkProposedApiEnabled(extension, 'tunnels');
return extHostTunnelService.onDidChangeTunnels(listener, thisArg, disposables);
},
registerPortAttributesProvider: (portSelector: { pid?: number; portRange?: [number, number]; commandMatcher?: RegExp }, provider: vscode.PortAttributesProvider) => {
Expand Down
29 changes: 3 additions & 26 deletions src/vscode-dts/vscode.proposed.resolvers.d.ts
Expand Up @@ -43,7 +43,7 @@ declare module 'vscode' {
label: string;
}

export interface TunnelOptions {
interface TunnelOptions {
remoteAddress: { port: number; host: string };
// The desired local port. If this port can't be used, then another will be chosen.
localAddressPort?: number;
Expand All @@ -56,7 +56,7 @@ declare module 'vscode' {
protocol?: string;
}

export interface TunnelDescription {
interface TunnelDescription {
remoteAddress: { port: number; host: string };
//The complete local address(ex. localhost:1234)
localAddress: { port: number; host: string } | string;
Expand All @@ -69,7 +69,7 @@ declare module 'vscode' {
protocol?: string;
}

export interface Tunnel extends TunnelDescription {
interface Tunnel extends TunnelDescription {
// Implementers of Tunnel should fire onDidDispose when dispose is called.
onDidDispose: Event<void>;
dispose(): void | Thenable<void>;
Expand Down Expand Up @@ -164,29 +164,6 @@ declare module 'vscode' {
candidatePortSource?: CandidatePortSource;
}

export namespace workspace {
/**
* Forwards a port. If the current resolver implements RemoteAuthorityResolver:forwardPort then that will be used to make the tunnel.
* By default, openTunnel only support localhost; however, RemoteAuthorityResolver:tunnelFactory can be used to support other ips.
*
* @throws When run in an environment without a remote.
*
* @param tunnelOptions The `localPort` is a suggestion only. If that port is not available another will be chosen.
*/
export function openTunnel(tunnelOptions: TunnelOptions): Thenable<Tunnel>;

/**
* Gets an array of the currently available tunnels. This does not include environment tunnels, only tunnels that have been created by the user.
* Note that these are of type TunnelDescription and cannot be disposed.
*/
// export let tunnels: Thenable<TunnelDescription[]>;

/**
* Fired when the list of tunnels has changed.
*/
export const onDidChangeTunnels: Event<void>;
}

export interface ResourceLabelFormatter {
scheme: string;
authority?: string;
Expand Down
10 changes: 9 additions & 1 deletion src/vscode-dts/vscode.proposed.tunnels.d.ts
Expand Up @@ -12,6 +12,10 @@ declare module 'vscode' {
// The desired local port. If this port can't be used, then another will be chosen.
localAddressPort?: number;
label?: string;
/**
* @deprecated Use privacy instead
*/
public?: boolean;
privacy?: string;
protocol?: string;
}
Expand All @@ -20,6 +24,10 @@ declare module 'vscode' {
remoteAddress: { port: number; host: string };
//The complete local address(ex. localhost:1234)
localAddress: { port: number; host: string } | string;
/**
* @deprecated Use privacy instead
*/
public?: boolean;
privacy?: string;
// If protocol is not provided it is assumed to be http, regardless of the localAddress.
protocol?: string;
Expand Down Expand Up @@ -51,6 +59,6 @@ declare module 'vscode' {
/**
* Fired when the list of tunnels has changed.
*/
// export const onDidChangeTunnels: Event<void>;
export const onDidChangeTunnels: Event<void>;
}
}

0 comments on commit 23e6c03

Please sign in to comment.