-
Notifications
You must be signed in to change notification settings - Fork 21
Home
The Apache Daffodil™ Extension for Visual Studio Code is an extension to the Microsoft® Visual Studio Code (VS Code) editor, designed for Data Format Description Language1 (DFDL) Schema developers. The purpose of the Apache Daffodil™ Extension for Visual Studio Code is to ease the burden on DFDL Schema developers by enabling rapid development of high-quality DFDL Schemas, with syntax highlighting, code completion, data file editing, and debugging of DFDL Schema parsing operations using Apache Daffodil™.
The Apache Daffodil™ Extension for Visual Studio Code provides syntax highlighting to improve the readability and context of the text and provide instant feedback to the developer indicating the structure and code are syntactically correct.
The Apache Daffodil™ Extension for Visual Studio Code provides code completion offering context-aware code segment predictions that can dramatically speed up DFDL Schema development by reducing keyboard input, memorization by the developer, and typos.
The Apache Daffodil™ Extension for Visual Studio provides a Daffodil parse debugger enabling the developer to control the execution of Daffodil parse operations. Given a DFDL Schema and a target data file, the developer can step through the execution of parse operations line by line, or until the parse reaches some developer-defined location, known as a breakpoint, in the DFDL Schema or the data being parsed. What is particularly helpful is that the developer can watch the parsed output, known as the “Infoset”, as it is being created by the parser, and watch where the parser is parsing in the data file. This enables the developer to quickly discover and correct DFDL Schema issues, making development and testing cycles more efficient.
The Apache Daffodil™ Extension for Visual Studio Code provides an integrated data editor that is tuned specifically for challenging Daffodil use cases. It is designed to support large files, of any type, that are well beyond the limits of the standard text editor in VS Code. The Data Editor allows for editing of single or multiple bytes in different encodings. The Data Editor can seek to file offsets, search and replace byte sequences, profile data, and determine a file's content type. Features of the Data Editor will evolve to address the specific needs of the Daffodil community.
The Data Editor component can be configured to run alongside and open the designated file specified by the data debugger. During this operation, whenever the debug session steps to a new byte position or stops from a breakpoint, the data content within the Data Editor will illustrate the byte location.
If additional help or guidance on using Apache Daffodil™, Apache Daffodil™ Extension for Visual Studio Code, or DFDL development in general is needed, please engage with the Daffodil user and developer communities on mailing lists (https://daffodil.apache.org/community/) and/or review the list archives (https://lists.apache.org/list.html?users@daffodil.apache.org).
Apache Daffodil™ and the Apache Daffodil™ Extension for Visual Studio Code are Apache Software Foundation (ASF) projects, are free open-source software, and under active development. Feedback and contributions are welcome.
- Apache Daffodil™ Home Page (https://daffodil.apache.org)
- Apache Daffodil™ Extension for Visual Studio Code Repository (https://github.com/apache/daffodil-vscode)
- Apache Daffodil™ Extension for Visual Studio Code Wiki (https://github.com/apache/daffodil-vscode/wiki)
- Apache Daffodil™ Library Repository (https://github.com/apache/daffodil)
Apache, Apache Feather Logo, Apache Daffodil, Daffodil, and the Apache Daffodil logo are trademarks of The Apache Software Foundation. Visual Studio Code, and VS Code are trademarks of Microsoft® Corporation. All rights reserved.
1 Data Format Description Language (DFDL) is a standard from the Open Grid Forum (www.ogf.org), available here (https://ogf.org/documents/GFD.240.pdf).
Copyright © 2023 The Apache Software Foundation. Licensed under the Apache License, Version 2.0.
Apache, Apache Daffodil, Daffodil, and the Apache Daffodil logo are trademarks of The Apache Software Foundation.