A VS Code extension that integrates the RTL Dependency Resolver, allowing you to analyze SystemVerilog/Verilog RTL files and generate a correctly ordered compilation list (src_files.list) directly from the editor.
Features
RTL File Discovery: Automatically finds all .v, .sv, and .svh files in the selected directory and its subdirectories.
Dependency Analysis: Parses RTL files to extract modules, interfaces, packages, imports, and includes.
Topological Sorting: Generates a src_files.list file with files ordered for correct compilation.
Cycle Detection: Identifies and reports circular dependencies.
Integrated Workflow: Seamlessly integrates with VS Code for easy access without leaving the editor.
Requirements
VS Code 1.110.0 or later
The extension bundles its own Python environment, so no additional Python installation is required.
How to Use
Install the Extension: Install TopoRTL from the VS Code Marketplace or by sideloading the .vsix file.
Open Your RTL Project: Open a workspace or folder containing your RTL source files in VS Code.
Run the Sort Command:
Open the Command Palette (Ctrl+Shift+P on Windows/Linux, Cmd+Shift+P on macOS).
Type and select TopoRTL: Sort.
A dialog will appear to select the RTL directory. Choose the root directory of your RTL project.
View Results: The extension will analyze the files and generate a src_files.list file in the selected directory. The output will be displayed in the "Testbench Assistant" output channel.
Extension Settings
This extension does not currently expose any user-configurable settings.
Known Issues
Ensure that the selected directory contains valid RTL files (.v, .sv, .svh).
The extension may take time to process large RTL projects.
Release Notes
0.0.1
Initial release
Basic RTL dependency resolution and file list generation
Following Extension Guidelines
This extension follows VS Code extension best practices. For more information, see the Extension Guidelines.
Working with Markdown
You can author your README using Visual Studio Code. Here are some useful editor keyboard shortcuts:
Split the editor (Cmd+\ on macOS or Ctrl+\ on Windows and Linux).
Toggle preview (Shift+Cmd+V on macOS or Shift+Ctrl+V on Windows and Linux).
Press Ctrl+Space (Windows, Linux, macOS) to see a list of Markdown snippets.
