rthomas320 commented on code in PR #1180: URL: https://github.com/apache/daffodil-vscode/pull/1180#discussion_r1983283077
########## DEVELOPMENT.md: ########## @@ -66,13 +243,238 @@ You can then take this .vsix file and install the extension into your vscode ins  +#### Automated Testing Suite + +The Apache Daffodil VS Code Extension comes with an automated test suite. Run it as follows: + +```shell +yarn test +``` + +##### Testing Against a Specific Version of VS Code + +By default, the test suite will use the earliest supported release of VS Code. To test against any _specific_ version of VS Code (in this example, VS Code version 1.74.3), execute the test suite as follows, setting `DAFFODIL_TEST_VSCODE_VERSION` to the desired version: + +```shell +DAFFODIL_TEST_VSCODE_VERSION=1.74.3 yarn test +``` + +Set `DAFFODIL_TEST_VSCODE_VERSION` to `stable` to use the latest stable release, or to `insiders` to use the latest (nightly) insiders build. + + +### Debugging the Extension + +Create a `sampleWorkspace` folder in the folder one level higher than where `daffodil-vscode` currently resides. For example, if you have your `daffodil-vscode` folder stored in a folder called repos, then make a folder in repos called `sampleWorkspace`. + + + +It’s advised to copy sample data files and sample DFDL schemas (.dfdl.xsd) in here. You can find DFDL schemas at [DFDL Schemas for Commercial and Scientific Data Formats](https://github.com/DFDLSchemas). + +Optional: If you would like to recompile the code when you're editing, run `yarn watch` before following the next steps. More information is outlined in [Automatically Recompile Code When it Changes](#automatically-recompile-code-when-it-changes) Review Comment: Pressing the button to start debugging automatically runs "yarn run watch" which will re-compile any changes as they are made. However for the changes to take affect you usually have to stop and restart debugging. I'm not sure if "Optional" is still talking about debugging. -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
