Google Git
Sign in
apache / daffodil-vscode / df66eabd94ca39311d36fe699494ebcc90822e9c
commitdf66eabd94ca39311d36fe699494ebcc90822e9c[log] [tgz]
authorShane Dell <shanedell100@gmail.com>Fri Jan 26 11:58:40 2024 -0500
committerShane Dell <32347414+shanedell@users.noreply.github.com>Tue Jan 30 11:10:36 2024 -0500
tree4e4ac519949c1bdc05c57161b23afd1e28bd0f55
parent1bb233b20629bd759933e00b2b0c7cbddfcbd144 [diff]
Change daffodilDebugClasspath to array of string instead of string

- This helps prevent issues where users might not be aware to use : for mac/linx and ; for windows.
- Update launch wizard to work properly with an array of strings instead of string.
- Update some other code to not try to split the daffodilDebugClasspath.
- When the classpath is passed to the debugger we join the array of string by either : or ; based on the OS.
- Allow rootName and rootNamespace to be null and allow null to be passed between TS and Scala.
  - Both also default to null.
  - Update properties of schema to require the path and define path, rootName and rootNamespace as properties.

Closes #934
13 files changed
tree: 4e4ac519949c1bdc05c57161b23afd1e28bd0f55
  1. .github/
  2. .vscode/
  3. build/
  4. debugger/
  5. doc/
  6. images/
  7. language/
  8. project/
  9. src/
  10. webpack/
  11. .asf.yaml
  12. .gitignore
  13. .prettierignore
  14. .prettierrc
  15. .scalafmt.conf
  16. build.sbt
  17. DEVELOPMENT.md
  18. generate_file.py
  19. LICENSE
  20. NOTICE
  21. package.json
  22. README.md
  23. tsconfig.json
  24. 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 and unzip it
    • Install dependencies
    • Compiles Extension
    • Packages Extension
    • Creates Files
      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.

This product includes the Regular Mono RedHatFont font, which is licensed under the SIL Open Font License, Version 1.1.

This product includes the space-grotesk font, which is licensed under the SIL Open Font License, Version 1.1.