VS Code extension for expanding macros in Rust code. Enables macro expansion based on module, crate or any other parameters supported by the cargo-expand crate.
Requires that you have the following installed:
- cargo-expand A cargo crate for easier handling of compiler commands
- Rust nightly compiler, you can install it with
rustup toolchain install nightly
This extension offers 5 commands to handle various use cases when expanding macros in Rust code.
The commands are as follows (long version first followed by the short version):
Expand Macros,rustex: Expand macros in the current file. Tries to find the module in which the current file resides and expands the macros in it. If it doesn't exist defaults to crate expand.
Expand Macros
The following settings are available:
rustMacroExpand.displayWarnings: Specifies whether or not to display warnings in the generated output. Warnings will be displayed as a multiline comment at the top of the generated output.rustMacroExpand.notifyWarnings: Specifies whether or not to display warnings as an action in a notification. After expand has been completed, if there were any warnings you will get a notification with a button which upon click will display the warnings in a spearate window.rustMacroExpand.displayCargoCommand: Specifies whether or not to display in the generated output the command sent to cargo expand.rustMacroExpand.displayCargoCommandPath: Specifies whether or not to display in the generated output the folder in which the cargo expand command was executed.rustMacroExpand.displayTimestamp: Specifies whether or not to display the timestamp in the generated output.rustMacroExpand.expandOnSave: Specifies whether or not to refresh expanded files on save.
Contributions of any kind are welcome and encouraged.
Initial release of Rust Macro Expand