Google Git
Sign in
apache / daffodil-vscode / 1df7e8a3bea1c9b6ea3a0391467b1c4b5f8678b9
commit1df7e8a3bea1c9b6ea3a0391467b1c4b5f8678b9[log] [tgz]
authorShane Dell <shanedell100@gmail.com>Fri May 05 12:19:36 2023 -0400
committerShane Dell <32347414+Shanedell@users.noreply.github.com>Tue May 09 12:48:26 2023 -0400
tree326482ff3e15a0f69bfff2eb70df3e6493905815
parent0195a88427a39452200cbc8c5eba81e7a9606d09 [diff]
Keep terminal open after debug ends

- Grab active terminal if its a daffodil-debugger named terminal, otherwise create a new one.
- Send command to run debugger to terminal.
- This allows for the terminal to stay open after the debugger exists.
- Allow for option to always create new terminal. This is mostly to support testing purposes.

Closes #614
3 files changed
tree: 326482ff3e15a0f69bfff2eb70df3e6493905815
  1. .github/
  2. .vscode/
  3. build/
  4. images/
  5. language/
  6. project/
  7. server/
  8. src/
  9. .asf.yaml
  10. .gitignore
  11. .prettierignore
  12. .prettierrc
  13. .scalafmt.conf
  14. build.sbt
  15. LICENSE
  16. NOTICE
  17. package.json
  18. README.md
  19. tsconfig.json
  20. yarn.lock
README.md

Apache Daffodil™ Extension for Visual Studio Code

CI Nightly Tests

This is an extension for Visual Studio Code (VS Code) which enables the interactive debugging of DFDL schema parsing using Apache Daffodil.

Build Requirements

Download

VS Code Marketplace

The easiest way to install the extension is through the VS Code Extension Marketplace. The steps are as follow:

  • Ctrl+P (windown/linux) OR Command+P (macos)
  • Type in ext install ASF.apache-daffodil-vscode, then hit Enter. This will begin installing the extension.

Prebuilt VSIX

If you wish to download the VSIX file instead, perhaps to install a previous version of the extension. The prebuilt VSIX files used to released the extension are available at Apache Daffodil VS Code Release Page. The steps are as follow:

  • Navigate to Apache Daffodil VS Code Release Page.
  • Click on a release version.
  • On the next page you will see Binaries click on the file listed to begin the download.
  • See the Installation From File section for installing the prebuilt file.

Package VSIX and Debugger

:exclamation:NOT necessary if using prebuilt VSIX:exclamation:

:exclamation:NOT necessary if running extension via VS Code without VSIX but a yarn install will be required:exclamation:

Run full package

yarn package
  • This command performs the following tasks:
    • Create sbt zip package
    • Install dependencies
    • Compiles Extension
    • Packages Extension
    • Creates Files
      server/core/target/universal/daffodil-debugger-*.zip
apache-daffodil-vscode-*.vsix

Running Debug Server

The debug server will automatically be run by the extension unless useExistingServer is to set to true inside of .vscode/launch.json

If you wish to run the debug server manually the scripts to do so are at the following locations:

  • Debugging through VS Code with or without VSIX:
    • Linux = /home/USERNAME/.local/share/daffodil-dap
    • Mac = /Users/USERNAME/Library/Application\ Support/daffodil-dap
    • Windows = C:\\Users\\USERNAME\\AppData\\Roaming\\daffodil-dap

Installation From File

Once you have either downloaded the VSIX file or created it, you can now install it. There are two options to do this:

  • Via “Extensions: Install from VSIX” command from within VS Code.

    • Open the Command Palette with Shift-Command-P (Mac) OR Shift-Ctrl-P (Windows/Linux)
    • Type vsix to bring up the command and pointing it at the vsix file

  • Via command line

    code --install-extension apache-daffodil-vscode-*.vsix

Usage

Please refer to the Wiki page at https://github.com/apache/daffodil-vscode/wiki

Getting Help

You can ask questions on the dev@daffodil.apache.org or users@daffodil.apache.org mailing lists. You can report bugs via GitHub Issues.

License

Apache Daffodil™ Extension for Visual Studio Code is licensed under the Apache License, v2.0.

This product includes the logback library, which is available under the Eclipse Public License v1.0.

This product includes the Java Debug Server for Visual Studio Code library, which is available under the Eclipse Public License v1.0.

This product includes the Xml Schema Object Model library, which is licensed under the Common Development and Distribution License Version 1.1.