kick-assembler-vscode-ext

A Kick Assembler extension for VSCode.

This extension is a work in progress and many features are not completed, and some might even be broken.

Feature Summary

• build, run and debug commands
• support for emulators like VICE and the C64Debugger
• auto completion (intellisense)
• syntax highlighting
• error checking
• hover Support
• code outline
• code snippets

Feature Details

The following features are currently working relatively well.

Editing

This extension provides a lot of features to make your coding life easier with Kick Assembler.

Syntax Highlighting

Syntax highlighting for every element in your code.

Code Snippets

Code snippets for built-in and personal functions and macros.

Code Completion

See all of your variables, macros and functions from your code and included source code.

Code Outline

See an outline of your current source code, and jump to those items in your code.

Imported File Support

Any imported files will have their variables, macros and functions available in auto completion for your current file. The heading of the hover will let you know which file the item was imported from.

Error Checking

Real time syntax checking of your code by using information from the Kick Assembler compiler.

Code Folding

Hover Support

Hover support has been added to help you with your daily coding. From simple things like a comment on your variable or macro, to more useful things like variable values and even support to show you high and low byte values in your code.

Comments

Most comments for defined variables, macros and functions are captured and displayed as a comment. There is some very basic MARKDOWN support so that you can include things like parameters in your comments.

Values

Most values will give you comments about the variable itself, but also decimal, hex and binary values as well.

Hi/Lo Byte Values

Useful when creating jump tables.

TODO

See the Roadmap

Release Notes

See the Release Notes for a summary of what was changed.

History

See the History for a more detailed breakdown of everything that has been done to the extenstion.

Acknowledgements

Thanks to SWOFFA for his work on the tmLanguage file for syntax highlighting from his Sublime Package.

I would also like to recognize Thomas Conté for his work on the original vscode-kickassembler extension for VSCode that inspired me to start this project.

Known Issues

• !! It might randomly stop working. You have been warned !!
• text editor must have focus when using build, run or debug commands

Contributing

Bug reports, fixes, and other changes are welcomed. The repository is on GitLab, and issues and pull requests are accepted. Check the contribute file on information of what the project needs, and how to run the extension locally for development and testing

Requirements

• Java Runtime
• Kick Assembler
• VICE
• C64Debugger