https://github.com/HJLebbink/asm-dude
Visual Studio extension for assembly syntax highlighting and code completion in assembly files and the disassembly window
https://github.com/HJLebbink/asm-dude
assembler assembly assembly-language-programming avx2 avx512 code-completion disassembly masm nasm syntax-highlighting visual-studio visual-studio-extension x86-64
Last synced: 3 months ago
JSON representation
Visual Studio extension for assembly syntax highlighting and code completion in assembly files and the disassembly window
- Host: GitHub
- URL: https://github.com/HJLebbink/asm-dude
- Owner: HJLebbink
- License: mit
- Created: 2016-02-19T15:43:23.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2024-04-01T12:06:41.000Z (over 1 year ago)
- Last Synced: 2024-10-29T15:28:49.733Z (9 months ago)
- Topics: assembler, assembly, assembly-language-programming, avx2, avx512, code-completion, disassembly, masm, nasm, syntax-highlighting, visual-studio, visual-studio-extension, x86-64
- Language: C#
- Homepage:
- Size: 80.2 MB
- Stars: 4,123
- Watchers: 730
- Forks: 97
- Open Issues: 43
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- AwesomeCppGameDev - asm-dude
- StarryDivineSky - HJLebbink/asm-dude - dude 是一个 Visual Studio 扩展，主要功能是为汇编文件和反汇编窗口提供语法高亮和代码补全功能。它支持多种汇编语法，旨在提升汇编代码编写和阅读的效率。该扩展通过识别汇编指令、寄存器、标签等元素，实现语法着色，使代码更易于理解。同时，它还提供智能代码补全，帮助开发者快速输入汇编指令和符号。Asm-dude 支持自定义语法规则，允许用户根据自己的需求进行配置。它适用于需要在 Visual Studio 中进行汇编开发或调试的开发者，可以显著提高工作效率。项目还包含一些示例和文档，方便用户快速上手使用。 (杀毒免杀_逆向工程 / 资源传输下载)
README
# AsmDude2
AsmDude2 represents a natural evolution from its predecessor, AsmDude. While AsmDude served as a
single, all-encompassing plugin for VS2015/17/19, providing support for Assembly source code,
AsmDude2 is built around a Language Server Protocol ([LSP](https://microsoft.github.io/language-server-protocol/))
and a lightweight Visual Studio extension (for VS2022), drawing its functionality from this LSP.
Transitioning from a Visual Studio 2019 extension to one compatible with Visual Studio 2022 wasn't
straightforward. Many of the features from the older AsmDude have yet to be ported, and some may
never be. See the list of known issues and things still todo.
This extension can be found in the [visual studio extensions gallery](https://marketplace.visualstudio.com/items?itemName=Henk-JanLebbink.AsmDude2)
or download latest installer [AsmDude.vsix (v2.0.0.4)](https://github.com/HJLebbink/asm-dude/releases/download/v2.0.0.4/Asmdude2.v2-0-0-4.vsix).
### Features
#### Syntax highlighting and Code Folding
AsmDude2 offers support for the following architectures: the instruction sets of x86 and x64, as well as
SSE, AVX, AVX2, Xeon-Phi (Knights Corner), and AVX-512 instructions.
Most of the commonly used Masm directives covered, along with a selection of Nasm directives.
#### Code Descriptions
When you hover over a mnemonic, you may receive a pop-up with descriptions. These descriptions
can be modified and added by updating the AsmDudeData.xml file, which will be located alongside
the installed plugin binaries (.vsix). Finding the directory where plugins are installed can be
a bit challenging; you might want to try a location like C:\Users\AppData\Local\Microsoft\VisualStudio\17.0\Extensions\AsmDude2\2.0.0.1\Server.
I kindly encourage you to share any updates you make.
Please note that the formatting of the pop-up does not display Markdown (see the known issues)
#### Code Completion
While typing text, the completion lists will be refined to display the relevant
language keywords. This applies to all keywords. However, please be aware that code suggestions
may not be flawless at this stage; only valid code completions should be proposed.
#### Signature Help
Signature Help, also referred to as Parameter Info, presents the method's signature in a tooltip when
a user enters the character marking the start of the parameter list (e.g., in C++, an opening parenthesis).
As the user types a parameter and a parameter separator (usually a comma),
the tooltip is refreshed to display the next parameter in bold.
## Disassembly Window in VS
Syntax highlighting in the disassembly window. No QuickInfo tooltips yet (see known issues)
## Where is the Source (Are you sure this is not a honeypot?!)
If you're reading this, you're probably an assembly programmer. However, if you're still interested
in some C#, or you're just being cautious, you can run the extension from the source code. To do
that, you'll need to have the Visual Studio 2022 SDK installed. To run the extension, press F5 or
select the 'Debug > Start Debugging' option from the menu. This will launch a new instance of Visual
Studio under the experimental environment.
### Things For a next release
* Update instructions for Sapphire Rapids
* Support AMX
* Make the LSP gracefully handle large (+10K lines)
* Restore hyperlinks in mnemonics (from AsmDude)
* Restore Label Analysis (from AsmDude)
* Restore AsmSim (from AsmDude)
### Feature Requests: (desire something - let me know)
* Support AMX
* Label rename assistance.
* Code formatting.
* Track flag influence. Select an opcode that uses a flag (as input), find the opcodes that produce this flag (as output). E.g. select opcode cmovc or setc , highlight all opcodes such as btr, sal, sar, shl, shr, etc.
* Register rename assistance. Highly desirable but very challenging. E.g. rename GPR rdx to rbx, find which rdx, edx, dx, dl and dh will need to be renamed, check if renames will clash with existing occurances of rbx, ebx, bx, bl and bh.
* Arm support.
* Nasm macros syntax highlighting.
* Add support for MASM keyword "comment".
* Add syntax highlighting, statement completion and syntax checks for struct member fields.
* Disassembly window: show memory content from selected address (see [here](https://github.com/HJLebbink/asm-dude/issues/72)).
* Disassembly window: show memory content of the stack frame and stack pointer (see [here](https://github.com/HJLebbink/asm-dude/issues/72)).
* Add comment/uncomment functionality (see [Issue](https://github.com/HJLebbink/asm-dude/issues/76)).
### Updates:
* 21 September 2022: AsmDude2
### Known issues
* LSP client extension [for Visual Studio 2022](https://www.nuget.org/packages/Microsoft.VisualStudio.LanguageServer.Protocol.Extensions) does not honor Markdown. Please help me and vote for (https://stackoverflow.com/questions/77015711/popup-hover-with-markdown-from-a-language-server-protocol-lsp)
* Debug window does not trigger requests to the LSP.