9 unstable releases (4 breaking)

0.6.0 Nov 26, 2023
0.4.2 Oct 22, 2023
0.3.3 Aug 29, 2023
0.3.2 Mar 30, 2023
0.1.0 Jul 27, 2020

#4 in #tooling

Download history 345/week @ 2023-12-07 307/week @ 2023-12-14 299/week @ 2023-12-21 290/week @ 2023-12-28 321/week @ 2024-01-04 298/week @ 2024-01-11 343/week @ 2024-01-18 349/week @ 2024-01-25 320/week @ 2024-02-01 363/week @ 2024-02-08 405/week @ 2024-02-15 398/week @ 2024-02-22 378/week @ 2024-02-29 346/week @ 2024-03-07 381/week @ 2024-03-14 254/week @ 2024-03-21

1,416 downloads per month

BSD-2-Clause

225KB
1.5K SLoC

Language Server for GAS/GO Assembly

crates.io Tests

Goal

Provide hovering and autocompletion for assembly files written in the GAS/NASM or GO assembly flavors. It supports assembly files for the x86 or x86_64 instruction sets.

This tool can serve as reference when reading the assembly output of a program. This way you can query what each command exactly does and deliberate about whether the compiler is producing the desired output or whether you have to tweak your code for optimisation.

Installation

Using cargo

Install using the cargo package manager, either from crates.io or from github:

cargo install asm-lsp
# or to get the latest version from github
cargo install --git https://github.com/bergercookie/asm-lsp

Set up as a language server

Add a section like the following in your settings.json file:

"asm-lsp": {
    "command": "asm-lsp",
    "filetypes": [
        "asm", "s", "S"
    ]
}

[OPTIONAL] Configure via .asm-lsp.toml

Add a .asm-lsp.toml file like the following to your project's root directory to selectively target specific assemblers and/or instruction sets:

version = "0.1"

[assemblers]
gas = true
go = false

[instruction_sets]
x86 = false
x86_64 = true

Demo

Hovering / Documentation support

Autocomplete

Acknowledgements

Current rust package builds on top of the opcodes python package

Dependencies

~16–32MB
~499K SLoC