Visual Studio Code language support for AthenISA .athe assembly files.
Features
- Highlighting for instructions and pseudo-instructions
- Highlighting for sections, registers, numbers, labels, constants, data names, and symbols
- Line comments beginning with
; - Bracket and parenthesis matching
The extension recognizes registers from R0 to R7 and decimal, hexadecimal, and binary numbers.
Installation
When available from the Visual Studio Marketplace, install AthenISA Language Support from the Extensions view in Visual Studio Code.
To install a downloaded .vsix package, open the Extensions view, select Install from VSIX... from its actions menu, and choose the package. It can also be installed from a terminal:
code --install-extension athenisa-language-0.1.0.vsix
Once installed, the extension is automatically enabled for every .athe file. It can be enabled, disabled, or uninstalled from the Extensions view like any other Visual Studio Code extension.
[!NOTE] Extensions installed manually from a VSIX package do not receive automatic Marketplace updates.
Development
Test locally
Launch a separate Visual Studio Code window with the local extension enabled:
code --extensionDevelopmentPath=/path/to/athenisa/vscode /path/to/program.athe
After changing the grammar, run Developer: Reload Window from the Command Palette in the development window. Use Developer: Inspect Editor Tokens and Scopes to inspect the highlighting assigned to a token.
Build a VSIX package
Node.js and npm are only required to package or publish the extension. From the vscode directory, run:
npx @vscode/vsce package
For version 0.1.0, this creates athenisa-language-0.1.0.vsix. Update the version field in package.json before creating a new release.
To reinstall a rebuilt package with the same version, use:
code --install-extension athenisa-language-0.1.0.vsix --force
Publish
Publishing to the Visual Studio Marketplace requires a Marketplace publisher matching the publisher field in package.json:
npx @vscode/vsce publish
Alternatively, the generated .vsix can be attached to a GitHub Release for manual installation.