Provide additional workspace API (read / write)

[ejizba]

Today I can call vscode.openFolder to open a folder programmatically:

vscode.commands.executeCommand("vscode.openFolder", vscode.Uri.file(path), false);

However, I would like to be able to do the same thing with the new multi-root workspace and just add a folder to the workspace. Something like this, but where I can pass in a Uri

For more context on our scenario, see @chrisdias's comments on this issue: #13807

NOTE: We realize such a command might restart the extension host, but we don't care if that happens.

[bpasero]

fyi @jrieken @sandy081 I guess eventually it would make sense to expose some kind of workspace editing API to extensions.

[jrieken]

I like, tho the weird thing we need to communicate is that calling such API might restart the extension itself

[ejizba]

The 'openFolder' api has the same behavior and just includes this in the description:

Open a folder in the current window or new window depending on the newWindow argument. Note that opening in the same window will shutdown the current extension host process and start a new one on the given folder unless the newWindow parameter is set to true.

[bpasero]

This landed as workspace.addWorkspaceFolder and workspace.removeWorkspaceFolder.

[bpasero]

@stef-levesque no, closing a workspace is currently not closing any documents.

[ejizba]

@bpasero any update on this? I see the api was removed because of #37301, but we don't need all of the functionality listed in that. We just want a single command to add a folder to a workspace. If 'remove' and 'insert' are blocking 'add', can we save those for later?

[bpasero]

@EricJizbaMSFT no update so far other than this is "on deck" so it will happen eventually. Please talk to @egamma or @kieferrm to put some pressure on this if this must happen at a specific time and thus have it planned for an iteration.

[bpasero]

@EricJizbaMSFT can you share more details on your scenario of adding a workspace folder from an extension?

[chrisdias]

azure function extension is a good example, it lets you create a new Azure Function "project", which is really just a folder.

So, imagine I have a folder open, my web app called "stickerApp". It could be the only folder open, or it could be a part of a workspace.

With the Azure Functions extension I choose to "Create a new Azure Function Project" from the command palette or the explorer commands.

This command first prompts me for the folder location in which to scaffold the project:

I choose Browse... and get the folder picker:

And I pick some new folder called stickerFunctions

The func cli then scaffolds out the new sticker function in the stickerFunctions folder.

At this point I probably want to start working on this function. Ideally it would be added to the explorer as a second top level root node: