kick-assembler-vscode-ext

A Kick Assembler extension for VSCode.

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
• illegal opcode support

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 Scoping

Support for Namespaces and Scopes in all providers, including .filenamespace.

Completion Provider according to cursor position first.

Code Outline

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

Including any Scoping or Namespaces.

Imported File Support

Code completion for all of your code files for the .import and #import directives.

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.

Breakpoints And Logging

The ability to add breakpoints and log messages using the built-in capabilities of the editor.

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.

Additional/Illegal Opcodes

Additional opcodes for 65c02, DTV and Illegal opcodes supported. Be a Rebel!

Support For -libdir Option

Work with external code libraries in your project, and then ensure they are added to your compile using the -libdir parameter on Kick.

Support for Plugins

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

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 (openjdk)
• Kick Assembler
• VICE
• C64Debugger