Apache Daffodil™ Extension for Visual Studio Code

Clone this repo:
  1. c28054e Bump concurrently from 9.2.0 to 9.2.1 by dependabot[bot] · 4 days ago main
  2. b3e25a9 update stopDebugging to kill terminals based on name by DuBois Ford · 7 days ago
  3. f0d6944 closes #100 \n Updated readme file to remove development documentation as this page will show up on extenstion market place. Added Changelog.md file. by Hitesh Dalsania · 3 weeks ago
  4. 7f986b9 Bump actions/checkout from 4.2.2 to 5.0.0 by dependabot[bot] · 9 days ago
  5. 6bf92be Bump mini-css-extract-plugin from 2.9.2 to 2.9.4 by dependabot[bot] · 9 days ago

Apache Daffodil

Apache Daffodil™ Extension for Visual Studio Code

CI Nightly Tests

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.

DFDL is a data modeling language used to describe file formats. The DFDL language is a subset of eXtensible Markup Language (XML) Schema Definition (XSD). File formats are rich and complex - they require a modeling language to describe them. Developing DFDL Schemas can be challenging, requiring extensive iterative development and testing.

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™.

DFDL Schema Development

image

The Apache Daffodil™ Extension for Visual Studio Code provides syntax highlighting to enhance the readability and context of the text. It provides instant feedback to developers, indicating that 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, developer memorization, and typos.

Daffodil Data Parse Debugger

image 2

The Apache Daffodil™ Extension for Visual Studio provides a Daffodil parse debugger, enabling developers 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.

Data Editor

image 3

The Apache Daffodil™ Extension for Visual Studio Code provides an integrated data editor 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 enables the editing of single or multiple bytes in various 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.

Data Debugger Integration

image

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 at a breakpoint, the data content within the Data Editor will illustrate the byte location.

Prerequisites

Getting Help

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).

Community Feedback

image 5

Apache Daffodil™ and the Apache Daffodil™ Extension for Visual Studio Code are Apache Software Foundation (ASF) projects, are free open-source software, and are under active development. Feedback and contributions are welcome.

Additional Resources

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.

Legal

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.

Footnotes

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 © 2025 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.