feat(tree-explorer): add insert document context menu action VSCODE-367

package.json

@@ -377,6 +377,10 @@
         "command": "mdb.refreshCollection",
         "title": "Refresh"
       },
+      {
+        "command": "mdb.insertDocumentFromTreeView",
+        "title": "Insert Document..."
+      },
       {
         "command": "mdb.refreshSchema",
         "title": "Refresh"
@@ -559,10 +563,15 @@
           "group": "2@1"
         },
         {
-          "command": "mdb.dropCollection",
+          "command": "mdb.insertDocumentFromTreeView",
           "when": "view == mongoDBConnectionExplorer && viewItem == collectionTreeItem",
           "group": "3@1"
         },
+        {
+          "command": "mdb.dropCollection",
+          "when": "view == mongoDBConnectionExplorer && viewItem == collectionTreeItem",
+          "group": "4@1"
+        },
         {
           "command": "mdb.searchForDocuments",
           "when": "view == mongoDBConnectionExplorer && viewItem == documentListTreeItem",
@@ -575,17 +584,24 @@
         },
         {
           "command": "mdb.viewCollectionDocuments",
-          "when": "view == mongoDBConnectionExplorer && viewItem == documentListTreeItem"
+          "when": "view == mongoDBConnectionExplorer && viewItem == documentListTreeItem",
+          "group": "1@1"
         },
         {
           "command": "mdb.refreshDocumentList",
-          "when": "view == mongoDBConnectionExplorer && viewItem == documentListTreeItem"
+          "when": "view == mongoDBConnectionExplorer && viewItem == documentListTreeItem",
+          "group": "1@2"
         },
         {
           "command": "mdb.searchForDocuments",
           "when": "view == mongoDBConnectionExplorer && viewItem == documentListTreeItem",
           "group": "2@1"
         },
+        {
+          "command": "mdb.insertDocumentFromTreeView",
+          "when": "view == mongoDBConnectionExplorer && viewItem == documentListTreeItem",
+          "group": "3@1"
+        },
         {
           "command": "mdb.refreshSchema",
           "when": "view == mongoDBConnectionExplorer && viewItem == schemaTreeItem"
@@ -760,6 +776,10 @@
           "command": "mdb.refreshDocumentList",
           "when": "false"
         },
+        {
+          "command": "mdb.insertDocumentFromTreeView",
+          "when": "false"
+        },
         {
           "command": "mdb.copyCollectionName",
           "when": "false"

src/commands/index.ts

@@ -54,6 +54,7 @@ enum EXTENSION_COMMANDS {
   MDB_VIEW_COLLECTION_DOCUMENTS = 'mdb.viewCollectionDocuments',
   MDB_REFRESH_COLLECTION = 'mdb.refreshCollection',
   MDB_REFRESH_DOCUMENT_LIST = 'mdb.refreshDocumentList',
+  MDB_INSERT_DOCUMENT_FROM_TREE_VIEW = 'mdb.insertDocumentFromTreeView',
   MDB_REFRESH_SCHEMA = 'mdb.refreshSchema',
   MDB_COPY_SCHEMA_FIELD_NAME = 'mdb.copySchemaFieldName',
   MDB_REFRESH_INDEXES = 'mdb.refreshIndexes',

src/editors/playgroundController.ts

@@ -19,6 +19,7 @@ import { LanguageServerController } from '../language';
 import playgroundCreateIndexTemplate from '../templates/playgroundCreateIndexTemplate';
 import playgroundCreateCollectionTemplate from '../templates/playgroundCreateCollectionTemplate';
 import playgroundCloneDocumentTemplate from '../templates/playgroundCloneDocumentTemplate';
+import playgroundInsertDocumentTemplate from '../templates/playgroundInsertDocumentTemplate';
 import {
   PlaygroundResult,
   ShellExecuteAllResult,
@@ -298,6 +299,17 @@ export default class PlaygroundController {
     return this._createPlaygroundFileWithContent(content);
   }
 
+  createPlaygroundForInsertDocument(
+    databaseName: string,
+    collectionName: string
+  ): Promise<boolean> {
+    const content = playgroundInsertDocumentTemplate
+      .replace('CURRENT_DATABASE', databaseName)
+      .replace('CURRENT_COLLECTION', collectionName);
+
+    return this._createPlaygroundFileWithContent(content);
+  }
+
   async createPlayground(): Promise<boolean> {
     const useDefaultTemplate = !!vscode.workspace
       .getConfiguration('mdb')

src/mdbExtensionController.ts

@@ -497,6 +497,17 @@ export default class MDBExtensionController implements vscode.Disposable {
         return Promise.resolve(true);
       }
     );
+    this.registerCommand(
+      EXTENSION_COMMANDS.MDB_INSERT_DOCUMENT_FROM_TREE_VIEW,
+      async (
+        documentsListTreeItem: DocumentListTreeItem | CollectionTreeItem
+      ): Promise<boolean> => {
+        return this._playgroundController.createPlaygroundForInsertDocument(
+          documentsListTreeItem.databaseName,
+          documentsListTreeItem.collectionName
+        );
+      }
+    );
     this.registerCommand(
       EXTENSION_COMMANDS.MDB_REFRESH_SCHEMA,
       (schemaTreeItem: SchemaTreeItem): Promise<boolean> => {

src/templates/playgroundInsertDocumentTemplate.ts

@@ -0,0 +1,13 @@
+const template = `// MongoDB Playground
+// Use Ctrl+Space inside a snippet or a string literal to trigger completions.
+
+// The current database to use.
+use('CURRENT_DATABASE');
+
+// Create a new document in the collection.
+db.getCollection('CURRENT_COLLECTION').insertOne({
+
+});
+`;
+
+export default template;

src/test/suite/mdbExtensionController.test.ts

@@ -1660,6 +1660,41 @@ suite('MDBExtensionController Test Suite', function () {
     assert.strictEqual(namespaceUsed, 'waffle.house');
   });
 
+  test('mdb.insertDocumentFromTreeView event should open a playground with an insert document template', async () => {
+    const collectionTreeItem = new CollectionTreeItem(
+      {
+        name: 'pineapple',
+        type: CollectionTypes.collection,
+      },
+      'plants',
+      {},
+      false,
+      false,
+      null
+    );
+
+    const mockCreatePlaygroundForInsertDocument = sinon.fake();
+    sinon.replace(
+      mdbTestExtension.testExtensionController._playgroundController,
+      'createPlaygroundForInsertDocument',
+      mockCreatePlaygroundForInsertDocument
+    );
+
+    await vscode.commands.executeCommand(
+      'mdb.insertDocumentFromTreeView',
+      collectionTreeItem
+    );
+    assert.strictEqual(mockCreatePlaygroundForInsertDocument.calledOnce, true);
+    assert.strictEqual(
+      mockCreatePlaygroundForInsertDocument.firstCall.args[0],
+      'plants'
+    );
+    assert.strictEqual(
+      mockCreatePlaygroundForInsertDocument.firstCall.args[1],
+      'pineapple'
+    );
+  });
+
   test('mdb.deleteDocumentFromTreeView should not delete a document when the confirmation is cancelled', async () => {
     const mockDocument = {
       _id: 'pancakes',